docs/about/build-platforms.rst

1 .. _Supported-build-platforms:
6 QEMU aims to support building and executing on multiple host OS
9 minimum required versions of 3rd party software QEMU depends on. The
11 the project when patches are submitted for review, and tested before and
14 If a platform is not listed here, it does not imply that QEMU won't
21 support targets, QEMU considers only the version number, and assumes the
24 software in their distro, QEMU upstream code will not add explicit
25 support for those backports, unless the feature is auto-detectable in a
33 :ref:`setup-build-env` page.
36 ----------------------------
40   .. list-table::
41    :header-rows: 1
43    * - CPU Architecture
44      - Accelerators
45    * - Arm
46      - hvf (64 bit only), kvm (64 bit only), tcg, xen
47    * - MIPS (64 bit little endian only)
48      - kvm, tcg
49    * - PPC
50      - kvm, tcg
51    * - RISC-V
52      - kvm, tcg
53    * - s390x
54      - kvm, tcg
55    * - SPARC
56      - tcg
57    * - x86
58      - hvf (64 bit only), kvm, nvmm, tcg, whpx (64 bit only), xen
60 Other host architectures are not supported. It is possible to build QEMU system
62 ``--enable-tcg-interpreter`` option to enable the TCI support, but note that
63 this is very slow and is not recommended for normal use. QEMU user emulation
64 requires host-specific support for signal handling, therefore TCI won't help
67 Non-supported architectures may be removed in the future following the
71 -----------------------------------------
73 The project aims to support the most recent major version at all times for
77 first. In this context, third-party efforts to extend the lifetime of a distro
84 the project will look at CentOS, Debian, Fedora, openSUSE, RHEL, SLES and
96   Distributions with long-term support often provide multiple versions
97   of the Python runtime.  While QEMU will initially aim to support the
100   In this case, it will be necessary to use the ``--python`` command line
101   option of the ``configure`` script to point QEMU to a supported
104   As of QEMU |version|, the minimum supported version of Python is 3.9.
107   Some of QEMU's build dependencies are written in Python.  Usually these
109   If QEMU bumps its minimum Python version and a non-default runtime is
111   Package Index (PyPI) via ``pip``, in order to build QEMU.
114   QEMU is generally conservative in adding new Rust dependencies, and all
119   a newer version using ``cargo install bindgen-cli``.
121   QEMU requires Rust 1.77.0.  This is available on all supported platforms
123   For all other architectures, Debian bookworm provides a new-enough Rust
124   compiler in the ``rustc-web`` package.
126   Also, on Ubuntu 22.04 or 24.04 this requires the ``rustc-1.77``
131   Build components whose absence does not affect the ability to build QEMU
136   of optional build-time dependency; in this case it is possible to
137   download them from repositories such as EPEL, to use container-based
138   cross compilation using ``docker`` or ``podman``, or to use pre-built
139   binaries distributed with QEMU.
142 -------
144 The project aims to support the two most recent versions of Windows that are
146 targeted is "Windows 8", so theoretically the QEMU binaries can still be run
151 The project supports building QEMU with current versions of the MinGW
154 problems with building via MSYS2. The building process of QEMU involves some
161 Only 64-bit Windows is supported.