» Distributing Boxes
To distribute the box to your team, update your Vagrantfile to reference the box on Vagrant Cloud.
Vagrant.configure(2) do |config| config.vm.box = "username/example-box" end
Now when a team member runs
vagrant up, the box will be downloaded from Vagrant Cloud.
If the box is private, the team member will be prompted to authorize access. Users
are granted access to private resources by logging in with a Vagrant Cloud username and
password or by using a shared Vagrant Cloud token.
Learn more about authorization options here.
» Private Boxes
If you create a private box, only you (the owner) and collaborators will be able to access it. This is valuable if you have information, data or provisioning in your box that cannot be public.
Private boxes will be excluded from the box catalog.
Collaborators can be both teams in organizations or individual users.
To add a collaborator:
- Go to the "Access" page of a box via the sidebar
- Enter the username or team name and submit the form
- You'll now see the user or team in the list of collaborators, and if necessary a collaborator can be removed
» Vagrant Login
In order to access these private boxes from Vagrant, you'll need to first authenticate with your Vagrant Cloud account.
- Enter your credentials
You should now be logged in. We use these credentials to request a unique authentication token that is stored locally by Vagrant. Your username or password is never stored on your machine.
» 404 Not Found
If you don't authenticate, you will likely receive a
404 Not Found
error in Vagrant. We return a 404 for security reasons, so a potential
attacker could not verify if a private box exists.