2013-09-03 18:08:28 +00:00
|
|
|
---
|
2013-09-06 16:50:43 +00:00
|
|
|
page_title: "Boxes"
|
2013-09-03 18:08:28 +00:00
|
|
|
sidebar_current: "boxes"
|
|
|
|
---
|
|
|
|
|
|
|
|
# Boxes
|
|
|
|
|
2014-01-25 20:18:41 +00:00
|
|
|
Boxes are the package format for Vagrant environments. A box can be used by
|
|
|
|
anyone on any platform that Vagrant supports to bring up an identical
|
|
|
|
working environment.
|
2013-09-03 18:08:28 +00:00
|
|
|
|
|
|
|
The `vagrant box` utility provides all the functionality for managing
|
2014-01-25 20:18:41 +00:00
|
|
|
boxes. You can read the documentation on the [vagrant box](/v2/cli/box.html)
|
|
|
|
command for more information.
|
2013-09-03 18:08:28 +00:00
|
|
|
|
2014-01-25 20:18:41 +00:00
|
|
|
The easiest way to use a box is to add a box from the
|
2014-12-09 01:42:29 +00:00
|
|
|
[publicly available catalog of Vagrant boxes](https://atlas.hashicorp.com).
|
2014-01-25 20:18:41 +00:00
|
|
|
You can also add and share your own customized boxes on this website.
|
2013-09-03 18:08:28 +00:00
|
|
|
|
2014-01-25 20:18:41 +00:00
|
|
|
Boxes also support versioning so that members of your team using Vagrant
|
|
|
|
can update the underlying box easily, and the people who create boxes
|
|
|
|
can push fixes and communicate these fixes efficiently.
|
2013-09-03 18:08:28 +00:00
|
|
|
|
2014-01-25 20:18:41 +00:00
|
|
|
You can learn all about boxes by reading this page as well as the
|
|
|
|
sub-pages in the navigation to the left.
|
2013-09-03 18:08:28 +00:00
|
|
|
|
2014-01-25 20:18:41 +00:00
|
|
|
## Discovering Boxes
|
2013-09-03 18:08:28 +00:00
|
|
|
|
2014-01-25 20:18:41 +00:00
|
|
|
The easiest way to find boxes is to look on the
|
2014-12-09 01:42:29 +00:00
|
|
|
[public Vagrant box catalog](https://atlas.hashicorp.com)
|
2014-01-25 20:18:41 +00:00
|
|
|
for a box matching your use case. The catalog contains most major operating
|
|
|
|
systems as bases, as well as specialized boxes to get you up and running
|
|
|
|
quickly with LAMP stacks, Ruby, Python, etc.
|
2013-09-03 18:08:28 +00:00
|
|
|
|
2014-01-25 20:18:41 +00:00
|
|
|
The boxes on the public catalog work with many different
|
|
|
|
[providers](/v2/providers/index.html). Whether you're using Vagrant with
|
|
|
|
VirtualBox, VMware, AWS, etc. you should be able to find a box you need.
|
2013-09-03 18:08:28 +00:00
|
|
|
|
2014-01-25 20:18:41 +00:00
|
|
|
Adding a box from the catalog is very easy. Each box shows you instructions
|
|
|
|
with how to add it, but they all follow the same format:
|
2013-09-03 18:08:28 +00:00
|
|
|
|
|
|
|
```
|
2014-01-25 20:18:41 +00:00
|
|
|
$ vagrant box add USER/BOX
|
|
|
|
...
|
2013-09-03 18:08:28 +00:00
|
|
|
```
|
|
|
|
|
2014-01-25 20:18:41 +00:00
|
|
|
For example: `vagrant box add hashicorp/precise64`. You can also quickly
|
|
|
|
initialize a Vagrant environment with `vagrant init hashicorp/precise64`.
|