1.6 KiB
| sidebar_current |
|---|
| cli-box |
Box
Command: vagrant box
This is the command used to manage (add, remove, etc.) boxes.
The main functionality of this command is exposed via even more subcommands:
addlistremoverepackage
Box Add
Command: vagrant box add NAME URL
This adds a box at the given URL to Vagrant and stores it under the
logical name NAME.
The URL may be a file path or an HTTP URL. For HTTP, basic authentication
is supported and http_proxy environmental variables are respected. HTTPS
is also supported.
The name argument of this command is a logical name, meaning you can
effectively choose whatever you want. This is the name that Vagrant searches
for to match with the config.vm.box setting in Vagrantfiles.
Options
--provider PROVIDER- If given, Vagrant will verify the box you're adding is for the given provider. By default, Vagrant automatically detects the proper provider to use.
Box List
Command: vagrant box list
This command lists all the boxes that are installed into Vagrant.
Box Remove
Command: vagrant box remove NAME PROVIDER
This command removes a box from Vagrant that matches the given name and provider.
Box Repackage
Command: vagrant box repackage NAME PROVIDER
This command repackages the given box and puts it in the current directory so you can redistribute it.
When you add a box, Vagrant unpacks it and stores it internally. The
original *.box file is not preserved. This command is useful for
reclaiming a *.box file from an installed Vagrant box.