boot2docker Vagrant Box

This repository contains the scripts necessary to create a Vagrant-compatible boot2docker box. If you work solely with Docker, this box lets you keep your Vagrant workflow and work in the most minimal Docker environment possible.

Usage

The box is available on Vagrant Cloud, making it very easy to use it:

$ vagrant init mitchellh/boot2docker
$ vagrant up

If you want the actual box file, you can download it from the releases page.

On OS X, to use the docker client, follow the directions here: http://docs.docker.io/installation/mac/#docker-os-x-client (you'll need to export DOCKER_HOST). You should then be able to to run docker version from the host.

Building the Box

If you want to recreate the box, rather than using the binary, then you can use the scripts and Packer template within this repository to do so in seconds.

To build the box, first install the following prerequisites:

• Packer (at least version 0.5.1)
• VirtualBox (at least version 4.3), VMware, or Parallels
• Vagrant

Then follow the steps:

$ vagrant up
...
$ vagrant ssh -c 'cd /vagrant && sudo ./build-iso.sh'
...
$ vagrant destroy --force
...
$ packer build template.json
...

Additional docker arguments, such as adding an insecure repository, can be done by setting the EXTRA_ARGS environment variable when running build-iso.sh.

You can restrict only VirtualBox, VMware, or Parallels by specifying the -only flag to Packer.