Enterprise Qt Debian Packages

To use Debian packaging with Qt, add your enterprise repositories to Advanced Packaging Tool (APT). For details, see Debian Repository Configuration Format.

To use the enterprise repositories, you need to:

Debian Repository Configuration Format

To add extra repositories for APT, insert repositories into a file with an extension of .list under the /etc/apt/sources.list.d directory. For each repository, add a new entry in the file. The generic format is as follows:

deb [arch=<arch> signed-by=<path>] <REPO_URL> <DIST> <COMPONENT(s)>

An example of an enterprise repository entry:

$ sudo nano /etc/apt/sources.list.d/tqtc.list

    deb [arch=arm64 signed-by=/home/<user>/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.3.1-arm64 tqtc-focal main

See Repository information for Qt Releases for detailed information on how you can configure repositories per Qt release and architecture.

Installing Public GPG Key

Install a public GPG (GNU Privacy Guard) key for Qt Enterprise Debian repositories as follows:

$ mkdir -p $HOME/keyrings/tqtc  # pick a suitable location for you!
$ cd $HOME/keyrings/tqtc
$ wget https://cdn.qt.io/debian/keys/qt-company-debian-repo.gpg

Configuring Authentication

To access the listed repositories, you need an enterprise Qt Account or an evaluation Qt Account.

Note: If your password contains special characters, you may need to escape those by using '\' or '%40'.

Configure the Qt Account credentials for your APT package manager as follows:

$ sudo nano /etc/apt/auth.conf

      machine https://debian-packages.qt.io
      login <Qt Account login name (email)>
      password <Qt Account password>

Updating Local Package Cache

Update the local package cache as follows:

$ sudo apt-get update

No errors should originate from the added repository in the output.

Full Configuration Example

The following code snippet demonstrates the whole work flow with Qt Debian packages:

# install repository key
$ mkdir -p $HOME/keyrings/tqtc
$ cd $HOME/keyrings/tqtc
$ wget https://cdn.qt.io/debian/keys/qt-company-debian-repo.gpg

# configure Qt Account based authentication to Qt Debian repositories
$ sudo nano /etc/apt/auth.conf
  machine https://debian-packages.qt.io
  login <your Qt Account email>
  password <your Qt Account password>

# add repositories
$ sudo nano /etc/apt/sources.list.d/tqtc.list
    deb [arch=arm64 signed-by=/home/<user>/keyrings/tqtc/qt-company-debian-repo.gpg]
    https://debian-packages.qt.io/debian/enterprise/qt-6.3.1-arm64 tqtc-focal main

# update local package cache
$ sudo apt-get update

# search and install packages
$ apt-cache search qt6.3.1
....
....
# files are installed under /opt/qt-6.3.1/
$ sudo apt-get install qt6.3.1-declarative-dev qt6.3.1-declarative-private-dev ...

See Repository information for Qt Releases to pick the needed repositories into your /etc/apt/sources.list.d/tqtc.list file.

Troubleshooting

Difficulties in authentication

The server may response with the following HTTP error codes:

401 Unauthorized

Wrong credentials. User email and password must be provided in correct format.

Also, try storing the credentials directly into the repository config:

deb [...] https://<Qt Account email>:<Qt Account passwd>@https://debian-packages.qt.io/.....

If your password contains special characters, you may need to escape those for APT. Use '' or '%40' for escaping those characters or try changing your Qt Account password.

403 Forbidden

Missing credentials.

429 Too Many Requests

User has sent too much failed requests (3 requests per minute).

500 Internal Server Error

Contact Qt support.

Difficulties with repository GPG key usage

An alternative to 'signed-by' usage attribute in the repository config is to install the key in the following way, althoug this is not recommended as it's deprecated way to install it:

$ sudo apt-key add qt-company-debian-repo.gpg

Repository information for Qt Releases

Below you can find the Qt releases that the enterprise Qt Debian packaging supports. Pick the needed repositories and add them to your /etc/apt/sources.list.d/tqtc.list as instructed above.

Also, the following tables list the installation directories on your system and the Linux distribution used to build the packages.

Qt 6.3.2

ArchitectureDistribution (build platform)Installation directoryPackage resource list entries for APT
amd64focal-fossa (Ubuntu 20.04)/opt/qt-6.3.2/aarch64-linux-gnu/deb [arch=amd64 signed-by=<path>] https://debian-packages.qt.io/debian/enterprise/qt-6.3.2-amd64 tqtc-focal main

Qt 6.3.1

ArchitectureDistribution (build platform)Installation directoryPackage resource list entries for APT
amd64focal-fossa (Ubuntu 20.04)/opt/qt-6.3.1/aarch64-linux-gnu/deb [arch=amd64 signed-by=<path>] https://debian-packages.qt.io/debian/enterprise/qt-6.3.1-amd64 tqtc-focal main
arm64focal-fossa (Ubuntu 20.04)/opt/qt-6.3.1/x86_64-linux-gnu/deb [arch=arm64 signed-by=<path>] https://debian-packages.qt.io/debian/enterprise/qt-6.3.1-arm64 tqtc-focal main

© 2023 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.