Helm is a Kubernetes package manager for deploying helm charts (collections of pre-configured Kubernetes application resources). It features all the necessary commands for simpler management of apps in a Kubernetes cluster.
This tutorial covers all important Helm operations and provides examples to help you understand its syntax and features.
Note: This tutorial covers Helm 3 commands. Aside from the command syntax, Helm 3 is also architecturally different from Helm 2. The most significant distinction is that Helm 3 improves security by eliminating Tiller, the server-side component present in Helm 2.
Basic Helm Concepts
Helm commands work with several Helm-related concepts. Understanding them makes the syntax easier to follow.
- The most important Helm concept is a chart. A chart is a set of Kubernetes
yamlmanifests packaged together for easy manipulation. Helm charts make it possible to deploy a containerized application using a single command.
- Charts are grouped in online collections called repositories. Each repository has a name and URL, making the charts easy to locate, download, and install.
- Helm Hub is an online collection of distributed repositories available on the internet. It works as an information center, where you can find apps and their repository addresses. As of today, it is not possible to install an app directly from Helm Hub.
- A release is a single instance of a chart deployed in a Kubernetes cluster.
List of Helm Commands
Use the commands listed below as a quick reference when working with Helm inside Kubernetes.
Install and Uninstall Apps
The main function of Helm is Kubernetes app management. Besides the basic operations of installing and uninstalling apps, Helm enables you to perform test installations and customize the installation process.
Install an app:
helm install [app-name] [chart]
Install an app in a specific namespace:
helm install [app-name] [chart] --namespace [namespace]
Override the default values with those specified in a file of your choice:
helm install [app-name] [chart] --values [yaml-file/url]
Run a test installation to validate and verify the chart:
helm install [app-name] --dry-run --debug
Uninstall a release:
helm uninstall [release]
Perform App Upgrade and Rollback
Helm offers users multiple options for app upgrades, such as automatic rollback and upgrading to a specific version. Rollbacks can also be executed on their own. For detailed instructions on how to perform a rollback, check out How to Roll Back Changes with Helm.
Upgrade an app:
helm upgrade [release] [chart]
Instruct Helm to rollback changes if the upgrade fails:
helm upgrade [release] [chart] --atomic
Upgrade a release. If it does not exist on the system, install it:
helm upgrade [release] [chart] --install
Upgrade to a specified version:
helm upgrade [release] [chart] --version [version-number]
Roll back a release:
helm rollback [release] [revision]
Download Release Information
helm get command lets you download information about a release.
Download all the release information:
helm get all [release]
Download all hooks:
helm get hooks [release]
Download the manifest:
helm get manifest [release]
Download the notes:
helm get notes [release]
Download the values file:
helm get values [release]
Fetch release history:
helm history [release]
Add, Remove, and Update Repositories
The command helm repo helps you manipulate chart repositories.
Add a repository from the internet:
helm repo add [repository-name] [url]
Remove a repository from your system:
helm repo remove [repository-name]
helm repo update
List and Search Repositories
helm repo and
helm search commands to list and search Helm repositories.
helm search also enables you to find apps and repositories in Helm Hub.
List chart repositories:
helm repo list
Generate an index file containing charts found in the current directory:
helm repo index
Search charts for a keyword:
helm search [keyword]
Search repositories for a keyword:
helm search repo [keyword]
Search Helm Hub:
helm search hub [keyword]
helm list command enables listing releases in a Kubernetes cluster according to several criteria, including using regular (Pearl compatible) expressions to filter results. Commands such as
helm status and
helm history provide more details about releases.
List all available releases in the current namespace:
List all available releases across all namespaces:
helm list --all-namespaces
List all releases in a specific namespace:
helm list --namespace [namespace]
List all releases in a specific output format:
helm list --output [format]
Apply a filter to the list of releases using regular expressions:
helm list --filter '[expression]'
See the status of a specific release:
helm status [release]
Display the release history:
helm history [release]
See information about the Helm client environment:
Note: Learn more about managing Kubernetes cluster namespaces and unwanted or multiple copies of Helm deployments by referring to our article How To Delete Helm Deployment And Namespace.
Install, manage and remove Helm plugins by using the
helm plugin command.
helm plugin install [path/url1] [path/url2] ...
View a list of all installed plugins:
helm plugin list
helm plugin update [plugin1] [plugin2] ...
Uninstall a plugin:
helm plugin uninstall [plugin]
Helm charts use Kubernetes resources to define an application. To find out more about their structure and requirements for their creation, refer to How to Create a Helm Chart.
Create a directory containing the common chart files and directories (c
helm create [name]
Package a chart into a chart archive:
helm package [chart-path]
Run tests to examine a chart and identify possible issues:
helm lint [chart]
Inspect a chart and list its contents:
helm show all [chart]
Display the chart’s definition:
helm show chart [chart]
Display the chart’s values:
helm show values [chart]
Download a chart:
helm pull [chart]
Download a chart and extract the archive’s contents into a directory:
helm pull [chart] --untar --untardir [directory]
Display a list of a chart’s dependencies:
helm dependency list [chart]
Get Help and Version Information
Display the general help output for Helm:
Show help for a particular helm command:
helm [command] --help
See the installed version of Helm:
Helm Cheat Sheet PDF
Below you can find a one-page reference sheet containing all the Helm commands listed above. Download the Helm cheat sheet PDF and save it for future reference.
The tutorial listed the most common Helm commands used for app management in your Kubernetes cluster. The downloadable cheat sheet included is a handy one-page guide useful for a quick reference.