kubernetes
/
website
mirror of https://github.com/kubernetes/website.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
website/content/en/docs/tasks/tools/install-minikube.md

4.1 KiB
Raw Blame History

title content_template weight card
Install Minikube templates/task 20
name weight
tasks 10

{{% capture overview %}}

This page shows you how to install Minikube, a tool that runs a single-node Kubernetes cluster in a virtual machine on your laptop.

{{% /capture %}}

{{% capture prerequisites %}}

VT-x or AMD-v virtualization must be enabled in your computer's BIOS. To check this on Linux run the following and verify the output is non-empty:

egrep --color 'vmx|svm' /proc/cpuinfo

{{% /capture %}}

{{% capture steps %}}

Install a Hypervisor

If you do not already have a hypervisor installed, install one for your OS now:

Operating system Supported hypervisors
macOS VirtualBox, VMware Fusion, HyperKit
Linux VirtualBox, KVM
Windows VirtualBox, Hyper-V

{{< note >}} Minikube also supports a --vm-driver=none option that runs the Kubernetes components on the host and not in a VM. Using this driver requires Docker and a Linux environment but not a hypervisor. {{< /note >}}

Install kubectl

Install Minikube

macOS

The easiest way to install Minikube on macOS is using Homebrew:

brew cask install minikube

You can also install it on macOS by downloading a static binary:

curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64 \
  && chmod +x minikube

Here's an easy way to add the Minikube executable to your path:

sudo mv minikube /usr/local/bin

Linux

{{< note >}} This document shows you how to install Minikube on Linux using a static binary. For alternative Linux installation methods, see Other Ways to Install in the official Minikube GitHub repository. {{< /note >}}

You can install Minikube on Linux by downloading a static binary:

curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 \
  && chmod +x minikube

Here's an easy way to add the Minikube executable to your path:

sudo cp minikube /usr/local/bin && rm minikube

Windows

{{< note >}} To run Minikube on Windows, you need to install Hyper-V first, which can be run on three versions of Windows 10: Windows 10 Enterprise, Windows 10 Professional, and Windows 10 Education. {{< /note >}}

The easiest way to install Minikube on Windows is using Chocolatey (run as an administrator):

choco install minikube kubernetes-cli

After Minikube has finished installing, close the current CLI session and restart. Minikube should have been added to your path automatically.

Windows manual installation

To install Minikube manually on Windows, download minikube-windows-amd64, rename it to minikube.exe, and add it to your path.

Windows Installer

To install Minikube manually on windows using Windows Installer, download minikube-installer.exe and execute the installer.

{{% /capture %}}

{{% capture whatsnext %}}

{{% /capture %}}

Cleanup everything to start fresh

If you have previously installed minikube, and run:

minikube start

And this command returns an error:

machine does not exist

You need to wipe the configuration files:

rm -rf ~/.minikube