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.

  1. Go to the Box search page

  2. Once you find a box, click its name to learn more about it.

  3. 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"

Provider Support

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 bento or 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