How to setup Minishift

How to setup Minishift
Photo by Andreea Petruti / Unsplash


Red Hat OpenShift is an open-source container application platform based on the Kubernetes container orchestrator for enterprise app development. Minishift is a tool that helps you run OKD locally by launching a single-node OKD cluster inside a virtual machine. With Minishift you can try out OKD or develop with it, day-to-day, on your local machine.

You can run Minishift on Windows, macOS, and GNU/Linux operating systems. Minishift uses libmachine for provisioning virtual machines and OKD for running the cluster. Click for more details.


In order to run Minishift, we need MacOS. The same steps may apply to other operating systems. For more details

Minishift Setup

In this article, I'll use homebrew. If you prefer, you can download the source code and compile it.

If you choose the source code compile method, don't forget to define path variables.
brew cask install minishift

If you already installed. (To update)

brew cask install --force minishift

Openshift CLI Setup

Openshift-cli is a command-line utility. Helps us to control Openshift.

brew install openshift-cli

First Run

In order to run minishift as a developer;

minishift addons install --defaults
$ minishift addons enable admin-user
$ minishift start --vm-driver=virtualbox

And we run the following line with "oc" to assign admin authority to the developer user;

oc adm policy --as system:admin add-cluster-role-to-user cluster-admin developer

Expected Output;

The server is accessible via web console at:

You are logged in as:
    User:     developer
    Password: <any value>

To login as administrator:
    oc login -u system:admin

-- Applying addon 'admin-user':..
-- Exporting of OpenShift images is occuring in background process with pid 12594.

# habilbozali at Habils-MBP in ~ [15:57:57]

The End

We completed Minishift and OC (openshift -cli) installation. Feel free to discover your newly created minishift. Open a new browser window and set up new applications.