Discovering Vagrant Boxes
Atlas serves a public, searchable index of Vagrant boxes. It's easy to find boxes you can use with Vagrant that contain the technologies you need for a Vagrant environment.
You don't need an Atlas account to use public boxes.
Go to the Box search page
Once you find a box, click its name to learn more about it.
When you're ready to use it, copy the name, such as "hashicorp/precise64" and initialize your Vagrant project with
vagrant init hashicorp/precise64. Or, if you already have a Vagrant project created, modify the Vagrantfile to use the box:
config.vm.box = "hashicorp/precise64"
Not all boxes are available for all providers. You may need to sort by a provider that you have on your local system to narrow down your search.
Choosing the Right Box
As with all software and configuration used from a public source, it's important to keep in mind whose box you're using. Here are some things to note when you're choosing a box:
- The username of the user. If it's
canonical, you can likely trust the box more than an anonymous user
- The number of downloads of the box. Heavily downloaded boxes are likely vetted more often by other members of the community. Hashicorp responds to reports of malicious software distributed via Atlas and takes down boxes
- The latest release date. More up-to-date boxes contain up-to-date software
- Availability of the box download. Atlas periodically checks if box has is publicly accessible. You can see this information on the box page next to the provider