All-in-One Vagrant Image for OpenShift Origin V3

Announcing our All-In-One OpenShift VM

sporks, handy like an OpenShift VM
Sporks, handy like an OpenShift VM

Greetings Shifters (and those who love them)! Today I am happy to announce the “delivery” of something we have been working with the OpenShift Engineers for a little while now. We now have an “all-in-one” Vagrant image of OpenShift V3!

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.

Purpose of this image

You can use this image if you want to do local application development and testing. It was originally built to use for our Summit workshops but there has been a lot of interest in it’s use. As long as you pre-cache the Docker images, you can even use this image without a connection to the intertubes.

This image may also be of use to sysadmins who just want to get a feel for a very simplistic setup. Again, the OpenShift Master, Node, Docker Registry, and other pieces are running in one VM. Given it’s focus on application developers, it should NOT be used in production.


We wanted to allow developers to use any Docker image they want, which required us turning off some security in OpenShift. By default, OpenShift will not allow a container to run as root or even a non-random platform 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.

To run the image, you need a recent version of VirtualBox (a FOSS virtualization solution that runs on all the major platforms) and Vagrant (I test with VirtualBox 4.3.30 and Vagrant 1.7.2). The Vagrant Box image is about 2.5 Gigs. We have also included links to the command line binaries for Windows, Mac, and Linux. You just need to unzip the binaries and put them somewhere you can use them.

The best way to get started is to download all the pieces and then read the document which contains set-up instructions and a set of exercises to familiarize you with the developer experience on OpenShift V3.

Where to get it the OpenShift VM

UPDATE March 14th 2016 [

The box file is now only 2.5 gigs and doesn’t include all the cached images anymore.

We also no longer recommend downloading pieces individually. The preferred installation method is covered on

Finally, the getting started document is out of date so it no longer is directly applicable.


So download it and give it a try. I would love to get your feedback on the usability of the image, your experience with OpenShift V3 as an application developer, and anything else you feel like sharing. Happy application building and welcome to the platform for the future!

News, OpenShift Origin
, , , , ,

12 Responses to “All-in-One Vagrant Image for OpenShift Origin V3”

  1. GregSwift

    I realize that this could easily get classified as ‘never making anyone happy’ but it would be nice if there was a Vagrant libvirt image too. I appreciate the cross platform capabilities of VirtualBox and the wide audience it targets, but I also appreciate that I’ve bought into the platform pushed by RH (kvm).

    • Rafael Soares

      Hi GregSwift !

      I managed to convert this box to vagrant-libvirt provider using the vagrant-mutate plugin.

      After converting the box you have to hack some pieces on original Vagrantfile:

      In my case Vagrant client can’t authenticate through ssh. So I had to:

      start the VM (vagrant up — provider libvirt)
      connect manually using ssh (vagrant/vagrant)

      Download the Vagrant original insecure ssh pub key

      wget –no-check-certificate -O /home/vagrant/.ssh/authorized_keys
      chmod 0700 /home/vagrant/.ssh
      chmod 0600 /home/vagrant/.ssh/authorized_keys

      Halt the vm.
      And finally change your Vagrantfile


      Vagrant up –provider libvirt

  2. tolleiv

    This is really great – thank’s for sharing.

  3. Anil G

    Any plans on releasing OSE 3.1 Origin? We want to try EFK stack on it.

    • Steven Pousty

      Anil, OSE is a product based off of Origin. The current version of the All-In-One is

  4. Manfred Nilsson

    Hi I am having some problems trying this out … seams that there are issues with ‘docker storage system’ .. any one got any good advice ?

    • Steven Pousty

      Manfred – we will need more details than that. Please let us know what host os you are using and more detailed error messages.

  5. jmandawg

    Just tried the latest vm, and besides ssh, ports are not forwarding.

    Bringing machine ‘default’ up with ‘virtualbox’ provider…

    ==> default: Importing base box ‘thesteve0/openshift-origin’…

    ==> default: Matching MAC address for NAT networking…

    ==> default: Checking if box ‘thesteve0/openshift-origin’ is up to date…

    ==> default: Setting the name of the VM: openshift-origin

    ==> default: Clearing any previously set network interfaces…

    ==> default: Preparing network interfaces based on configuration…

    default: Adapter 1: nat

    default: Adapter 2: hostonly

    ==> default: Forwarding ports…

    default: 22 (guest) => 2222 (host) (adapter 1)

    ==> default: Running ‘pre-boot’ VM customizations…

    ==> default: Booting VM…

    ==> default: Waiting for machine to boot. This may take a few minutes…

  6. Akshay Baheti

    I am trying to install openshift Origin using the All-in-One Virtual machine. But somehow my vagrant fails on unpacking the box.

    ==> default: Adding box ‘’ (v0) for provider: virtualbox default: Unpacking necessary files from: file:///Users/akshay/vagrant/

    The box failed to unpackage properly. Please verify that the box
    file you’re trying to add is not corrupted and try again. The
    output from attempting to unpackage (if any):

    x ./Vagrantfile: Cannot restore extended attributes on this system
    x ./box.ovf
    x ./include/
    x ./include/_Vagrantfile
    x ./box-disk1.vmdk
    bsdtar: Error exit delayed from previous errors.

  7. Neil Piper

    Hi – I’m trying to run through the O’Reilly book ‘Openshift for Developers’ . In the last few days the Openshift Origin VM link has now changed to ‘minishift’ install & the examples in the book aren’t as workable. An example is the wildfly & other quick start templates are not installed – is it possible to maintain the original vagrant option as a set of documentation so this book can still be used?

    • Steven Pousty

      Still available in Vagrant and that page has links to the old instructions. Search in Atlas on HashiCorp for OpenShift and you should find it.

  8. Manuel Silva


Comments are closed.