diff --git a/Available-Vagrant-Boxes.md b/Available-Vagrant-Boxes.md index 64306a2..9b3568f 100644 --- a/Available-Vagrant-Boxes.md +++ b/Available-Vagrant-Boxes.md @@ -1,30 +1,25 @@ -## Official Boxes +## "Official" Boxes -Note: to understand the different Ubuntu version names, check out [Ubuntu's official releases page](http://releases.ubuntu.com/). +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: -### Ubuntu Lucid 32 Bit +```shell +vagrant init hashicorp/precise64 +``` -[http://files.vagrantup.com/lucid32.box](http://files.vagrantup.com/lucid32.box) +or you can update your `Vagrantfile` as follows: -### Ubuntu Lucid 64 Bit +```ruby +Vagrant.configure("2") do + config.box = "hashicorp/precise64" +end +``` -[http://files.vagrantup.com/lucid64.box](http://files.vagrantup.com/lucid64.box) +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. -### Ubuntu Precise 32 Bit +**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. -[http://files.vagrantup.com/precise32.box](http://files.vagrantup.com/precise32.box) +## Community Boxes on Atlas -### Ubuntu Precise 64 Bit - -[http://files.vagrantup.com/precise64.box](http://files.vagrantup.com/precise64.box) (VirtualBox) - -[http://files.vagrantup.com/precise64_vmware_fusion.box](http://files.vagrantup.com/precise64_vmware_fusion.box) (VMware Fusion) - -## User Community Boxes - -The best place to find boxes from the user community is at [http://vagrantbox.es](http://vagrantbox.es). These boxes have not been verified by the vagrant project, so please use them at your own risk. Files may change after the pull requests have been merged in, so please only download from URLs you trust enough to use for your project. If you're concerned about using a contributed box, you may be able to find build scripts for a particular distribution on GitHub, which you can verify by reading the source, and then [use to build your own box](http://docs.vagrantup.com/v2/boxes.html). - -## Ubuntu Cloud Images - -Ubuntu, now, actively builds Vagrant boxes for several of its releases. You can find the URL for the various releases by navigating the directory tree @ [cloud-images.ubuntu.com/vagrant/](http://cloud-images.ubuntu.com/vagrant/). \ No newline at end of file +The best place to find boxes from the user community is via HashiCorp's [https://atlas.hashicorp.com/discover](Atlas). 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 `/` (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. \ No newline at end of file