You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

qm.1-synopsis.adoc 42KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355
  1. *qm* `<COMMAND> [ARGS] [OPTIONS]`
  2. *qm agent*
  3. An alias for 'qm guest cmd'.
  4. *qm cleanup* `<vmid> <clean-shutdown> <guest-requested>`
  5. Cleans up resources like tap devices, vgpus, etc. Called after a vm shuts
  6. down, crashes, etc.
  7. `<vmid>`: `<integer> (1 - N)` ::
  8. The (unique) ID of the VM.
  9. `<clean-shutdown>`: `<boolean>` ::
  10. Indicates if qemu shutdown cleanly.
  11. `<guest-requested>`: `<boolean>` ::
  12. Indicates if the shutdown was requested by the guest or via qmp.
  13. *qm clone* `<vmid> <newid>` `[OPTIONS]`
  14. Create a copy of virtual machine/template.
  15. `<vmid>`: `<integer> (1 - N)` ::
  16. The (unique) ID of the VM.
  17. `<newid>`: `<integer> (1 - N)` ::
  18. VMID for the clone.
  19. `--bwlimit` `<integer> (0 - N)` ('default =' `clone limit from datacenter or storage config`)::
  20. Override I/O bandwidth limit (in KiB/s).
  21. `--description` `<string>` ::
  22. Description for the new VM.
  23. `--format` `<qcow2 | raw | vmdk>` ::
  24. Target format for file storage. Only valid for full clone.
  25. `--full` `<boolean>` ::
  26. 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.
  27. `--name` `<string>` ::
  28. Set a name for the new VM.
  29. `--pool` `<string>` ::
  30. Add the new VM to the specified pool.
  31. `--snapname` `<string>` ::
  32. The name of the snapshot.
  33. `--storage` `<string>` ::
  34. Target storage for full clone.
  35. `--target` `<string>` ::
  36. Target node. Only allowed if the original VM is on shared storage.
  37. *qm cloudinit dump* `<vmid> <type>`
  38. Get automatically generated cloudinit config.
  39. `<vmid>`: `<integer> (1 - N)` ::
  40. The (unique) ID of the VM.
  41. `<type>`: `<meta | network | user>` ::
  42. Config type.
  43. *qm config* `<vmid>` `[OPTIONS]`
  44. Get current virtual machine configuration. This does not include pending
  45. configuration changes (see 'pending' API).
  46. `<vmid>`: `<integer> (1 - N)` ::
  47. The (unique) ID of the VM.
  48. `--current` `<boolean>` ('default =' `0`)::
  49. Get current values (instead of pending values).
  50. `--snapshot` `<string>` ::
  51. Fetch config values from given snapshot.
  52. *qm create* `<vmid>` `[OPTIONS]`
  53. Create or restore a virtual machine.
  54. `<vmid>`: `<integer> (1 - N)` ::
  55. The (unique) ID of the VM.
  56. `--acpi` `<boolean>` ('default =' `1`)::
  57. Enable/disable ACPI.
  58. `--agent` `[enabled=]<1|0> [,fstrim_cloned_disks=<1|0>]` ::
  59. Enable/disable Qemu GuestAgent and its properties.
  60. `--arch` `<aarch64 | x86_64>` ::
  61. Virtual processor architecture. Defaults to the host.
  62. `--archive` `<string>` ::
  63. The backup file.
  64. `--args` `<string>` ::
  65. Arbitrary arguments passed to kvm.
  66. `--audio0` `device=<ich9-intel-hda|intel-hda|AC97> [,driver=<spice>]` ::
  67. Configure a audio device, useful in combination with QXL/Spice.
  68. `--autostart` `<boolean>` ('default =' `0`)::
  69. Automatic restart after crash (currently ignored).
  70. `--balloon` `<integer> (0 - N)` ::
  71. Amount of target RAM for the VM in MB. Using zero disables the ballon driver.
  72. `--bios` `<ovmf | seabios>` ('default =' `seabios`)::
  73. Select BIOS implementation.
  74. `--boot` `[acdn]{1,4}` ('default =' `cdn`)::
  75. Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).
  76. `--bootdisk` `(ide|sata|scsi|virtio)\d+` ::
  77. Enable booting from specified disk.
  78. `--bwlimit` `<integer> (0 - N)` ('default =' `restore limit from datacenter or storage config`)::
  79. Override I/O bandwidth limit (in KiB/s).
  80. `--cdrom` `<volume>` ::
  81. This is an alias for option -ide2
  82. `--cicustom` `[meta=<volume>] [,network=<volume>] [,user=<volume>]` ::
  83. cloud-init: Specify custom files to replace the automatically generated ones at start.
  84. `--cipassword` `<password>` ::
  85. 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.
  86. `--citype` `<configdrive2 | nocloud>` ::
  87. 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.
  88. `--ciuser` `<string>` ::
  89. cloud-init: User name to change ssh keys and password for instead of the image's configured default user.
  90. `--cores` `<integer> (1 - N)` ('default =' `1`)::
  91. The number of cores per socket.
  92. `--cpu` `[cputype=]<enum> [,flags=<+FLAG[;-FLAG...]>] [,hidden=<1|0>] [,hv-vendor-id=<vendor-id>]` ::
  93. Emulated CPU type.
  94. `--cpulimit` `<number> (0 - 128)` ('default =' `0`)::
  95. Limit of CPU usage.
  96. `--cpuunits` `<integer> (2 - 262144)` ('default =' `1024`)::
  97. CPU weight for a VM.
  98. `--description` `<string>` ::
  99. Description for the VM. Only used on the configuration web interface. This is saved as comment inside the configuration file.
  100. `--efidisk0` `[file=]<volume> [,format=<enum>] [,size=<DiskSize>]` ::
  101. Configure a Disk for storing EFI vars
  102. `--force` `<boolean>` ::
  103. Allow to overwrite existing VM.
  104. +
  105. NOTE: Requires option(s): `archive`
  106. `--freeze` `<boolean>` ::
  107. Freeze CPU at startup (use 'c' monitor command to start execution).
  108. `--hookscript` `<string>` ::
  109. Script that will be executed during various steps in the vms lifetime.
  110. `--hostpci[n]` `[host=]<HOSTPCIID[;HOSTPCIID2...]> [,mdev=<string>] [,pcie=<1|0>] [,rombar=<1|0>] [,romfile=<string>] [,x-vga=<1|0>]` ::
  111. Map host PCI devices into guest.
  112. `--hotplug` `<string>` ('default =' `network,disk,usb`)::
  113. 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'.
  114. `--hugepages` `<1024 | 2 | any>` ::
  115. Enable/disable hugepages memory.
  116. `--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>]` ::
  117. Use volume as IDE hard disk or CD-ROM (n is 0 to 3).
  118. `--ipconfig[n]` `[gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>]` ::
  119. cloud-init: Specify IP addresses and gateways for the corresponding interface.
  120. +
  121. IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.
  122. +
  123. The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.
  124. For IPv6 the special string 'auto' can be used to use stateless autoconfiguration.
  125. +
  126. If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.
  127. `--ivshmem` `size=<integer> [,name=<string>]` ::
  128. Inter-VM shared memory. Useful for direct communication between VMs, or to the host.
  129. `--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>` ::
  130. Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.It should not be necessary to set it.
  131. `--kvm` `<boolean>` ('default =' `1`)::
  132. Enable/disable KVM hardware virtualization.
  133. `--localtime` `<boolean>` ::
  134. Set the real time clock to local time. This is enabled by default if ostype indicates a Microsoft OS.
  135. `--lock` `<backup | clone | create | migrate | rollback | snapshot | snapshot-delete | suspended | suspending>` ::
  136. Lock/unlock the VM.
  137. `--machine` `(pc|pc(-i440fx)?-\d+(\.\d+)+(\.pxe)?|q35|pc-q35-\d+(\.\d+)+(\.pxe)?|virt(?:-\d+(\.\d+)+)?)` ::
  138. Specifies the Qemu machine type.
  139. `--memory` `<integer> (16 - N)` ('default =' `512`)::
  140. Amount of RAM for the VM in MB. This is the maximum available memory when you use the balloon device.
  141. `--migrate_downtime` `<number> (0 - N)` ('default =' `0.1`)::
  142. Set maximum tolerated downtime (in seconds) for migrations.
  143. `--migrate_speed` `<integer> (0 - N)` ('default =' `0`)::
  144. Set maximum speed (in MB/s) for migrations. Value 0 is no limit.
  145. `--name` `<string>` ::
  146. Set a name for the VM. Only used on the configuration web interface.
  147. `--nameserver` `<string>` ::
  148. 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.
  149. `--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>]` ::
  150. Specify network devices.
  151. `--numa` `<boolean>` ('default =' `0`)::
  152. Enable/disable NUMA.
  153. `--numa[n]` `cpus=<id[-id];...> [,hostnodes=<id[-id];...>] [,memory=<number>] [,policy=<preferred|bind|interleave>]` ::
  154. NUMA topology.
  155. `--onboot` `<boolean>` ('default =' `0`)::
  156. Specifies whether a VM will be started during system bootup.
  157. `--ostype` `<l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win10 | win7 | win8 | wvista | wxp>` ::
  158. Specify guest operating system.
  159. `--parallel[n]` `/dev/parport\d+|/dev/usb/lp\d+` ::
  160. Map host parallel devices (n is 0 to 2).
  161. `--pool` `<string>` ::
  162. Add the VM to the specified pool.
  163. `--protection` `<boolean>` ('default =' `0`)::
  164. Sets the protection flag of the VM. This will disable the remove VM and remove disk operations.
  165. `--reboot` `<boolean>` ('default =' `1`)::
  166. Allow reboot. If set to '0' the VM exit on reboot.
  167. `--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>]` ::
  168. Use volume as SATA hard disk or CD-ROM (n is 0 to 5).
  169. `--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>]` ::
  170. Use volume as SCSI hard disk or CD-ROM (n is 0 to 13).
  171. `--scsihw` `<lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single>` ('default =' `lsi`)::
  172. SCSI controller model
  173. `--searchdomain` `<string>` ::
  174. 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.
  175. `--serial[n]` `(/dev/.+|socket)` ::
  176. Create a serial device inside the VM (n is 0 to 3)
  177. `--shares` `<integer> (0 - 50000)` ('default =' `1000`)::
  178. 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.
  179. `--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>]` ::
  180. Specify SMBIOS type 1 fields.
  181. `--smp` `<integer> (1 - N)` ('default =' `1`)::
  182. The number of CPUs. Please use option -sockets instead.
  183. `--sockets` `<integer> (1 - N)` ('default =' `1`)::
  184. The number of CPU sockets.
  185. `--spice_enhancements` `[foldersharing=<1|0>] [,videostreaming=<off|all|filter>]` ::
  186. Configure additional enhancements for SPICE.
  187. `--sshkeys` `<filepath>` ::
  188. cloud-init: Setup public SSH keys (one key per line, OpenSSH format).
  189. `--start` `<boolean>` ('default =' `0`)::
  190. Start VM after it was created successfully.
  191. `--startdate` `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` ('default =' `now`)::
  192. 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'.
  193. `--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
  194. 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.
  195. `--storage` `<string>` ::
  196. Default storage.
  197. `--tablet` `<boolean>` ('default =' `1`)::
  198. Enable/disable the USB tablet device.
  199. `--tdf` `<boolean>` ('default =' `0`)::
  200. Enable/disable time drift fix.
  201. `--template` `<boolean>` ('default =' `0`)::
  202. Enable/disable Template.
  203. `--unique` `<boolean>` ::
  204. Assign a unique random ethernet address.
  205. +
  206. NOTE: Requires option(s): `archive`
  207. `--unused[n]` `<string>` ::
  208. Reference to unused volumes. This is used internally, and should not be modified manually.
  209. `--usb[n]` `[host=]<HOSTUSBDEVICE|spice> [,usb3=<1|0>]` ::
  210. Configure an USB device (n is 0 to 4).
  211. `--vcpus` `<integer> (1 - N)` ('default =' `0`)::
  212. Number of hotplugged vcpus.
  213. `--vga` `[[type=]<enum>] [,memory=<integer>]` ::
  214. Configure the VGA hardware.
  215. `--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>]` ::
  216. Use volume as VIRTIO hard disk (n is 0 to 15).
  217. `--vmgenid` `<UUID>` ('default =' `1 (autogenerated)`)::
  218. Set VM Generation ID. Use '1' to autogenerate on create or update, pass '0' to disable explicitly.
  219. `--vmstatestorage` `<string>` ::
  220. Default storage for VM state volumes/files.
  221. `--watchdog` `[[model=]<i6300esb|ib700>] [,action=<enum>]` ::
  222. Create a virtual hardware watchdog device.
  223. *qm delsnapshot* `<vmid> <snapname>` `[OPTIONS]`
  224. Delete a VM snapshot.
  225. `<vmid>`: `<integer> (1 - N)` ::
  226. The (unique) ID of the VM.
  227. `<snapname>`: `<string>` ::
  228. The name of the snapshot.
  229. `--force` `<boolean>` ::
  230. For removal from config file, even if removing disk snapshots fails.
  231. *qm destroy* `<vmid>` `[OPTIONS]`
  232. Destroy the vm (also delete all used/owned volumes).
  233. `<vmid>`: `<integer> (1 - N)` ::
  234. The (unique) ID of the VM.
  235. `--purge` `<boolean>` ::
  236. Remove vmid from backup cron jobs.
  237. `--skiplock` `<boolean>` ::
  238. Ignore locks - only root is allowed to use this option.
  239. *qm guest cmd* `<vmid> <command>`
  240. Execute Qemu Guest Agent commands.
  241. `<vmid>`: `<integer> (1 - N)` ::
  242. The (unique) ID of the VM.
  243. `<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>` ::
  244. The QGA command.
  245. *qm guest exec* `<vmid> [<extra-args>]` `[OPTIONS]`
  246. Executes the given command via the guest agent
  247. `<vmid>`: `<integer> (1 - N)` ::
  248. The (unique) ID of the VM.
  249. `<extra-args>`: `<array>` ::
  250. Extra arguments as array
  251. `--synchronous` `<boolean>` ('default =' `1`)::
  252. If set to off, returns the pid immediately instead of waiting for the commmand to finish or the timeout.
  253. `--timeout` `<integer> (0 - N)` ('default =' `30`)::
  254. The maximum time to wait synchronously for the command to finish. If reached, the pid gets returned. Set to 0 to deactivate
  255. *qm guest exec-status* `<vmid> <pid>`
  256. Gets the status of the given pid started by the guest-agent
  257. `<vmid>`: `<integer> (1 - N)` ::
  258. The (unique) ID of the VM.
  259. `<pid>`: `<integer>` ::
  260. The PID to query
  261. *qm guest passwd* `<vmid> <username>` `[OPTIONS]`
  262. Sets the password for the given user to the given password
  263. `<vmid>`: `<integer> (1 - N)` ::
  264. The (unique) ID of the VM.
  265. `<username>`: `<string>` ::
  266. The user to set the password for.
  267. `--crypted` `<boolean>` ('default =' `0`)::
  268. set to 1 if the password has already been passed through crypt()
  269. *qm help* `[OPTIONS]`
  270. Get help about specified command.
  271. `--extra-args` `<array>` ::
  272. Shows help for a specific command
  273. `--verbose` `<boolean>` ::
  274. Verbose output format.
  275. *qm importdisk* `<vmid> <source> <storage>` `[OPTIONS]`
  276. Import an external disk image as an unused disk in a VM. The
  277. image format has to be supported by qemu-img(1).
  278. `<vmid>`: `<integer> (1 - N)` ::
  279. The (unique) ID of the VM.
  280. `<source>`: `<string>` ::
  281. Path to the disk image to import
  282. `<storage>`: `<string>` ::
  283. Target storage ID
  284. `--format` `<qcow2 | raw | vmdk>` ::
  285. Target format
  286. *qm importovf* `<vmid> <manifest> <storage>` `[OPTIONS]`
  287. Create a new VM using parameters read from an OVF manifest
  288. `<vmid>`: `<integer> (1 - N)` ::
  289. The (unique) ID of the VM.
  290. `<manifest>`: `<string>` ::
  291. path to the ovf file
  292. `<storage>`: `<string>` ::
  293. Target storage ID
  294. `--dryrun` `<boolean>` ::
  295. Print a parsed representation of the extracted OVF parameters, but do not create a VM
  296. `--format` `<qcow2 | raw | vmdk>` ::
  297. Target format
  298. *qm list* `[OPTIONS]`
  299. Virtual machine index (per node).
  300. `--full` `<boolean>` ::
  301. Determine the full status of active VMs.
  302. *qm listsnapshot* `<vmid>`
  303. List all snapshots.
  304. `<vmid>`: `<integer> (1 - N)` ::
  305. The (unique) ID of the VM.
  306. *qm migrate* `<vmid> <target>` `[OPTIONS]`
  307. Migrate virtual machine. Creates a new migration task.
  308. `<vmid>`: `<integer> (1 - N)` ::
  309. The (unique) ID of the VM.
  310. `<target>`: `<string>` ::
  311. Target node.
  312. `--bwlimit` `<integer> (0 - N)` ('default =' `migrate limit from datacenter or storage config`)::
  313. Override I/O bandwidth limit (in KiB/s).
  314. `--force` `<boolean>` ::
  315. Allow to migrate VMs which use local devices. Only root may use this option.
  316. `--migration_network` `<string>` ::
  317. CIDR of the (sub) network that is used for migration.
  318. `--migration_type` `<insecure | secure>` ::
  319. Migration traffic is encrypted using an SSH tunnel by default. On secure, completely private networks this can be disabled to increase performance.
  320. `--online` `<boolean>` ::
  321. Use online/live migration if VM is running. Ignored if VM is stopped.
  322. `--targetstorage` `<string>` ::
  323. Default target storage.
  324. `--with-local-disks` `<boolean>` ::
  325. Enable live storage migration for local disk
  326. *qm monitor* `<vmid>`
  327. Enter Qemu Monitor interface.
  328. `<vmid>`: `<integer> (1 - N)` ::
  329. The (unique) ID of the VM.
  330. *qm move_disk* `<vmid> <disk> <storage>` `[OPTIONS]`
  331. Move volume to different storage.
  332. `<vmid>`: `<integer> (1 - N)` ::
  333. The (unique) ID of the VM.
  334. `<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>` ::
  335. The disk you want to move.
  336. `<storage>`: `<string>` ::
  337. Target storage.
  338. `--bwlimit` `<integer> (0 - N)` ('default =' `move limit from datacenter or storage config`)::
  339. Override I/O bandwidth limit (in KiB/s).
  340. `--delete` `<boolean>` ('default =' `0`)::
  341. Delete the original disk after successful copy. By default the original disk is kept as unused disk.
  342. `--digest` `<string>` ::
  343. Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
  344. `--format` `<qcow2 | raw | vmdk>` ::
  345. Target Format.
  346. *qm mtunnel*
  347. Used by qmigrate - do not use manually.
  348. *qm nbdstop* `<vmid>`
  349. Stop embedded nbd server.
  350. `<vmid>`: `<integer> (1 - N)` ::
  351. The (unique) ID of the VM.
  352. *qm pending* `<vmid>`
  353. Get virtual machine configuration, including pending changes.
  354. `<vmid>`: `<integer> (1 - N)` ::
  355. The (unique) ID of the VM.
  356. *qm reboot* `<vmid>` `[OPTIONS]`
  357. Reboot the VM by shutting it down, and starting it again. Applies pending
  358. changes.
  359. `<vmid>`: `<integer> (1 - N)` ::
  360. The (unique) ID of the VM.
  361. `--timeout` `<integer> (0 - N)` ::
  362. Wait maximal timeout seconds for the shutdown.
  363. *qm rescan* `[OPTIONS]`
  364. Rescan all storages and update disk sizes and unused disk images.
  365. `--dryrun` `<boolean>` ('default =' `0`)::
  366. Do not actually write changes out to VM config(s).
  367. `--vmid` `<integer> (1 - N)` ::
  368. The (unique) ID of the VM.
  369. *qm reset* `<vmid>` `[OPTIONS]`
  370. Reset virtual machine.
  371. `<vmid>`: `<integer> (1 - N)` ::
  372. The (unique) ID of the VM.
  373. `--skiplock` `<boolean>` ::
  374. Ignore locks - only root is allowed to use this option.
  375. *qm resize* `<vmid> <disk> <size>` `[OPTIONS]`
  376. Extend volume size.
  377. `<vmid>`: `<integer> (1 - N)` ::
  378. The (unique) ID of the VM.
  379. `<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>` ::
  380. The disk you want to resize.
  381. `<size>`: `\+?\d+(\.\d+)?[KMGT]?` ::
  382. 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.
  383. `--digest` `<string>` ::
  384. Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
  385. `--skiplock` `<boolean>` ::
  386. Ignore locks - only root is allowed to use this option.
  387. *qm resume* `<vmid>` `[OPTIONS]`
  388. Resume virtual machine.
  389. `<vmid>`: `<integer> (1 - N)` ::
  390. The (unique) ID of the VM.
  391. `--nocheck` `<boolean>` ::
  392. no description available
  393. `--skiplock` `<boolean>` ::
  394. Ignore locks - only root is allowed to use this option.
  395. *qm rollback* `<vmid> <snapname>`
  396. Rollback VM state to specified snapshot.
  397. `<vmid>`: `<integer> (1 - N)` ::
  398. The (unique) ID of the VM.
  399. `<snapname>`: `<string>` ::
  400. The name of the snapshot.
  401. *qm sendkey* `<vmid> <key>` `[OPTIONS]`
  402. Send key event to virtual machine.
  403. `<vmid>`: `<integer> (1 - N)` ::
  404. The (unique) ID of the VM.
  405. `<key>`: `<string>` ::
  406. The key (qemu monitor encoding).
  407. `--skiplock` `<boolean>` ::
  408. Ignore locks - only root is allowed to use this option.
  409. *qm set* `<vmid>` `[OPTIONS]`
  410. Set virtual machine options (synchrounous API) - You should consider using
  411. the POST method instead for any actions involving hotplug or storage
  412. allocation.
  413. `<vmid>`: `<integer> (1 - N)` ::
  414. The (unique) ID of the VM.
  415. `--acpi` `<boolean>` ('default =' `1`)::
  416. Enable/disable ACPI.
  417. `--agent` `[enabled=]<1|0> [,fstrim_cloned_disks=<1|0>]` ::
  418. Enable/disable Qemu GuestAgent and its properties.
  419. `--arch` `<aarch64 | x86_64>` ::
  420. Virtual processor architecture. Defaults to the host.
  421. `--args` `<string>` ::
  422. Arbitrary arguments passed to kvm.
  423. `--audio0` `device=<ich9-intel-hda|intel-hda|AC97> [,driver=<spice>]` ::
  424. Configure a audio device, useful in combination with QXL/Spice.
  425. `--autostart` `<boolean>` ('default =' `0`)::
  426. Automatic restart after crash (currently ignored).
  427. `--balloon` `<integer> (0 - N)` ::
  428. Amount of target RAM for the VM in MB. Using zero disables the ballon driver.
  429. `--bios` `<ovmf | seabios>` ('default =' `seabios`)::
  430. Select BIOS implementation.
  431. `--boot` `[acdn]{1,4}` ('default =' `cdn`)::
  432. Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).
  433. `--bootdisk` `(ide|sata|scsi|virtio)\d+` ::
  434. Enable booting from specified disk.
  435. `--cdrom` `<volume>` ::
  436. This is an alias for option -ide2
  437. `--cicustom` `[meta=<volume>] [,network=<volume>] [,user=<volume>]` ::
  438. cloud-init: Specify custom files to replace the automatically generated ones at start.
  439. `--cipassword` `<password>` ::
  440. 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.
  441. `--citype` `<configdrive2 | nocloud>` ::
  442. 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.
  443. `--ciuser` `<string>` ::
  444. cloud-init: User name to change ssh keys and password for instead of the image's configured default user.
  445. `--cores` `<integer> (1 - N)` ('default =' `1`)::
  446. The number of cores per socket.
  447. `--cpu` `[cputype=]<enum> [,flags=<+FLAG[;-FLAG...]>] [,hidden=<1|0>] [,hv-vendor-id=<vendor-id>]` ::
  448. Emulated CPU type.
  449. `--cpulimit` `<number> (0 - 128)` ('default =' `0`)::
  450. Limit of CPU usage.
  451. `--cpuunits` `<integer> (2 - 262144)` ('default =' `1024`)::
  452. CPU weight for a VM.
  453. `--delete` `<string>` ::
  454. A list of settings you want to delete.
  455. `--description` `<string>` ::
  456. Description for the VM. Only used on the configuration web interface. This is saved as comment inside the configuration file.
  457. `--digest` `<string>` ::
  458. Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
  459. `--efidisk0` `[file=]<volume> [,format=<enum>] [,size=<DiskSize>]` ::
  460. Configure a Disk for storing EFI vars
  461. `--force` `<boolean>` ::
  462. 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.
  463. +
  464. NOTE: Requires option(s): `delete`
  465. `--freeze` `<boolean>` ::
  466. Freeze CPU at startup (use 'c' monitor command to start execution).
  467. `--hookscript` `<string>` ::
  468. Script that will be executed during various steps in the vms lifetime.
  469. `--hostpci[n]` `[host=]<HOSTPCIID[;HOSTPCIID2...]> [,mdev=<string>] [,pcie=<1|0>] [,rombar=<1|0>] [,romfile=<string>] [,x-vga=<1|0>]` ::
  470. Map host PCI devices into guest.
  471. `--hotplug` `<string>` ('default =' `network,disk,usb`)::
  472. 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'.
  473. `--hugepages` `<1024 | 2 | any>` ::
  474. Enable/disable hugepages memory.
  475. `--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>]` ::
  476. Use volume as IDE hard disk or CD-ROM (n is 0 to 3).
  477. `--ipconfig[n]` `[gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>]` ::
  478. cloud-init: Specify IP addresses and gateways for the corresponding interface.
  479. +
  480. IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.
  481. +
  482. The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.
  483. For IPv6 the special string 'auto' can be used to use stateless autoconfiguration.
  484. +
  485. If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.
  486. `--ivshmem` `size=<integer> [,name=<string>]` ::
  487. Inter-VM shared memory. Useful for direct communication between VMs, or to the host.
  488. `--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>` ::
  489. Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.It should not be necessary to set it.
  490. `--kvm` `<boolean>` ('default =' `1`)::
  491. Enable/disable KVM hardware virtualization.
  492. `--localtime` `<boolean>` ::
  493. Set the real time clock to local time. This is enabled by default if ostype indicates a Microsoft OS.
  494. `--lock` `<backup | clone | create | migrate | rollback | snapshot | snapshot-delete | suspended | suspending>` ::
  495. Lock/unlock the VM.
  496. `--machine` `(pc|pc(-i440fx)?-\d+(\.\d+)+(\.pxe)?|q35|pc-q35-\d+(\.\d+)+(\.pxe)?|virt(?:-\d+(\.\d+)+)?)` ::
  497. Specifies the Qemu machine type.
  498. `--memory` `<integer> (16 - N)` ('default =' `512`)::
  499. Amount of RAM for the VM in MB. This is the maximum available memory when you use the balloon device.
  500. `--migrate_downtime` `<number> (0 - N)` ('default =' `0.1`)::
  501. Set maximum tolerated downtime (in seconds) for migrations.
  502. `--migrate_speed` `<integer> (0 - N)` ('default =' `0`)::
  503. Set maximum speed (in MB/s) for migrations. Value 0 is no limit.
  504. `--name` `<string>` ::
  505. Set a name for the VM. Only used on the configuration web interface.
  506. `--nameserver` `<string>` ::
  507. 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.
  508. `--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>]` ::
  509. Specify network devices.
  510. `--numa` `<boolean>` ('default =' `0`)::
  511. Enable/disable NUMA.
  512. `--numa[n]` `cpus=<id[-id];...> [,hostnodes=<id[-id];...>] [,memory=<number>] [,policy=<preferred|bind|interleave>]` ::
  513. NUMA topology.
  514. `--onboot` `<boolean>` ('default =' `0`)::
  515. Specifies whether a VM will be started during system bootup.
  516. `--ostype` `<l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win10 | win7 | win8 | wvista | wxp>` ::
  517. Specify guest operating system.
  518. `--parallel[n]` `/dev/parport\d+|/dev/usb/lp\d+` ::
  519. Map host parallel devices (n is 0 to 2).
  520. `--protection` `<boolean>` ('default =' `0`)::
  521. Sets the protection flag of the VM. This will disable the remove VM and remove disk operations.
  522. `--reboot` `<boolean>` ('default =' `1`)::
  523. Allow reboot. If set to '0' the VM exit on reboot.
  524. `--revert` `<string>` ::
  525. Revert a pending change.
  526. `--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>]` ::
  527. Use volume as SATA hard disk or CD-ROM (n is 0 to 5).
  528. `--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>]` ::
  529. Use volume as SCSI hard disk or CD-ROM (n is 0 to 13).
  530. `--scsihw` `<lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single>` ('default =' `lsi`)::
  531. SCSI controller model
  532. `--searchdomain` `<string>` ::
  533. 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.
  534. `--serial[n]` `(/dev/.+|socket)` ::
  535. Create a serial device inside the VM (n is 0 to 3)
  536. `--shares` `<integer> (0 - 50000)` ('default =' `1000`)::
  537. 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.
  538. `--skiplock` `<boolean>` ::
  539. Ignore locks - only root is allowed to use this option.
  540. `--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>]` ::
  541. Specify SMBIOS type 1 fields.
  542. `--smp` `<integer> (1 - N)` ('default =' `1`)::
  543. The number of CPUs. Please use option -sockets instead.
  544. `--sockets` `<integer> (1 - N)` ('default =' `1`)::
  545. The number of CPU sockets.
  546. `--spice_enhancements` `[foldersharing=<1|0>] [,videostreaming=<off|all|filter>]` ::
  547. Configure additional enhancements for SPICE.
  548. `--sshkeys` `<filepath>` ::
  549. cloud-init: Setup public SSH keys (one key per line, OpenSSH format).
  550. `--startdate` `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` ('default =' `now`)::
  551. 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'.
  552. `--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
  553. 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.
  554. `--tablet` `<boolean>` ('default =' `1`)::
  555. Enable/disable the USB tablet device.
  556. `--tdf` `<boolean>` ('default =' `0`)::
  557. Enable/disable time drift fix.
  558. `--template` `<boolean>` ('default =' `0`)::
  559. Enable/disable Template.
  560. `--unused[n]` `<string>` ::
  561. Reference to unused volumes. This is used internally, and should not be modified manually.
  562. `--usb[n]` `[host=]<HOSTUSBDEVICE|spice> [,usb3=<1|0>]` ::
  563. Configure an USB device (n is 0 to 4).
  564. `--vcpus` `<integer> (1 - N)` ('default =' `0`)::
  565. Number of hotplugged vcpus.
  566. `--vga` `[[type=]<enum>] [,memory=<integer>]` ::
  567. Configure the VGA hardware.
  568. `--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>]` ::
  569. Use volume as VIRTIO hard disk (n is 0 to 15).
  570. `--vmgenid` `<UUID>` ('default =' `1 (autogenerated)`)::
  571. Set VM Generation ID. Use '1' to autogenerate on create or update, pass '0' to disable explicitly.
  572. `--vmstatestorage` `<string>` ::
  573. Default storage for VM state volumes/files.
  574. `--watchdog` `[[model=]<i6300esb|ib700>] [,action=<enum>]` ::
  575. Create a virtual hardware watchdog device.
  576. *qm showcmd* `<vmid>` `[OPTIONS]`
  577. Show command line which is used to start the VM (debug info).
  578. `<vmid>`: `<integer> (1 - N)` ::
  579. The (unique) ID of the VM.
  580. `--pretty` `<boolean>` ('default =' `0`)::
  581. Puts each option on a new line to enhance human readability
  582. `--snapshot` `<string>` ::
  583. Fetch config values from given snapshot.
  584. *qm shutdown* `<vmid>` `[OPTIONS]`
  585. Shutdown virtual machine. This is similar to pressing the power button on a
  586. physical machine.This will send an ACPI event for the guest OS, which
  587. should then proceed to a clean shutdown.
  588. `<vmid>`: `<integer> (1 - N)` ::
  589. The (unique) ID of the VM.
  590. `--forceStop` `<boolean>` ('default =' `0`)::
  591. Make sure the VM stops.
  592. `--keepActive` `<boolean>` ('default =' `0`)::
  593. Do not deactivate storage volumes.
  594. `--skiplock` `<boolean>` ::
  595. Ignore locks - only root is allowed to use this option.
  596. `--timeout` `<integer> (0 - N)` ::
  597. Wait maximal timeout seconds.
  598. *qm snapshot* `<vmid> <snapname>` `[OPTIONS]`
  599. Snapshot a VM.
  600. `<vmid>`: `<integer> (1 - N)` ::
  601. The (unique) ID of the VM.
  602. `<snapname>`: `<string>` ::
  603. The name of the snapshot.
  604. `--description` `<string>` ::
  605. A textual description or comment.
  606. `--vmstate` `<boolean>` ::
  607. Save the vmstate
  608. *qm start* `<vmid>` `[OPTIONS]`
  609. Start virtual machine.
  610. `<vmid>`: `<integer> (1 - N)` ::
  611. The (unique) ID of the VM.
  612. `--machine` `(pc|pc(-i440fx)?-\d+(\.\d+)+(\.pxe)?|q35|pc-q35-\d+(\.\d+)+(\.pxe)?|virt(?:-\d+(\.\d+)+)?)` ::
  613. Specifies the Qemu machine type.
  614. `--migratedfrom` `<string>` ::
  615. The cluster node name.
  616. `--migration_network` `<string>` ::
  617. CIDR of the (sub) network that is used for migration.
  618. `--migration_type` `<insecure | secure>` ::
  619. Migration traffic is encrypted using an SSH tunnel by default. On secure, completely private networks this can be disabled to increase performance.
  620. `--skiplock` `<boolean>` ::
  621. Ignore locks - only root is allowed to use this option.
  622. `--stateuri` `<string>` ::
  623. Some command save/restore state from this location.
  624. `--targetstorage` `<string>` ::
  625. Target storage for the migration. (Can be '1' to use the same storage id as on the source node.)
  626. *qm status* `<vmid>` `[OPTIONS]`
  627. Show VM status.
  628. `<vmid>`: `<integer> (1 - N)` ::
  629. The (unique) ID of the VM.
  630. `--verbose` `<boolean>` ::
  631. Verbose output format
  632. *qm stop* `<vmid>` `[OPTIONS]`
  633. Stop virtual machine. The qemu process will exit immediately. Thisis akin
  634. to pulling the power plug of a running computer and may damage the VM data
  635. `<vmid>`: `<integer> (1 - N)` ::
  636. The (unique) ID of the VM.
  637. `--keepActive` `<boolean>` ('default =' `0`)::
  638. Do not deactivate storage volumes.
  639. `--migratedfrom` `<string>` ::
  640. The cluster node name.
  641. `--skiplock` `<boolean>` ::
  642. Ignore locks - only root is allowed to use this option.
  643. `--timeout` `<integer> (0 - N)` ::
  644. Wait maximal timeout seconds.
  645. *qm suspend* `<vmid>` `[OPTIONS]`
  646. Suspend virtual machine.
  647. `<vmid>`: `<integer> (1 - N)` ::
  648. The (unique) ID of the VM.
  649. `--skiplock` `<boolean>` ::
  650. Ignore locks - only root is allowed to use this option.
  651. `--statestorage` `<string>` ::
  652. The storage for the VM state
  653. +
  654. NOTE: Requires option(s): `todisk`
  655. `--todisk` `<boolean>` ('default =' `0`)::
  656. If set, suspends the VM to disk. Will be resumed on next VM start.
  657. *qm template* `<vmid>` `[OPTIONS]`
  658. Create a Template.
  659. `<vmid>`: `<integer> (1 - N)` ::
  660. The (unique) ID of the VM.
  661. `--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>` ::
  662. If you want to convert only 1 disk to base image.
  663. *qm terminal* `<vmid>` `[OPTIONS]`
  664. Open a terminal using a serial device (The VM need to have a serial device
  665. configured, for example 'serial0: socket')
  666. `<vmid>`: `<integer> (1 - N)` ::
  667. The (unique) ID of the VM.
  668. `--escape` `<string>` ('default =' `^O`)::
  669. Escape character.
  670. `--iface` `<serial0 | serial1 | serial2 | serial3>` ::
  671. Select the serial device. By default we simply use the first suitable device.
  672. *qm unlink* `<vmid> --idlist <string>` `[OPTIONS]`
  673. Unlink/delete disk images.
  674. `<vmid>`: `<integer> (1 - N)` ::
  675. The (unique) ID of the VM.
  676. `--force` `<boolean>` ::
  677. 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.
  678. `--idlist` `<string>` ::
  679. A list of disk IDs you want to delete.
  680. *qm unlock* `<vmid>`
  681. Unlock the VM.
  682. `<vmid>`: `<integer> (1 - N)` ::
  683. The (unique) ID of the VM.
  684. *qm vncproxy* `<vmid>`
  685. Proxy VM VNC traffic to stdin/stdout
  686. `<vmid>`: `<integer> (1 - N)` ::
  687. The (unique) ID of the VM.
  688. *qm wait* `<vmid>` `[OPTIONS]`
  689. Wait until the VM is stopped.
  690. `<vmid>`: `<integer> (1 - N)` ::
  691. The (unique) ID of the VM.
  692. `--timeout` `<integer> (1 - N)` ::
  693. Timeout in seconds. Default is to wait forever.