Move to docs

Seth Vargo 2016-06-20 09:22:41 -04:00
parent 701eb1425a
commit 67524a8ab8
1 changed files with 1 additions and 25 deletions

@ -1,25 +1 @@
## "Official" Boxes
HashiCorp (the makers of Vagrant) publish a basic Ubuntu 12.04 (32 and 64-bit) box that is available for minimal use cases. It is highly optimized, small in size, and includes support for Virtualbox and VMware. You can use it like this:
```shell
$ vagrant init hashicorp/precise64
```
or you can update your `Vagrantfile` as follows:
```ruby
Vagrant.configure("2") do
config.box = "hashicorp/precise64"
end
```
For other users, we recommend the [Bento boxes](https://atlas.hashicorp.com/bento). The Bento boxes are [open source](https://github.com/chef/bento) and build for a number of providers including VMware, Virtualbox, and Parallels. There are a variety of operating systems and versions available.
These are the only two recommended box sets.
**Please note** - it is often a point of confusion, but Canonical (the company that makes the Ubuntu operating system) publishes boxes under the `ubuntu` namespace on Atlas. These boxes only support Virtualbox. We recommend using the Bento boxes instead.
## Community Boxes on Atlas
The best place to find boxes from the user community is via HashiCorp's [Atlas](https://atlas.hashicorp.com/discover). Unless otherwise noted, these boxes are not supported by HashiCorp, so please use them at your own risk. Similar to GitHub, Atlas uses user namespaces for content in the form `<username>/<box>` (e.g. `hashicorp/precise64`). Just like GitHub is unable to support issues on a repository, HashiCorp is unable to provide support for other users' boxes on Atlas.
This page has moved to the [Vagrant official box documentation](https://www.vagrantup.com/docs/boxes.html).