Docs Hub ›
QuantaBox ›
Configuration Reference
Configuration Reference
QB-CR-001
Rev 1.0
A lookup table of every VM setting, its values, and where to change it. For the underlying JSON schema, see VM Configuration Format . Settings are changed in the GUI's Settings dialog (grouped into the sections below) or at creation time via the CLI.
General #
Setting Values Default Where
Name text -- General Description text empty General Encryption on / off on (new VMs) General, --encrypted at create
System (CPU & Memory) #
Setting Values Default Where
Processors (cores) 1, 2, 4, 6, 8, 12, 16 per-OS preset (often 2) System, --cpus Threads per core ≥ 1 1 System Memory 512 MB - 32 GB per-OS preset (often 4096 MB) System, --memory Memory ballooning on / off on System Nested virtualization on / off off System Boot order Disk, CDROM, Network, USB [Disk, CDROM] System
Storage (per disk) #
Setting Values Default Where
Disk size 8 - 500 GB (growable) per-OS preset Storage, --disk Format QCOW2, QVD, Raw, VMDK, VDI QCOW2 (QVD if encrypted) Storage Bus VirtIO, SATA, NVMe, IDE VirtIO Storage Read-only on / off off Storage Encrypted on / off follows VM encryption Storage
Display #
Setting Values Default Where
Backend SPICE, VNC, SDL SPICE Display Resolution width x height 1920 x 1080 Display GPU acceleration on / off off Display Graphics controller VirtIO-GPU VirtIO-GPU Display Remote display on / off -- Display
Note: The in-app console uses a VNC server with a WebSocket port regardless of the display backend chosen for the guest window.
Network (per adapter) #
Setting Values Default Where
Enabled on / off on Network Mode NAT, Bridged, Host-Only, Internal NAT Network Adapter (NIC model) VirtIO-net, Intel PRO/1000 (e1000), RTL8139 VirtIO-net Network MAC address auto / manual auto-generated Network Cable connected on / off on Network SSH host port port number -- (NAT) forwards host port to guest 22
Default NAT network: 10.0.2.0/24, gateway 10.0.2.2, DHCP 10.0.2.15-254, DNS 10.0.2.3. Default host-only network: 192.168.56.0/24, gateway 192.168.56.1, DHCP 192.168.56.100-254.
USB #
Setting Values Default Where
USB enabled on / off on USB Controller version xHCI (USB 3.0), EHCI (USB 2.0) xHCI USB Passthrough devices vendor/product IDs none USB
Shared Folders (per folder) #
Setting Values Default Where
Name (mount tag) text -- Shared Folders Host path directory path -- Shared Folders Read-only on / off off Shared Folders Auto-mount on / off off Shared Folders
Audio & Serial #
Setting Values Default Where
Audio enabled on / off -- Audio Audio controller Intel HD Intel HD Audio Serial enabled on / off off Serial Ports
Unattended Installation #
Setting Values Default Where
Enabled on / off off Create VM dialog Username text -- Create VM dialog Password text -- Create VM dialog Hostname text derived from VM name Create VM dialog Locale e.g. en-US -- (generated) Timezone IANA, e.g. America/New_York -- (generated)
Application Settings (global) #
Setting Values Default Where
Default encryption on / off on Settings Data directory path platform default Settings Engine path path to QEMU auto-detected Settings VNC enabled on / off on Settings Theme theme name default Settings
See Architecture for details on the data directory and where files are stored.