To distribute the box to your team, update your Vagrantfile to reference the box on Atlas.
Vagrant.configure(2) do |config| config.vm.box = "ATLAS_USERNAME_HERE/example-box" end
Now when a team member runs
vagrant up, the box will be downloaded from Atlas.
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 an Atlas username and
password or by using a shared Atlas token.
Learn more about authorization options here.
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 an the user or team in the list of collaborators, and if necessary a collaborator can be removed
In order to access these private boxes from Vagrant, you'll need to first authenticate with your Atlas account.
vagrant login(with the latest version of Vagrant)
- 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.