Use Docker to build RIOT

Use Docker to build RIOT

Docker is a platform that allows packaging software into containers that can easily be run on any Linux that has Docker installed.

You can use the included Dockerfile (in dist/Dockerfile) to build a RIOT Docker container and then use that to build your project making use of all toolchains that we've preinstalled in the container.

First, install Docker. Probably sudo apt-get install docker (or equivalent) will be all you need. Second, make sure your user can execute Docker containers. You probably have to add yourself to the docker group and relogin.

Then, enter the dist-directory and build the RIOT Docker container:

dist/ # docker build -t riotbuild .

This will take a while. If it finishes correctly, you can then use the toolchains contained in the Docker container: (from the riot root):

# docker run -i -t -u $UID -v $(pwd):/data/riotbuild riotbuild ./dist/tools/compile_test/compile_test.py

The Docker container has it's working directory set to (the container's virtual) /data/riotbuild. If you want to build the default example for the chronos board, try something like this:

# docker run -i -t -u $UID -v /path/to/your/riot/rootdir:/data/riotbuild --env BOARD=chronos riotbuild make -C examples/default clean all