Skip to content

Latest commit

 

History

History
117 lines (75 loc) · 3.87 KB

install-minikube.md

File metadata and controls

117 lines (75 loc) · 3.87 KB
Raw
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 %}}