Installing kluctl.

Kluctl is available as a CLI and as a GitOps controller.

Installing the CLI


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 | 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
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:


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:

  - git:
      subDir: install/controller
        tag: v2.22.1

Installing the Kluctl Webui

See Installing the Kluctl Webui for details.