docs/about/build-platforms.rst

1 .. _Supported-build-platforms:
3 Supported build platforms
7 platforms. This appendix outlines which platforms are the major build
25 support for those backports, unless the feature is auto-detectable in a
32 You can find how to install build dependencies for different systems on the
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
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 -----------------------------------------
77 first. In this context, third-party efforts to extend the lifetime of a distro
78 are not considered, even when they are endorsed by the vendor (eg. Debian LTS);
80 releases (e.g. Debian backports). Within each major release, only the most
84 the project will look at CentOS, Debian, Fedora, openSUSE, RHEL, SLES and
93 Some build dependencies may follow less conservative rules:
96   Distributions with long-term support often provide multiple versions
100   In this case, it will be necessary to use the ``--python`` command line
106 Python build dependencies
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.
113 Rust build dependencies
119   a newer version using ``cargo install bindgen-cli``.
122   with one exception, namely the ``mips64el`` architecture on Debian bookworm.
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``
130 Optional build dependencies
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
142 -------
152 toolchain, either hosted on Linux (Debian/Fedora) or via `MSYS2`_ on Windows.
156 build process to successfully complete. On newer versions of Windows 10,
161 Only 64-bit Windows is supported.