Skip to content

Helm

Install Helm

Via the official install script: 

1
$ curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

Via package managers: 

1
2
3
4
5
6
7
# macOS
$ brew install helm

# Debian / Ubuntu
$ curl https://baltocdn.com/helm/signing.asc | gpg --dearmor | sudo tee /usr/share/keyrings/helm.gpg > /dev/null
$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/helm.gpg] https://baltocdn.com/helm/stable/debian/ all main" | sudo tee /etc/apt/sources.list.d/helm-stable-debian.list
$ sudo apt-get update && sudo apt-get install helm

Verify installation: 

1
$ helm version

Repositories

Add a chart repository: 

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

List configured repos: 

1
$ helm repo list

Update repo index (fetch latest charts): 

1
$ helm repo update

Remove a repo: 

1
$ helm repo remove bitnami

Search charts

Search in configured repos: 

1
$ helm search repo nginx

Show all available versions of a chart: 

1
$ helm search repo nginx --versions

Search on Artifact Hub: 

1
$ helm search hub wordpress

Inspect a chart

Show chart metadata: 

1
$ helm show chart bitnami/nginx

Show default values (useful before installing): 

1
$ helm show values bitnami/nginx

Show the full README: 

1
$ helm show readme bitnami/nginx

Install a chart

Basic install (generates a release name): 

1
$ helm install my-release bitnami/nginx

Install in a specific namespace (create it if needed): 

1
$ helm install my-release bitnami/nginx -n my-namespace --create-namespace

Override values inline: 

1
$ helm install my-release bitnami/nginx --set service.type=ClusterIP --set replicaCount=2

Override values from a file: 

1
$ helm install my-release bitnami/nginx -f custom-values.yaml

Install a specific chart version: 

1
$ helm install my-release bitnami/nginx --version 15.0.0

Dry-run (render templates without installing): 

1
$ helm install my-release bitnami/nginx --dry-run

List releases

1
2
3
$ helm list
$ helm list -n my-namespace
$ helm list --all-namespaces

Upgrade a release

Upgrade with new values: 

1
$ helm upgrade my-release bitnami/nginx --set replicaCount=3

Upgrade from a values file: 

1
$ helm upgrade my-release bitnami/nginx -f updated-values.yaml

Install if not present, upgrade if it is: 

1
$ helm upgrade --install my-release bitnami/nginx -f values.yaml

Rollback

View release history: 

1
$ helm history my-release

Rollback to previous revision: 

1
$ helm rollback my-release

Rollback to a specific revision: 

1
$ helm rollback my-release 2

Uninstall a release

1
2
$ helm uninstall my-release
$ helm uninstall my-release -n my-namespace

Get release info

Show computed values for a release: 

1
$ helm get values my-release

Show rendered manifests: 

1
$ helm get manifest my-release

Show release status: 

1
$ helm status my-release

Template (local rendering)

Render templates locally without connecting to a cluster: 

1
$ helm template my-release bitnami/nginx -f values.yaml