USAGE: qm create [OPTIONS] Create or restore a virtual machine. (100 - 999999999) The (unique) ID of the VM. --acpi (default=1) Enable/disable ACPI. --affinity List of host cores used to execute guest processes, for example: 0,5,8-11 --agent [enabled=]<1|0> [,freeze-fs=<1|0>] [,fstrim_cloned_disks=<1|0>] [,type=] Enable/disable communication with the QEMU Guest Agent and its properties. --allow-ksm (default=1) Allow memory pages of this guest to be merged via KSM (Kernel Samepage Merging). --amd-sev [type=] [,allow-smt=<1|0>] [,kernel-hashes=<1|0>] [,no-debug=<1|0>] [,no-key-sharing=<1|0>] Secure Encrypted Virtualization (SEV) features by AMD CPUs --arch Virtual processor architecture. Defaults to the host architecture. --archive The backup archive. Either the file system path to a .tar or .vma file (use '-' to pipe data from stdin) or a proxmox storage backup volume identifier. --args Arbitrary arguments passed to kvm. --audio0 device= [,driver=] Configure a audio device, useful in combination with QXL/Spice. --autostart (default=0) Automatic restart after crash (currently ignored). --balloon (0 - N) Amount of target RAM for the VM in MiB. The balloon driver is enabled by default, unless it is explicitly disabled by setting the value to zero. --bios (default=seabios) Select BIOS implementation. --boot [[legacy=]<[acdn]{1,4}>] [,order=] Specify guest boot order. Use the 'order=' sub-property as usage with no key or 'legacy=' is deprecated. --bootdisk (ide|sata|scsi|virtio)\d+ Enable booting from specified disk. Deprecated: Use 'boot: order=foo;bar' instead. --bwlimit (0 - N) (default=restore limit from datacenter or storage config) Override I/O bandwidth limit (in KiB/s). --cdrom This is an alias for option -ide2 --cicustom [meta=] [,network=] [,user=] [,vendor=] cloud-init: Specify custom files to replace the automatically generated ones at start. --cipassword 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 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. --ciupgrade (default=1) cloud-init: do an automatic package upgrade after the first boot. --ciuser cloud-init: User name to change ssh keys and password for instead of the image's configured default user. --cores (1 - N) (default=1) The number of cores per socket. --cpu [[cputype=]] [,flags=<+FLAG[;-FLAG...]>] [,guest-phys-bits=] [,hidden=<1|0>] [,hv-vendor-id=] [,level=] [,phys-bits=<8-64|host>] [,reported-model=] Emulated CPU type. --cpulimit (0 - 128) (default=0) Limit of CPU usage. --cpuunits (1 - 262144) (default=cgroup v1: 1024, cgroup v2: 100) CPU weight for a VM, will be clamped to [1, 10000] in cgroup v2. --description Description for the VM. Shown in the web-interface VM's summary. This is saved as comment inside the configuration file. --efidisk0 [file=] [,efitype=<2m|4m>] [,format=] [,import-from=] [,ms-cert=] [,pre-enrolled-keys=<1|0>] [,size=] Configure a disk for storing EFI vars. Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume. Note that SIZE_IN_GiB is ignored here and that the default EFI vars are copied to the volume instead. Use STORAGE_ID:0 and the 'import-from' parameter to import from an existing volume. --force Allow to overwrite existing VM. Requires option(s): archive --freeze Freeze CPU at startup (use 'c' monitor command to start execution). --ha-managed (default=0) Add the VM as a HA resource after it was created. --hookscript Script that will be executed during various steps in the vms lifetime. --hostpci[n] [[host=]] [,device-id=] [,driver=] [,legacy-igd=<1|0>] [,mapping=] [,mdev=] [,pcie=<1|0>] [,rombar=<1|0>] [,romfile=] [,sub-device-id=] [,sub-vendor-id=] [,vendor-id=] [,x-vga=<1|0>] Map host PCI devices into guest. --hotplug (default=network,disk,usb) Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory', 'usb' and 'cloudinit'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`. USB hotplugging is possible for guests with machine version >= 7.1 and ostype l26 or windows > 7. --hugepages <1024 | 2 | any> Enables hugepages memory. Sets the size of hugepages in MiB. If the value is set to 'any' then 1 GiB hugepages will be used if possible, otherwise the size will fall back to 2 MiB. --ide[n] [file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_max_length=] [,bps_wr=] [,bps_wr_max_length=] [,cache=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,import-from=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_max=] [,iops_rd_max_length=] [,iops_wr=] [,iops_wr_max=] [,iops_wr_max_length=] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,model=] [,replicate=<1|0>] [,rerror=] [,serial=] [,shared=<1|0>] [,size=] [,snapshot=<1|0>] [,ssd=<1|0>] [,werror=] [,wwn=] Use volume as IDE hard disk or CD-ROM (n is 0 to 3). Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume. Use STORAGE_ID:0 and the 'import-from' parameter to import from an existing volume. --import-working-storage A file-based storage with 'images' content-type enabled, which is used as an intermediary extraction storage during import. Defaults to the source storage. --intel-tdx [type=] ,attestation=<1|0> [,vsock-cid=] [,vsock-port=] Trusted Domain Extension (TDX) features by Intel CPUs --ipconfig[n] [gw=] [,gw6=] [,ip=] [,ip6=] 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. This requires cloud-init 19.4 or newer. If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4. --ivshmem size= [,name=] Inter-VM shared memory. Useful for direct communication between VMs, or to the host. --keephugepages (default=0) Use together with hugepages. If enabled, hugepages will not not be deleted after VM shutdown and can be used for subsequent starts. --keyboard Keyboard layout for VNC server. This option is generally not required and is often better handled from within the guest OS. --kvm (default=1) Enable/disable KVM hardware virtualization. --live-restore Start the VM immediately while importing or restoring in the background. --localtime Set the real time clock (RTC) to local time. This is enabled by default if the `ostype` indicates a Microsoft Windows OS. --lock Lock/unlock the VM. --machine [[type=]] [,aw-bits=] [,enable-s3=<1|0>] [,enable-s4=<1|0>] [,viommu=] Specify the QEMU machine. --memory [current=] Memory properties. --migrate_downtime (0 - N) (default=0.1) Set maximum tolerated downtime (in seconds) for migrations. Should the migration not be able to converge in the very end, because too much newly dirtied RAM needs to be transferred, the limit will be increased automatically step-by-step until migration can converge. Will be capped to 2000 seconds (maximum in QEMU). --migrate_speed (0 - N) (default=0) Set maximum speed (in MB/s) for migrations. Value 0 is no limit. --name Set a name for the VM. Only used on the configuration web interface. --nameserver 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=] [,bridge=] [,firewall=<1|0>] [,host-tunnel=<1|0>] [,link_down=<1|0>] [,macaddr=] [,mtu=] [,queues=] [,rate=] [,tag=] [,trunks=] [,=] Specify network devices. --numa (default=0) Enable/disable NUMA. --numa[n] cpus= [,hostnodes=] [,memory=] [,policy=] NUMA topology. --onboot (default=0) Specifies whether a VM will be started during system bootup. --ostype (default=other) Specify guest operating system. --parallel[n] /dev/parport\d+|/dev/usb/lp\d+ Map host parallel devices (n is 0 to 2). --pool Add the VM to the specified pool. --protection (default=0) Sets the protection flag of the VM. This will disable the remove VM and remove disk operations. --reboot (default=1) Allow reboot. If set to '0' the VM exit on reboot. --rng0 [source=] [,max_bytes=] [,period=] Configure a VirtIO-based Random Number Generator. --sata[n] [file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_max_length=] [,bps_wr=] [,bps_wr_max_length=] [,cache=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,import-from=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_max=] [,iops_rd_max_length=] [,iops_wr=] [,iops_wr_max=] [,iops_wr_max_length=] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,replicate=<1|0>] [,rerror=] [,serial=] [,shared=<1|0>] [,size=] [,snapshot=<1|0>] [,ssd=<1|0>] [,werror=] [,wwn=] Use volume as SATA hard disk or CD-ROM (n is 0 to 5). Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume. Use STORAGE_ID:0 and the 'import-from' parameter to import from an existing volume. --scsi[n] [file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_max_length=] [,bps_wr=] [,bps_wr_max_length=] [,cache=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,import-from=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_max=] [,iops_rd_max_length=] [,iops_wr=] [,iops_wr_max=] [,iops_wr_max_length=] [,iothread=<1|0>] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,product=] [,queues=] [,replicate=<1|0>] [,rerror=] [,ro=<1|0>] [,scsiblock=<1|0>] [,serial=] [,shared=<1|0>] [,size=] [,snapshot=<1|0>] [,ssd=<1|0>] [,vendor=] [,werror=] [,wwn=] Use volume as SCSI hard disk or CD-ROM (n is 0 to 30). Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume. Use STORAGE_ID:0 and the 'import-from' parameter to import from an existing volume. --scsihw (default=lsi) SCSI controller model --searchdomain cloud-init: Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set. --serial[n] (/dev/[^,]+|socket) Create a serial device inside the VM (n is 0 to 3) --shares (0 - 50000) (default=1000) Amount of memory shares for auto-ballooning. The larger the number is, the more memory this VM gets. Number is relative to weights of all other running VMs. Using zero disables auto-ballooning. Auto-ballooning is done by pvestatd. --smbios1 [base64=<1|0>] [,family=] [,manufacturer=] [,product=] [,serial=] [,sku=] [,uuid=] [,version=] Specify SMBIOS type 1 fields. --smp (1 - N) (default=1) The number of CPUs. Please use option -sockets instead. --sockets (1 - N) (default=1) The number of CPU sockets. --spice_enhancements [foldersharing=<1|0>] [,videostreaming=] Configure additional enhancements for SPICE. --sshkeys cloud-init: Setup public SSH keys (one key per line, OpenSSH format). --start (default=0) Start VM after it was created successfully. --startdate (now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS) (default=now) Set the initial date of the real time clock. Valid format for date are:'now' or '2006-06-17T16:01:21' or '2006-06-17'. --startup [[order=]\d+] [,up=\d+] [,down=\d+] Startup and shutdown behavior. Order is a non-negative number defining the general startup order. Shutdown in done with reverse ordering. Additionally you can set the 'up' or 'down' delay in seconds, which specifies a delay to wait before the next VM is started or stopped. --storage Default storage. --tablet (default=1) Enable/disable the USB tablet device. --tags Tags of the VM. This is only meta information. --tdf (default=0) Enable/disable time drift fix. --template (default=0) Enable/disable Template. --tpmstate0 [file=] [,format=] [,import-from=] [,size=] [,version=] Configure a Disk for storing TPM state. The format is fixed to 'raw'. Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume. Note that SIZE_IN_GiB is ignored here and 4 MiB will be used instead. Use STORAGE_ID:0 and the 'import-from' parameter to import from an existing volume. --unique Assign a unique random ethernet address. Requires option(s): archive --unused[n] [file=] Reference to unused volumes. This is used internally, and should not be modified manually. --usb[n] [[host=]] [,mapping=] [,usb3=<1|0>] Configure an USB device (n is 0 to 4, for machine version >= 7.1 and ostype l26 or windows > 7, n can be up to 14). --vcpus (1 - N) (default=0) Number of hotplugged vcpus. --vga [[type=]] [,clipboard=] [,memory=] Configure the VGA hardware. --virtio[n] [file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_max_length=] [,bps_wr=] [,bps_wr_max_length=] [,cache=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,import-from=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_max=] [,iops_rd_max_length=] [,iops_wr=] [,iops_wr_max=] [,iops_wr_max_length=] [,iothread=<1|0>] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,replicate=<1|0>] [,rerror=] [,ro=<1|0>] [,serial=] [,shared=<1|0>] [,size=] [,snapshot=<1|0>] [,werror=] Use volume as VIRTIO hard disk (n is 0 to 15). Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume. Use STORAGE_ID:0 and the 'import-from' parameter to import from an existing volume. --virtiofs[n] [dirid=] [,cache=] [,direct-io=<1|0>] [,expose-acl=<1|0>] [,expose-xattr=<1|0>] Configuration for sharing a directory between host and guest using Virtio-fs. --vmgenid (default=1 (autogenerated)) Set VM Generation ID. Use '1' to autogenerate on create or update, pass '0' to disable explicitly. --vmstatestorage Default storage for VM state volumes/files. --watchdog [[model=]] [,action=] Create a virtual hardware watchdog device.