Helmfile — Declarative Helm Chart Deployment Manager

What it is

Helmfile is a declarative tool for managing multiple Helm chart deployments. Instead of running individual helm install and helm upgrade commands, you define all your releases in a single helmfile.yaml and deploy them together. Helmfile handles repository management, dependency ordering, environment-specific value overrides, and diff-based previews before applying changes.

Helmfile targets DevOps and platform engineers who manage Kubernetes clusters with many Helm releases. If you run more than a few Helm charts and need consistent, repeatable deployments across environments, Helmfile provides the orchestration layer.

How it saves time or tokens

Managing Helm releases individually means tracking versions, values files, and upgrade order manually. Helmfile centralizes this into a single file that describes the desired state. Running helmfile apply computes the diff between the current cluster state and the desired state, then applies only the changes.

Environment-specific overrides (environments: block) eliminate the need for separate values files per environment. You define base values once and override specific settings for staging, production, or other environments.

How to use

1. Install Helmfile:

brew install helmfile

1. Create a helmfile.yaml:

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

releases:
  - name: prometheus
    namespace: monitoring
    chart: prometheus/prometheus
    version: 25.0.0
    values:
      - values/prometheus.yaml

1. Deploy:

helmfile apply

Example

environments:
  staging:
    values:
      - env/staging.yaml
  production:
    values:
      - env/production.yaml

repositories:
  - name: ingress-nginx
    url: https://kubernetes.github.io/ingress-nginx
  - name: cert-manager
    url: https://charts.jetstack.io

releases:
  - name: cert-manager
    namespace: cert-manager
    chart: cert-manager/cert-manager
    version: 1.14.0
    set:
      - name: installCRDs
        value: true

  - name: ingress-nginx
    namespace: ingress
    chart: ingress-nginx/ingress-nginx
    version: 4.9.0
    needs:
      - cert-manager/cert-manager

This deploys cert-manager first (because ingress-nginx depends on it), with environment-specific value overrides for staging and production.

Related on TokRepo

• DevOps tools -- Explore other Kubernetes and infrastructure tools
• Automation tools -- Browse deployment automation solutions

Common pitfalls

• Helmfile requires Helm and the helm-diff plugin. Install both before running helmfile: helm plugin install https://github.com/databus23/helm-diff. Missing helm-diff causes helmfile diff to fail silently.
• The needs: directive defines deployment order. Without it, Helmfile deploys releases in parallel, which can fail if one release depends on CRDs or resources from another.
• Helmfile caches Helm repositories locally. Stale caches can cause version resolution failures. Run helmfile repos to update repository indexes before deploying.