Qt for Linux/X11
Qt's support for different Linux platforms is extensive and mature.
To download and install Qt for Linux, follow the instructions on the Getting Started with Qt page.
Supported Configurations
The following configurations are supported.
| Distribution | Architecture | Compiler | Notes |
|---|---|---|---|
| Red Hat 8.6 | x86_64 | GCC 10 (toolset) | |
| Red Hat 8.8 | x86_64 | GCC 10 (toolset) | |
| Red Hat 9.2 | x86_64 | GCC 11 | |
| openSUSE 15.5 | x86_64 | GCC 9, GCC 10, GCC 11, GCC 12 | |
| SUSE Linux Enterprise Server 15 SP5 | x86_64 | GCC 10 | |
| Ubuntu 22.04 | x86_64 | GCC as provided by Canonical, GCC 11.x | |
| Ubuntu 24.04 | x86_64, arm64 | GCC as provided by Canonical, GCC 13.x | See the note. |
| Debian 11.6 | x86_64, arm64 | GCC 10 | Technology Preview See also: Enterprise Qt Debian Packages. |
Note: For Linux on Arm on desktops, we use Raspberry Pi 5 with 8GB RAM and Ubuntu 24.04 as a reference platform. If you have an issue with another hardware, please try to reproduce the issue on Raspberry Pi 5. We plan to move to regular platform support when a wider range of ARM-based desktop hardware becomes available.
Requirements for Development Host
The Qt installers for Linux assume that a C++ compiler, debugger, make, and other development tools are provided by the host operating system. In addition, building graphical Qt applications requires Qt for X11 Requirements, and OpenGL libraries and headers installed. Most Linux distributions do not install all of these by default, but setting up a development environment is still straightforward.
Use the following commands to install the basic requirements for building Qt applications:
Debian/Ubuntu (apt-get)
sudo apt-get install build-essential libgl1-mesa-dev
Fedora/RHEL/CentOS (yum)
sudo yum groupinstall "C Development Tools and Libraries" sudo yum install mesa-libGL-devel
openSUSE (zypper)
sudo zypper install -t pattern devel_basis
Building Qt from Source
You can also build Qt from the source package and configure it according to your target platform. The source packages are obtained from http://www.qt.io/download/.
Below, you will find more information about building Qt from source.
Deployment and Other Issues
The pages below covers specific issues and recommendations for creating Linux/X11 applications.
Where to Go from Here
We invite you to explore the rest of Qt. We prepared overviews which help you decide which APIs to use and our examples demonstrate how to use our API.
- Qt Overviews - list of topics about application development
- Examples and Tutorials - code samples and tutorials
- Qt Reference Pages - a listing of C++ and QML APIs
Qt's vibrant and active community site, http://qt.io houses a wiki, a forum, and additional learning guides and presentations.
© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
