Enterprise Qt Debian Packages

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

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 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 <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 find the Qt releases that the Enterprise Qt Debian packages support. 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.

Qt Creator

Qt 6.3.2

Qt 6.3.1