quickemu-project /quickemu
Quickly create and run optimised Windows, macOS and Linux virtual machines
★ 16,737⑂ 770👁 83⑃ 1,028● 776▤ 45
+8
Daily
+104
Weekly
+210
Monthly
16,737
stars
770
forks
83
watchers
1,028
prs
776
issues
45
releases
README
Quickemu Quickly create and run optimised Windows, macOS and Linux virtual machines: Made with 💝 for & Introduction Quickemu is a wrapper for the excellent QEMU that automatically "does the right thing" when creating virtual machines. No requirement for exhaustive configuration options. You decide what operating system you want to run and Quickemu takes care of the rest 🤖 - quickget automatically downloads the upstream OS and creates the configuration 📀 - quickemu enumerates your hardware and launches the virtual machine with the optimum configuration best suited to your computer ⚡️ The original objective of the project was to enable quick testing of Linux distributions where the virtual machines and their configuration can be stored anywhere (such as external USB storage or your home directory) and no elevated permissions are required to run the virtual machines. Today, Quickemu includes comprehensive support for macOS, Windows, most of the BSDs, novel non-Linux operating systems such as FreeDOS, Haiku, KolibriOS, OpenIndiana, ReactOS, and more. Features - Host support for Linux and macOS - macOS Sequoia, Sonoma, Ventura, Monterey, Big Sur, Catalina & Mojave - Windows 10 and 11 including TPM 2.0 - Windows Server 2022 2019 2016 - ARM64 guest support for running aarch64 VMs (native on ARM hosts, emulated on x86_64) - Ubuntu and all the official Ubuntu flavours - Nearly 1000 operating system editions are supported! - Full SPICE support including host/guest clipboard sharing - VirtIO-webdavd file sharing for Linux and Windows guests - VirtIO-9p file sharing for Linux and macOS guests - QEMU Guest Agent support; provides access to a system-level agent via standard QMP commands - Samba file sharing for Linux, macOS and Windows guests (if smbd is installed on the host) - VirGL acceleration - USB device pass-through - Smartcard pass-through - Automatic SSH port forwarding to guests - Network port forwarding - Full duplex audio - Braille support - EFI (with or without SecureBoot) and Legacy BIOS boot As featured on Linux Matters podcast! The presenters of Linux Matters 🐧🎙️ are the creators of each of the principal Quickemu projects. We discussed Quickemu's 2024 reboot in Episode 30 - Quickemu Rising From the Bashes. Linux Matters Podcast Quick start Once Quickemu is installed, there are two simple steps to create and run a virtual machine: - quickget automatically downloads the ISO image for the operating system you want to run and creates a configuration file for the virtual machine. shell quickget nixos unstable minimal - quickemu starts the virtual machine using the configuration file created by quickget. shell quickemu --vm nixos-unstable-minimal.conf Execute quickget (with no arguments) to see a list of all the supported operating systems. Demo Documentation The wiki describes how to get up and running with Quickemu and also covers
Top issues
#1547bug: Cannot login into Apple ID on macos VM27 comments · 2025-01-01#1918Windows could not apply the unattend answer file's <DiskConfiguration> setting14 comments · 2026-06-01#1904bug: MacOS starts with black screen9 comments · 2026-04-12#1721feat: add support for passt network backend9 comments · 2025-08-20#1927bug: Auto-unattend + VirtIO driver not loaded8 comments · 2026-06-22#1902bug: The wiki appears to specify that the wrong partiton be erased for `tahoe`.6 comments · 2026-04-11#1517feat: put all files related to a VM in one place6 comments · 2024-11-16#1871bug: arm64 guest doesn't boot5 comments · 2026-02-12
Discussions
#1970Keyboard functions normally in Windows host besides specific characters1 comments · 2026-11-10#1969How to share folders with windows host1 comments · 2026-11-10#1945macos "This disk is locked"1 comments · 2026-08-17#1932Windows on arm64?2 comments · 2026-07-09#1924No network with Windows 111 comments · 2026-06-16#1923qm --display spice-app with ubuntu 26.04 and windows-11 stuck at "Connected to graphic server"0 comments · 2026-06-14#1914Absolute Beginner0 comments · 2026-05-09#1907Why is there a minimal disk size?0 comments · 2026-04-23
Latest release
4.9.9 4.9.9 2026-02-10Quickemu 4.9.9 Release Notes Cross Architecture Support Full ARM64 (aarch64) guest support - quickemu now supports running ARM64 virtual machines on both x86_64 and ARM64 hosts. The host architecture is automatically detected, and you can override it with the --arch flag when downloading OS images. - Architecture-aware filenames and output for downloaded images - Per-distro architecture validation - quickget only lists architectures each OS actually supports - --check-all-arch flag to test both amd64 and arm64 downloads for a given OS - Correct architecture selection for Fedora and