Qt for Linux/X11

Platform support 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 8.10	x86_64	GCC 10 (toolset)
Red Hat 9.2	x86_64	GCC 11
Red Hat 9.4	x86_64	GCC 11
Red Hat 9.6	x86_64	GCC 11
openSUSE 15.6	x86_64	GCC 9, GCC 10, GCC 11, GCC 12
SUSE Linux Enterprise Server 15 SP6	x86_64	GCC 11
Ubuntu 22.04	x86_64	GCC as provided by Canonical, GCC 11.x	See also: Enterprise Qt Debian Packages .
Ubuntu 24.04	x86_64, arm64	GCC as provided by Canonical, GCC 13.x	See the note regarding Linux on Arm desktop support.
Debian 11.6	x86_64, arm64	GCC 10	See the note regarding Linux on Arm desktop support.
Debian 12	x86_64, arm64	GCC 12	See also: Enterprise Qt Debian Packages . See the note regarding Linux on Arm desktop support.

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. The official binaries in Qt Online Installer are built on Ubuntu 24.04 which ships with glibc 2.39, if your glibc is older than what we build with, you need to rebuild from sources.

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.

• Qt for X11 Requirements

• Qt for Linux/X11 - Building from Source

Deployment and Other Issues

The pages below covers specific issues and recommendations for creating Linux/X11 applications.

• Qt for Linux/X11 - Deployment

• Qt for Linux/X11 - Specific Issues

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, https://www.qt.io houses a wiki, a forum, and additional learning guides and presentations.