How to setup OpenShift Locally on Mac OS

Yann Mulonda
Jul 1, 2020 · 4 min read

Getting Started with OpenShift Minishift

img source:

The following section describes how to install Minishift and the required dependencies for mac os. This is not for production use, but rather just something to get you started and get familiar with Openshift setup and usage. These are the basic steps for setting up Minishift on your personal system:

1. Install virtual box

Download VirtualBox for Mac OS here and follow this video tutorial on how to install Virtualbox on Mac OS:

2. Set up your virtualization environment

Minishift uses libmachine and its driver plug-in architecture to provide a consistent way to manage the Minishift VM. Some hypervisors require manual installation of the driver plug-in.

Minishift embeds the VirtualBox driver plug-in, so no additional steps are required to configure it. However, VirtualBox will need to be identified to Minishift via the --vm-driver virtualbox flag or persistent configuration settings. See Setting Up Minishift to Use VirtualBox for more information.

Minishift is currently tested against docker-machine-driver-xhyve version 0.3.3. Use the following command to install the latest version of the driver with Homebrew:

$ brew install docker-machine-driver-xhyve

Once installed, enable root access for the docker-machine-driver-xhyve binary and add it to the default wheel group:

$ sudo chown root:wheel $(brew --prefix)/opt/docker-machine-driver-xhyve/bin/docker-machine-driver-xhyve

Set the owner User ID (SUID) for the binary as follows:

$ sudo chmod u+s $(brew --prefix)/opt/docker-machine-driver-xhyve/bin/docker-machine-driver-xhyve
You can also see this command on your terminal. Simpl copy-pastes them — This is a screenshot of mine

3. Install Minishift

On macOS, 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

4. Start Minishift

By default, Minishift uses the driver most relevant to the host OS. To use a different driver, set the --vm-driver flag in minishift start. For example, to use VirtualBox instead of KVM on Linux operating systems, run minishift start --vm-driver=virtualbox.

So, go ahead and run the following command to start Minishit:

$ minishift start --vm-driver=virtualbox

When Minishift is starting you will see it running on your Virtualbox:

Screenshot of my Virtualbox
$ minishift oc-env

To access the resources you just created, use the info provided at the end of the minishift start process to log into your web console or using the ofoc login -u system:admincommand:

This is my screenshot after completion of minishit start process

Use this link to access your Openshift web console: The password is not validated since it’s running locally, so you can use any password to log in.

You are all set!!! 🥳😎.

5. Stop Minishift

To stop Minishift, use the following command:

$ minishift stop

Now you can play with it and circle back later when we explore how to deploy a Nodejs application store on GitHub repo using Onpenshift.

If you enjoyed this story, you might also like “How to Set Up the Development Environment


The Startup

Get smarter at building your thing. Join The Startup’s +786K followers.

Sign up for Top 10 Stories

By The Startup

Get smarter at building your thing. Subscribe to receive The Startup's top 10 most read stories — delivered straight into your inbox, once a week. Take a look.

By signing up, you will create a Medium account if you don’t already have one. Review our Privacy Policy for more information about our privacy practices.

Check your inbox
Medium sent you an email at to complete your subscription.

The Startup

Get smarter at building your thing. Follow to join The Startup’s +8 million monthly readers & +786K followers.

Yann Mulonda

Written by

Writer — Model — Soccer Player— Software Engineer "Learning is experience; everything else is just information!"

The Startup

Get smarter at building your thing. Follow to join The Startup’s +8 million monthly readers & +786K followers.

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store