Linux

Installation

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

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

Download and install minikube:

curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube_1.9.1-0_amd64.deb \
 && sudo dpkg -i minikube_1.9.1-0_amd64.deb

Download and install minikube:

curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-1.9.1-0.x86_64.rpm \
 && sudo rpm -ivh minikube-1.9.1-0.x86_64.rpm

Driver Setup

Check container support

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

Check virtualization support

To use VM drivers, verify that your system has virtualization support enabled:

egrep -q 'vmx|svm' /proc/cpuinfo && echo yes || echo no

If the above command outputs “no”:

  • If you are running within a VM, your hypervisor does not allow nested virtualization. You will need to use the None (bare-metal) driver
  • If you are running on a physical machine, ensure that your BIOS has hardware virtualization enabled

Requirements

  • libvirt v1.3.1 or higher
  • qemu-kvm v2.0 or higher

Installing Prerequisites

Proper installation of KVM and libvirt is highly specific to each Linux distribution. Please consult:

Once configured, validate that libvirt reports no errors:

virt-host-validate

Usage

Start a cluster using the kvm2 driver:

minikube start --driver=kvm2

To make kvm2 the default driver:

minikube config set driver kvm2

Check virtualization support

To use VM drivers, verify that your system has virtualization support enabled:

egrep -q 'vmx|svm' /proc/cpuinfo && echo yes || echo no

If the above command outputs “no”:

  • If you are running within a VM, your hypervisor does not allow nested virtualization. You will need to use the None (bare-metal) driver
  • If you are running on a physical machine, ensure that your BIOS has hardware virtualization enabled

Requirements

Usage

Start a cluster using the virtualbox driver:

minikube start --driver=virtualbox

To make virtualbox the default driver:

minikube config set driver virtualbox

Check baremetal support

To use baremetal driver (none driver). verify that your operating system is Linux and also have ‘systemd’ installed.

pidof systemd && echo "yes" || echo "no"

If the above command outputs “no”: Your system is not suitable for none driver.

If you are already running minikube from inside a VM, it is possible to skip the creation of an additional VM layer by using the none driver.

Requirements

VM running a systemd-based Linux distribution (see #2704)

Usage

The none driver requires minikube to be run as root, until #3760 can be addressed.

sudo minikube start --driver=none

To make none the default driver:

sudo minikube config set driver none

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)