Welcome to the instructions for running OpenShift Origin , the FOSS PaaS from Red Hat, in a local VM on your machine. On this page you will find instructions on how to use Minishift for local application development with OpenShift.
This image is based off of OpenShift Origin and is a fully functioning OpenShift instance with an integrated Docker registry. The intent of this project is to allow Web developers and other interested parties to run OpenShift V3 on their own computer. Given the way it is configured, the VM will appear to your local machine as if it was running somewhere off the machine.
Please follow the instructions for installing Minishift. Be aware that Minishift is currently in Beta and will be changing rapidly. The Minishift maintainers also appreciate GitHub Issues when you find problems.
We, the OpenShift Evangelists, also have some suggestions that we have found helpful:
minishift deleteWe recommend the first time you run Minishift, you pass in the memory and CPUs you want to give to the VM. For example
minishift start --memory 12048 --cpus 3starts a VM with ~12 gigs of RAM and 3 vCPUs. The full list of flags are described here
minishift.exe start --vm-driver virtualbox
The old Vagrant based all in one has been retired and is no longer supported. Due to instability in Vagrant builds it became impossible to maintain and troubleshoot the all in one. The old versions are still on Atlas, with instructions here, but are not supported.
This VM is intended for local development on top of OpenShift. It is not intended to be used in production. There is no official support for this image, support is community based and best effort (but we care a lot about you and your happiness).
If you need a supported VM version running on Red Hat Enterprise Linux with OpenShift Container Platform, please use the Container Development Kit (CDK).
WARNING: To allow developers to use any Docker image they want, turning off some security in OpenShift is required. By default, OpenShift will not allow a container to run as root or even a non-random container assigned userid. Most Docker images in the Dockerhub do not follow this best practice and instead run as root. As a double negative, a large majority of Dockerhub images are not patched for well known vulnerabilities. Therefore, please use images from Dockerhub with caution. We think some of the risk is mitigated because you are running OpenShift in a VM, but still - be careful which Docker images you run.