Building Qt Sources

You can install Qt by building Qt sources. This is useful if, for example:

• You need a custom build (for example, with patches or debug options).
• Your platform isn't supported by pre-built packages.
• You're contributing to Qt or debugging its internals.

The installation procedure is different on each Qt platform. This page provides relevant information for the supported platforms and links to module-specific system requirements.

General Installation Information

When you build Qt sources, you use the configure tool to configure Qt for a particular platform with a particular set of Qt features or modules. For more information, see Qt Configure Options.

The Build and Installation Process

A brief overview of the build and installation process:

1. Download the Qt source code and set up the initial environment.
2. Configure the build according to the use case, such as development on the host system or cross-compilation for a target platform.
3. Build (compile) in a separate directory.
4. Optional. Install the built artifacts.

Platform-Specific Installation Information

Windows

• Qt for Windows - Building from Source

macOS

• Qt for macOS - Building from Source

Linux/X11

• Qt for X11 Requirements
• Qt for Linux/X11 - Building from Source

Embedded Linux

• Configure an Embedded Linux Device
• Qt for Embedded Linux

Android

• Qt for Android - Building from Source

iOS

• Qt for iOS - Building from Source

Module-specific System Requirements

• Building Qt WebEngine from Source
• Building Qt Quick 3D from Source
• Building Qt Multimedia from Source
• Qt GRPC and Qt Protobuf Module Requirements

Additional Information

The top-level qt5 Git repository contains a set of build instructions in the form of provisioning scripts, used by Qt's continuous integration (CI) system to build and test the Supported Platforms. These scripts are useful for anyone building Qt from source, as they provide information on the tools and components that are required for each configuration.

• Building Optimized Qt
• qt/qt5.git CI provisioning for Qt 6.11
• CI Overview in Qt Wiki
• Building Qt Documentation