Setting up the target system

We’ll walk you through the installation in a local Minikube installation. Adapt these steps to install the o12stack into your cluster. We use Homebrew to install software on the client side.

Heads up!

Before installing the observability stack into a Kubernetes cluster (maybe even a production system), we urge you to test things in a test environment!


Have minikube and helm installed on your client:

brew cask install minikube
brew install kubernetes-cli helm

Kubernetes cluster

Set up Minikube on your local machine. We use the hyperkit hypervisor on our Macs as this avoids hasseling with Oracle Virtual Box. The full o12stack will consume more than default memory (1GB) and cpu (1). Please provide more memory and cpu:

minikube start --vm-driver=hyperkit --memory 8192 --cpus 3
minikube addons enable ingress

Set up the Helm server component Tiller. Check that it’s up and running:

$ helm init

Check that it’s up and running:

$ kubectl get pods --all-namespaces
NAMESPACE     NAME                                       READY   STATUS    RESTARTS   AGE
kube-system   tiller-deploy-69ffbf64bc-n9lss             0/1     Running   0          11s

Configure ingress domain

Configure an ingress domain (or sobdomain) to point at your cluster. If you’re running Minikube, utilize

sudo sed -i '' '/' /etc/hosts
sudo bash -c 'echo "$(minikube ip)" >> /etc/hosts'

Now your good to go, deploy the o12stack.


When you’re done evaluating, shut everything down and dispose the cluster.

minikube stop
minikube delete