đĨī¸ Create the First VM
MOS supports running full virtual machines (VMs) using KVM/QEMU.
This guide walks you through creating and configuring your first VM.
Navigate to:
VMs
â Creating a VMâ
Click the three-dot menu (âŽ) in the bottom right corner and select + Create VM.
âī¸ Basic Configurationâ
đˇī¸ Nameâ
The unique name for your VM as it appears in the overview.
Best practices:
- Use short, descriptive names
- Avoid spaces and special characters
đ§ Memory Size (GB)â
Defines how much RAM is allocated to the VM.
Use the slider to set the desired memory size in GB.
[!NOTE] Only allocate as much memory as the VM actually needs to avoid starving the host system.
đ Core Pinningâ
Allows pinning vCPUs to specific physical CPU cores.
[!TIP] Useful for performance-critical VMs to reduce CPU scheduling overhead.
đĨī¸ Machine Typeâ
Defines the emulated machine architecture.
| Option | Description |
|---|---|
q35 | Modern PCIe-based machine (recommended) |
pc | Legacy i440FX machine |
đĸ Versionâ
Defines the version of the selected machine type.
Example: q35 (default)
đ§ BIOS Typeâ
Defines the firmware used to boot the VM.
| Option | Description |
|---|---|
ovmf | UEFI firmware (recommended for modern OS) |
seabios | Legacy BIOS |
[!NOTE] Use
ovmffor Windows 11 and modern Linux distributions that require UEFI.
đž Disksâ
Click + Add Disk to add a virtual disk to the VM.
Disk Configuration Fieldsâ
| Field | Description |
|---|---|
| đ Source | Path to the disk image file (e.g. /mnt/main/vms/Test/vdisk1.qcow2) |
| đ Size | Size of the virtual disk |
| đ Bus | Controller type used for the disk |
| đī¸ Format | Disk image format |
| đĸ Boot Order | Boot priority (lower = higher priority) |
đ Disk Bus Optionsâ
| Bus | Description |
|---|---|
virtio | Best performance (recommended for Linux) |
sata | Good compatibility |
usb | USB-attached disk |
scsi | SCSI controller |
ide | Legacy, slowest option |
đī¸ Disk Format Optionsâ
| Format | Description |
|---|---|
qcow2 | Supports snapshots, thin provisioning (recommended) |
raw | Maximum performance, no snapshot support |
đŋ CD-ROMâ
Click + Add CD-ROM to attach an ISO image as a virtual optical drive.
CD-ROM Configuration Fieldsâ
| Field | Description |
|---|---|
| đ Source | Path to the ISO file |
| đ Bus | Controller type for the CD-ROM |
| đĸ Boot Order | Boot priority |
đ CD-ROM Bus Optionsâ
Available options: virtio, sata (default), usb, scsi, ide
[!TIP] Use
satafor best OS installer compatibility.
đĒ VirtIO Driversâ
For Windows VMs, VirtIO drivers are required to use virtio disks and network adapters.
Select the VirtIO ISO from the dropdown to attach the driver disk.
[!NOTE] The VirtIO ISO must be downloaded and placed on the system beforehand. It provides drivers for disk controllers, network adapters, and more inside Windows VMs.
đ Network Adapterâ
Click + Add Adapter to add a virtual network interface.
Network Configuration Fieldsâ
| Field | Description |
|---|---|
| đ Type | Network connection type |
| đĄ Source | Network bridge or interface to connect to |
| đ§ Model | Virtual NIC model |
| đ MAC Address | Optional static MAC address |
đ Network Type Optionsâ
| Type | Description |
|---|---|
bridge | Connects VM to a host bridge (most common) |
macvtap | Direct connection via macvtap interface |
network | Uses a libvirt virtual network |
đĄ Network Source Optionsâ
| Source | Description |
|---|---|
br0 | Physical network bridge (for real network access) |
virbr0 | Virtual NAT bridge (isolated network) |
đ§ Network Model Optionsâ
| Model | Description |
|---|---|
virtio | Best performance (recommended) |
e1000 | Intel Gigabit emulation, good compatibility |
rtl8139 | Legacy, broadest compatibility |
đŧī¸ Graphicsâ
Defines how the VM's display is accessed remotely.
Graphics Configuration Fieldsâ
| Field | Description |
|---|---|
| đĨī¸ Type | Remote display protocol |
| â¨ī¸ Keymap | Keyboard layout used inside the VM |
| đ Port | Port for remote display connection (leave empty for auto) |
| đ Listen | IP address to listen on (0.0.0.0 = all interfaces) |
đĨī¸ Graphics Type Optionsâ
| Type | Description |
|---|---|
vnc | Basic remote display (default, widely supported) |
spice | Advanced protocol with better performance and USB redirection |
none | No graphical output |
â¨ī¸ Keymap Optionsâ
Select the keyboard layout that matches your physical keyboard:
en-us, en-gb, de, de-ch, fr, fr-be, and more.
đ Host Devicesâ
Click + Add Host Device to pass through a physical PCI device directly to the VM.
[!WARNING] PCI passthrough gives the VM exclusive access to the device. The host will no longer be able to use it while the VM is running.
Common use cases:
- đŽ GPU passthrough for gaming VMs
- đ Dedicated network card passthrough
- đž NVMe/storage controller passthrough
đ USB Devicesâ
Click + Add USB Device to pass through a connected USB device to the VM.
Select the USB device from the dropdown â all currently connected USB devices are listed.
Examples of passthrough devices:
- đĩ Bluetooth adapters
- đž USB flash drives
- đąī¸ Input devices
[!NOTE] USB passthrough requires the device to be physically connected to the host at VM start time.
â Finalizing the VMâ
Once all settings are configured, click Create to create the VM.
The new VM will appear in the VMs overview with a stopped state.
đ VM Overview Columnsâ
| Column | Description |
|---|---|
| đˇī¸ Name | VM name and current state |
| đ Description | Optional description |
| đ CPU Load | Live CPU usage while running |
| đž Disks | Attached disk and ISO paths |
| đ Port | VNC/SPICE port for remote access |
| âļī¸ Autostart | Whether the VM starts automatically on boot |
| âšī¸ Info | Additional VM information |
â Summaryâ
To create your first VM, follow these steps:
- đˇī¸ Set a Name and configure Memory
- đĨī¸ Choose Machine Type and BIOS Type
- đž Add a Disk and select format + bus type
- đŋ Add a CD-ROM with the OS installer ISO
- đĒ (Windows only) Attach the VirtIO ISO
- đ Add a Network Adapter
- đŧī¸ Configure Graphics for remote access
- đ (Optional) Add Host Devices or USB Devices
- đ Click Create â your VM is ready!
Parts of this documentation were created with the assistance of AI tools. All AI-generated content has undergone review, but it may still contain inaccuracies, omissions, or outdated information.