Set up Helm locally

Helm is made up of two parts, a client and a server called Tiller. The rest of this page provides a quick start guide for installing Helm and Tiller on a development machine running MacOS or Ubuntu. Refer to the official Helm install guide for other platforms.

Lightbend Console requires Tiller to have the ability to create cluster RBAC roles. This means installing it with an account that has cluster-admin privileges.

Installing the Helm client

Install on MacOS using homebrew or on Ubuntu 16.04 or higher using curl:

Mac
brew install kubernetes-helm
Ubuntu
curl https://raw.githubusercontent.com/kubernetes/helm/master/scripts/get > get_helm.sh
chmod 700 ./get_helm.sh
sudo ./get_helm.sh

Initializing Tiller

With a cluster running and the Helm client installed, you can initialize Tiller from the command line. The following commands create a serviceaccount and bind the cluster on Minikube or Minishift:

Minishift
TILLER_NAMESPACE=kube-system
oc create serviceaccount --namespace $TILLER_NAMESPACE tiller
oc create clusterrolebinding $TILLER_NAMESPACE:tiller --clusterrole=cluster-admin --serviceaccount=$TILLER_NAMESPACE:tiller
helm init --wait --service-account tiller --tiller-namespace=$TILLER_NAMESPACE
Minikube
TILLER_NAMESPACE=kube-system
kubectl create serviceaccount --namespace $TILLER_NAMESPACE tiller
kubectl create clusterrolebinding $TILLER_NAMESPACE:tiller --clusterrole=cluster-admin --serviceaccount=$TILLER_NAMESPACE:tiller
helm init --wait --service-account tiller --tiller-namespace=$TILLER_NAMESPACE

Next, verify that the client and server versions match:

helm version