← All insightsGetting Started

Getting started with Flux CD

CodeWizard Engineering · 12 June 2026 · 3 min read · Beginner

Flux is a set of Kubernetes controllers that keep clusters in sync with sources like Git, Helm repositories and OCI artifacts, with first-class Kustomize and Helm support.

Why teams use it

  • Composable controllers (source, kustomize, helm, notification)
  • Native Helm and Kustomize reconciliation from Git or OCI
  • Strong multi-tenant and progressive-delivery support (Flagger)

Install it

bash
curl -s https://fluxcd.io/install.sh | sudo bash
flux check --pre
flux bootstrap github --owner=acme --repository=fleet --path=clusters/prod

A first working config

A GitRepository source plus a Kustomization that applies it.

yaml
apiVersion: source.toolkit.fluxcd.io/v1
kind: GitRepository
metadata: { name: apps, namespace: flux-system }
spec:
  interval: 1m
  url: https://github.com/acme/deploy
  ref: { branch: main }
---
apiVersion: kustomize.toolkit.fluxcd.io/v1
kind: Kustomization
metadata: { name: web, namespace: flux-system }
spec:
  interval: 5m
  path: ./apps/web
  prune: true
  sourceRef: { kind: GitRepository, name: apps }

Run and verify

bash
flux get kustomizations
flux reconcile kustomization web --with-source
flux suspend kustomization web

Mistakes to avoid early

  • Long reconcile intervals hiding how stale the cluster is
  • Forgetting prune:true, so deleted files stay live in the cluster
  • No notifications wired up, so failed reconciliations go unnoticed

Want senior help putting Flux CD to work - or a team bootcamp on it? CodeWizard runs Israel's largest DevOps community and embeds named senior engineers with a transparent hours log. Book a free consult or explore the Academy.

Like where this is going?

Get hands-on help from the engineers who write these posts.

Book a free consult