Maze Linux ships as a bootable live ISO — you can run it in a virtual machine without installing anything. The live environment is the full system: all security services, Ollama, the Maze desktop, and every pre-installed app are active. Nothing is stripped down.
Turn on UEFI in the VM — otherwise it will not boot. Maze is UEFI-only; most hypervisors default to legacy BIOS, and the ISO simply won't start there (black screen or "no bootable medium"). Leave Secure Boot off in the VM — plain UEFI is all it needs. Each section below shows where the switch is.
Note: Some security features behave differently in a VM. AppArmor and firewalld run normally, but MAC randomization applies to the virtual NIC (not your physical adapter).
| Minimum | Recommended | |
|---|---|---|
| RAM | 4 GB allocated to VM | 8 GB+ (needed if you want to run Ollama) |
| CPU | 2 cores, 64-bit | 4+ cores with hardware virtualization |
| Disk | None (live mode) | — |
| Host OS | Linux, Windows, macOS | — |
Maze ships with zram compressed swap, which helps when RAM is tight — but local AI models (llama3, etc.) need headroom. If you plan to use Ollama inside the VM, allocate at least 8 GB.
QEMU with KVM gives near-native performance and is the best way to test Maze on Linux.
Install QEMU:
# Maze Linux / Arch
sudo pacman -S qemu-full edk2-ovmf
# Fedora
sudo dnf install qemu-kvm edk2-ovmf
# Debian / Ubuntu
sudo apt install qemu-system-x86 ovmf
edk2-ovmf / ovmf is the UEFI firmware for QEMU — without it QEMU boots
in legacy BIOS mode and the ISO will not start.
Boot the ISO:
qemu-system-x86_64 \
-enable-kvm \
-drive if=pflash,format=raw,readonly=on,file=/usr/share/edk2/x64/OVMF_CODE.4m.fd \
-m 6G \
-cpu host \
-smp 4 \
-cdrom mazelinux-*.iso \
-boot d \
-vga virtio \
-display gtk
-drive if=pflash,…OVMF_CODE… — boots the VM in UEFI mode (required). The
path differs per distro: Fedora /usr/share/edk2/ovmf/OVMF_CODE.fd,
Debian/Ubuntu /usr/share/OVMF/OVMF_CODE_4M.fd-enable-kvm — hardware acceleration (Linux hosts only, requires kvm kernel modules loaded)-m 6G — 6 GB is a comfortable amount for the full desktop + security stack-cpu host — exposes your real CPU flags to the VM; improves compatibility with some Maze toolsPress Ctrl+Alt+G to release keyboard/mouse from the QEMU window.
Download and install VirtualBox. On a Linux host, load VirtualBox's kernel modules — without them no VM starts ("Kernel driver not installed (rc=-1908)"):
sudo modprobe -a vboxdrv vboxnetflt vboxnetadp
On Arch-based hosts (including Maze) install the modules first:
sudo pacman -S virtualbox virtualbox-host-modules-arch (or
virtualbox-host-dkms for a non-default kernel).
Click New. The wizard has collapsible sections — fill in the three shown below, then press Finish:



VirtualBox uses software rendering unless Guest Additions are installed. The desktop will work, but may feel sluggish compared to QEMU/KVM. Wayland compositing effects may be reduced.
| Feature | Works in VM? |
|---|---|
| KDE Plasma desktop | Yes |
| AppArmor / firewalld | Yes |
| ClamAV / QLAM | Yes |
| Entropy Shield (Tor + I2P) | Yes |
| MAC randomization | Yes (applies to virtual NIC) |
| Ollama / local AI | Yes — needs enough RAM allocated |
| GPU acceleration (Ollama) | No — VM GPU passthrough is not supported out of the box |
| Guided installer | Yes — you can install to a virtual disk from live mode |
-device virtio-serial -chardev spicevmchannel with a SPICE display.