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.4.0.deb \
 && sudo dpkg -i minikube_1.4.0.deb

Download and install minikube:

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

Hypervisor Setup

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 --vm-driver=kvm2

To make kvm2 the default driver:

minikube config set vm-driver kvm2

Requirements

Usage

minikube currently uses VirtualBox by default, but it can also be explicitly set:

minikube start --vm-driver=virtualbox

To make virtualbox the default driver:

minikube config set vm-driver virtualbox

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 --vm-driver=none

To make none the default driver:

sudo minikube config set vm-driver none

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