Enterprise Qt Debian Packages | Qt 6.7 (original) (raw)

To use Enterprise Debian packages 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:

• Install a public GPG key for enterprise repositories
• Configure Qt Account based authentication for enterprise repository access
• Configure repositories

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= signed-by=] <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.8.0-arm64 tqtc-jammy 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 Enterprise Qt 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:

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

Debian Alias Packages

You can install the content more easily with alias packages, which are just meta-packages pointing to the actual Debian packages.

The contents of the Debian alias packages are listed in the table below.

Note: Qt 6.7.0 release is used in the alias package examples listed below. Always remember to use the packages that match the Qt release you are working on. For more information, see Repository information for Qt Releases.

Debian Installation Command Example

$ sudo apt install qt6.7.0-full-dev

Full Configuration Example

The following code snippet demonstrates the whole work flow with Enterprise 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 password

add repositories

$ sudo nano /etc/apt/sources.list.d/tqtc.list deb [arch=arm64 signed-by=/home//keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.8.0-arm64 tqtc-jammy main

update local package cache

$ sudo apt-get update

search and install packages

$ apt-cache search qt6.7.0-full-dev .... ....

files are installed under /opt/qt-6.7.0

$ sudo apt install qt6.7.0-full-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:

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

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

deb [...] https://:@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 packages 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 compatible with the packages.

Note: To access the listed repositories, you need an evaluation Qt Account or a commercial Qt Account with a Qt for Device Creation license.

Note: The packages may work on other distributions as well but there is no guarantee on that.

Qt Creator

Qt 6.7.0

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