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.

DistributionArchitectureCompilerNotes
Red Hat 8.6x86_64GCC 10 (toolset)
Red Hat 8.8x86_64GCC 10 (toolset)
Red Hat 8.10x86_64GCC 10 (toolset)
Red Hat 9.2x86_64GCC 11
Red Hat 9.4x86_64GCC 11
openSUSE 15.5x86_64GCC 9
SUSE Linux Enterprise Server 15 SP5x86_64GCC 10
Ubuntu 22.04x86_64GCC as provided by Canonical, GCC 11.x
Ubuntu 24.04x86_64, arm64GCC as provided by Canonical, GCC 13.xSee the note.
Debian 11.6x86_64, arm64GCC 10Technology 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's vibrant and active community site, http://qt.io houses a wiki, a forum, and additional learning guides and presentations.