W3cubDocs

/Vagrant

Init

Command: vagrant init [name [url]]

This initializes the current directory to be a Vagrant environment by creating an initial Vagrantfile if one does not already exist.

If a first argument is given, it will prepopulate the config.vm.box setting in the created Vagrantfile.

If a second argument is given, it will prepopulate the config.vm.box_url setting in the created Vagrantfile.

Options

  • --box-version - (Optional) The box version or box version constraint to add to the Vagrantfile.

  • --force - If specified, this command will overwite any existing Vagrantfile.

  • --minimal - If specified, a minimal Vagrantfile will be created. This Vagrantfile does not contain the instructional comments that the normal Vagrantfile contains.

  • --output FILE - This will output the Vagrantfile to the given file. If this is "-", the Vagrantfile will be sent to stdout.

Examples

Create a base Vagrantfile:

$ vagrant init hashicorp/precise64

Create a minimal Vagrantfile (no comments or helpers):

$ vagrant init -m hashicorp/precise64

Create a new Vagrantfile, overwriting the one at the current path:

$ vagrant init -f hashicorp/precise64

Create a Vagrantfile with the specific box, from the specific box URL:

$ vagrant init my-company-box https://boxes.company.com/my-company.box

Create a Vagrantfile, locking the box to a version constraint:

$ vagrant init --box-version '> 0.1.5' hashcorp/precise64

© 2010–2017 Mitchell Hashimoto
Licensed under the MPL 2.0 License.
https://www.vagrantup.com/docs/cli/init.html