vagrant/website/source/docs/cli/up.html.md

44 lines
1.5 KiB
Markdown
Raw Normal View History

---
layout: "docs"
page_title: "vagrant up - Command-Line Interface"
sidebar_current: "cli-up"
description: |-
The "vagrant up" command is used to create, configuration, and provision a
guest machine according to your Vagrantfile.
---
# Up
2016-04-12 11:45:10 +00:00
**Command: `vagrant up [name|id]`**
This command creates and configures guest machines according to your
[Vagrantfile](/docs/vagrantfile/).
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.
2014-05-01 07:11:19 +00:00
## Options
* `--[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.
* `--[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.
* `--[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.
* `--provider x` - Bring the machine up with the given
[provider](/docs/providers/). By default this is "virtualbox".
2016-11-21 17:13:52 +00:00
* `--[no-]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.