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('https://chocolatey.org/install.ps1'))
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:
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:
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!