Getting openshift origin “cluster up” working with xhyve

In latest openshift client (oc) there is a nifty (relatively) new feature to get you a OpenShift cluster starting (very) quickly. It’s a pretty nice way to get you a new openshift origin environment on your laptop  without the hassle.

On macosx there is a (as well relatively) new lightweight virtualization solution called xhyve it’s a bit like KVM in the sense of being lightweight and does not need like virtualbox or vmware to get a UI running. It seemed to be a perfect fit to try those two together.

xhyve docker machine driver needed to be installed first so I just went on its website here :

and followed the installation instruction from the README which I could see everything was working :


I then fired up the “oc cluster up –create-machine” command and to my disappointment it was starting by default the virtualbox and I could not see anything in the options how to specify the “–driver xhyve” option to docker-machine which is what the oc cluster feature is using on the backend to bootstrap a docker environment.

Digging into the code it seems that the oc cluster has those feature set in static as virtualbox :

since there was no way to pass other options I first looked in the github issues to see if there was nothing reported about it and sent a feature request here,

I started to think a little bit more about a workaround going from modifying to my liking and recompiling the oc client or to just give up on xhyve but in fact the solution is actually much simplier.

Since there is the ability to specify to “oc cluster up” an already configured docker-machine environment with the ” –docker-machine” option. We just had to configured previously properly first (which is with the option –engine-insecure-registry :


and after a bit the new docker should be setup which can be easily used with the command eval $(docker-machine env xhyve)

I then just have to start my oc cluster up with the option  –docker-machine=”xhyve” and I would get my nicely setuped openshift origin cluster to play with in mere seconds :


Share on FacebookTweet about this on TwitterShare on Google+Print this pageEmail this to someone
  • grahamd

    When using xhyve driver, have you found a way to have local volume mounts work under OpenShift?

    I have tried a couple of different xhyve drivers available and they fail to mount volumes. Looks like only option is to use NFS volumes. As a result, using docker-machine is useless if need local volumes (that is, don’t want to play with NFS), as volumes don’t always work under virtualbox either.

    I thus still recommend use of the default Docker instance when using Docker for Mac and avoid docker-machine.

    BTW, this isn’t an issue with OpenShift, but with Docker, or the docker-machine drivers, as I understand it.

    • yes you right that seems to still not be working, I haven’t found a workaround for this yet. I wonder if we can update docker-machine easily to handle nfs volumes,

      • grahamd

        The xhyve driver has an option –xhyve-experimental-nfs-share but there is very little information on it and how to use it. With it also being marked experimental, not brave enough to try it.