Installing Docker

Percy Liang edited this page Dec 24, 2015 · 3 revisions

Every execution on CodaLab (should ideally) happen in a docker container, which provides a standardized Linux environment that is lighter-weight than a full virtual machine.

The current official docker image is codalab/ubuntu, which consists of Ubuntu 14.04 plus some standard packages. See the CodaLab docker registery.

Installing on Ubuntu Linux 14.04

To install docker on your local machine (either if you want see what's actually in the environment or to run your own local CodaLab instance), follow these instructions:

sudo apt-key adv --keyserver hkp:// --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
sudo sh -c "echo deb ubuntu-trusty main > /etc/apt/sources.list.d/docker.list"
sudo apt-get update
sudo apt-get install docker-engine
sudo useradd $USER docker

If you are upgrading docker, then you might need to remove devicemapper by doing this.

To start docker:

sudo service docker start

Then, to test out your environment, open a shell (the first time you do this, it will take some time to download the image):

docker run -ti ubuntu bash

Installing on OS X / Windows

Because Windows and OS X don't support LXC natively, you need to actually install Docker in a VM that you access from your machine. Thankfully, Docker has already packaged a solution for this that they release whenever they have a version bump of docker: Docker Toolbox (click for download page). After selecting the download for your OS, go through and follow the setup instructions for your platform:

OS X Environment Settings

The docker-machine binary is used to control the VM running Docker. By default, there is a VM named "default" that you can start and stop when you would like to use Docker.

Starting Docker

To start the VM and allow you to use Docker:

> docker-machine start default
> eval $(docker-machine env default)