Where Is the helmfile.yaml?
Helmfile reads helmfile.yaml at the repo root, listing chart releases with values per environment.
Last updated
Helmfile configures releases from a YAML file at the repository root. The helmfile.yaml file lists charts with versions, values files, and environment overrides. Sub files split large setups through includes.
Environments select value sets per deploy target. Secrets plug in through vals backends rather than committed files. Keep the file beside the values it references for portable deploys.
Where Helmfile stores this, by platform
[Repo]/helmfile.yaml
Releases with charts, versions, and values live here. Environments switch value sets per flag. Secrets resolve through vals backends.
[Repo]/helmfile.yaml
Same root file on Mac. Templating renders values before helm sees them. Pin helm and helmfile versions together.
[Repo]\helmfile.yaml
Same file on Windows. Path separators inside follow the repo root. Exact schema keys vary by Helmfile release.
Frequently asked questions
How do I deploy one release?
Select it by label or name flag on the sync command. Dependencies order automatically. The file stays the single source for all sets.
Where do Helmfile secrets go?
In vals backends like sops files or vault paths referenced from values. Never commit plaintext secrets beside the file. CI injects backends per environment.
Notice an outdated path? Let us know.