A command line tool that takes the complexity out of building Vagrant boxes.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin Implements the basic command structure and binary. Aug 14, 2015
lib Bumps the version to 3.2.1. May 6, 2018
scripts Ubuntu Bionic (18.04) support. (#56) May 10, 2018
spec Improve the default help. (#49) Feb 5, 2018
templates Ubuntu Bionic (18.04) support. (#56) May 10, 2018
.gitignore Adds the basics of a Gem spec. Aug 14, 2015
.hound.yml Specify a Hound config. Nov 6, 2017
.rubocop.yml Add a rubocop.yml for Hound. (#37) Nov 6, 2017
.ruby-version Upgrade Ruby to 2.4.2. Oct 21, 2017
.travis.yml Prefer .ruby-version for current Ruby. (#36) Nov 6, 2017
CHANGELOG.md Bumps the version to 3.2.1. May 6, 2018
Gemfile Adds the basics of a Gem spec. Aug 14, 2015
LICENSE Initial commit; adds the README and LICENSE. Aug 3, 2013
README.md Rewrites the README. Oct 10, 2015
Rakefile Acceptance test for version, w/custom matchers. (#43) Dec 21, 2017
boxes.gemspec

README.md

boxes

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.

Usage

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 trusty64-empty.box 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.

Contributing

  1. Fork it ( https://github.com/nickcharlton/boxes/fork )
  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

Author

Copyright (c) 2013 Nick Charlton nick@nickcharlton.net