Installing Minishift on Windows 10 Home

Minishift is a tool to run OpenShift Origin locally as a single node cluster inside a Virtual Machine. It is a good choice for development or doing PoCs locally before deploying things in a real OpenShift cluster. In this post I am going to explain how to install and run it on a Windows 10 Home machine, where no Hyper-V support is available.

The only available alternative to Hyper-V is Oracle VirtualBox. You need to install it before going on with the Minishift installation: follow the instructions in the official website or use the Chocolatey package manager.

If you don’t have Chocolatey in the destination machine, you can install it by opening an Admin PowerShell and first checking which execution policy is set, by running the Get-ExecutionPolicy command. If it returnsRestricted, then install by executing:

Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString(''))

The fastest and secure way to install Minishift is through Chocolatey as well. From an Admin PowerShell execute:

choco install -y minishift

At the end of the installation process, double check that everything was fine by executing:

minishift version

This command should print the version of the installed Minishift.

You need now to install, using Chocolatey as well,kubectl, the Kubernetes command-line tool:

choco install -y kubernetes-cli

Finally, you need to installoc, the OpenShift command-line tool (using Chocolatey of course):

choco install -y openshift-cli

Before starting the cluster, set up VirtualBox as default driver for Minishift:

minishift config set vm-driver virtualbox

You can now start Minishift:

minishift start

The first time the start would be slower as the ISO image needs to be downloaded.

Once the server is up and running, you can access the web UI at the following URL: https://<minishift_ip>:8443/console


Login using developer as username and any value as password. I suggest to use Firefox or Chrome for the web UI.

You can also login using theoc client.

Minishift is now ready to be used. Enjoy it!

Published on System Code Geeks with permission by Guglielmo Iozzia, partner at our SCG program. See the original article here: Installing Minishift on Windows 10 Home

Opinions expressed by System Code Geeks contributors are their own.

Guglielmo Iozzia

Guglielmo is currenty a Big Data Delivery Lead at Optum Ireland. He has been a software engineer and architect for a variety of Java and Scala applications (Big Data, web, cloud, web services, mobile). Since 2018 he is also a frequent speaker to international conferences. His first technical book is going to be published in December 2018
Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

1 Comment
Newest Most Voted
Inline Feedbacks
View all comments
4 years ago

Thank you so much! had hiccups with some connection as below. But running the minishift start command again worked out well.

— Starting Minishift VM …….. FAIL .E0114 16:07:51.076523 12940 start.go:494] Error starting the VM: Error creating new host: Error attempting to get plugin server address for RPC: Failed to dial the plugin server in 10s. Retrying.
Error starting the VM: Error creating new host: Error attempting to get plugin server address for RPC: Failed to dial the plugin server in 10s

Back to top button