0Pricing
Helm Academy · Lesson

Flux HelmRelease and HelmRepository

Declaring Helm sources and releases the Flux way.

Flux HelmRelease and HelmRepository is a free Helm Academy lesson on CoddyKit — lesson 3 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Helm Academy learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Flux Splits the Job

Flux separates concerns into two resources: a HelmRepository defines where charts come from, and a HelmRelease defines what to install.

Declaring a Source

A HelmRepository tells Flux to poll a chart repo on an interval, caching its index so releases can resolve chart versions.

kind: HelmRepository
metadata:
  name: bitnami
spec:
  url: https://charts.bitnami.com/bitnami
  interval: 1h

OCI Repositories Too

Flux also supports OCI chart registries. Set the HelmRepository type to oci and point its url at an oci:// registry path.

spec:
  type: oci
  url: oci://ghcr.io/my-org/charts

The HelmRelease

A HelmRelease is the desired installed release. It references a chart from a source and carries the values you want applied.

Referencing the Chart

Inside spec.chart.spec you set the chart name, a version, and a sourceRef pointing back to your HelmRepository.

chart:
  spec:
    chart: nginx
    version: 15.5.2
    sourceRef:
      kind: HelmRepository
      name: bitnami

Inline Values

The values block in a HelmRelease holds your overrides as plain YAML, just like a values file passed to helm upgrade.

values:
  replicaCount: 3
  service:
    type: ClusterIP

Values from Other Objects

You can also pull overrides from a ConfigMap or Secret using valuesFrom, keeping sensitive values out of the HelmRelease itself.

valuesFrom:
  - kind: Secret
    name: nginx-secrets

The Reconcile Interval

Each HelmRelease has an interval. Flux re-evaluates it on that schedule, re-running the install or upgrade if anything has drifted.

spec:
  interval: 5m

Flux Runs Helm

Under the hood the helm-controller performs a real Helm install or upgrade, so you get genuine releases, history, and rollbacks.

Target Namespace

Set targetNamespace to choose where the release lands, and releaseName to control the name of the resulting Helm release.

spec:
  targetNamespace: web
  releaseName: nginx

All Driven by Git

You commit the HelmRepository and HelmRelease to Git. Flux reconciles them, so editing YAML and pushing is your whole workflow.

Quick Check

Which Flux resource defines where a chart is fetched from?

Recap: Flux Helm Resources

Flux uses a HelmRepository for the source and a HelmRelease for the install plus values. Commit both, and the helm-controller reconciles. ✅

Frequently asked questions

Is the “Flux HelmRelease and HelmRepository” lesson free?

Yes — the full text of “Flux HelmRelease and HelmRepository” is free to read here on the web, and the Helm Academy course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Helm Academy course, upgrade to CoddyKit PRO.

What will I learn in “Flux HelmRelease and HelmRepository”?

Declaring Helm sources and releases the Flux way. You practise Helm Academy with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Helm Academy?

No prior experience is required. Helm Academy on CoddyKit is structured for beginners through advanced learners; this is — lesson 3 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Flux HelmRelease and HelmRepository” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Helm Academy lesson?

Yes. Every Helm Academy lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

  1. The GitOps Model for Helm Releases
  2. Deploying Charts with an Argo CD Application
  3. Flux HelmRelease and HelmRepository
  4. Drift Detection and Automated Sync
← Back to Helm Academy