Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

vmctl up

Bring up VMs defined in VMFile.kdl.

Synopsis

vmctl up [OPTIONS]

Options

OptionTypeDefaultDescription
--filepathPath to VMFile.kdl (auto-discovered if omitted)
--namestringOnly bring up a specific VM
--no-provisionflagfalseSkip provisioning steps

Details

For each VM in the VMFile:

  1. If the VM is already running, it is skipped.
  2. If the VM exists but is stopped, it is restarted and re-provisioned.
  3. If the VM doesn't exist, it is created, started, and provisioned.

Images are downloaded and cached as needed. SSH keys are auto-generated when cloud-init is configured without an explicit key.

Examples

# Bring up all VMs in ./VMFile.kdl
vmctl up

# Bring up a specific VM
vmctl up --name webserver

# Bring up without provisioning
vmctl up --no-provision

# Use a specific VMFile
vmctl up --file path/to/VMFile.kdl

See Also

vmctl down, vmctl reload