Helm Basics
Package and release Kubernetes apps with Helm 3. Results appear in the same fence: same-line # comments when short, multiline # blocks below the sample when not. Fences are bash, dockerfile, or yaml as appropriate.
//
Search across all documentation pages
Package and release Kubernetes apps with Helm 3. Results appear in the same fence: same-line # comments when short, multiline # blocks below the sample when not. Fences are bash, dockerfile, or yaml as appropriate.
Install a chart as a release.
helm install api ./charts/api -n app --create-namespace
# NAME: api STATUS: deployedUpgrade or install with -i.
helm upgrade --install api ./charts/api -n app -f values-prod.yaml
# Release "api" has been upgradedDefault chart configuration.
# yaml
image:
repository: ghcr.io/acme/api
tag: "1.0.0"
replicaCount: 3
# overridden by -f / --setRevert to a prior revision.
helm rollback api 1 -n app
# Rollback to 1Render manifests without installing.
helm template api ./charts/api -f values.yaml
# --- yaml docs to stdoutList releases.
helm list -n app
# NAME NAMESPACE REVISION STATUSRemove a release.
helm uninstall api -n app
# release "api" uninstalledRevision history.
helm history api -n app
# REVISION STATUS DESCRIPTIONCLI value overrides.
helm upgrade --install api ./charts/api --set replicaCount=5
# replicaCount=5Chart metadata.
# yaml
apiVersion: v2
name: api
version: 0.1.0
appVersion: "1.0.0"Chart.yaml dependencies + helm dependency update.
helm dependency update ./charts/api
# saves charts/*.tgzPre/post install Job hooks via annotations.
# yaml
annotations:
"helm.sh/hook": pre-install
# Job runs as hookShow computed user values.
helm get values api -n app
# USER-SUPPLIED VALUESPull/push charts via OCI registries.
helm pull oci://ghcr.io/acme/charts/api --version 1.2.3
# api-1.2.3.tgzRollback automatically on failure.
helm upgrade --install api ./charts/api --atomic --timeout 5m
# failed upgrade rolls backStack versions: Kubernetes 1.36.2 · Docker Engine 29.6.1 · Helm 3 · Compose v2 · containerd via CRI
Reviewed by Chris St. John·Last updated Jul 18, 2026