vagrant/website/docs/source/v2/boxes.html.md

49 lines
1.7 KiB
Markdown
Raw Normal View History

---
page_title: "Boxes"
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.
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.
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.
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.
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.
2014-01-25 20:18:41 +00:00
## Discovering Boxes
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.
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.
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:
```
2014-01-25 20:18:41 +00:00
$ vagrant box add USER/BOX
...
```
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`.