How to Install Helm: Step-by-Step Guide for Kubernetes

To install helm, download the latest release from the official Helm GitHub repository or use a package manager like brew on macOS or chocolatey on Windows. After installation, verify it by running helm version in your terminal.

Syntax

The basic syntax to install Helm depends on your operating system and preferred method. Common methods include using package managers or downloading the binary directly.

• macOS: Use brew install helm to install via Homebrew.
• Linux: Download the binary, extract it, and move it to your /usr/local/bin directory or use the official installation script.
• Windows: Use choco install kubernetes-helm with Chocolatey.

After installation, run helm version to check the installed version.

bash

brew install helm

# or for Linux
curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3
chmod 700 get_helm.sh
./get_helm.sh

# or for Windows (PowerShell as admin)
choco install kubernetes-helm

# Verify installation
helm version

Output

version.BuildInfo{Version:"v3.x.x", GitCommit:"...", GitTreeState:"clean", GoVersion:"go1.xx"}

Example

This example shows how to install Helm on a Linux system using the official installation script and verify the installation.

bash

curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3
chmod 700 get_helm.sh
./get_helm.sh
helm version

Output

version.BuildInfo{Version:"v3.x.x", GitCommit:"...", GitTreeState:"clean", GoVersion:"go1.xx"}

Common Pitfalls

Common mistakes when installing Helm include:

• Not setting executable permissions on the downloaded script or binary.
• Not moving the Helm binary to a directory in your system PATH, causing helm command not found errors.
• Using outdated installation methods for Helm 2 instead of Helm 3.
• Not verifying the installation with helm version.

Always use the official Helm installation script or trusted package managers to avoid issues.

bash

## Wrong: Running script without execute permission
./get_helm.sh

## Right: Add execute permission first
chmod 700 get_helm.sh
./get_helm.sh

Quick Reference

Here is a quick summary of Helm installation commands by platform:

Platform	Installation Command
macOS	brew install helm
Linux	curl -fsSL https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
Windows (PowerShell)	choco install kubernetes-helm

Key Takeaways

Use the official Helm installation script or trusted package managers for your OS.

Always verify Helm installation by running 'helm version'.

Set executable permissions on downloaded scripts before running them.

Move Helm binary to a directory in your system PATH if installing manually.

Avoid using legacy Helm 2 installation methods; use Helm 3 instead.