Skip to content
This repository has been archived by the owner on Sep 27, 2021. It is now read-only.
/ boxes Public archive

A command line tool that takes the complexity out of building Vagrant boxes.


Notifications You must be signed in to change notification settings


Repository files navigation


boxes takes the complexity out of building custom Vagrant boxes.

It's a command line tool which provides a set of templates and scripts to combine as you need. There are also a set of pre-build boxes which are regenerated regularly.

Installation & Requirements

[sudo] gem install boxes

boxes leans on Packer and VirtualBox, VMware Fusion or VMware Workstation for building boxes and these will need to available in your $PATH.


boxes is driven by the boxes command line tool, and works with artifacts inside it's own working directory. You need to specify a name for the build, a template to work with and the output provider. Something like so:

boxes build --name=trusty64-empty --template=ubuntu/trusty64 --provider=vmware

This will build a file called in the current directory.

There's lots more to boxes than building simple empty Vagrant boxes like this, which can be see in the inline help.


  1. Fork it ( )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request


Copyright (c) 2013 Nick Charlton