1 `acpi`: `<boolean>` ('default =' `1`)::
5 `agent`: `[enabled=]<1|0> [,fstrim_cloned_disks=<1|0>]` ::
7 Enable/disable Qemu GuestAgent and its properties.
9 `enabled`=`<boolean>` ('default =' `0`);;
11 Enable/disable Qemu GuestAgent.
13 `fstrim_cloned_disks`=`<boolean>` ('default =' `0`);;
15 Run fstrim after cloning/moving a disk.
17 `arch`: `<aarch64 | x86_64>` ::
19 Virtual processor architecture. Defaults to the host.
23 Arbitrary arguments passed to kvm, for example:
25 args: -no-reboot -no-hpet
27 NOTE: this option is for experts only.
29 `autostart`: `<boolean>` ('default =' `0`)::
31 Automatic restart after crash (currently ignored).
33 `balloon`: `<integer> (0 - N)` ::
35 Amount of target RAM for the VM in MB. Using zero disables the ballon driver.
37 `bios`: `<ovmf | seabios>` ('default =' `seabios`)::
39 Select BIOS implementation.
41 `boot`: `[acdn]{1,4}` ('default =' `cdn`)::
43 Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).
45 `bootdisk`: `(ide|sata|scsi|virtio)\d+` ::
47 Enable booting from specified disk.
49 `cdrom`: `<volume>` ::
51 This is an alias for option -ide2
53 `cicustom`: `[meta=<volume>] [,network=<volume>] [,user=<volume>]` ::
55 cloud-init: Specify custom files to replace the automatically generated ones at start.
59 Specify a custom file containing all meta data passed to the VM via cloud-init. This is provider specific meaning configdrive2 and nocloud differ.
61 `network`=`<volume>` ;;
63 Specify a custom file containing all network data passed to the VM via cloud-init.
67 Specify a custom file containing all user data passed to the VM via cloud-init.
69 `cipassword`: `<string>` ::
71 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.
73 `citype`: `<configdrive2 | nocloud>` ::
75 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.
77 `ciuser`: `<string>` ::
79 cloud-init: User name to change ssh keys and password for instead of the image's configured default user.
81 `cores`: `<integer> (1 - N)` ('default =' `1`)::
83 The number of cores per socket.
85 `cpu`: `[cputype=]<enum> [,flags=<+FLAG[;-FLAG...]>] [,hidden=<1|0>] [,hv-vendor-id=<vendor-id>]` ::
89 `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`);;
93 `flags`=`<+FLAG[;-FLAG...]>` ;;
95 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', 'md-clear'.
97 `hidden`=`<boolean>` ('default =' `0`);;
99 Do not identify as a KVM virtual machine.
101 `hv-vendor-id`=`<vendor-id>` ;;
103 The Hyper-V vendor ID. Some drivers or programs inside Windows guests need a specific ID.
105 `cpulimit`: `<number> (0 - 128)` ('default =' `0`)::
109 NOTE: If the computer has 2 CPUs, it has total of '2' CPU time. Value '0' indicates no CPU limit.
111 `cpuunits`: `<integer> (2 - 262144)` ('default =' `1024`)::
113 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.
115 `description`: `<string>` ::
117 Description for the VM. Only used on the configuration web interface. This is saved as comment inside the configuration file.
119 `efidisk0`: `[file=]<volume> [,format=<enum>] [,size=<DiskSize>]` ::
121 Configure a Disk for storing EFI vars
125 The drive's backing volume.
127 `format`=`<cloop | cow | qcow | qcow2 | qed | raw | vmdk>` ;;
129 The drive's backing file's data format.
131 `size`=`<DiskSize>` ;;
133 Disk size. This is purely informational and has no effect.
135 `freeze`: `<boolean>` ::
137 Freeze CPU at startup (use 'c' monitor command to start execution).
139 `hookscript`: `<string>` ::
141 Script that will be executed during various steps in the vms lifetime.
143 `hostpci[n]`: `[host=]<HOSTPCIID[;HOSTPCIID2...]> [,mdev=<string>] [,pcie=<1|0>] [,rombar=<1|0>] [,romfile=<string>] [,x-vga=<1|0>]` ::
145 Map host PCI devices into guest.
147 NOTE: This option allows direct access to host hardware. So it is no longer
148 possible to migrate such machines - use with special care.
150 CAUTION: Experimental! User reported problems with this option.
152 `host`=`<HOSTPCIID[;HOSTPCIID2...]>` ;;
154 Host PCI device pass through. The PCI ID of a host's PCI device or a list
155 of PCI virtual functions of the host. HOSTPCIID syntax is:
157 'bus:dev.func' (hexadecimal numbers)
159 You can us the 'lspci' command to list existing PCI devices.
163 The type of mediated device to use.
164 An instance of this type will be created on startup of the VM and
165 will be cleaned up when the VM stops.
167 `pcie`=`<boolean>` ('default =' `0`);;
169 Choose the PCI-express bus (needs the 'q35' machine model).
171 `rombar`=`<boolean>` ('default =' `1`);;
173 Specify whether or not the device's ROM will be visible in the guest's memory map.
175 `romfile`=`<string>` ;;
177 Custom pci device rom filename (must be located in /usr/share/kvm/).
179 `x-vga`=`<boolean>` ('default =' `0`);;
181 Enable vfio-vga device support.
183 `hotplug`: `<string>` ('default =' `network,disk,usb`)::
185 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'.
187 `hugepages`: `<1024 | 2 | any>` ::
189 Enable/disable hugepages memory.
191 `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>] [,wwn=<wwn>]` ::
193 Use volume as IDE hard disk or CD-ROM (n is 0 to 3).
195 `aio`=`<native | threads>` ;;
199 `backup`=`<boolean>` ;;
201 Whether the drive should be included when making backups.
205 Maximum r/w speed in bytes per second.
207 `bps_max_length`=`<seconds>` ;;
209 Maximum length of I/O bursts in seconds.
213 Maximum read speed in bytes per second.
215 `bps_rd_max_length`=`<seconds>` ;;
217 Maximum length of read I/O bursts in seconds.
221 Maximum write speed in bytes per second.
223 `bps_wr_max_length`=`<seconds>` ;;
225 Maximum length of write I/O bursts in seconds.
227 `cache`=`<directsync | none | unsafe | writeback | writethrough>` ;;
229 The drive's cache mode
231 `cyls`=`<integer>` ;;
233 Force the drive's physical geometry to have a specific cylinder count.
235 `detect_zeroes`=`<boolean>` ;;
237 Controls whether to detect and try to optimize writes of zeroes.
239 `discard`=`<ignore | on>` ;;
241 Controls whether to pass discard/trim requests to the underlying storage.
245 The drive's backing volume.
247 `format`=`<cloop | cow | qcow | qcow2 | qed | raw | vmdk>` ;;
249 The drive's backing file's data format.
251 `heads`=`<integer>` ;;
253 Force the drive's physical geometry to have a specific head count.
257 Maximum r/w I/O in operations per second.
259 `iops_max`=`<iops>` ;;
261 Maximum unthrottled r/w I/O pool in operations per second.
263 `iops_max_length`=`<seconds>` ;;
265 Maximum length of I/O bursts in seconds.
267 `iops_rd`=`<iops>` ;;
269 Maximum read I/O in operations per second.
271 `iops_rd_max`=`<iops>` ;;
273 Maximum unthrottled read I/O pool in operations per second.
275 `iops_rd_max_length`=`<seconds>` ;;
277 Maximum length of read I/O bursts in seconds.
279 `iops_wr`=`<iops>` ;;
281 Maximum write I/O in operations per second.
283 `iops_wr_max`=`<iops>` ;;
285 Maximum unthrottled write I/O pool in operations per second.
287 `iops_wr_max_length`=`<seconds>` ;;
289 Maximum length of write I/O bursts in seconds.
293 Maximum r/w speed in megabytes per second.
295 `mbps_max`=`<mbps>` ;;
297 Maximum unthrottled r/w pool in megabytes per second.
299 `mbps_rd`=`<mbps>` ;;
301 Maximum read speed in megabytes per second.
303 `mbps_rd_max`=`<mbps>` ;;
305 Maximum unthrottled read pool in megabytes per second.
307 `mbps_wr`=`<mbps>` ;;
309 Maximum write speed in megabytes per second.
311 `mbps_wr_max`=`<mbps>` ;;
313 Maximum unthrottled write pool in megabytes per second.
315 `media`=`<cdrom | disk>` ('default =' `disk`);;
317 The drive's media type.
321 The drive's reported model name, url-encoded, up to 40 bytes long.
323 `replicate`=`<boolean>` ('default =' `1`);;
325 Whether the drive should considered for replication jobs.
327 `rerror`=`<ignore | report | stop>` ;;
331 `secs`=`<integer>` ;;
333 Force the drive's physical geometry to have a specific sector count.
335 `serial`=`<serial>` ;;
337 The drive's reported serial number, url-encoded, up to 20 bytes long.
339 `shared`=`<boolean>` ('default =' `0`);;
341 Mark this locally-managed volume as available on all nodes.
343 WARNING: This option does not share the volume automatically, it assumes it is shared already!
345 `size`=`<DiskSize>` ;;
347 Disk size. This is purely informational and has no effect.
349 `snapshot`=`<boolean>` ;;
351 Controls qemu's snapshot mode feature. If activated, changes made to the disk are temporary and will be discarded when the VM is shutdown.
355 Whether to expose this drive as an SSD, rather than a rotational hard disk.
357 `trans`=`<auto | lba | none>` ;;
359 Force disk geometry bios translation mode.
361 `werror`=`<enospc | ignore | report | stop>` ;;
367 The drive's worldwide name, encoded as 16 bytes hex string, prefixed by '0x'.
369 `ipconfig[n]`: `[gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>]` ::
371 cloud-init: Specify IP addresses and gateways for the corresponding interface.
373 IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.
375 The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.
376 For IPv6 the special string 'auto' can be used to use stateless autoconfiguration.
378 If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.
380 `gw`=`<GatewayIPv4>` ;;
382 Default gateway for IPv4 traffic.
384 NOTE: Requires option(s): `ip`
386 `gw6`=`<GatewayIPv6>` ;;
388 Default gateway for IPv6 traffic.
390 NOTE: Requires option(s): `ip6`
392 `ip`=`<IPv4Format/CIDR>` ('default =' `dhcp`);;
394 IPv4 address in CIDR format.
396 `ip6`=`<IPv6Format/CIDR>` ('default =' `dhcp`);;
398 IPv6 address in CIDR format.
400 `ivshmem`: `size=<integer> [,name=<string>]` ::
402 Inter-VM shared memory. Useful for direct communication between VMs, or to the host.
406 The name of the file. Will be prefixed with 'pve-shm-'. Default is the VMID. Will be deleted when the VM is stopped.
408 `size`=`<integer> (1 - N)` ;;
410 The size of the file in MB.
412 `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>` ::
414 Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.It should not be necessary to set it.
416 `kvm`: `<boolean>` ('default =' `1`)::
418 Enable/disable KVM hardware virtualization.
420 `localtime`: `<boolean>` ::
422 Set the real time clock to local time. This is enabled by default if ostype indicates a Microsoft OS.
424 `lock`: `<backup | clone | create | migrate | rollback | snapshot | snapshot-delete | suspended | suspending>` ::
428 `machine`: `(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?|virt(?:-\d+\.\d+)?)` ::
430 Specifies the Qemu machine type.
432 `memory`: `<integer> (16 - N)` ('default =' `512`)::
434 Amount of RAM for the VM in MB. This is the maximum available memory when you use the balloon device.
436 `migrate_downtime`: `<number> (0 - N)` ('default =' `0.1`)::
438 Set maximum tolerated downtime (in seconds) for migrations.
440 `migrate_speed`: `<integer> (0 - N)` ('default =' `0`)::
442 Set maximum speed (in MB/s) for migrations. Value 0 is no limit.
444 `name`: `<string>` ::
446 Set a name for the VM. Only used on the configuration web interface.
448 `nameserver`: `<string>` ::
450 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.
452 `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>]` ::
454 Specify network devices.
456 `bridge`=`<bridge>` ;;
458 Bridge to attach the network device to. The Proxmox VE standard bridge
461 If you do not specify a bridge, we create a kvm user (NATed) network
462 device, which provides DHCP and DNS services. The following addresses
469 The DHCP server assign addresses to the guest starting from 10.0.2.15.
471 `firewall`=`<boolean>` ;;
473 Whether this interface should be protected by the firewall.
475 `link_down`=`<boolean>` ;;
477 Whether this interface should be disconnected (like pulling the plug).
479 `macaddr`=`<XX:XX:XX:XX:XX:XX>` ;;
481 A common MAC address with the I/G (Individual/Group) bit not set.
483 `model`=`<e1000 | e1000-82540em | e1000-82544gc | e1000-82545em | i82551 | i82557b | i82559er | ne2k_isa | ne2k_pci | pcnet | rtl8139 | virtio | vmxnet3>` ;;
485 Network Card Model. The 'virtio' model provides the best performance with very low CPU overhead. If your guest does not support this driver, it is usually best to use 'e1000'.
487 `queues`=`<integer> (0 - 16)` ;;
489 Number of packet queues to be used on the device.
491 `rate`=`<number> (0 - N)` ;;
493 Rate limit in mbps (megabytes per second) as floating point number.
495 `tag`=`<integer> (1 - 4094)` ;;
497 VLAN tag to apply to packets on this interface.
499 `trunks`=`<vlanid[;vlanid...]>` ;;
501 VLAN trunks to pass through this interface.
503 `numa`: `<boolean>` ('default =' `0`)::
507 `numa[n]`: `cpus=<id[-id];...> [,hostnodes=<id[-id];...>] [,memory=<number>] [,policy=<preferred|bind|interleave>]` ::
511 `cpus`=`<id[-id];...>` ;;
513 CPUs accessing this NUMA node.
515 `hostnodes`=`<id[-id];...>` ;;
517 Host NUMA nodes to use.
519 `memory`=`<number>` ;;
521 Amount of memory this NUMA node provides.
523 `policy`=`<bind | interleave | preferred>` ;;
525 NUMA allocation policy.
527 `onboot`: `<boolean>` ('default =' `0`)::
529 Specifies whether a VM will be started during system bootup.
531 `ostype`: `<l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win10 | win7 | win8 | wvista | wxp>` ::
533 Specify guest operating system. This is used to enable special
534 optimization/features for specific operating systems:
537 other;; unspecified OS
538 wxp;; Microsoft Windows XP
539 w2k;; Microsoft Windows 2000
540 w2k3;; Microsoft Windows 2003
541 w2k8;; Microsoft Windows 2008
542 wvista;; Microsoft Windows Vista
543 win7;; Microsoft Windows 7
544 win8;; Microsoft Windows 8/2012/2012r2
545 win10;; Microsoft Windows 10/2016
546 l24;; Linux 2.4 Kernel
547 l26;; Linux 2.6/3.X Kernel
548 solaris;; Solaris/OpenSolaris/OpenIndiania kernel
550 `parallel[n]`: `/dev/parport\d+|/dev/usb/lp\d+` ::
552 Map host parallel devices (n is 0 to 2).
554 NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.
556 CAUTION: Experimental! User reported problems with this option.
558 `protection`: `<boolean>` ('default =' `0`)::
560 Sets the protection flag of the VM. This will disable the remove VM and remove disk operations.
562 `reboot`: `<boolean>` ('default =' `1`)::
564 Allow reboot. If set to '0' the VM exit on reboot.
566 `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>] [,wwn=<wwn>]` ::
568 Use volume as SATA hard disk or CD-ROM (n is 0 to 5).
570 `aio`=`<native | threads>` ;;
574 `backup`=`<boolean>` ;;
576 Whether the drive should be included when making backups.
580 Maximum r/w speed in bytes per second.
582 `bps_max_length`=`<seconds>` ;;
584 Maximum length of I/O bursts in seconds.
588 Maximum read speed in bytes per second.
590 `bps_rd_max_length`=`<seconds>` ;;
592 Maximum length of read I/O bursts in seconds.
596 Maximum write speed in bytes per second.
598 `bps_wr_max_length`=`<seconds>` ;;
600 Maximum length of write I/O bursts in seconds.
602 `cache`=`<directsync | none | unsafe | writeback | writethrough>` ;;
604 The drive's cache mode
606 `cyls`=`<integer>` ;;
608 Force the drive's physical geometry to have a specific cylinder count.
610 `detect_zeroes`=`<boolean>` ;;
612 Controls whether to detect and try to optimize writes of zeroes.
614 `discard`=`<ignore | on>` ;;
616 Controls whether to pass discard/trim requests to the underlying storage.
620 The drive's backing volume.
622 `format`=`<cloop | cow | qcow | qcow2 | qed | raw | vmdk>` ;;
624 The drive's backing file's data format.
626 `heads`=`<integer>` ;;
628 Force the drive's physical geometry to have a specific head count.
632 Maximum r/w I/O in operations per second.
634 `iops_max`=`<iops>` ;;
636 Maximum unthrottled r/w I/O pool in operations per second.
638 `iops_max_length`=`<seconds>` ;;
640 Maximum length of I/O bursts in seconds.
642 `iops_rd`=`<iops>` ;;
644 Maximum read I/O in operations per second.
646 `iops_rd_max`=`<iops>` ;;
648 Maximum unthrottled read I/O pool in operations per second.
650 `iops_rd_max_length`=`<seconds>` ;;
652 Maximum length of read I/O bursts in seconds.
654 `iops_wr`=`<iops>` ;;
656 Maximum write I/O in operations per second.
658 `iops_wr_max`=`<iops>` ;;
660 Maximum unthrottled write I/O pool in operations per second.
662 `iops_wr_max_length`=`<seconds>` ;;
664 Maximum length of write I/O bursts in seconds.
668 Maximum r/w speed in megabytes per second.
670 `mbps_max`=`<mbps>` ;;
672 Maximum unthrottled r/w pool in megabytes per second.
674 `mbps_rd`=`<mbps>` ;;
676 Maximum read speed in megabytes per second.
678 `mbps_rd_max`=`<mbps>` ;;
680 Maximum unthrottled read pool in megabytes per second.
682 `mbps_wr`=`<mbps>` ;;
684 Maximum write speed in megabytes per second.
686 `mbps_wr_max`=`<mbps>` ;;
688 Maximum unthrottled write pool in megabytes per second.
690 `media`=`<cdrom | disk>` ('default =' `disk`);;
692 The drive's media type.
694 `replicate`=`<boolean>` ('default =' `1`);;
696 Whether the drive should considered for replication jobs.
698 `rerror`=`<ignore | report | stop>` ;;
702 `secs`=`<integer>` ;;
704 Force the drive's physical geometry to have a specific sector count.
706 `serial`=`<serial>` ;;
708 The drive's reported serial number, url-encoded, up to 20 bytes long.
710 `shared`=`<boolean>` ('default =' `0`);;
712 Mark this locally-managed volume as available on all nodes.
714 WARNING: This option does not share the volume automatically, it assumes it is shared already!
716 `size`=`<DiskSize>` ;;
718 Disk size. This is purely informational and has no effect.
720 `snapshot`=`<boolean>` ;;
722 Controls qemu's snapshot mode feature. If activated, changes made to the disk are temporary and will be discarded when the VM is shutdown.
726 Whether to expose this drive as an SSD, rather than a rotational hard disk.
728 `trans`=`<auto | lba | none>` ;;
730 Force disk geometry bios translation mode.
732 `werror`=`<enospc | ignore | report | stop>` ;;
738 The drive's worldwide name, encoded as 16 bytes hex string, prefixed by '0x'.
740 `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>] [,wwn=<wwn>]` ::
742 Use volume as SCSI hard disk or CD-ROM (n is 0 to 13).
744 `aio`=`<native | threads>` ;;
748 `backup`=`<boolean>` ;;
750 Whether the drive should be included when making backups.
754 Maximum r/w speed in bytes per second.
756 `bps_max_length`=`<seconds>` ;;
758 Maximum length of I/O bursts in seconds.
762 Maximum read speed in bytes per second.
764 `bps_rd_max_length`=`<seconds>` ;;
766 Maximum length of read I/O bursts in seconds.
770 Maximum write speed in bytes per second.
772 `bps_wr_max_length`=`<seconds>` ;;
774 Maximum length of write I/O bursts in seconds.
776 `cache`=`<directsync | none | unsafe | writeback | writethrough>` ;;
778 The drive's cache mode
780 `cyls`=`<integer>` ;;
782 Force the drive's physical geometry to have a specific cylinder count.
784 `detect_zeroes`=`<boolean>` ;;
786 Controls whether to detect and try to optimize writes of zeroes.
788 `discard`=`<ignore | on>` ;;
790 Controls whether to pass discard/trim requests to the underlying storage.
794 The drive's backing volume.
796 `format`=`<cloop | cow | qcow | qcow2 | qed | raw | vmdk>` ;;
798 The drive's backing file's data format.
800 `heads`=`<integer>` ;;
802 Force the drive's physical geometry to have a specific head count.
806 Maximum r/w I/O in operations per second.
808 `iops_max`=`<iops>` ;;
810 Maximum unthrottled r/w I/O pool in operations per second.
812 `iops_max_length`=`<seconds>` ;;
814 Maximum length of I/O bursts in seconds.
816 `iops_rd`=`<iops>` ;;
818 Maximum read I/O in operations per second.
820 `iops_rd_max`=`<iops>` ;;
822 Maximum unthrottled read I/O pool in operations per second.
824 `iops_rd_max_length`=`<seconds>` ;;
826 Maximum length of read I/O bursts in seconds.
828 `iops_wr`=`<iops>` ;;
830 Maximum write I/O in operations per second.
832 `iops_wr_max`=`<iops>` ;;
834 Maximum unthrottled write I/O pool in operations per second.
836 `iops_wr_max_length`=`<seconds>` ;;
838 Maximum length of write I/O bursts in seconds.
840 `iothread`=`<boolean>` ;;
842 Whether to use iothreads for this drive
846 Maximum r/w speed in megabytes per second.
848 `mbps_max`=`<mbps>` ;;
850 Maximum unthrottled r/w pool in megabytes per second.
852 `mbps_rd`=`<mbps>` ;;
854 Maximum read speed in megabytes per second.
856 `mbps_rd_max`=`<mbps>` ;;
858 Maximum unthrottled read pool in megabytes per second.
860 `mbps_wr`=`<mbps>` ;;
862 Maximum write speed in megabytes per second.
864 `mbps_wr_max`=`<mbps>` ;;
866 Maximum unthrottled write pool in megabytes per second.
868 `media`=`<cdrom | disk>` ('default =' `disk`);;
870 The drive's media type.
872 `queues`=`<integer> (2 - N)` ;;
876 `replicate`=`<boolean>` ('default =' `1`);;
878 Whether the drive should considered for replication jobs.
880 `rerror`=`<ignore | report | stop>` ;;
884 `scsiblock`=`<boolean>` ('default =' `0`);;
886 whether to use scsi-block for full passthrough of host block device
888 WARNING: can lead to I/O errors in combination with low memory or high memory fragmentation on host
890 `secs`=`<integer>` ;;
892 Force the drive's physical geometry to have a specific sector count.
894 `serial`=`<serial>` ;;
896 The drive's reported serial number, url-encoded, up to 20 bytes long.
898 `shared`=`<boolean>` ('default =' `0`);;
900 Mark this locally-managed volume as available on all nodes.
902 WARNING: This option does not share the volume automatically, it assumes it is shared already!
904 `size`=`<DiskSize>` ;;
906 Disk size. This is purely informational and has no effect.
908 `snapshot`=`<boolean>` ;;
910 Controls qemu's snapshot mode feature. If activated, changes made to the disk are temporary and will be discarded when the VM is shutdown.
914 Whether to expose this drive as an SSD, rather than a rotational hard disk.
916 `trans`=`<auto | lba | none>` ;;
918 Force disk geometry bios translation mode.
920 `werror`=`<enospc | ignore | report | stop>` ;;
926 The drive's worldwide name, encoded as 16 bytes hex string, prefixed by '0x'.
928 `scsihw`: `<lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single>` ('default =' `lsi`)::
930 SCSI controller model
932 `searchdomain`: `<string>` ::
934 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.
936 `serial[n]`: `(/dev/.+|socket)` ::
938 Create a serial device inside the VM (n is 0 to 3), and pass through a
939 host serial device (i.e. /dev/ttyS0), or create a unix socket on the
940 host side (use 'qm terminal' to open a terminal connection).
942 NOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care.
944 CAUTION: Experimental! User reported problems with this option.
946 `shares`: `<integer> (0 - 50000)` ('default =' `1000`)::
948 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.
950 `smbios1`: `[base64=<1|0>] [,family=<Base64 encoded string>] [,manufacturer=<Base64 encoded string>] [,product=<Base64 encoded string>] [,serial=<Base64 encoded string>] [,sku=<Base64 encoded string>] [,uuid=<UUID>] [,version=<Base64 encoded string>]` ::
952 Specify SMBIOS type 1 fields.
954 `base64`=`<boolean>` ;;
956 Flag to indicate that the SMBIOS values are base64 encoded
958 `family`=`<Base64 encoded string>` ;;
960 Set SMBIOS1 family string.
962 `manufacturer`=`<Base64 encoded string>` ;;
964 Set SMBIOS1 manufacturer.
966 `product`=`<Base64 encoded string>` ;;
968 Set SMBIOS1 product ID.
970 `serial`=`<Base64 encoded string>` ;;
972 Set SMBIOS1 serial number.
974 `sku`=`<Base64 encoded string>` ;;
976 Set SMBIOS1 SKU string.
982 `version`=`<Base64 encoded string>` ;;
986 `smp`: `<integer> (1 - N)` ('default =' `1`)::
988 The number of CPUs. Please use option -sockets instead.
990 `sockets`: `<integer> (1 - N)` ('default =' `1`)::
992 The number of CPU sockets.
994 `sshkeys`: `<string>` ::
996 cloud-init: Setup public SSH keys (one key per line, OpenSSH format).
998 `startdate`: `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` ('default =' `now`)::
1000 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'.
1002 `startup`: `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
1004 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.
1006 `tablet`: `<boolean>` ('default =' `1`)::
1008 Enable/disable the USB tablet device. This device is usually needed to allow absolute mouse positioning with VNC. Else the mouse runs out of sync with normal VNC clients. If you're running lots of console-only guests on one host, you may consider disabling this to save some context switches. This is turned off by default if you use spice (-vga=qxl).
1010 `tdf`: `<boolean>` ('default =' `0`)::
1012 Enable/disable time drift fix.
1014 `template`: `<boolean>` ('default =' `0`)::
1016 Enable/disable Template.
1018 `unused[n]`: `<string>` ::
1020 Reference to unused volumes. This is used internally, and should not be modified manually.
1022 `usb[n]`: `[host=]<HOSTUSBDEVICE|spice> [,usb3=<1|0>]` ::
1024 Configure an USB device (n is 0 to 4).
1026 `host`=`<HOSTUSBDEVICE|spice>` ;;
1028 The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is:
1030 'bus-port(.port)*' (decimal numbers) or
1031 'vendor_id:product_id' (hexadeciaml numbers) or
1034 You can use the 'lsusb -t' command to list existing usb devices.
1036 NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.
1038 The value 'spice' can be used to add a usb redirection devices for spice.
1040 `usb3`=`<boolean>` ('default =' `0`);;
1042 Specifies whether if given host option is a USB3 device or port (this does currently not work reliably with spice redirection and is then ignored).
1044 `vcpus`: `<integer> (1 - N)` ('default =' `0`)::
1046 Number of hotplugged vcpus.
1048 `vga`: `[[type=]<enum>] [,memory=<integer>]` ::
1050 Configure the VGA Hardware. If you want to use high resolution modes (>= 1280x1024x16) you may need to increase the vga memory option. Since QEMU 2.9 the default VGA display type is 'std' for all OS types besides some Windows versions (XP and older) which use 'cirrus'. The 'qxl' option enables the SPICE display server. For win* OS you can select how many independent displays you want, Linux guests can add displays them self.
1051 You can also run without any graphic card, using a serial device as terminal.
1053 `memory`=`<integer> (4 - 512)` ;;
1055 Sets the VGA memory (in MiB). Has no effect with serial display.
1057 `type`=`<cirrus | none | qxl | qxl2 | qxl3 | qxl4 | serial0 | serial1 | serial2 | serial3 | std | virtio | vmware>` ('default =' `std`);;
1059 Select the VGA type.
1061 `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>]` ::
1063 Use volume as VIRTIO hard disk (n is 0 to 15).
1065 `aio`=`<native | threads>` ;;
1069 `backup`=`<boolean>` ;;
1071 Whether the drive should be included when making backups.
1075 Maximum r/w speed in bytes per second.
1077 `bps_max_length`=`<seconds>` ;;
1079 Maximum length of I/O bursts in seconds.
1083 Maximum read speed in bytes per second.
1085 `bps_rd_max_length`=`<seconds>` ;;
1087 Maximum length of read I/O bursts in seconds.
1091 Maximum write speed in bytes per second.
1093 `bps_wr_max_length`=`<seconds>` ;;
1095 Maximum length of write I/O bursts in seconds.
1097 `cache`=`<directsync | none | unsafe | writeback | writethrough>` ;;
1099 The drive's cache mode
1101 `cyls`=`<integer>` ;;
1103 Force the drive's physical geometry to have a specific cylinder count.
1105 `detect_zeroes`=`<boolean>` ;;
1107 Controls whether to detect and try to optimize writes of zeroes.
1109 `discard`=`<ignore | on>` ;;
1111 Controls whether to pass discard/trim requests to the underlying storage.
1113 `file`=`<volume>` ;;
1115 The drive's backing volume.
1117 `format`=`<cloop | cow | qcow | qcow2 | qed | raw | vmdk>` ;;
1119 The drive's backing file's data format.
1121 `heads`=`<integer>` ;;
1123 Force the drive's physical geometry to have a specific head count.
1127 Maximum r/w I/O in operations per second.
1129 `iops_max`=`<iops>` ;;
1131 Maximum unthrottled r/w I/O pool in operations per second.
1133 `iops_max_length`=`<seconds>` ;;
1135 Maximum length of I/O bursts in seconds.
1137 `iops_rd`=`<iops>` ;;
1139 Maximum read I/O in operations per second.
1141 `iops_rd_max`=`<iops>` ;;
1143 Maximum unthrottled read I/O pool in operations per second.
1145 `iops_rd_max_length`=`<seconds>` ;;
1147 Maximum length of read I/O bursts in seconds.
1149 `iops_wr`=`<iops>` ;;
1151 Maximum write I/O in operations per second.
1153 `iops_wr_max`=`<iops>` ;;
1155 Maximum unthrottled write I/O pool in operations per second.
1157 `iops_wr_max_length`=`<seconds>` ;;
1159 Maximum length of write I/O bursts in seconds.
1161 `iothread`=`<boolean>` ;;
1163 Whether to use iothreads for this drive
1167 Maximum r/w speed in megabytes per second.
1169 `mbps_max`=`<mbps>` ;;
1171 Maximum unthrottled r/w pool in megabytes per second.
1173 `mbps_rd`=`<mbps>` ;;
1175 Maximum read speed in megabytes per second.
1177 `mbps_rd_max`=`<mbps>` ;;
1179 Maximum unthrottled read pool in megabytes per second.
1181 `mbps_wr`=`<mbps>` ;;
1183 Maximum write speed in megabytes per second.
1185 `mbps_wr_max`=`<mbps>` ;;
1187 Maximum unthrottled write pool in megabytes per second.
1189 `media`=`<cdrom | disk>` ('default =' `disk`);;
1191 The drive's media type.
1193 `replicate`=`<boolean>` ('default =' `1`);;
1195 Whether the drive should considered for replication jobs.
1197 `rerror`=`<ignore | report | stop>` ;;
1201 `secs`=`<integer>` ;;
1203 Force the drive's physical geometry to have a specific sector count.
1205 `serial`=`<serial>` ;;
1207 The drive's reported serial number, url-encoded, up to 20 bytes long.
1209 `shared`=`<boolean>` ('default =' `0`);;
1211 Mark this locally-managed volume as available on all nodes.
1213 WARNING: This option does not share the volume automatically, it assumes it is shared already!
1215 `size`=`<DiskSize>` ;;
1217 Disk size. This is purely informational and has no effect.
1219 `snapshot`=`<boolean>` ;;
1221 Controls qemu's snapshot mode feature. If activated, changes made to the disk are temporary and will be discarded when the VM is shutdown.
1223 `trans`=`<auto | lba | none>` ;;
1225 Force disk geometry bios translation mode.
1227 `werror`=`<enospc | ignore | report | stop>` ;;
1231 `vmgenid`: `<UUID>` ('default =' `1 (autogenerated)`)::
1233 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.
1234 Note that auto-creation only works when done throug API/CLI create or update methods, but not when manually editing the config file.
1236 `vmstatestorage`: `<string>` ::
1238 Default storage for VM state volumes/files.
1240 `watchdog`: `[[model=]<i6300esb|ib700>] [,action=<enum>]` ::
1242 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)
1244 `action`=`<debug | none | pause | poweroff | reset | shutdown>` ;;
1246 The action to perform if after activation the guest fails to poll the watchdog in time.
1248 `model`=`<i6300esb | ib700>` ('default =' `i6300esb`);;
1250 Watchdog type to emulate.