Flux CLI

The Flux Command-Line Interface documentation.

The Flux CLI is available as a binary executable for all major platforms, the binaries can be downloaded from GitHub releases page.

Install using package management

With Homebrew:

brew install fluxcd/tap/flux

With Homebrew:

brew install fluxcd/tap/flux

With yay:

yay -S flux-bin

With nix-env:

nix-env -i fluxcd

With Chocolatey:

choco install flux

Install using Bash

To install the latest release on Linux, macOS or Windows WSL:

curl -s https://fluxcd.io/install.sh | sudo FLUX_VERSION=2.0.0 bash

The install script does the following:

  • attempts to detect your OS
  • downloads, verifies and unpacks the release tar file in a temporary directory
  • copies the flux binary to /usr/local/bin
  • removes the temporary directory

Install using Docker

A container image with kubectl and flux is available on DockerHub and GitHub:

  • docker.io/fluxcd/flux-cli:<version>
  • ghcr.io/fluxcd/flux-cli:<version>

Example usage:

$ docker run -it --entrypoint=sh -v ~/.kube/config:/kubeconfig ghcr.io/fluxcd/flux-cli:v2.0.0
/ # flux check --kubeconfig=kubeconfig

Enable shell autocompletion

To configure your shell to load flux bash completions add to your profile:

. <(flux completion bash)

zsh, fish, and powershell are also supported with their own sub-commands.

Install using GitHub Actions

To install the latest release on Linux, macOS or Windows GitHub runners:

steps:
  - name: Setup Flux CLI
    uses: fluxcd/flux2/action@main
    with:
      version: 'latest'
  - name: Run Flux CLI
    run: flux version --client

For more information please see the Flux GitHub Action documentation.


flux

flux bootstrap

flux bootstrap bitbucket-server

flux bootstrap git

flux bootstrap gitea

flux bootstrap github

flux bootstrap gitlab

flux build

flux build artifact

flux build kustomization

flux check

flux completion

flux completion bash

flux completion fish

flux completion powershell

flux completion zsh

flux create

flux create alert

flux create alert-provider

flux create helmrelease

flux create image

flux create image policy

flux create image repository

flux create image update

flux create kustomization

flux create receiver

flux create secret

flux create secret git

flux create secret helm

flux create secret oci

flux create secret tls

flux create source

flux create source bucket

flux create source git

flux create source helm

flux create source oci

flux create tenant

flux delete

flux delete alert

flux delete alert-provider

flux delete helmrelease

flux delete image

flux delete image policy

flux delete image repository

flux delete image update

flux delete kustomization

flux delete receiver

flux delete source

flux delete source bucket

flux delete source git

flux delete source helm

flux delete source oci

flux diff

flux diff artifact

flux diff kustomization

flux events

flux export

flux export alert

flux export alert-provider

flux export helmrelease

flux export image

flux export image policy

flux export image repository

flux export image update

flux export kustomization

flux export receiver

flux export source

flux export source bucket

flux export source git

flux export source helm

flux export source oci

flux get

flux get alert-providers

flux get alerts

flux get all

flux get helmreleases

flux get images

flux get images all

flux get images policy

flux get images repository

flux get images update

flux get kustomizations

flux get receivers

flux get sources

flux get sources all

flux get sources bucket

flux get sources chart

flux get sources git

flux get sources helm

flux get sources oci

flux install

flux list

flux list artifacts

flux logs

flux pull

flux pull artifact

flux push

flux push artifact

flux reconcile

flux reconcile helmrelease

flux reconcile image

flux reconcile image repository

flux reconcile image update

flux reconcile kustomization

flux reconcile receiver

flux reconcile source

flux reconcile source bucket

flux reconcile source chart

flux reconcile source git

flux reconcile source helm

flux reconcile source oci

flux resume

flux resume alert

flux resume alert-provider

flux resume helmrelease

flux resume image

flux resume image repository

flux resume image update

flux resume kustomization

flux resume receiver

flux resume source

flux resume source bucket

flux resume source chart

flux resume source git

flux resume source helm

flux resume source oci

flux stats

flux suspend

flux suspend alert

flux suspend alert-provider

flux suspend helmrelease

flux suspend image

flux suspend image repository

flux suspend image update

flux suspend kustomization

flux suspend receiver

flux suspend source

flux suspend source bucket

flux suspend source chart

flux suspend source git

flux suspend source helm

flux suspend source oci

flux tag

flux tag artifact

flux trace

flux tree

flux tree kustomization

flux uninstall

flux version