Hi, I’m Sidhartha Mani, one of the engineers at Rancher, and I wanted to provide a quick overview for how to get started using RancherOS. RancherOS is a micro-linux distribution that has the aim of providing just the right amount of OS to run Docker. It turns out, all Docker really requires to function is the kernel. RancherOS embraces this by running Docker as PID1 and everything running inside of it is a container. At about 22MB, the OS is easy to distribute, orchestrate and spin up in your data center. You can learn more about RancherOS on our website.
In this blog, I will walk through spinning up RancherOS on virtualbox using Docker machine. This is the easiest way to get RancherOS up and running.
- VirtualBox in your path. Download and install from VirtualBox Downloads page
- Docker Machine. The machine version should be atleast v0.3.0. Download it from the docker machine releases page
- Fetch the latest RancherOS ISO URL for machine from the RancherOS
releases page. At the
time of writing this article, the latest release is
might notice that there are two
machine-rancheros.isois the file you want. This ISO has been built with special configuration for setup with docker-machine. Copy the link to
Go to your console, and use this command
docker-machine create -d virtualbox --virtualbox-boot2docker-url $RANCHEROS-ISO-URL $MACHINE-NAME
Note that, For the v0.3.3 release of RancherOS, the value for
MACHINE-NAMEis the name that you would like to call your machine.
That’s it. You have a RancherOS host running on virtualbox now. You can
verify that you have a VirtualBox VM running on your host using this
VBoxManage list runningvms | grep $MACHINE-NAME It should
print out the newly crated machine. If not, something went wrong with
the provisioning step.
Logging into RancherOS
Logging into RancherOS follows the standard docker-machine way. Use this
command to login into your newly provisioned RancherOS VM.
docker-machine ssh $MACHINE-NAME This will log you into the RancherOS
VM. You’ll then be able to explore the OS, run commands, spin up
containers etc. Once you’ve finished exploring, exit by pressing
Spinning up containers on RancherOS
You can point the docker client on your host to the docker daemon
running inside of the VM. That way, you can run your docker commands
like you had installed docker on your host. To point your docker client
to the daemon inside the VM, use this command
eval $(docker-machine env $MACHINE-NAME) You can run any docker
commmand like you would normally, and it will execute your command in
the RancherOS VM.
Congrats! Now let’s run some applications remotely using docker
docker run -p 80:80 -p 443:443 -d nginx This will startup nginx on
your VM. In order to access it, you need the ip address of the VM.
docker-machine ip $MACHINE-NAME If you copy the IP address printed
from the above command and paste it in your browser, you should see a
Welcome Page for nginx!
The above information should help you get started with RancherOS.
- If you have any questions, please post them on our forums.
- If you want to hack on RancherOS, then visit our github page.
- The Documentation for RancherOS is available in the docs page.
If you’re interested in learning more about RancherOS, or our management and infrastructure platform Rancher, please join us for one of our upcoming online meetups. Sidhartha Mani is an engineer at Rancher Labs, you can follow him on Twitterand Github.