Installation
Kluctl is available as a CLI and as a GitOps controller.
Installing the CLI
Binaries
The kluctl CLI is available as a binary executable for all major platforms, the binaries can be downloaded form GitHub releases page .
Installation with Homebrew
With Homebrew for macOS and Linux:
brew install kluctl/tap/kluctl
Installation with Bash
With Bash for macOS and Linux:
curl -s https://kluctl.io/install.sh | bash
The install script does the following:
- attempts to detect your OS
- downloads and unpacks the release tar file in a temporary directory
- copies the kluctl binary to
/usr/local/bin
- removes the temporary directory
Build from source
Clone the repository:
git clone https://github.com/kluctl/kluctl
cd kluctl
Build the kluctl
binary (requires go >= 1.19):
make build
Run the binary:
./bin/kluctl -h
Container images
A container image with kluctl
is available on GitHub:
ghcr.io/kluctl/kluctl:<version>
Installing the GitOps Controller
The controller can be installed via two available options.
Using the “install” sub-command
The
kluctl controller install
command can be used to install the
controller. It will use an embedded version of the Controller Kluctl deployment project
found
here
.
Using a Kluctl deployment
To manage and install the controller via Kluctl, you can use a Git include in your own deployment:
deployments:
- git:
url: https://github.com/kluctl/kluctl.git
subDir: install/controller
ref: v2.20.3