Every run bundle is created by executing a command in a Docker container, which provides a standardized Linux environment that is lighter-weight than a full virtual machine.

You need to install Docker if you intend to execute CodaLab runs yourself. There are two use cases:

1. You have set up your own CodaLab server.
2. You want to run your own worker that connects to the main CodaLab server (worksheets.codalab.org).

Installing on Ubuntu Linux 14.04

Follow these instructions:

sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
sudo sh -c "echo deb https://apt.dockerproject.org/repo ubuntu-trusty main > /etc/apt/sources.list.d/docker.list"
sudo apt-get update
sudo apt-get install docker-engine
sudo usermod -a -G docker $USER

Note that after adding yourself to the docker group you need to log out and log back in for the setting to take effect.

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

To start Docker:

sudo service docker start

To test that everything is working, type:

docker run --rm codalab/ubuntu:1.9 cat /etc/issue

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:

• Mac OS X. Also see the OS X Environment Settings section below.
• Windows

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.

To start the VM:

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