Sha256: 9b507d1100dc627c3df65d7ba1a63c9fe17263b1c1f727b7daf9cd86bd7ecb3d

Contents?: true

Size: 1.6 KB

Versions: 19

Compression:

Stored size: 1.6 KB

Contents

# 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

```shell
[sudo] gem install boxes
```

boxes leans on [Packer][] and [VirtualBox][], [VMware Fusion][fusion] or
[VMware Workstation][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:

```shell
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>

[boxes]: http://boxes.io
[Vagrant]: http://vagrantup.com
[Packer]: https://packer.io
[VirtualBox]: https://www.virtualbox.org
[fusion]: https://www.vmware.com/products/fusion/features.html
[workstation]: https://www.vmware.com/products/workstation/features.html

Version data entries

19 entries across 19 versions & 1 rubygems

Version Path
boxes-3.7.0 README.md
boxes-3.6.1 README.md
boxes-3.6.0 README.md
boxes-3.5.0 README.md
boxes-3.4.0 README.md
boxes-3.3.1 README.md
boxes-3.3.0 README.md
boxes-3.2.0 README.md
boxes-3.1.0 README.md
boxes-3.0.0 README.md
boxes-2.5.0 README.md
boxes-2.4.0 README.md
boxes-2.3.0 README.md
boxes-2.2.0 README.md
boxes-2.1.1 README.md
boxes-2.1.0 README.md
boxes-2.0.2 README.md
boxes-2.0.1 README.md
boxes-2.0.0 README.md