Overview

The following section describes how to install Minishift and the required dependencies.

Prerequisites

Minishift requires a hypervisor to start the virtual machine on which the OpenShift cluster is provisioned. Verify that the hypervisor of your choice is installed and enabled on your system before you start Minishift.

Depending on your host operating system, you have the choice of the following hypervisors:

macOS
Linux
Windows

Installing Minishift

Manually

  1. Download the archive for your operating system from the Minishift releases page and unpack it.

  2. Copy the contents of the directory to your preferred location.

  3. Add the minishift binary to your PATH environment variable.

On the Windows operating system, due to issue #236, you need to execute the Minishift binary from your local C:\ drive. You cannot run Minishift from a network drive.

Minishift will use any SSH binary found on the PATH in preference to internal SSH code. Ensure that any SSH binary in the system PATH does not generate warning messages as this will cause installation problems such as issue #1923.

With Homebrew

Stable

On macOS you can also use Homebrew Cask to install the stable version of Minishift:

  $ brew cask install minishift

To update the binary, run following command:

  $ brew cask install --force minishift