Set up Minishift or Minikube

Minishift and Minikube offer a great way to get started quickly. They run a local Kubernetes cluster and allow you to set up Lightbend Console on your local machine for exploration. If you already have one of them installed on your machine, skip to the Run Minikube/Minishift page.

The OpenShift Getting Started with Minishift and the Kubernetes Install Minikube guides provide detailed installation and configuration instructions. Both Minishift and Minikube require a hypervisor, such as VirtualBox. If you want to start with a basic install, the sections below provide simple commands for VirtualBox on both OS X and Ubuntu. If you choose to follow the more extensive Minishift or Minikube documentation, return here to see how to Run Minishift/Minikube using parameters that work best for Lightbend Console.

Basic installation for OS X

Using homebrew, follow these steps to install VirtualBox and Minishift or Minikube on OS X:

  1. Download and install VirtualBox: https://www.virtualbox.org/wiki/Downloads.

  2. Install Minishift or Minikube using the following commands:

Minishift
brew cask install minishift
Minikube
brew cask install minikube
brew install kubernetes-cli

Basic installation for Ubuntu 16.04+

  1. If you do not have curl, install it:

    sudo apt-get install curl
    
  2. Use the following command in a shell to download and install VirtualBox:

    sudo apt-get install virtualbox virtualbox-ext-pack
    
  3. Install Minikube or Minishift using the following commands:

Minishift
cd /tmp/
curl -Lso minishift.tgz  https://github.com/minishift/minishift/releases/download/v1.24.0/minishift-1.24.0-linux-amd64.tgz
tar -xvzf minishift.tgz
sudo cp minishift-1.24.0-linux-amd64/minishift /usr/local/bin/
sudo chmod +x /usr/local/bin/minishift
Minikube
curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo cp minikube /usr/local/bin  
sudo chmod +x /usr/local/bin/minikube
sudo snap install kubectl --classic