Enable/disable ACPI.
-`agent`: `<boolean>` ('default =' `0`)::
+`agent`: `[enabled=]<1|0> [,fstrim_cloned_disks=<1|0>]` ::
+
+Enable/disable Qemu GuestAgent and its properties.
+
+`enabled`=`<boolean>` ('default =' `0`);;
Enable/disable Qemu GuestAgent.
+`fstrim_cloned_disks`=`<boolean>` ('default =' `0`);;
+
+Run fstrim after cloning/moving a disk.
+
`args`: `<string>` ::
Arbitrary arguments passed to kvm, for example:
This is an alias for option -ide2
+`cipassword`: `<string>` ::
+
+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> [,hidden=<1|0>]` ::
+`cpu`: `[cputype=]<enum> [,flags=<+FLAG[;-FLAG...]>] [,hidden=<1|0>]` ::
Emulated CPU type.
-`cputype`=`<486 | Broadwell | Broadwell-noTSX | Conroe | Haswell | Haswell-noTSX | IvyBridge | Nehalem | Opteron_G1 | Opteron_G2 | Opteron_G3 | Opteron_G4 | Opteron_G5 | Penryn | SandyBridge | Westmere | athlon | core2duo | coreduo | host | kvm32 | kvm64 | pentium | pentium2 | pentium3 | phenom | qemu32 | qemu64>` ('default =' `kvm64`);;
+`cputype`=`<486 | Broadwell | Broadwell-IBRS | Broadwell-noTSX | Broadwell-noTSX-IBRS | Conroe | EPYC | EPYC-IBPB | Haswell | Haswell-IBRS | Haswell-noTSX | Haswell-noTSX-IBRS | IvyBridge | IvyBridge-IBRS | Nehalem | Nehalem-IBRS | Opteron_G1 | Opteron_G2 | Opteron_G3 | Opteron_G4 | Opteron_G5 | Penryn | SandyBridge | SandyBridge-IBRS | Skylake-Client | Skylake-Client-IBRS | Skylake-Server | Skylake-Server-IBRS | Westmere | Westmere-IBRS | athlon | core2duo | coreduo | host | kvm32 | kvm64 | max | pentium | pentium2 | pentium3 | phenom | qemu32 | qemu64>` ('default =' `kvm64`);;
Emulated CPU type.
+`flags`=`<+FLAG[;-FLAG...]>` ;;
+
+List of additional CPU flags separated by ';'. Use '+FLAG' to enable, '-FLAG' to disable a flag. Currently supported flags: 'pcid', 'spec-ctrl', 'ibpb', 'ssbd', 'virt-ssbd', 'amd-ssbd', 'amd-no-ssb', 'pdpe1gb'.
+
`hidden`=`<boolean>` ('default =' `0`);;
Do not identify as a KVM virtual machine.
+
NOTE: If the computer has 2 CPUs, it has total of '2' CPU time. Value '0' indicates no CPU limit.
-`cpuunits`: `<integer> (0 - 500000)` ('default =' `1024`)::
+`cpuunits`: `<integer> (2 - 262144)` ('default =' `1024`)::
CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to weights of all the other running VMs.
-+
-NOTE: You can disable fair-scheduler configuration by setting this to 0.
`description`: `<string>` ::
Freeze CPU at startup (use 'c' monitor command to start execution).
-`hostpci[n]`: `[host=]<HOSTPCIID[;HOSTPCIID2...]> [,pcie=<1|0>] [,rombar=<1|0>] [,x-vga=<1|0>]` ::
+`hostpci[n]`: `[host=]<HOSTPCIID[;HOSTPCIID2...]> [,pcie=<1|0>] [,rombar=<1|0>] [,romfile=<string>] [,x-vga=<1|0>]` ::
Map host PCI devices into guest.
+
Specify whether or not the device's ROM will be visible in the guest's memory map.
+`romfile`=`<string>` ;;
+
+Custom pci device rom filename (must be located in /usr/share/kvm/).
+
`x-vga`=`<boolean>` ('default =' `0`);;
Enable vfio-vga device support.
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_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_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_length=<seconds>] [,iops_rd_max=<iops>] [,iops_wr=<iops>] [,iops_wr_length=<seconds>] [,iops_wr_max=<iops>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,model=<model>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::
+`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).
Maximum read speed in bytes per second.
-`bps_rd_length`=`<seconds>` ;;
+`bps_rd_max_length`=`<seconds>` ;;
Maximum length of read I/O bursts in seconds.
Maximum write speed in bytes per second.
-`bps_wr_length`=`<seconds>` ;;
+`bps_wr_max_length`=`<seconds>` ;;
Maximum length of write I/O bursts in seconds.
Maximum read I/O in operations per second.
-`iops_rd_length`=`<seconds>` ;;
-
-Maximum length of read I/O bursts in seconds.
-
`iops_rd_max`=`<iops>` ;;
Maximum unthrottled read I/O pool in operations per second.
-`iops_wr`=`<iops>` ;;
+`iops_rd_max_length`=`<seconds>` ;;
-Maximum write I/O in operations per second.
+Maximum length of read I/O bursts in seconds.
-`iops_wr_length`=`<seconds>` ;;
+`iops_wr`=`<iops>` ;;
-Maximum length of write I/O bursts in seconds.
+Maximum write I/O in operations per second.
`iops_wr_max`=`<iops>` ;;
Maximum unthrottled write I/O pool in operations per second.
+`iops_wr_max_length`=`<seconds>` ;;
+
+Maximum length of write I/O bursts in seconds.
+
`mbps`=`<mbps>` ;;
Maximum r/w speed in megabytes per second.
The drive's reported model name, url-encoded, up to 40 bytes long.
+`replicate`=`<boolean>` ('default =' `1`);;
+
+Whether the drive should considered for replication jobs.
+
`rerror`=`<ignore | report | stop>` ;;
Read error action.
The drive's reported serial number, url-encoded, up to 20 bytes long.
+`shared`=`<boolean>` ('default =' `0`);;
+
+Mark this locally-managed volume as available on all nodes.
++
+WARNING: This option does not share the volume automatically, it assumes it is shared already!
+
`size`=`<DiskSize>` ;;
Disk size. This is purely informational and has no effect.
`snapshot`=`<boolean>` ;;
-Whether the drive should be included when making snapshots.
+Controls qemu's snapshot mode feature. If activated, changes made to the disk are temporary and will be discarded when the VM is shutdown.
+
+`ssd`=`<boolean>` ;;
+
+Whether to expose this drive as an SSD, rather than a rotational hard disk.
`trans`=`<auto | lba | none>` ;;
Write error action.
-`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>` ('default =' `en-us`)::
+`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.
+
+`gw`=`<GatewayIPv4>` ;;
+
+Default gateway for IPv4 traffic.
++
+NOTE: Requires option(s): `ip`
+
+`gw6`=`<GatewayIPv6>` ;;
+
+Default gateway for IPv6 traffic.
++
+NOTE: Requires option(s): `ip6`
+
+`ip`=`<IPv4Format/CIDR>` ('default =' `dhcp`);;
+
+IPv4 address in CIDR format.
-Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.conf' configuration file.
+`ip6`=`<IPv6Format/CIDR>` ('default =' `dhcp`);;
+
+IPv6 address in CIDR format.
+
+`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`)::
`machine`: `(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?)` ::
-Specific the Qemu machine type.
+Specifies the Qemu machine type.
`memory`: `<integer> (16 - N)` ('default =' `512`)::
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.
w2k8;; Microsoft Windows 2008
wvista;; Microsoft Windows Vista
win7;; Microsoft Windows 7
-win8;; Microsoft Windows 8/2012
+win8;; Microsoft Windows 8/2012/2012r2
+win10;; Microsoft Windows 10/2016
l24;; Linux 2.4 Kernel
l26;; Linux 2.6/3.X Kernel
solaris;; Solaris/OpenSolaris/OpenIndiania kernel
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_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_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_length=<seconds>] [,iops_rd_max=<iops>] [,iops_wr=<iops>] [,iops_wr_length=<seconds>] [,iops_wr_max=<iops>] [,mbps=<mbps>] [,mbps_max=<mbps>] [,mbps_rd=<mbps>] [,mbps_rd_max=<mbps>] [,mbps_wr=<mbps>] [,mbps_wr_max=<mbps>] [,media=<cdrom|disk>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::
+`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).
Maximum read speed in bytes per second.
-`bps_rd_length`=`<seconds>` ;;
+`bps_rd_max_length`=`<seconds>` ;;
Maximum length of read I/O bursts in seconds.
Maximum write speed in bytes per second.
-`bps_wr_length`=`<seconds>` ;;
+`bps_wr_max_length`=`<seconds>` ;;
Maximum length of write I/O bursts in seconds.
Maximum read I/O in operations per second.
-`iops_rd_length`=`<seconds>` ;;
-
-Maximum length of read I/O bursts in seconds.
-
`iops_rd_max`=`<iops>` ;;
Maximum unthrottled read I/O pool in operations per second.
-`iops_wr`=`<iops>` ;;
+`iops_rd_max_length`=`<seconds>` ;;
-Maximum write I/O in operations per second.
+Maximum length of read I/O bursts in seconds.
-`iops_wr_length`=`<seconds>` ;;
+`iops_wr`=`<iops>` ;;
-Maximum length of write I/O bursts in seconds.
+Maximum write I/O in operations per second.
`iops_wr_max`=`<iops>` ;;
Maximum unthrottled write I/O pool in operations per second.
+`iops_wr_max_length`=`<seconds>` ;;
+
+Maximum length of write I/O bursts in seconds.
+
`mbps`=`<mbps>` ;;
Maximum r/w speed in megabytes per second.
The drive's media type.
+`replicate`=`<boolean>` ('default =' `1`);;
+
+Whether the drive should considered for replication jobs.
+
`rerror`=`<ignore | report | stop>` ;;
Read error action.
The drive's reported serial number, url-encoded, up to 20 bytes long.
+`shared`=`<boolean>` ('default =' `0`);;
+
+Mark this locally-managed volume as available on all nodes.
++
+WARNING: This option does not share the volume automatically, it assumes it is shared already!
+
`size`=`<DiskSize>` ;;
Disk size. This is purely informational and has no effect.
`snapshot`=`<boolean>` ;;
-Whether the drive should be included when making snapshots.
+Controls qemu's snapshot mode feature. If activated, changes made to the disk are temporary and will be discarded when the VM is shutdown.
+
+`ssd`=`<boolean>` ;;
+
+Whether to expose this drive as an SSD, rather than a rotational hard disk.
`trans`=`<auto | lba | none>` ;;
Write error action.
-`scsi[n]`: `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_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_length=<seconds>] [,iops_rd_max=<iops>] [,iops_wr=<iops>] [,iops_wr_length=<seconds>] [,iops_wr_max=<iops>] [,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>] [,secs=<integer>] [,serial=<serial>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::
+`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).
Maximum read speed in bytes per second.
-`bps_rd_length`=`<seconds>` ;;
+`bps_rd_max_length`=`<seconds>` ;;
Maximum length of read I/O bursts in seconds.
Maximum write speed in bytes per second.
-`bps_wr_length`=`<seconds>` ;;
+`bps_wr_max_length`=`<seconds>` ;;
Maximum length of write I/O bursts in seconds.
Maximum read I/O in operations per second.
-`iops_rd_length`=`<seconds>` ;;
-
-Maximum length of read I/O bursts in seconds.
-
`iops_rd_max`=`<iops>` ;;
Maximum unthrottled read I/O pool in operations per second.
-`iops_wr`=`<iops>` ;;
+`iops_rd_max_length`=`<seconds>` ;;
-Maximum write I/O in operations per second.
+Maximum length of read I/O bursts in seconds.
-`iops_wr_length`=`<seconds>` ;;
+`iops_wr`=`<iops>` ;;
-Maximum length of write I/O bursts in seconds.
+Maximum write I/O in operations per second.
`iops_wr_max`=`<iops>` ;;
Maximum unthrottled write I/O pool in operations per second.
+`iops_wr_max_length`=`<seconds>` ;;
+
+Maximum length of write I/O bursts in seconds.
+
`iothread`=`<boolean>` ;;
Whether to use iothreads for this drive
Number of queues.
+`replicate`=`<boolean>` ('default =' `1`);;
+
+Whether the drive should considered for replication jobs.
+
+`rerror`=`<ignore | report | stop>` ;;
+
+Read error action.
+
+`scsiblock`=`<boolean>` ('default =' `0`);;
+
+whether to use scsi-block for full passthrough of host block device
++
+WARNING: can lead to I/O errors in combination with low memory or high memory fragmentation on host
+
`secs`=`<integer>` ;;
Force the drive's physical geometry to have a specific sector count.
The drive's reported serial number, url-encoded, up to 20 bytes long.
+`shared`=`<boolean>` ('default =' `0`);;
+
+Mark this locally-managed volume as available on all nodes.
++
+WARNING: This option does not share the volume automatically, it assumes it is shared already!
+
`size`=`<DiskSize>` ;;
Disk size. This is purely informational and has no effect.
`snapshot`=`<boolean>` ;;
-Whether the drive should be included when making snapshots.
+Controls qemu's snapshot mode feature. If activated, changes made to the disk are temporary and will be discarded when the VM is shutdown.
+
+`ssd`=`<boolean>` ;;
+
+Whether to expose this drive as an SSD, rather than a rotational hard disk.
`trans`=`<auto | lba | none>` ;;
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), and pass through a
`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
+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>]` ::
The number of CPU sockets.
+`sshkeys`: `<string>` ::
+
+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'.
Number of hotplugged vcpus.
-`vga`: `<cirrus | qxl | qxl2 | qxl3 | qxl4 | serial0 | serial1 | serial2 | serial3 | std | vmware>` ::
+`vga`: `<cirrus | qxl | qxl2 | qxl3 | qxl4 | serial0 | serial1 | serial2 | serial3 | std | virtio | vmware>` ::
Select the VGA type. If you want to use high resolution modes (>= 1280x1024x16) then you should use the options 'std' or 'vmware'. Default is 'std' for win8/win7/w2k8, and 'cirrus' for other OS types. The 'qxl' option enables the SPICE display sever. For win* OS you can select how many independent displays you want, Linux guests can add displays them self. You can also run without any graphic card, using a serial device as terminal.
-`virtio[n]`: `[file=]<volume> [,aio=<native|threads>] [,backup=<1|0>] [,bps=<bps>] [,bps_max_length=<seconds>] [,bps_rd=<bps>] [,bps_rd_length=<seconds>] [,bps_wr=<bps>] [,bps_wr_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_length=<seconds>] [,iops_rd_max=<iops>] [,iops_wr=<iops>] [,iops_wr_length=<seconds>] [,iops_wr_max=<iops>] [,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>] [,rerror=<ignore|report|stop>] [,secs=<integer>] [,serial=<serial>] [,size=<DiskSize>] [,snapshot=<1|0>] [,trans=<none|lba|auto>] [,werror=<enum>]` ::
+`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).
Maximum read speed in bytes per second.
-`bps_rd_length`=`<seconds>` ;;
+`bps_rd_max_length`=`<seconds>` ;;
Maximum length of read I/O bursts in seconds.
Maximum write speed in bytes per second.
-`bps_wr_length`=`<seconds>` ;;
+`bps_wr_max_length`=`<seconds>` ;;
Maximum length of write I/O bursts in seconds.
Maximum read I/O in operations per second.
-`iops_rd_length`=`<seconds>` ;;
-
-Maximum length of read I/O bursts in seconds.
-
`iops_rd_max`=`<iops>` ;;
Maximum unthrottled read I/O pool in operations per second.
-`iops_wr`=`<iops>` ;;
+`iops_rd_max_length`=`<seconds>` ;;
-Maximum write I/O in operations per second.
+Maximum length of read I/O bursts in seconds.
-`iops_wr_length`=`<seconds>` ;;
+`iops_wr`=`<iops>` ;;
-Maximum length of write I/O bursts in seconds.
+Maximum write I/O in operations per second.
`iops_wr_max`=`<iops>` ;;
Maximum unthrottled write I/O pool in operations per second.
+`iops_wr_max_length`=`<seconds>` ;;
+
+Maximum length of write I/O bursts in seconds.
+
`iothread`=`<boolean>` ;;
Whether to use iothreads for this drive
The drive's media type.
+`replicate`=`<boolean>` ('default =' `1`);;
+
+Whether the drive should considered for replication jobs.
+
`rerror`=`<ignore | report | stop>` ;;
Read error action.
The drive's reported serial number, url-encoded, up to 20 bytes long.
+`shared`=`<boolean>` ('default =' `0`);;
+
+Mark this locally-managed volume as available on all nodes.
++
+WARNING: This option does not share the volume automatically, it assumes it is shared already!
+
`size`=`<DiskSize>` ;;
Disk size. This is purely informational and has no effect.
`snapshot`=`<boolean>` ;;
-Whether the drive should be included when making snapshots.
+Controls qemu's snapshot mode feature. If activated, changes made to the disk are temporary and will be discarded when the VM is shutdown.
`trans`=`<auto | lba | none>` ;;
Write error action.
+`vmgenid`: `<UUID>` ('default =' `1 (autogenerated)`)::
+
+The VM generation ID (vmgenid) device exposes a 128-bit integer value identifier to the guest OS. This allows to notify the guest operating system when the virtual machine is executed with a different configuration (e.g. snapshot execution or creation from a template). The guest operating system notices the change, and is then able to react as appropriate by marking its copies of distributed databases as dirty, re-initializing its random number generator, etc.
+Note that auto-creation only works when done throug API/CLI create or update methods, but not when manually editing the config file.
+
+`vmstatestorage`: `<string>` ::
+
+Default storage for VM state volumes/files.
+
`watchdog`: `[[model=]<i6300esb|ib700>] [,action=<enum>]` ::
Create a virtual hardware watchdog device. Once enabled (by a guest action), the watchdog must be periodically polled by an agent inside the guest or else the watchdog will reset the guest (or execute the respective action specified)
projects / pve-docs.git / blobdiff