Interface nodesQemuConfigVmConfig

Returned by GET /nodes/{node}/qemu/{vmid}/config

Hierarchy

  • nodesQemuConfigVmConfig

Indexable

[additionalProperties: string]: any

Properties

acpi?: boolean

Enable/disable ACPI.

agent?: string

Enable/disable communication with the Qemu Guest Agent and its properties.

arch?: string

Virtual processor architecture. Defaults to the host.

args?: string

Arbitrary arguments passed to kvm, for example: args: -no-reboot -no-hpet NOTE: this option is for experts only.

audio0?: string

Configure a audio device, useful in combination with QXL/Spice.

autostart?: boolean

Automatic restart after crash (currently ignored).

balloon?: number

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

bios?: string

Select BIOS implementation.

boot?: string

Specify guest boot order. Use the 'order=' sub-property as usage with no key or 'legacy=' is deprecated.

bootdisk?: string

Enable booting from specified disk. Deprecated: Use 'boot: order=foo;bar' instead.

cdrom?: string

This is an alias for option -ide2

cicustom?: string

cloud-init: Specify custom files to replace the automatically generated ones at start.

cipassword?: string

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

citype?: string

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

ciuser?: string

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

cores?: number

The number of cores per socket.

cpu?: string

Emulated CPU type.

cpulimit?: number

Limit of CPU usage. NOTE: If the computer has 2 CPUs, it has total of '2' CPU time. Value '0' indicates no CPU limit.

cpuunits?: number

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.

description?: string

Description for the VM. Shown in the web-interface VM's summary. This is saved as comment inside the configuration file.

digest: string

SHA1 digest of configuration file. This can be used to prevent concurrent modifications.

efidisk0?: string

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.

freeze?: boolean

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

hookscript?: string

Script that will be executed during various steps in the vms lifetime.

hostpci0?: string

Map host PCI devices into guest. NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

hostpci1?: string

Map host PCI devices into guest. NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

hostpci2?: string

Map host PCI devices into guest. NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

hostpci3?: string

Map host PCI devices into guest. NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

hostpci4?: string

Map host PCI devices into guest. NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

hostpci5?: string

Map host PCI devices into guest. NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

hostpci6?: string

Map host PCI devices into guest. NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

hostpci7?: string

Map host PCI devices into guest. NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

hotplug?: string

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. Using '1' as value is an alias for the default network,disk,usb.

hugepages?: string

Enable/disable hugepages memory.

ide0?: string

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.

ide1?: string

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.

ide2?: string

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.

ide3?: string

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.

ipconfig0?: string

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.

ipconfig1?: string

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.

ipconfig2?: string

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.

ipconfig3?: string

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.

ipconfig4?: string

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.

ipconfig5?: string

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.

ipconfig6?: string

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.

ipconfig7?: string

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?: string

Inter-VM shared memory. Useful for direct communication between VMs, or to the host.

keephugepages?: boolean

Use together with hugepages. If enabled, hugepages will not not be deleted after VM shutdown and can be used for subsequent starts.

keyboard?: string

Keyboard layout for VNC server. The default is read from the'/etc/pve/datacenter.cfg' configuration file. It should not be necessary to set it.

kvm?: boolean

Enable/disable KVM hardware virtualization.

localtime?: boolean

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

lock?: string

Lock/unlock the VM.

machine?: string

Specifies the Qemu machine type.

memory?: number

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

migrate_downtime?: number

Set maximum tolerated downtime (in seconds) for migrations.

migrate_speed?: number

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

name?: string

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

nameserver?: string

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

net0?: string

Specify network devices.

net1?: string

Specify network devices.

net2?: string

Specify network devices.

net3?: string

Specify network devices.

numa?: boolean

Enable/disable NUMA.

numa0?: string

NUMA topology.

numa1?: string

NUMA topology.

numa2?: string

NUMA topology.

numa3?: string

NUMA topology.

onboot?: boolean

Specifies whether a VM will be started during system bootup.

ostype?: string

Specify guest operating system. This is used to enable special optimization/features for specific operating systems: [horizontal] other;; unspecified OS wxp;; Microsoft Windows XP w2k;; Microsoft Windows 2000 w2k3;; Microsoft Windows 2003 w2k8;; Microsoft Windows 2008 wvista;; Microsoft Windows Vista win7;; Microsoft Windows 7 win8;; Microsoft Windows 8/2012/2012r2 win10;; Microsoft Windows 10/2016/2019 win11;; Microsoft Windows 11/2022 l24;; Linux 2.4 Kernel l26;; Linux 2.6 - 5.X Kernel solaris;; Solaris/OpenSolaris/OpenIndiania kernel

parallel0?: string

Map host parallel devices (n is 0 to 2). NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

parallel1?: string

Map host parallel devices (n is 0 to 2). NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

parallel2?: string

Map host parallel devices (n is 0 to 2). NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

parallel3?: string

Map host parallel devices (n is 0 to 2). NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

protection?: boolean

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

reboot?: boolean

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

rng0?: string

Configure a VirtIO-based Random Number Generator.

sata0?: string

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.

sata1?: string

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.

sata2?: string

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.

sata3?: string

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.

scsi0?: string

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.

scsi1?: string

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.

scsi2?: string

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.

scsi3?: string

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.

scsihw?: string

SCSI controller model

searchdomain?: string

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

serial0?: string

Create a serial device inside the VM (n is 0 to 3), and pass through a host serial device (i.e. /dev/ttyS0), or create a unix socket on the host side (use 'qm terminal' to open a terminal connection). NOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

serial1?: string

Create a serial device inside the VM (n is 0 to 3), and pass through a host serial device (i.e. /dev/ttyS0), or create a unix socket on the host side (use 'qm terminal' to open a terminal connection). NOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

serial2?: string

Create a serial device inside the VM (n is 0 to 3), and pass through a host serial device (i.e. /dev/ttyS0), or create a unix socket on the host side (use 'qm terminal' to open a terminal connection). NOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

serial3?: string

Create a serial device inside the VM (n is 0 to 3), and pass through a host serial device (i.e. /dev/ttyS0), or create a unix socket on the host side (use 'qm terminal' to open a terminal connection). NOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care. CAUTION: Experimental! User reported problems with this option.

shares?: number

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?: string

Specify SMBIOS type 1 fields.

smp?: number

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

sockets?: number

The number of CPU sockets.

spice_enhancements?: string

Configure additional enhancements for SPICE.

sshkeys?: string

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

startdate?: string

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?: string

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

tablet?: boolean

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 (qm set <vmid> --vga qxl).

tags?: string

Tags of the VM. This is only meta information.

tdf?: boolean

Enable/disable time drift fix.

template?: boolean

Enable/disable Template.

tpmstate0?: string

Configure a Disk for storing TPM state. 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 size of 4 MiB will always be used instead. The format is also fixed to 'raw'.

unused0?: string

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

unused1?: string

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

unused2?: string

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

unused3?: string

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

usb0?: string

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

usb1?: string

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

usb2?: string

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

usb3?: string

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

vcpus?: number

Number of hotplugged vcpus.

vga?: string

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. You can also run without any graphic card, using a serial device as terminal.

virtio0?: string

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.

virtio1?: string

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.

virtio2?: string

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.

virtio3?: string

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.

vmgenid?: string

The VM generation ID (vmgenid) device exposes a 128-bit integer value identifier to the guest OS. This allows to notify the guest operating system when the virtual machine is executed with a different configuration (e.g. snapshot execution or creation from a template). The guest operating system notices the change, and is then able to react as appropriate by marking its copies of distributed databases as dirty, re-initializing its random number generator, etc. Note that auto-creation only works when done through API/CLI create or update methods, but not when manually editing the config file.

vmstatestorage?: string

Default storage for VM state volumes/files.

watchdog?: string

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)

Generated using TypeDoc