>fluxcd-kustomize-controller

fluxcd-kustomize-controller

Reconciles Kubernetes manifests with support for Kustomize, applying desired state from sources managed by Flux.

fluxcd

source-controller

helm-controller

argo-cd

What is fluxcd-kustomize-controller?

The fluxcd-kustomize-controller image is part of the Flux GitOps toolkit. It automates the application of Kubernetes manifests using Kustomize, ensuring that the actual state of the cluster matches the declared state stored in Git or other supported sources.

It works together with source-controller, which provides the raw manifests from Git repositories, buckets, or OCI registries. The kustomize-controller then fetches those resources, builds them with Kustomize overlays, and applies them to the cluster.

This design allows teams to structure Kubernetes manifests with overlays for different environments, enforce GitOps workflows, and achieve continuous delivery with minimal manual intervention.

How to use this image

The fluxcd-kustomize-controller image is typically deployed as part of a Flux installation in Kubernetes.

Examples:

# Install Flux with kustomize-controller included
kubectl create ns flux-system
flux install --components=kustomize-controller

# Create a Kustomization that points to a GitRepository source
kubectl apply -f - <<EOF
apiVersion: kustomize.toolkit.fluxcd.io/v1
kind: Kustomization
metadata:
  name: podinfo
  namespace: flux-system
spec:
  interval: 10m
  path: "./kustomize/overlays/dev"
  prune: true
  sourceRef:
    kind: GitRepository
    name: podinfo
EOF

The controller will periodically reconcile this Kustomization, ensuring that Kubernetes resources are applied and drift is corrected automatically.

Image variants

The fluxcd-kustomize-controller image is typically released under ghcr.io/fluxcd/kustomize-controller and published in these forms:

kustomize-controller:<version>

Version-pinned images (e.g., kustomize-controller:v1.3.0) are recommended for production use.

kustomize-controller:latest

Tracks the most recent stable release. Useful for evaluation but not ideal for production.

kustomize-controller:main / nightly

Built from the development branch. Intended for contributors or teams testing new features.

Interested in base images that start and stay clean?

Oops! Something went wrong while submitting the form.