move guest-example-hookscript into new examples directory

[pve-docs.git] / qm.1-synopsis.adoc

*qm* `<COMMAND> [ARGS] [OPTIONS]`

*qm agent*

An alias for 'qm guest cmd'.

*qm cleanup* `<vmid> <clean-shutdown> <guest-requested>`

Cleans up resources like tap devices, vgpus, etc. Called after a vm shuts
down, crashes, etc.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<clean-shutdown>`: `<boolean>` ::

Indicates if qemu shutdown cleanly.

`<guest-requested>`: `<boolean>` ::

Indicates if the shutdown was requested by the guest or via qmp.

*qm clone* `<vmid> <newid>` `[OPTIONS]`

Create a copy of virtual machine/template.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<newid>`: `<integer> (1 - N)` ::

VMID for the clone.

`--description` `<string>` ::

Description for the new VM.

`--format` `<qcow2 | raw | vmdk>` ::

Target format for file storage. Only valid for full clone.

`--full` `<boolean>` ::

Create a full copy of all disks. This is always done when you clone a normal VM. For VM templates, we try to create a linked clone by default.

`--name` `<string>` ::

Set a name for the new VM.

`--pool` `<string>` ::

Add the new VM to the specified pool.

`--snapname` `<string>` ::

The name of the snapshot.

`--storage` `<string>` ::

Target storage for full clone.

`--target` `<string>` ::

Target node. Only allowed if the original VM is on shared storage.

*qm config* `<vmid>` `[OPTIONS]`

Get current virtual machine configuration. This does not include pending
configuration changes (see 'pending' API).

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--current` `<boolean>` ('default =' `0`)::

Get current values (instead of pending values).

*qm create* `<vmid>` `[OPTIONS]`

Create or restore a virtual machine.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--acpi` `<boolean>` ('default =' `1`)::

Enable/disable ACPI.

`--agent` `[enabled=]<1|0> [,fstrim_cloned_disks=<1|0>]` ::

Enable/disable Qemu GuestAgent and its properties.

`--arch` `<aarch64 | x86_64>` ::

Virtual processor architecture. Defaults to the host.

`--archive` `<string>` ::

The backup file.

`--args` `<string>` ::

Arbitrary arguments passed to kvm.

`--autostart` `<boolean>` ('default =' `0`)::

Automatic restart after crash (currently ignored).

`--balloon` `<integer> (0 - N)` ::

Amount of target RAM for the VM in MB. Using zero disables the ballon driver.

`--bios` `<ovmf | seabios>` ('default =' `seabios`)::

Select BIOS implementation.

`--boot` `[acdn]{1,4}` ('default =' `cdn`)::

Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).

`--bootdisk` `(ide|sata|scsi|virtio)\d+` ::

Enable booting from specified disk.

`--bwlimit` `<integer> (0 - N)` ::

Override i/o bandwidth limit (in KiB/s).

`--cdrom` `<volume>` ::

This is an alias for option -ide2

`--cipassword` `<password>` ::

cloud-init: Password to assign the user. Using this is generally not recommended. Use ssh keys instead. Also note that older cloud-init versions do not support hashed passwords.

`--citype` `<configdrive2 | nocloud>` ::

Specifies the cloud-init configuration format. The default depends on the configured operating system type (`ostype`. We use the `nocloud` format for Linux, and `configdrive2` for windows.

`--ciuser` `<string>` ::

cloud-init: User name to change ssh keys and password for instead of the image's configured default user.

`--cores` `<integer> (1 - N)` ('default =' `1`)::

The number of cores per socket.

`--cpu` `[cputype=]<enum> [,flags=<+FLAG[;-FLAG...]>] [,hidden=<1|0>]` ::

Emulated CPU type.

`--cpulimit` `<number> (0 - 128)` ('default =' `0`)::

Limit of CPU usage.

`--cpuunits` `<integer> (2 - 262144)` ('default =' `1024`)::

CPU weight for a VM.

`--description` `<string>` ::

Description for the VM. Only used on the configuration web interface. This is saved as comment inside the configuration file.

`--efidisk0` `[file=]<volume> [,format=<enum>] [,size=<DiskSize>]` ::

Configure a Disk for storing EFI vars

`--force` `<boolean>` ::

Allow to overwrite existing VM.
+
NOTE: Requires option(s): `archive`

`--freeze` `<boolean>` ::

Freeze CPU at startup (use 'c' monitor command to start execution).

`--hostpci[n]` `[host=]<HOSTPCIID[;HOSTPCIID2...]> [,mdev=<string>] [,pcie=<1|0>] [,rombar=<1|0>] [,romfile=<string>] [,x-vga=<1|0>]` ::

Map host PCI devices into guest.

`--hotplug` `<string>` ('default =' `network,disk,usb`)::

Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to disable hotplug completely. Value '1' is an alias for the default 'network,disk,usb'.

`--hugepages` `<1024 | 2 | any>` ::

Enable/disable hugepages memory.

`--ide[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,model=<model>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::

Use volume as IDE hard disk or CD-ROM (n is 0 to 3).

`--ipconfig[n]` `[gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>]` ::

cloud-init: Specify IP addresses and gateways for the corresponding interface.
+
IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.
+
The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.
For IPv6 the special string 'auto' can be used to use stateless autoconfiguration.
+
If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.

`--keyboard` `<da | de | de-ch | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sl | sv | tr>` ::

Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.It should not be necessary to set it.

`--kvm` `<boolean>` ('default =' `1`)::

Enable/disable KVM hardware virtualization.

`--localtime` `<boolean>` ::

Set the real time clock to local time. This is enabled by default if ostype indicates a Microsoft OS.

`--lock` `<backup | migrate | rollback | snapshot>` ::

Lock/unlock the VM.

`--machine` `(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?|virt(?:-\d+\.\d+)?)` ::

Specifies the Qemu machine type.

`--memory` `<integer> (16 - N)` ('default =' `512`)::

Amount of RAM for the VM in MB. This is the maximum available memory when you use the balloon device.

`--migrate_downtime` `<number> (0 - N)` ('default =' `0.1`)::

Set maximum tolerated downtime (in seconds) for migrations.

`--migrate_speed` `<integer> (0 - N)` ('default =' `0`)::

Set maximum speed (in MB/s) for migrations. Value 0 is no limit.

`--name` `<string>` ::

Set a name for the VM. Only used on the configuration web interface.

`--nameserver` `<string>` ::

cloud-init: Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.

`--net[n]` `[model=]<enum> [,bridge=<bridge>] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=<XX:XX:XX:XX:XX:XX>] [,queues=<integer>] [,rate=<number>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,<model>=<macaddr>]` ::

Specify network devices.

`--numa` `<boolean>` ('default =' `0`)::

Enable/disable NUMA.

`--numa[n]` `cpus=<id[-id];...> [,hostnodes=<id[-id];...>] [,memory=<number>] [,policy=<preferred|bind|interleave>]` ::

NUMA topology.

`--onboot` `<boolean>` ('default =' `0`)::

Specifies whether a VM will be started during system bootup.

`--ostype` `<l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win10 | win7 | win8 | wvista | wxp>` ::

Specify guest operating system.

`--parallel[n]` `/dev/parport\d+|/dev/usb/lp\d+` ::

Map host parallel devices (n is 0 to 2).

`--pool` `<string>` ::

Add the VM to the specified pool.

`--protection` `<boolean>` ('default =' `0`)::

Sets the protection flag of the VM. This will disable the remove VM and remove disk operations.

`--reboot` `<boolean>` ('default =' `1`)::

Allow reboot. If set to '0' the VM exit on reboot.

`--sata[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::

Use volume as SATA hard disk or CD-ROM (n is 0 to 5).

`--scsi[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::

Use volume as SCSI hard disk or CD-ROM (n is 0 to 13).

`--scsihw` `<lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single>` ('default =' `lsi`)::

SCSI controller model

`--searchdomain` `<string>` ::

cloud-init: Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.

`--serial[n]` `(/dev/.+|socket)` ::

Create a serial device inside the VM (n is 0 to 3)

`--shares` `<integer> (0 - 50000)` ('default =' `1000`)::

Amount of memory shares for auto-ballooning. The larger the number is, the more memory this VM gets. Number is relative to weights of all other running VMs. Using zero disables auto-ballooning. Auto-ballooning is done by pvestatd.

`--smbios1` `[family=<string>] [,manufacturer=<string>] [,product=<string>] [,serial=<string>] [,sku=<string>] [,uuid=<UUID>] [,version=<string>]` ::

Specify SMBIOS type 1 fields.

`--smp` `<integer> (1 - N)` ('default =' `1`)::

The number of CPUs. Please use option -sockets instead.

`--sockets` `<integer> (1 - N)` ('default =' `1`)::

The number of CPU sockets.

`--sshkeys` `<filepath>` ::

cloud-init: Setup public SSH keys (one key per line, OpenSSH format).

`--start` `<boolean>` ('default =' `0`)::

Start VM after it was created successfully.

`--startdate` `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` ('default =' `now`)::

Set the initial date of the real time clock. Valid format for date are: 'now' or '2006-06-17T16:01:21' or '2006-06-17'.

`--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::

Startup and shutdown behavior. Order is a non-negative number defining the general startup order. Shutdown in done with reverse ordering. Additionally you can set the 'up' or 'down' delay in seconds, which specifies a delay to wait before the next VM is started or stopped.

`--storage` `<string>` ::

Default storage.

`--tablet` `<boolean>` ('default =' `1`)::

Enable/disable the USB tablet device.

`--tdf` `<boolean>` ('default =' `0`)::

Enable/disable time drift fix.

`--template` `<boolean>` ('default =' `0`)::

Enable/disable Template.

`--unique` `<boolean>` ::

Assign a unique random ethernet address.
+
NOTE: Requires option(s): `archive`

`--unused[n]` `<string>` ::

Reference to unused volumes. This is used internally, and should not be modified manually.

`--usb[n]` `[host=]<HOSTUSBDEVICE|spice> [,usb3=<1|0>]` ::

Configure an USB device (n is 0 to 4).

`--vcpus` `<integer> (1 - N)` ('default =' `0`)::

Number of hotplugged vcpus.

`--vga` `[[type=]<enum>] [,memory=<integer>]` ::

Configure the VGA hardware.

`--virtio[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::

Use volume as VIRTIO hard disk (n is 0 to 15).

`--vmgenid` `<UUID>` ('default =' `1 (autogenerated)`)::

Set VM Generation ID. Use '1' to autogenerate on create or update, pass '0' to disable explicitly.

`--vmstatestorage` `<string>` ::

Default storage for VM state volumes/files.

`--watchdog` `[[model=]<i6300esb|ib700>] [,action=<enum>]` ::

Create a virtual hardware watchdog device.

*qm delsnapshot* `<vmid> <snapname>` `[OPTIONS]`

Delete a VM snapshot.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<snapname>`: `<string>` ::

The name of the snapshot.

`--force` `<boolean>` ::

For removal from config file, even if removing disk snapshots fails.

*qm destroy* `<vmid>` `[OPTIONS]`

Destroy the vm (also delete all used/owned volumes).

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--skiplock` `<boolean>` ::

Ignore locks - only root is allowed to use this option.

*qm guest cmd* `<vmid> <command>`

Execute Qemu Guest Agent commands.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<command>`: `<fsfreeze-freeze | fsfreeze-status | fsfreeze-thaw | fstrim | get-fsinfo | get-host-name | get-memory-block-info | get-memory-blocks | get-osinfo | get-time | get-timezone | get-users | get-vcpus | info | network-get-interfaces | ping | shutdown | suspend-disk | suspend-hybrid | suspend-ram>` ::

The QGA command.

*qm guest exec* `<vmid> [<extra-args>]` `[OPTIONS]`

Executes the given command via the guest agent

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<extra-args>`: `<array>` ::

Extra arguments as array

`--synchronous` `<boolean>` ('default =' `1`)::

If set to off, returns the pid immediately instead of waiting for the commmand to finish or the timeout.

`--timeout` `<integer> (0 - N)` ('default =' `30`)::

The maximum time to wait synchronously for the command to finish. If reached, the pid gets returned. Set to 0 to deactivate

*qm guest exec-status* `<vmid> <pid>`

Gets the status of the given pid started by the guest-agent

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<pid>`: `<integer>` ::

The PID to query

*qm guest passwd* `<vmid> <username>` `[OPTIONS]`

Sets the password for the given user to the given password

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<username>`: `<string>` ::

The user to set the password for.

`--crypted` `<boolean>` ('default =' `0`)::

set to 1 if the password has already been passed through crypt()

*qm help* `[OPTIONS]`

Get help about specified command.

`--extra-args` `<array>` ::

Shows help for a specific command

`--verbose` `<boolean>` ::

Verbose output format.

*qm importdisk* `<vmid> <source> <storage>` `[OPTIONS]`

Import an external disk image as an unused disk in a VM. The
 image format has to be supported by qemu-img(1).

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<source>`: `<string>` ::

Path to the disk image to import

`<storage>`: `<string>` ::

Target storage ID

`--format` `<qcow2 | raw | vmdk>` ::

Target format

*qm importovf* `<vmid> <manifest> <storage>` `[OPTIONS]`

Create a new VM using parameters read from an OVF manifest

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<manifest>`: `<string>` ::

path to the ovf file

`<storage>`: `<string>` ::

Target storage ID

`--dryrun` `<boolean>` ::

Print a parsed representation of the extracted OVF parameters, but do not create a VM

`--format` `<qcow2 | raw | vmdk>` ::

Target format

*qm list* `[OPTIONS]`

Virtual machine index (per node).

`--full` `<boolean>` ::

Determine the full status of active VMs.

*qm listsnapshot* `<vmid>`

List all snapshots.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

*qm migrate* `<vmid> <target>` `[OPTIONS]`

Migrate virtual machine. Creates a new migration task.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<target>`: `<string>` ::

Target node.

`--force` `<boolean>` ::

Allow to migrate VMs which use local devices. Only root may use this option.

`--migration_network` `<string>` ::

CIDR of the (sub) network that is used for migration.

`--migration_type` `<insecure | secure>` ::

Migration traffic is encrypted using an SSH tunnel by default. On secure, completely private networks this can be disabled to increase performance.

`--online` `<boolean>` ::

Use online/live migration.

`--targetstorage` `<string>` ::

Default target storage.

`--with-local-disks` `<boolean>` ::

Enable live storage migration for local disk

*qm monitor* `<vmid>`

Enter Qemu Monitor interface.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

*qm move_disk* `<vmid> <disk> <storage>` `[OPTIONS]`

Move volume to different storage.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<disk>`: `<efidisk0 | ide0 | ide1 | ide2 | ide3 | sata0 | sata1 | sata2 | sata3 | sata4 | sata5 | scsi0 | scsi1 | scsi10 | scsi11 | scsi12 | scsi13 | scsi2 | scsi3 | scsi4 | scsi5 | scsi6 | scsi7 | scsi8 | scsi9 | virtio0 | virtio1 | virtio10 | virtio11 | virtio12 | virtio13 | virtio14 | virtio15 | virtio2 | virtio3 | virtio4 | virtio5 | virtio6 | virtio7 | virtio8 | virtio9>` ::

The disk you want to move.

`<storage>`: `<string>` ::

Target storage.

`--delete` `<boolean>` ('default =' `0`)::

Delete the original disk after successful copy. By default the original disk is kept as unused disk.

`--digest` `<string>` ::

Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.

`--format` `<qcow2 | raw | vmdk>` ::

Target Format.

*qm mtunnel*

Used by qmigrate - do not use manually.

*qm nbdstop* `<vmid>`

Stop embedded nbd server.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

*qm pending* `<vmid>`

Get virtual machine configuration, including pending changes.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

*qm rescan* `[OPTIONS]`

Rescan all storages and update disk sizes and unused disk images.

`--dryrun` `<boolean>` ('default =' `0`)::

Do not actually write changes out to VM config(s).

`--vmid` `<integer> (1 - N)` ::

The (unique) ID of the VM.

*qm reset* `<vmid>` `[OPTIONS]`

Reset virtual machine.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--skiplock` `<boolean>` ::

Ignore locks - only root is allowed to use this option.

*qm resize* `<vmid> <disk> <size>` `[OPTIONS]`

Extend volume size.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<disk>`: `<efidisk0 | ide0 | ide1 | ide2 | ide3 | sata0 | sata1 | sata2 | sata3 | sata4 | sata5 | scsi0 | scsi1 | scsi10 | scsi11 | scsi12 | scsi13 | scsi2 | scsi3 | scsi4 | scsi5 | scsi6 | scsi7 | scsi8 | scsi9 | virtio0 | virtio1 | virtio10 | virtio11 | virtio12 | virtio13 | virtio14 | virtio15 | virtio2 | virtio3 | virtio4 | virtio5 | virtio6 | virtio7 | virtio8 | virtio9>` ::

The disk you want to resize.

`<size>`: `\+?\d+(\.\d+)?[KMGT]?` ::

The new size. With the `+` sign the value is added to the actual size of the volume and without it, the value is taken as an absolute one. Shrinking disk size is not supported.

`--digest` `<string>` ::

Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.

`--skiplock` `<boolean>` ::

Ignore locks - only root is allowed to use this option.

*qm resume* `<vmid>` `[OPTIONS]`

Resume virtual machine.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--nocheck` `<boolean>` ::

no description available

`--skiplock` `<boolean>` ::

Ignore locks - only root is allowed to use this option.

*qm rollback* `<vmid> <snapname>`

Rollback VM state to specified snapshot.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<snapname>`: `<string>` ::

The name of the snapshot.

*qm sendkey* `<vmid> <key>` `[OPTIONS]`

Send key event to virtual machine.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<key>`: `<string>` ::

The key (qemu monitor encoding).

`--skiplock` `<boolean>` ::

Ignore locks - only root is allowed to use this option.

*qm set* `<vmid>` `[OPTIONS]`

Set virtual machine options (synchrounous API) - You should consider using
the POST method instead for any actions involving hotplug or storage
allocation.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--acpi` `<boolean>` ('default =' `1`)::

Enable/disable ACPI.

`--agent` `[enabled=]<1|0> [,fstrim_cloned_disks=<1|0>]` ::

Enable/disable Qemu GuestAgent and its properties.

`--arch` `<aarch64 | x86_64>` ::

Virtual processor architecture. Defaults to the host.

`--args` `<string>` ::

Arbitrary arguments passed to kvm.

`--autostart` `<boolean>` ('default =' `0`)::

Automatic restart after crash (currently ignored).

`--balloon` `<integer> (0 - N)` ::

Amount of target RAM for the VM in MB. Using zero disables the ballon driver.

`--bios` `<ovmf | seabios>` ('default =' `seabios`)::

Select BIOS implementation.

`--boot` `[acdn]{1,4}` ('default =' `cdn`)::

Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).

`--bootdisk` `(ide|sata|scsi|virtio)\d+` ::

Enable booting from specified disk.

`--cdrom` `<volume>` ::

This is an alias for option -ide2

`--cipassword` `<password>` ::

cloud-init: Password to assign the user. Using this is generally not recommended. Use ssh keys instead. Also note that older cloud-init versions do not support hashed passwords.

`--citype` `<configdrive2 | nocloud>` ::

Specifies the cloud-init configuration format. The default depends on the configured operating system type (`ostype`. We use the `nocloud` format for Linux, and `configdrive2` for windows.

`--ciuser` `<string>` ::

cloud-init: User name to change ssh keys and password for instead of the image's configured default user.

`--cores` `<integer> (1 - N)` ('default =' `1`)::

The number of cores per socket.

`--cpu` `[cputype=]<enum> [,flags=<+FLAG[;-FLAG...]>] [,hidden=<1|0>]` ::

Emulated CPU type.

`--cpulimit` `<number> (0 - 128)` ('default =' `0`)::

Limit of CPU usage.

`--cpuunits` `<integer> (2 - 262144)` ('default =' `1024`)::

CPU weight for a VM.

`--delete` `<string>` ::

A list of settings you want to delete.

`--description` `<string>` ::

Description for the VM. Only used on the configuration web interface. This is saved as comment inside the configuration file.

`--digest` `<string>` ::

Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.

`--efidisk0` `[file=]<volume> [,format=<enum>] [,size=<DiskSize>]` ::

Configure a Disk for storing EFI vars

`--force` `<boolean>` ::

Force physical removal. Without this, we simple remove the disk from the config file and create an additional configuration entry called 'unused[n]', which contains the volume ID. Unlink of unused[n] always cause physical removal.
+
NOTE: Requires option(s): `delete`

`--freeze` `<boolean>` ::

Freeze CPU at startup (use 'c' monitor command to start execution).

`--hostpci[n]` `[host=]<HOSTPCIID[;HOSTPCIID2...]> [,mdev=<string>] [,pcie=<1|0>] [,rombar=<1|0>] [,romfile=<string>] [,x-vga=<1|0>]` ::

Map host PCI devices into guest.

`--hotplug` `<string>` ('default =' `network,disk,usb`)::

Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to disable hotplug completely. Value '1' is an alias for the default 'network,disk,usb'.

`--hugepages` `<1024 | 2 | any>` ::

Enable/disable hugepages memory.

`--ide[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,model=<model>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::

Use volume as IDE hard disk or CD-ROM (n is 0 to 3).

`--ipconfig[n]` `[gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>]` ::

cloud-init: Specify IP addresses and gateways for the corresponding interface.
+
IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.
+
The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.
For IPv6 the special string 'auto' can be used to use stateless autoconfiguration.
+
If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.

`--keyboard` `<da | de | de-ch | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sl | sv | tr>` ::

Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.It should not be necessary to set it.

`--kvm` `<boolean>` ('default =' `1`)::

Enable/disable KVM hardware virtualization.

`--localtime` `<boolean>` ::

Set the real time clock to local time. This is enabled by default if ostype indicates a Microsoft OS.

`--lock` `<backup | migrate | rollback | snapshot>` ::

Lock/unlock the VM.

`--machine` `(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?|virt(?:-\d+\.\d+)?)` ::

Specifies the Qemu machine type.

`--memory` `<integer> (16 - N)` ('default =' `512`)::

Amount of RAM for the VM in MB. This is the maximum available memory when you use the balloon device.

`--migrate_downtime` `<number> (0 - N)` ('default =' `0.1`)::

Set maximum tolerated downtime (in seconds) for migrations.

`--migrate_speed` `<integer> (0 - N)` ('default =' `0`)::

Set maximum speed (in MB/s) for migrations. Value 0 is no limit.

`--name` `<string>` ::

Set a name for the VM. Only used on the configuration web interface.

`--nameserver` `<string>` ::

cloud-init: Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.

`--net[n]` `[model=]<enum> [,bridge=<bridge>] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=<XX:XX:XX:XX:XX:XX>] [,queues=<integer>] [,rate=<number>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,<model>=<macaddr>]` ::

Specify network devices.

`--numa` `<boolean>` ('default =' `0`)::

Enable/disable NUMA.

`--numa[n]` `cpus=<id[-id];...> [,hostnodes=<id[-id];...>] [,memory=<number>] [,policy=<preferred|bind|interleave>]` ::

NUMA topology.

`--onboot` `<boolean>` ('default =' `0`)::

Specifies whether a VM will be started during system bootup.

`--ostype` `<l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win10 | win7 | win8 | wvista | wxp>` ::

Specify guest operating system.

`--parallel[n]` `/dev/parport\d+|/dev/usb/lp\d+` ::

Map host parallel devices (n is 0 to 2).

`--protection` `<boolean>` ('default =' `0`)::

Sets the protection flag of the VM. This will disable the remove VM and remove disk operations.

`--reboot` `<boolean>` ('default =' `1`)::

Allow reboot. If set to '0' the VM exit on reboot.

`--revert` `<string>` ::

Revert a pending change.

`--sata[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::

Use volume as SATA hard disk or CD-ROM (n is 0 to 5).

`--scsi[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,queues=<integer>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,scsiblock=<1|0>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::

Use volume as SCSI hard disk or CD-ROM (n is 0 to 13).

`--scsihw` `<lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single>` ('default =' `lsi`)::

SCSI controller model

`--searchdomain` `<string>` ::

cloud-init: Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.

`--serial[n]` `(/dev/.+|socket)` ::

Create a serial device inside the VM (n is 0 to 3)

`--shares` `<integer> (0 - 50000)` ('default =' `1000`)::

Amount of memory shares for auto-ballooning. The larger the number is, the more memory this VM gets. Number is relative to weights of all other running VMs. Using zero disables auto-ballooning. Auto-ballooning is done by pvestatd.

`--skiplock` `<boolean>` ::

Ignore locks - only root is allowed to use this option.

`--smbios1` `[family=<string>] [,manufacturer=<string>] [,product=<string>] [,serial=<string>] [,sku=<string>] [,uuid=<UUID>] [,version=<string>]` ::

Specify SMBIOS type 1 fields.

`--smp` `<integer> (1 - N)` ('default =' `1`)::

The number of CPUs. Please use option -sockets instead.

`--sockets` `<integer> (1 - N)` ('default =' `1`)::

The number of CPU sockets.

`--sshkeys` `<filepath>` ::

cloud-init: Setup public SSH keys (one key per line, OpenSSH format).

`--startdate` `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` ('default =' `now`)::

Set the initial date of the real time clock. Valid format for date are: 'now' or '2006-06-17T16:01:21' or '2006-06-17'.

`--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::

Startup and shutdown behavior. Order is a non-negative number defining the general startup order. Shutdown in done with reverse ordering. Additionally you can set the 'up' or 'down' delay in seconds, which specifies a delay to wait before the next VM is started or stopped.

`--tablet` `<boolean>` ('default =' `1`)::

Enable/disable the USB tablet device.

`--tdf` `<boolean>` ('default =' `0`)::

Enable/disable time drift fix.

`--template` `<boolean>` ('default =' `0`)::

Enable/disable Template.

`--unused[n]` `<string>` ::

Reference to unused volumes. This is used internally, and should not be modified manually.

`--usb[n]` `[host=]<HOSTUSBDEVICE|spice> [,usb3=<1|0>]` ::

Configure an USB device (n is 0 to 4).

`--vcpus` `<integer> (1 - N)` ('default =' `0`)::

Number of hotplugged vcpus.

`--vga` `[[type=]<enum>] [,memory=<integer>]` ::

Configure the VGA hardware.

`--virtio[n]` `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_max_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_max_length=<seconds>] [,cache=<enum>] [,cyls=<integer>] [,detect_zeroes=<1|0>] [,discard=<ignore|on>] [,format=<enum>] [,heads=<integer>] [,iops=<iops>] [,iops_max=<iops>] [,iops_max_length=<seconds>] [,iops_rd=<iops>] [,iops_rd_max=<iops>] [,iops_rd_max_length=<seconds>] [,iops_wr=<iops>] [,iops_wr_max=<iops>] [,iops_wr_max_length=<seconds>] [,iothread=<1|0>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,replicate=<1|0>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,shared=<1|0>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::

Use volume as VIRTIO hard disk (n is 0 to 15).

`--vmgenid` `<UUID>` ('default =' `1 (autogenerated)`)::

Set VM Generation ID. Use '1' to autogenerate on create or update, pass '0' to disable explicitly.

`--vmstatestorage` `<string>` ::

Default storage for VM state volumes/files.

`--watchdog` `[[model=]<i6300esb|ib700>] [,action=<enum>]` ::

Create a virtual hardware watchdog device.

*qm showcmd* `<vmid>` `[OPTIONS]`

Show command line which is used to start the VM (debug info).

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--pretty` `<boolean>` ('default =' `0`)::

Puts each option on a new line to enhance human readability

*qm shutdown* `<vmid>` `[OPTIONS]`

Shutdown virtual machine. This is similar to pressing the power button on a
physical machine.This will send an ACPI event for the guest OS, which
should then proceed to a clean shutdown.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--forceStop` `<boolean>` ('default =' `0`)::

Make sure the VM stops.

`--keepActive` `<boolean>` ('default =' `0`)::

Do not deactivate storage volumes.

`--skiplock` `<boolean>` ::

Ignore locks - only root is allowed to use this option.

`--timeout` `<integer> (0 - N)` ::

Wait maximal timeout seconds.

*qm snapshot* `<vmid> <snapname>` `[OPTIONS]`

Snapshot a VM.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`<snapname>`: `<string>` ::

The name of the snapshot.

`--description` `<string>` ::

A textual description or comment.

`--vmstate` `<boolean>` ::

Save the vmstate

*qm start* `<vmid>` `[OPTIONS]`

Start virtual machine.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--machine` `(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?|virt(?:-\d+\.\d+)?)` ::

Specifies the Qemu machine type.

`--migratedfrom` `<string>` ::

The cluster node name.

`--migration_network` `<string>` ::

CIDR of the (sub) network that is used for migration.

`--migration_type` `<insecure | secure>` ::

Migration traffic is encrypted using an SSH tunnel by default. On secure, completely private networks this can be disabled to increase performance.

`--skiplock` `<boolean>` ::

Ignore locks - only root is allowed to use this option.

`--stateuri` `<string>` ::

Some command save/restore state from this location.

`--targetstorage` `<string>` ::

Target storage for the migration. (Can be '1' to use the same storage id as on the source node.)

*qm status* `<vmid>` `[OPTIONS]`

Show VM status.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--verbose` `<boolean>` ::

Verbose output format

*qm stop* `<vmid>` `[OPTIONS]`

Stop virtual machine. The qemu process will exit immediately. Thisis akin
to pulling the power plug of a running computer and may damage the VM data

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--keepActive` `<boolean>` ('default =' `0`)::

Do not deactivate storage volumes.

`--migratedfrom` `<string>` ::

The cluster node name.

`--skiplock` `<boolean>` ::

Ignore locks - only root is allowed to use this option.

`--timeout` `<integer> (0 - N)` ::

Wait maximal timeout seconds.

*qm suspend* `<vmid>` `[OPTIONS]`

Suspend virtual machine.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--skiplock` `<boolean>` ::

Ignore locks - only root is allowed to use this option.

*qm template* `<vmid>` `[OPTIONS]`

Create a Template.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--disk` `<efidisk0 | ide0 | ide1 | ide2 | ide3 | sata0 | sata1 | sata2 | sata3 | sata4 | sata5 | scsi0 | scsi1 | scsi10 | scsi11 | scsi12 | scsi13 | scsi2 | scsi3 | scsi4 | scsi5 | scsi6 | scsi7 | scsi8 | scsi9 | virtio0 | virtio1 | virtio10 | virtio11 | virtio12 | virtio13 | virtio14 | virtio15 | virtio2 | virtio3 | virtio4 | virtio5 | virtio6 | virtio7 | virtio8 | virtio9>` ::

If you want to convert only 1 disk to base image.

*qm terminal* `<vmid>` `[OPTIONS]`

Open a terminal using a serial device (The VM need to have a serial device
configured, for example 'serial0: socket')

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--escape` `<string>` ('default =' `^O`)::

Escape character.

`--iface` `<serial0 | serial1 | serial2 | serial3>` ::

Select the serial device. By default we simply use the first suitable device.

*qm unlink* `<vmid> --idlist <string>` `[OPTIONS]`

Unlink/delete disk images.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--force` `<boolean>` ::

Force physical removal. Without this, we simple remove the disk from the config file and create an additional configuration entry called 'unused[n]', which contains the volume ID. Unlink of unused[n] always cause physical removal.

`--idlist` `<string>` ::

A list of disk IDs you want to delete.

*qm unlock* `<vmid>`

Unlock the VM.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

*qm vncproxy* `<vmid>`

Proxy VM VNC traffic to stdin/stdout

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

*qm wait* `<vmid>` `[OPTIONS]`

Wait until the VM is stopped.

`<vmid>`: `<integer> (1 - N)` ::

The (unique) ID of the VM.

`--timeout` `<integer> (1 - N)` ::

Timeout in seconds. Default is to wait forever.