Docker Cookbook

See Also
• Official Docker development environment 
documentation
4.4 Replacing Your Current Docker Binary with a New One
Problem
You have built a new Docker binary and run the unit and integration tests described
in 
Recipe 4.2
and 
Recipe 4.3
. Now you would like to use this new binary on your
host.
Solution
Start from within the virtual machine setup in 
Recipe 4.2
.
Stop the current Docker daemon. On Ubuntu 14.04, edit the 
/etc/default/docker
file to
uncomment the 
DOCKER
variable that defines where to find the binary and set it to
DOCKER="/usr/local/bin/docker"
. Copy the new binary to 
/usr/local/bin/docker
,
and finally, restart the Docker daemon:
112 | Chapter 4: Docker Configuration and Development

---

$ pwd
/tmp/docker
$ sudo service docker stop
docker stop/waiting
$ sudo vi /etc/default/docker
$ sudo cp bundles/1.8.0-dev/binary/docker-8.0-dev /usr/local/bin/docker
$ sudo cp bundles/1.8.0-dev/binary/docker-1.8.0-dev /usr/bin/docker
$ sudo service docker restart
stop: Unknown instance:
$ docker version
Client:
Version: 1.8.0-dev
API version: 1.21
Go version: go1.4.2
Git commit: 3e596da
Built: Tue Aug 11 16:51:56 UTC 2015
OS/Arch: linux/amd64
Server:
Version: 1.8.0-dev
API version: 1.21
Go version: go1.4.2
Git commit: 3e596da
Built: Tue Aug 11 16:51:56 UTC 2015
OS/Arch: linux/amd64
You are now using the latest Docker version from the master development branch
(i.e., master branch at Git commit 3e596da at the time of this writing).
Discussion
The Docker bootstrap script used in the Vagrant virtual machine provisioning installs
the latest stable version of Docker with the following:
sudo curl -sSL https://get.docker.com/ubuntu/ | sudo sh
This puts the Docker binary in 
/usr/bin/docker
. This may conflict with your new
binary installation. Either remove it or replace it with the new one if you see any con‐
flicts when running 
docker version
.