Declaratively deploy your Kubernetes manifests, Kustomize configs, and Charts as Helm releases in one shot
Go to file
dependabot[bot] 33b6fca12c
build(deps): bump github.com/helmfile/chartify from 0.24.6 to 0.24.7 (#2135)
Bumps [github.com/helmfile/chartify](https://github.com/helmfile/chartify) from 0.24.6 to 0.24.7.
- [Release notes](https://github.com/helmfile/chartify/releases)
- [Commits](https://github.com/helmfile/chartify/compare/v0.24.6...v0.24.7)

---
updated-dependencies:
- dependency-name: github.com/helmfile/chartify
  dependency-version: 0.24.7
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2025-08-15 07:08:12 +08:00
.github refactor(state): extract getMissingFileHandler method for clarity (#2133) 2025-08-14 21:10:44 +08:00
cmd feat: add --take-ownership flag to helm diff and related config (#1992) 2025-04-27 12:57:41 -04:00
docs refactor(yaml): switch yaml library import paths from gopkg.in to go.yaml.in (#2114) 2025-08-01 11:28:39 +08:00
examples replace all mozilla/sops with getsops/sops (#1028) 2023-09-17 18:50:21 -05:00
hack release: fix hack/semtag when there are one or more git remotes before `origin` 2019-01-22 01:29:28 +09:00
logo Add logo as .png and .ai (Adobe Illustrator) files (#263) 2022-08-24 07:37:52 +09:00
pkg Fix parseHelmVersion to handle helm versions without 'v' prefix (#2132) 2025-08-14 21:11:09 +08:00
test Update recommended Helm versions in init.go and run.sh (#2129) 2025-08-14 08:41:43 +08:00
.dockerignore rework dockerfiles (#519) 2022-11-25 10:14:27 +09:00
.editorconfig Improve capitalization and formats of README.md. (#1545) 2020-10-19 08:47:19 +09:00
.gitignore feat: add duration to failed releases summary (#1066) 2023-10-12 18:49:07 -05:00
.golangci.yaml refactor(filesystem): add CopyDir method and optimize Fetch function (#2111) 2025-07-28 16:10:25 -04:00
.goreleaser.yml feat: add helmfile archive configuration in goreleaser (#2000) 2025-04-19 12:11:39 +08:00
.readthedocs.yaml update python3 version for mkdoc.yaml (#1712) 2024-09-18 07:11:12 +08:00
CODEOWNERS add zhaque44 in CODEOWNERS (#1711) 2024-09-17 12:23:21 +08:00
CONTRIBUTING.md Misc documentation fixes (#1442) 2024-04-06 07:17:32 +08:00
Dockerfile Update recommended Helm versions in init.go and run.sh (#2129) 2025-08-14 08:41:43 +08:00
Dockerfile.debian-stable-slim Update recommended Helm versions in init.go and run.sh (#2129) 2025-08-14 08:41:43 +08:00
Dockerfile.ubuntu Update recommended Helm versions in init.go and run.sh (#2129) 2025-08-14 08:41:43 +08:00
LICENSE Create LICENSE 2017-11-10 16:07:38 -05:00
Makefile Remove all v0.x references (#1919) 2025-03-08 07:43:21 -06:00
README-zh_CN.md docs: Add Gurubase badge to README-zh_CN (#1777) 2024-11-10 18:43:18 -05:00
README.md Update README.md (#2046) 2025-05-20 22:38:01 +08:00
SECURITY.md Create SECURITY.md (#135) 2022-06-05 17:11:54 +09:00
USERS.md Add RightCapital to USERS.md (#1676) 2024-08-24 05:14:38 +08:00
go.mod build(deps): bump github.com/helmfile/chartify from 0.24.6 to 0.24.7 (#2135) 2025-08-15 07:08:12 +08:00
go.sum build(deps): bump github.com/helmfile/chartify from 0.24.6 to 0.24.7 (#2135) 2025-08-15 07:08:12 +08:00
main.go Make helmfile respect signals send by kill command (not only Ctrl+C in terminal) (#750) 2023-04-29 15:25:29 +09:00
mkdocs.yml v1: Document experimental features (#1512) 2024-05-09 10:18:29 +08:00

README.md

Helmfile

Tests Container Image Repository on GHCR Go Report Card Slack Community #helmfile Documentation Gurubase

Deploy Kubernetes Helm Charts

English | 简体中文

About

Helmfile is a declarative spec for deploying helm charts. It lets you...

  • Keep a directory of chart value files and maintain changes in version control.
  • Apply CI/CD to configuration changes.
  • Periodically sync to avoid skew in environments.

To avoid upgrades for each iteration of helm, the helmfile executable delegates to helm - as a result, helm must be installed.

Highlights

Declarative: Write, version-control, apply the desired state file for visibility and reproducibility.

Modules: Modularize common patterns of your infrastructure, distribute it via Git, S3, etc. to be reused across the entire company (See #648)

Versatility: Manage your cluster consisting of charts, kustomizations, and directories of Kubernetes resources, turning everything to Helm releases (See #673)

Patch: JSON/Strategic-Merge Patch Kubernetes resources before helm-installing, without forking upstream charts (See #673)

Status

May 2025 Update

  • Helmfile v1.0 and v1.1 has been released. We recommend upgrading directly to v1.1 if you are still using v0.x.
  • If you haven't already upgraded, please go over this v1 proposal here to see a small list of breaking changes.

Installation

1: Binary Installation

download one of releases

2: Package Manager

  • Archlinux: install via pacman -S helmfile
  • openSUSE: install via zypper in helmfile assuming you are on Tumbleweed; if you are on Leap you must add the kubic repo for your distribution version once before that command, e.g. zypper ar https://download.opensuse.org/repositories/devel:/kubic/openSUSE_Leap_\$releasever kubic
  • Windows (using scoop): scoop install helmfile
  • macOS (using homebrew): brew install helmfile

3: Container

For more details, see run as a container

Make sure to run helmfile init once after installation. Helmfile uses the helm-diff plugin.

Getting Started

Let's start with a simple helmfile and gradually improve it to fit your use-case!

Suppose the helmfile.yaml representing the desired state of your helm releases looks like:

repositories:
- name: prometheus-community
  url: https://prometheus-community.github.io/helm-charts

releases:
- name: prom-norbac-ubuntu
  namespace: prometheus
  chart: prometheus-community/prometheus
  set:
  - name: rbac.create
    value: false

Sync your Kubernetes cluster state to the desired one by running:

helmfile apply

Congratulations! You now have your first Prometheus deployment running inside your cluster.

Iterate on the helmfile.yaml by referencing:

More complex examples

See: multi-env-helmfile

Docs

Please read complete documentation

Contributing

Welcome to contribute together to make helmfile better: contributing doc

Attribution

We use:

  • semtag for automated semver tagging. I greatly appreciate the author(pnikosis)'s effort on creating it and their kindness to share it!

Users

Helmfile has been used by many users in production:

For more users, please see: Users

License

MIT

Star History

Star History Chart