Set up Helm

Lightbend Console is provided as a Helm chart. Helm is made up of two parts, a client and a server called Tiller. Some organizations do not allow Tiller to be installed because of security concerns, in which case you can install the Console without Tiller. The client is still required. Whether using Tiller or just the client, you need to install Helm before setting up the Console.

We require that the Tiller has the ability to create cluster RBAC roles. This usually requires cluster-admin privileges. This is to create the read-only roles needed by Console (see RBAC for more details). If desired, the cluster-admin privilege can be removed once Console is installed.

The rest of this page provides a quick start guide for installing Helm and Tiller. Refer to the official Helm install guide for greater detail.

Installing the Helm client

Install on OS X using homebrew or on Ubuntu 16.04 or higher using curl:

OS X

brew install kubernetes-helm

Ubuntu 16.04+

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.

1. The following commands create a serviceaccount and bind the cluster on Kubernetes & Minikube, OpenShift, or Minishift:

Openshift & Minishift

export 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

Kubernetes & 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

1. Verify that the client and server versions match:

   helm version