Docker Cookbook

1.7 Using Boot2Docker to Get a Docker Host on OS X | 11

---

Figure 1-4. boot2docker VirtualBox VM
You do not need to have the VirtualBox UI open; the snapshots are
here only for illustration. Boot2Docker uses the VBoxManage
commands to manage the boot2docker VM in the background.
You are now ready to start Boot2Docker. This will run the VM and return some
instructions to set environment variables for properly connecting to the Docker dae‐
mon running in the VM:
12 | Chapter 1: Getting Started with Docker

---

$ boot2docker start
Waiting for VM and Docker daemon to start...
.........................ooooooooooooooooooooo
Started.
Writing /Users/sebgoa/.boot2docker/certs/boot2docker-vm/ca.pem
Writing /Users/sebgoa/.boot2docker/certs/boot2docker-vm/cert.pem
Writing /Users/sebgoa/.boot2docker/certs/boot2docker-vm/key.pem
To connect the Docker client to the Docker daemon, please set:
export DOCKER_CERT_PATH=/Users/sebgoa/.boot2docker/certs/boot2docker-vm
export DOCKER_TLS_VERIFY=1
export DOCKER_HOST=tcp://192.168.59.103:2376
Although you can set the environment variables by hand, Boot2Docker provides a
handy command: 
shellinit
. Use it to configure the Transport Layer Security (TLS)
connection to the Docker daemon, and you will have access to the Docker host from
your local OS X machine:
$ $(boot2docker shellinit)
Writing /Users/sebgoa/.boot2docker/certs/boot2docker-vm/ca.pem
Writing /Users/sebgoa/.boot2docker/certs/boot2docker-vm/cert.pem
Writing /Users/sebgoa/.boot2docker/certs/boot2docker-vm/key.pem
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
Discussion
When a new version of Boot2Docker is available, you can upgrade easily by down‐
loading the new Boot2Docker installer and downloading a new ISO image with the
download
command.
Make sure that you stop the current boot2docker VM with
$ boot2docker stop
before running the installer script:
$ boot2docker stop
$ boot2docker upgrade
$ boot2docker start