https://github.com/sighupio/furyctl
furyctl is the SIGHUP Distribution cluster lifecycle manager
https://github.com/sighupio/furyctl
devops golang k8s kubernetes terraform
Last synced: 3 days ago
JSON representation
furyctl is the SIGHUP Distribution cluster lifecycle manager
- Host: GitHub
- URL: https://github.com/sighupio/furyctl
- Owner: sighupio
- License: apache-2.0
- Created: 2018-11-19T19:24:56.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2026-01-21T14:09:25.000Z (11 days ago)
- Last Synced: 2026-01-22T01:59:10.506Z (11 days ago)
- Topics: devops, golang, k8s, kubernetes, terraform
- Language: Go
- Homepage: https://docs.sighup.io
- Size: 45.8 MB
- Stars: 37
- Watchers: 9
- Forks: 7
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
The Swiss Army Knife
for the SIGHUP Distribution
[](https://ci.sighup.io/sighupio/furyctl)
[](https://goreportcard.com/report/github.com/sighupio/furyctl)
## What is furyctl?
`furyctl` is the command line companion for the SIGHUP Distribution (SD) to manage the **full lifecycle** of your SD Kubernetes clusters.
> [!TIP]
> Learn more about the SIGHUP Distribution in the [documentation site](https://docs.sighup.io).
> [!NOTE]
> Starting from v0.25.0, the next generation of `furyctl` has been officially released. Previous versions (<= 0.11), are considered legacy and will only receive bug fixes. It will be maintained under the `release-v0.11` branch.
>
> If you're looking for the old documentation for furyctl legacy, you can find it [here](https://github.com/sighupio/furyctl/blob/release-v0.11/README.md).
### Available providers
- `EKSCluster`: Provides comprehensive lifecycle management for a SIGHUP Distribution Kubernetes cluster based on EKS from AWS. It handles the installation of the VPC, VPN, EKS using the installers, and deploys the Distribution onto the EKS cluster.
- `KFDDistribution`: Dedicated provider for the distribution, which installs the SIGHUP Distribution (modules only) on an existing Kubernetes cluster.
- `OnPremises`: Provider to manage the full lifecycle of a SIGHUP Distribution cluster on Virtual Machines.
## Support & Compatibility 🪢
Check the [compatibility matrix][compatibility-matrix] for information about `furyctl` and `SD` versions compatibility.
## Installation
### Installing from binaries
You can find `furyctl` binaries on the [Releases page](https://github.com/sighupio/furyctl/releases).
To download the latest release, run:
```bash
curl -L "https://github.com/sighupio/furyctl/releases/latest/download/furyctl-$(uname -s)-amd64.tar.gz" -o /tmp/furyctl.tar.gz && tar xfz /tmp/furyctl.tar.gz -C /tmp
chmod +x /tmp/furyctl
sudo mv /tmp/furyctl /usr/local/bin/furyctl
```
Alternatively, you can install `furyctl` using `mise` or the `asdf` plugin.
### Installing with [mise](https://mise.jdx.dev/)
```bash
mise use furyctl@0.33.3
```
Check that everything is working correctly with `furyctl version`:
```bash
$ furyctl version
...
goVersion: go1.23
osArch: arm64
version: 0.33.3
```
### Installing with [asdf](https://github.com/asdf-vm/asdf)
Add furyctl asdf plugin:
```bash
asdf plugin add furyctl
```
Check that everything is working correctly with `furyctl version`:
```bash
$ furyctl version
...
goVersion: go1.23
osArch: amd64
version: 0.33.3
```
## Development
For development setup, building from source, and contributing guidelines, see [DEVELOPMENT.md](docs/DEVELOPMENT.md).
## Usage
For basic and advanced usage instructions, please refer to furyctl's [official documentation](https://docs.sighup.io/furyctl/) and the [SIGHUP Distribution getting started guides](https://docs.sighup.io/docs/getting-started/).
## Reporting Issues
In case you experience any problems with `furyctl` itslef, please [open a new issue](https://github.com/sighupio/furyctl/issues/new/choose) on GitHub. If the issue is related to the SIGHUP Distribution, please open the issue in [its repository](https://github.com/sighupio/distribution) instead.
## License
This software is open-source and it's released under the following [LICENSE](LICENSE).
[compatibility-matrix]: https://github.com/sighupio/furyctl/blob/main/docs/COMPATIBILITY_MATRIX.md