macOS

Prerequisites

  • macOS 10.12 (Sierra)
  • A hypervisor such as Hyperkit, Parallels, VirtualBox, or VMware Fusion

Installation

If the Brew Package Manager is installed, use it to download and install minikube:

brew install minikube

Download and install minikube to /usr/local/bin:

curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64 \
  && sudo install minikube-darwin-amd64 /usr/local/bin/minikube

Upgrading minikube

If the Brew Package Manager is installed, use it to download and upgrade minikube:

brew update
brew upgrade minikube

Hypervisor Setup

Requirements

  • macOS 10.11+
  • HyperKit

HyperKit installation

Usage

Start a cluster using the hyperkit driver:

minikube start --vm-driver=hyperkit

To make hyperkit the default driver:

minikube config set vm-driver hyperkit

Requirements

Usage

Start a cluster using the virtualbox driver:

minikube start --vm-driver=virtualbox

To make virtualbox the default driver:

minikube config set vm-driver virtualbox

Requirements

  • Parallels Desktop 11.0.0+ Pro or Business edition

Driver Installation

If the Brew Package Manager is installed, run:

brew install docker-machine-parallels

Otherwise:

r=https://api.github.com/repos/Parallels/docker-machine-parallels
curl -LO $(curl -s $r/releases/latest | grep -o 'http.*parallels' | head -n1) \
 && install docker-machine-driver-parallels /usr/local/bin/

Usage

Start a cluster using the parallels driver:

minikube start --vm-driver=parallels

To make parallels the default driver:

minikube config set vm-driver parallels

Requirements

  • VMware Fusion

Driver Installation

If the Brew Package Manager is installed, run:

brew install docker-machine-driver-vmware

Otherwise:

r=https://api.github.com/repos/machine-drivers/docker-machine-driver-vmware
curl -LO $(curl -s $r/releases/latest | grep -o 'http.*darwin_amd64' | head -n1) \
 && install docker-machine-driver-vmware_darwin_amd64 \
  /usr/local/bin/docker-machine-driver-vmware

Usage

Start a cluster using the vmware driver:

minikube start --vm-driver=vmware

To make vmware the default driver:

minikube config set vm-driver vmware

Getting to know Kubernetes

Once started, you can use any regular Kubernetes command to interact with your minikube cluster. For example, you can see the pod states by running:

 kubectl get po -A

Increasing memory allocation

minikube only allocates 2GB of RAM by default, which is only enough for trivial deployments. For larger deployments, increase the memory allocation using the --memory flag, or make the setting persistent using:

minikube config set memory 4096

Where to go next?

Visit the examples page to get an idea of what you can do with minikube.

📣😀 Please fill out our fast 5-question survey so that we can learn how & why you use minikube, and what improvements we should make. Thank you! 💃🏽🎉