Template:VMConfiguration/VirtualBox/doc

To list a configuration for VirtualBox for use in the Recommended VM configurations page, you must use the "VMConfiguration/VirtualBox" template, which can list the configuration in a structured table.

Usage

VirtualBox Configuration
Setting type	Configuration
General	Operating System: Other/Unknown
System	Base Memory: 64 MB Chipset: PIIX3 Pointing Device: PS/2 Mouse I/O APIC: Disabled EFI: Disabled Processor(s): 3 CPUs
Display	Video Memory: 9 MB Graphics Controller: VBoxVGA 3D Acceleration: Disabled
Storage	Floppy: One floppy controller Hard drive: IDE 2 GB drive
Audio	Audio controller: Sound Blaster 16
Network	Network adapter: Disabled
Serial Ports	Ports: All ports disabled
USB	USB Controller: Disabled
Notes
Setup will fail if the RAM is larger than 64 MB.

The following code will result in the table above:

{{VMConfiguration/VirtualBox|
 |os = Other/Unknown
 |ram = 64 MB
 |processor = 3
 |vram = 9 MB
 |floppy = y
 |hdd = IDE 2 GB drive
 |sound = Sound Blaster 16
 |notes = Setup will fail if the RAM is larger than 64 MB.
}}

os

Required: The operating system and version to use. Failure to provide the OS will default it to "Unknown".

ram

Required: Memory to use in the machine. Failure to provide the memory amount will default it to "Unknown".

chipset

Chipset to use in the virtual machine. PIIX3 or ICH9. Defaults to PIIX3.

mouse

Pointing device for the virtual machine. PS/2 Mouse, USB Tablet, or USB Multi-Touch Tablet. Defaults to PS/2 Mouse.

ioapic

Set this value to "y" to ensure the I/O APIC setting has to be enabled, otherwise don't set it to keep it disabled by default.

efi

Set this value to "y" to ensure the EFI BIOS setting has to be enabled, otherwise don't set it to keep it disabled by default.

processor

Required: Enter the number of processors to use here.

vram

Required: The amount of video memory the virtual machine should use. Failure to set this value will default it to "Unknown".

display

Name of the graphics controller to use. VBoxVGA, VMSVGA, VBoxSVGA, None. Default is VBoxVGA.

3d

Set this value to "y" to ensure the 3D video acceleration setting has to be enabled, otherwise don't set it to keep it disabled by default.

floppy

Set this value to "y" to ensure the floppy controller should be added, otherwise don't set it to keep it disabled by default.

hdd

The bus and size of the hard drive.

sound

The name of the audio controller to use. Sound Blaster 16, ICH AC97, Intel HD Audio. Default is disabled.

network

Set this value to "y" to ensure the network adapter should be enabled, otherwise don't set it to keep it disabled by default.

ports

List any serial ports that should be enabled and the settings for such. Default is "All ports disabled".

usb

The USB controller compatibility to use. USB 1.1 (OHCI) Controller, USB 2.0 (OHCI + EHCI) Controller, USB 3.0 (xHCI) Controller. Default is "Disabled".

notes

Any additional notes regarding to the configuration of the machine, such as additional drivers or instructions, can be listed here.