"Docker is an open-source project that automates the deployment of applications inside software containers".
Lately the Docker project has grown to include many different projects, but the core is still the docker server and client. The client and server is contained in the same binary and written in Go (golang). This is the binary we'll compile from source.
Docker is pretty easy to install from binaries. They release pre-compiled binaries, an install script and many linux distros have packages ready to install.
So why would you want to build it from source? Well, I personally have two reasons: 1) I'm currently tinkering with Docker Plugins, a feature under development, and even the experimental build is lagging behind the latest developments. 2) Being able to modify the source and run the result can be very helpful when trying to understand how Docker works.
It turns out there are basically two ways of building docker from source: The hard way and the easy way. The hard way is to install all the dependencies and build everything from scratch. Although this is not that hard, docker has more dependencies than expected. The easy way is to use their build scripts to automate everything. This saves you all the trouble of finding and installing the right dependencies. The scripts builds and runs a docker image to compile the binary. So you need to have docker installed already to build docker in this way, which is the drawback.
Being lazy, I'm going to go with the easy way, but if you want to this the hard way (without using docker) this Dockerfile is a good starting point. From that you can extract all the dependencies and steps necessary.
The easy way is roughly:
- Install docker
- Get the docker source
- Run the included scripts to create the docker image and compile everything
- Test the binaries
- Copy the binaries to wherever you want to have them.
If you don't have docker already, install it. You can find instructions on docs.docker.com.
For ubuntu this is basically:
Get the docker source
This should be as easy as fetching the code from Github. Install git if you don't have it already and run:
Compile docker in a docker container
The Dockerfile and supporting scripts make it pretty easy to compile a new docker from source, they do all the heavy lifting for you. This works by first building a new docker image from the Dockerfile, running this image and compiling a new docker binary. Since it's building a new docker image, the docker server (docker -d) must be running. Hence the need for installing docker first. This docker image then has all the dependencies necessary to build docker from source. The docker binary is build inside this container and copied out afterwards. Ideally the included Makefile and scrips do all of this for us, and produce a binary ready to use:
Test the new binary
Stop the old docker daemon
Stop the docker daemon so w can run our new one. On Ubuntu / debian this is: On other systems it might be.. something else. You can try "killall docker" or "pkill docker"
Start a daemon using our new binary
Start a daemon with the new binary:
Run the old binary as a client and connect to our new daemon
With the docker server (docker -d) still running, open a new console / terminal and run: docker version. This will use the original docker as a client and it should be able to contact our new docker binary. You should see the difference in server version and client version, like so: As you can see "Client version" and "Server version" are different. This is expected since the server is the new binary we just started as a daemon (./bundles...docker -d). The client, however, is the docker installed on the system. Run "which docker" to see where this binary is located.
Run the new binary as a client and connect to our new daemon
You can test the new binary as a client as well: As you can see the Client and Server version is now the same. Both the server and client is running the same binary file; the one we just built. Also, it looks like the output of docker version changed between version 1.6 and 1.8.
Last test: Run a docker container
A basic test that everything works is to run the official hello-world image using our new binary. Make sure the server is still running and run:
Installing our new binary system-wide
As far as I know, installing the new binary is as simple as copying it into place, overwriting the old one. (I'm sure there's cases where this is not enough, or could break things, so, you know.. )
Questions? Comments? Found something wrong or confusing?
Hit me up on twitter or hello @ this domain