Skip to content

01 Installation

Jump to bottom
Martin Wimpress edited this page May 12, 2024 · 19 revisions

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

Packaging status of quickemu

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:

These examples may save a little typing:

Install requirements on Debian

This also applies to derivatives:

sudo apt install qemu bash coreutils ovmf grep jq mesa-utils pciutils procps python3 genisoimage usbutils util-linux sed socat spice-client-gtk libtss2-tcti-swtpm0 xdg-user-dirs zsync unzip

Install requirements on Fedora

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

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 qemu bash coreutils grep jq pciutils [email protected] cdrtools gnu-sed spice-gtk zsync
Clone this wiki locally