01 Installation

Quickemu is available in the repositories of the following distros (packaging status by Repology.org):

Arch Linux

Quickemu is available from the AUR (Arch user repository), and can be installed via any AUR helper. Assuming your AUR helper is yay, Run the following command:

yay -Sy quickemu

Debian (and derivatives)

A .deb package is available for Debian and derivatives on this project's GitHub releases page. Download the .deb and install it with apt-get.

sudo apt-get install ./quickemu_x.y.z-1_all.deb

Ubuntu

Quickemu is available from a PPA for Ubuntu users. The Quickemu PPA also includes a backport of QEMU 6.0.0 for 20.04 (Focal) and 21.04 (Hirsute). To install Quickemu and all the dependencies, run the following in a terminal:

sudo apt-add-repository ppa:flexiondotorg/quickemu
sudo apt update
sudo apt install quickemu

NixOS hosts

To quickly try quickemu:

nix-shell -p quickemu

To install via Nix profile:

nix-env -iA pkgs.quickemu

To install via NixOS config:

# /etc/nixos/configuration.nix
{pkgs, ...}: {
   environment.systemPackages = with pkgs;
     quickemu
   };
}

To install via Flakes:

# TODO (flake users, please add an example!)

Any Linux (installing from source)

git clone --filter=blob:none https://github.com/quickemu-project/quickemu
cd quickemu

When installing from source, you will need to install the following requirements manually:

• QEMU (6.0.0 or newer) with GTK, SDL, SPICE & VirtFS support
• bash (4.0 or newer)
• Coreutils
• curl
• EDK II
• gawk
• grep
• glxinfo
• jq
• pciutils
• procps
• python3
• mkisofs
• usbutils
• util-linux
• sed
• socat
• spicy
• swtpm
• xdg-user-dirs
• xrandr
• zsync
• unzip

These examples may save a little typing:

Install requirements on Debian

This also applies to derivatives:

sudo apt-get install bash coreutils curl genisoimage grep jq mesa-utils ovmf pciutils procps python3 qemu sed socat spice-client-gtk swtpm-tools unzip usbutils util-linux xdg-user-dirs xrandr zsync 

Install requirements on Fedora

sudo dnf install bash coreutils curl edk2-tools genisoimage grep jq mesa-demos pciutils procps python3 qemu sed socat spice-gtk-tools swtpm unzip usbutils util-linux xdg-user-dirs xrandr zsync

Install requirements on Gentoo

Please note that you may have to use sys-firmware/edk2-ovmf instead of sys-firmware/edk2-ovmf-bin - depending on how your system is configured.

sudo emerge --ask --noreplace app-emulation/qemu \
 app-shells/bash \
 sys-apps/coreutils \
 net-misc/curl \
 sys-firmware/edk2-ovmf-bin \
 sys-apps/gawk \
 sys-apps/grep \
 x11-apps/mesa-progs \
 app-misc/jq \
 sys-apps/pciutils \
 sys-process/procps \
 app-cdr/cdrtools \
 sys-apps/usbutils \
 sys-apps/util-linux \
 sys-apps/sed \
 net-misc/socat \
 app-emulation/spice \
 app-crypt/swtpm \
 x11-misc/xdg-user-dirs \
 x11-apps/xrandr \
 net-misc/zsync \
 app-arch/unzip

Install on macOS

macOS support is a work in progress. See issue 447 for more information.

brew install bash curl cdrtools coreutils gnu-sed grep jq ncurses pciutils procps [email protected] qemu unzip usbutils samba socat spice-gtk swtpm zsync