D

Helm

Helm commands for installing, upgrading and rolling back Kubernetes chart releases.

Updated 2026-09-03

On this page

Helm packages a set of Kubernetes manifests as a versioned, templated chart, and tracks each install as a numbered release you can upgrade or roll back.

Repositories

helm repo add bitnami https://charts.bitnami.com/bitnami

Adds a chart repository under a local name.

helm repo update

Refreshes the local cache of available charts and versions from every added repository.

helm search repo nginx

Searches added repositories for charts matching a name.

Install

helm install my-release bitnami/nginx

Installs a chart under the release name my-release.

helm install my-release ./my-chart -f values-prod.yaml

Installs from a local chart directory, overriding default values with a values file.

helm install my-release ./my-chart --set replicaCount=3

Overrides a single value from the command line without a separate values file.

helm install my-release ./my-chart --dry-run --debug

Renders the final manifests without installing anything — the fastest way to check templating output before it touches the cluster.

Upgrade & Rollback

helm upgrade my-release ./my-chart -f values-prod.yaml

Upgrades an existing release to a new chart version or values.

helm upgrade --install my-release ./my-chart

Upgrades the release if it exists, or installs it if it doesn't — the standard pattern for idempotent CI/CD deploy steps.

helm upgrade my-release ./my-chart --atomic

Automatically rolls back to the previous release if the upgrade fails, instead of leaving the cluster in a half-upgraded state.

helm history my-release

Lists every revision of a release with its status and chart version.

helm rollback my-release 3

Rolls back a release to a specific revision number. Omit the number to roll back to the previous one.

Inspecting Releases

helm list

Lists releases in the current namespace.

helm list -A

Lists releases across every namespace.

helm status my-release

Shows the current state and notes for a release.

helm get values my-release

Shows the values actually in effect for a deployed release, merged from defaults and overrides.

helm get manifest my-release

Prints the exact Kubernetes manifests Helm applied for a release.

Uninstall

helm uninstall my-release
destructive

Deletes every resource the release created and removes its release history. Not reversible through Helm itself — the resources are gone unless recreated.

Chart Development

helm create my-chart

Scaffolds a new chart with the standard directory layout and a starter set of templates.

helm lint ./my-chart

Checks a chart for structural and templating problems before packaging it.

helm template ./my-chart -f values.yaml

Renders a chart's templates to plain YAML locally, without needing a cluster connection at all — useful in CI to diff rendered output.

helm package ./my-chart

Packages a chart directory into a versioned .tgz archive for distribution.

Official documentation