2017-05-19 15:01:01 +00:00
|
|
|
---
|
|
|
|
layout: "docs"
|
|
|
|
page_title: "Discovering Vagrant Boxes"
|
|
|
|
sidebar_current: "vagrant-cloud-boxes-catalog"
|
|
|
|
---
|
|
|
|
|
|
|
|
# Discovering Vagrant Boxes
|
|
|
|
|
2017-07-31 23:33:18 +00:00
|
|
|
Vagrant Cloud serves a public, searchable index of Vagrant boxes. It's easy to find
|
2017-05-19 15:01:01 +00:00
|
|
|
boxes you can use with Vagrant that contain the technologies you need
|
|
|
|
for a Vagrant environment.
|
|
|
|
|
2017-07-31 23:33:18 +00:00
|
|
|
You don't need a Vagrant Cloud account to use public boxes.
|
2017-05-19 15:01:01 +00:00
|
|
|
|
|
|
|
1. Go to the [Box search page](https://vagrantcloud.com/boxes/search)
|
|
|
|
|
|
|
|
1. Once you find a box, click its name to learn more about it.
|
|
|
|
|
|
|
|
1. 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
|
2017-07-31 23:33:18 +00:00
|
|
|
responds to reports of malicious software distributed via Vagrant Cloud
|
2017-05-19 15:01:01 +00:00
|
|
|
and takes down boxes
|
|
|
|
- __The latest release date__. More up-to-date boxes contain up-to-date
|
|
|
|
software
|
2017-07-31 23:33:18 +00:00
|
|
|
- __Availability of the box download__. Vagrant Cloud periodically checks if box
|
2017-05-19 15:01:01 +00:00
|
|
|
has is publicly accessible. You can see this information on the box
|
|
|
|
page next to the provider
|