- A running Kubernetes cluster (local or remote).
kubectlinstalled and configured on your workstation, with the correct cluster context selected in your kubeconfig so Helm targets the intended cluster.
Before installing Helm, confirm
kubectl can reach your cluster. For example, kubectl get nodes should return the cluster nodes and not an error. If kubectl fails, fix your kubeconfig or cluster access before proceeding.
- Linux, macOS, and Windows are supported.
- Choose an installer that matches your OS and distribution.
Example installation commands (Linux)
- macOS: install with Homebrew (
brew install helm). See Homebrew docs: https://brew.sh - Windows: use Chocolatey, or download binaries from Helm releases: https://github.com/helm/helm/releases
- Check Helm client and server versions:
- Confirm Helm can list releases in the cluster:
- If you added a repo, update and list repos:
- If
helmcommands fail with authentication or connectivity errors, confirmkubectlworks first:kubectl config current-contextkubectl get nodes
- On systems using snap, omit
--classiconly if you intentionally want strict sandboxing and have arranged alternative kubeconfig access.
- Official Helm documentation: https://helm.sh/docs/
- Helm releases (binaries): https://github.com/helm/helm/releases
- Homebrew: https://brew.sh
- Chocolatey: https://chocolatey.org/install
helm versionreturns the client and (if applicable) server version,helm list --all-namespacesruns without cluster-access errors.