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


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:

Mac macOS

Installing Minishift


  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 Windows operating system, due to issue #236, you need to execute the minishift binary from the drive containing your %USERPROFILE% directory.

  • Automatic update of the Minishift binary and the virtual machine ISO is currently disabled. See also issue #204.

With Homebrew


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

  $ brew cask install minishift

Latest Beta

If you want to install the latest beta version of Minishift use the homebrew-cask versions tap. After you install homebrew-cask, run the following command:

  $ brew tap caskroom/versions

You can now install the latest beta version of Minishift.

  $ brew cask install minishift-beta