flux

What is flux?

The flux image provides the Flux CLI and the GitOps Toolkit, a set of composable Kubernetes controllers that continuously reconcile cluster state with configuration stored in Git, OCI registries, or Helm repositories. Flux watches source repositories for changes and automatically applies them to the cluster, implementing a pull-based GitOps delivery model.

The core toolkit components include the Source Controller, Kustomize Controller, Helm Controller, Notification Controller, and Image Automation Controller. Flux is widely used for application delivery, cluster configuration management, and multi-tenancy in platform engineering teams.

How to use this image

Install Flux onto a cluster:

flux bootstrap github \
  --owner=my-org \
  --repository=my-fleet-repo \
  --branch=main \
  --path=clusters/my-cluster \
  --personal

Check the status of all Flux resources:

flux get all

Define a GitRepository source:

apiVersion: source.toolkit.fluxcd.io/v1
kind: GitRepository
metadata:
  name: my-app
  namespace: flux-system
spec:
  interval: 1m
  url: https://github.com/my-org/my-app
  ref:
    branch: main

Define a Kustomization to deploy from the source:

apiVersion: kustomize.toolkit.fluxcd.io/v1
kind: Kustomization
metadata:
  name: my-app
  namespace: flux-system
spec:
  interval: 5m
  path: "./deploy"
  prune: true
  sourceRef:
    kind: GitRepository
    name: my-app

Trigger a manual reconciliation:

flux reconcile kustomization my-app --with-source

Image variants

ghcr.io/fluxcd/flux-cli:latest

The latest stable Flux CLI release. Used for bootstrapping, inspecting, and managing Flux resources from the command line.

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

Pinned version tags such as ghcr.io/fluxcd/flux-cli:v2.2.3. Recommended for CI pipelines to ensure consistent behavior across runs.

Individual toolkit component images (e.g. ghcr.io/fluxcd/source-controller, ghcr.io/fluxcd/kustomize-controller) are managed by the Flux bootstrap process and should not typically be pulled or overridden manually.