2013-09-03 18:08:28 +00:00
|
|
|
---
|
2013-09-06 16:50:43 +00:00
|
|
|
page_title: "vagrant up - Command-Line Interface"
|
2013-09-03 18:08:28 +00:00
|
|
|
sidebar_current: "cli-up"
|
|
|
|
---
|
|
|
|
|
|
|
|
# Up
|
|
|
|
|
|
|
|
**Command: `vagrant up`**
|
|
|
|
|
|
|
|
This command creates and configures guest machines according to your
|
|
|
|
[Vagrantfile](/v2/vagrantfile/index.html).
|
|
|
|
|
|
|
|
This is the single most important command in Vagrant, since it is how
|
|
|
|
any Vagrant machine is created. Anyone using Vagrant must use this command
|
|
|
|
on a day-to-day basis.
|
2013-09-06 16:50:43 +00:00
|
|
|
|
2014-05-01 07:11:19 +00:00
|
|
|
## Options
|
2013-09-06 16:50:43 +00:00
|
|
|
|
|
|
|
* `--[no-]destroy-on-error` - Destroy the newly created machine if a fatal,
|
|
|
|
unexpected error occurs. This will only happen on the first `vagrant up`.
|
|
|
|
By default this is set.
|
|
|
|
|
2015-11-05 21:59:08 +00:00
|
|
|
* `--[no-]install-provider` - If the requested provider is not installed,
|
|
|
|
Vagrant will attempt to automatically install it if it can. By default this
|
|
|
|
is enabled.
|
|
|
|
|
2013-09-06 16:50:43 +00:00
|
|
|
* `--[no-]parallel` - Bring multiple machines up in parallel if the provider
|
2014-10-17 15:23:31 +00:00
|
|
|
supports it. Please consult the provider documentation to see if this feature
|
|
|
|
is supported.
|
2013-09-06 16:50:43 +00:00
|
|
|
|
|
|
|
* `--provider x` - Bring the machine up with the given
|
|
|
|
[provider](/v2/providers/index.html). By default this is "virtualbox".
|
|
|
|
|
|
|
|
* `--provision` - Force the provisioners to run.
|
|
|
|
|
|
|
|
* `--provision-with x,y,z` - This will only run the given provisioners. For
|
|
|
|
example, if you have a `:shell` and `:chef_solo` provisioner and run
|
|
|
|
`vagrant provision --provision-with shell`, only the shell provisioner will
|
|
|
|
be run.
|