Need help with boot2docker-vagrant-box?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

427 Stars 199 Forks 78 Commits 12 Opened issues


Packer scripts to build a Vagrant-compatible boot2docker box.

Services available


Need anything else?

Contributors list

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.


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: (you'll need to export

). You should then be able to to run
docker version
from the host.

Vagrant Up Boot2Docker

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:

Then follow the steps:

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

You can restrict only VirtualBox, VMware, or Parallels by specifying the

flag to Packer.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.