Installation and Configuration

In this lesson we cover installing and configuring Helm so you can manage Kubernetes applications using charts. Before installing Helm, confirm you have a working Kubernetes cluster and a configured kubectl client. Helm uses your kubeconfig to talk to the cluster, so ensure it points to the intended cluster context.

Make sure kubectl can talk to your cluster and that your kubeconfig is accessible from your user home directory. Snap-installed Helm (see below) requires a less restrictive sandbox to read kubeconfig by default.

Prerequisites

A running Kubernetes cluster (local, cloud, or remote).
kubectl installed and configured with the correct kubeconfig.
Network access to download Helm binaries or packages.

Quick verification commands:

# Verify kubectl client and cluster access
kubectl version --client
kubectl cluster-info

# Show active kubeconfig and contexts
kubectl config view
kubectl config current-context

Install Helm (platforms and common methods) The examples below focus on common installation methods for Linux and also show macOS/Windows alternatives.

Platform / Method	When to use	Install commands (examples)
Snap (Linux desktop/server)	Fast install on systems with snap support	`bash\nsudo snap install helm --classic\n`
APT (Debian / Ubuntu)	For servers or when you want package-managed updates	`bash\n# Add Helm GPG key\ncurl -fsSL https://baltocdn.com/helm/signing.asc \| sudo gpg --dearmor -o /usr/share/keyrings/helm.gpg\n\n# Add Helm repository to APT\necho \"deb [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\n\n# Update and install\nsudo apt update\nsudo apt install helm\n`
FreeBSD (pkg)	FreeBSD package manager	`bash\nsudo pkg install helm\n`
macOS (Homebrew)	macOS users preferring Homebrew	`bash\nbrew install helm\n`
Windows (Chocolatey / Scoop)	Windows CLI package managers	`powershell\nchoco install kubernetes-helm\n# or\nscoop install helm\n`

Note: The --classic flag is required for Snap installs to relax confinement so Helm can read files from standard locations (like kubeconfig) on the host. Install examples (step-by-step)

Snap (Linux):

sudo snap install helm --classic

Debian / Ubuntu (APT):

# Add Helm GPG key
curl -fsSL https://baltocdn.com/helm/signing.asc | sudo gpg --dearmor -o /usr/share/keyrings/helm.gpg

# Add the Helm repository to APT sources
echo "deb [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

# Update package lists and install Helm
sudo apt update
sudo apt install helm

FreeBSD:

sudo pkg install helm

macOS:

brew install helm

Windows (PowerShell with Chocolatey):

choco install kubernetes-helm

Verify Helm is installed and operational

# Show Helm client version
helm version

# Add a popular chart repository and refresh cache
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

# Search the local repo cache for charts
helm search repo bitnami

Troubleshooting tips and important notes

If you installed Helm via Snap and Helm cannot access your kubeconfig, the Snap confinement may be blocking access. Use the --classic option on install or place kubeconfig in a location the snap can read. Always verify kubectl can reach the cluster before troubleshooting Helm connectivity issues.

Ensure kubectl works first: most Helm connectivity problems are kubeconfig/context related.
Helm 3 removed the server-side Tiller component; everything runs client-side communicating with the Kubernetes API.
Keep Helm updated via your chosen package manager to receive chart tooling and security fixes.

References and further reading

Official Helm documentation: https://helm.sh/docs/
Kubernetes documentation: https://kubernetes.io/docs/

Practice suggestion

In a lab environment, install Helm using one of the methods above, add a chart repository (for example Bitnami), and deploy a simple chart (e.g., nginx) to validate end-to-end functionality.

Introduction

Core Concepts

Scheduling

Logging & Monitoring

Application Lifecycle Management

Cluster Maintenance

Security

Storage

Networking

Design and Install a Kubernetes Cluster

Install "Kubernetes the kubeadm way"

Troubleshooting

Helm Basics (2025 Updates)

Kustomize Basics (2025 Updates)

Other Topics

Mock Exams

Installation and Configuration

Watch Video

Practice Lab