5.0 KiB
| title | content_template | weight | card | ||||
|---|---|---|---|---|---|---|---|
| Install Minikube | templates/task | 20 |
|
{{% 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.
{{< tabs name="minikube_before_you_begin" >}} {{% tab name="Linux" %}} To check if virtualization is supported on Linux, run the following command and verify that the output is non-empty:
egrep --color 'vmx|svm' /proc/cpuinfo
{{% /tab %}} {{% tab name="macOS" %}} To check if virtualization is supported on macOS, run the following command on your terminal.
sysctl -a | grep machdep.cpu.features
If you see VMX in the output, the VT-x feature is supported on your OS.
{{% /tab %}}
{{% tab name="Windows" %}}
To check if virtualization is supported on Windows 8 and above, run the following command on your Windows terminal or command prompt.
systeminfo
If you see the following output, virtualization is supported on Windows.
Hyper-V Requirements: VM Monitor Mode Extensions: Yes
Virtualization Enabled In Firmware: Yes
Second Level Address Translation: Yes
Data Execution Prevention Available: Yes
{{% /tab %}} {{< /tabs >}}
{{% /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 kubectl according to the instructions in Install and Set Up 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. {{< /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 first need to install VirtualBox or Hyper-V. Hyper-V can be run on three versions of Windows 10: Windows 10 Enterprise, Windows 10 Professional, and Windows 10 Education. See the official Minikube GitHub repository for additional installation information. {{< /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