flux create helmrelease: Deploy a Helm Chart
flux create helmrelease creates a HelmRelease that installs and upgrades a Helm chart from a source via Flux.
HelmRelease is how Flux manages Helm charts declaratively. create helmrelease wires a chart to a source and a target namespace.
What it does
flux create helmrelease creates a HelmRelease custom resource that references a chart in a --source (a HelmRepository, GitRepository, or OCIRepository), installs it into --target-namespace, and applies value overrides from --values files. Flux's helm-controller reconciles installs and upgrades.
Common usage
flux create helmrelease podinfo \
--source=HelmRepository/podinfo \
--chart=podinfo \
--chart-version=">=6.0.0" \
--target-namespace=apps \
--values=./values-prod.yaml \
--interval=10mOptions
| Flag | What it does |
|---|---|
| --source <kind/name> | Chart source (HelmRepository/GitRepository/OCIRepository) |
| --chart <name> | Chart name or path within the source |
| --chart-version <range> | SemVer range to install |
| --target-namespace <ns> | Namespace to release into |
| --values <file> | Values file override (repeatable) |
| --interval <dur> | Reconcile interval |
Common errors in CI
"✗ HelmRelease reconciliation failed: ... chart pull error: ... no chart name found" means the --chart or --source is wrong. "Helm install failed: ... timed out waiting for the condition" means workloads never became Ready. "values don't meet the specifications of the schema" means a values override violates the chart's values.schema.json.