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

Install Docker

Usage

Start a cluster using the docker driver:

minikube start --driver=docker

To make docker the default driver:

minikube config set driver docker

Requirements

  • macOS 10.11+
  • HyperKit

HyperKit installation

  • If Docker for Desktop is installed, you already have HyperKit
  • Otherwise, if you have Brew Package Manager, run:
brew install hyperkit

Usage

Start a cluster using the hyperkit driver:

minikube start --driver=hyperkit

To make hyperkit the default driver:

minikube config set driver hyperkit

Requirements

Usage

Start a cluster using the virtualbox driver:

minikube start --driver=virtualbox

To make virtualbox the default driver:

minikube config set 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 --driver=parallels

To make parallels the default driver:

minikube config set 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 --driver=vmware

To make vmware the default driver:

minikube config set driver vmware

experimental

This is an experimental driver. please use it only for experimental reasons. for a better kubernetes in container experience, use docker driver.

Install Podman

Usage

Start a cluster using the docker driver:

minikube start --driver=podman

To make docker the default driver:

minikube config set driver podman

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 auto-selects the memory size based on your system up to 6000mb. For larger deployments, increase the memory allocation using the --memory flag, or make the setting persistent using:

minikube config set memory 8096

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! 💃🏽🎉

Last modified April 4, 2020: Move start page back (cf61a8342)