Qt License Service configuration
Qt Online Installer configures Qt License Service automatically and you should not touch the configuration files unless you need to investigate potential issues. The only exception is the configuration file where you need to define the on-premises instance address.
Configuration file locations
The table below summarizes the locations of the Qt License Service configuration files.
| File | Location |
|---|---|
| Configuration file | /home/<user>/.local/share/Qt/qtlicd/qtlicd.ini |
| On-demand startup registration file | /home/<user>/.local/share/Qt/qtlicd/installations.ini |
| On-demand TCP port configuration file | /home/<user>/.local/share/Qt/qtlicd/port.ini |
| License cache | /home/<user>/.local/share/Qt/qtlicd/cache |
| Qt Account configuration file | /home/<user>/.local/share/Qt/qtaccount.ini |
| File | Location |
|---|---|
| Configuration file | $HOME/Library/Application Support/Qt/qtlicd/qtlicd.ini |
| On-demand startup registration file | $HOME/Library/Application Support/Qt/qtlicd/installations.ini |
| On-demand TCP port configuration file | $HOME/Library/Application Support/Qt/qtlicd/port.ini |
| License cache | $HOME/Library/Application Support/Qt/qtlicd/cache |
| Qt Account configuration file | $HOME/Library/Application Support/Qt/qtaccount.ini |
| File | Location |
|---|---|
| Configuration file | C:\Users<user>\AppData\Roaming\Qt\qtlicd\qtlicd.ini |
| On-demand startup registration file | C:\Users\<user>\AppData\Roaming\Qt\qtlicd\installations.ini |
| On-demand TCP port configuration file | C:\Users\<user>\AppData\Roaming\Qt\qtlicd\port.ini |
| License cache | C:\Users\<user>\AppData\Roaming\Qt\qtlicd\cache |
| Qt Account configuration file | C:\Users\<user>\AppData\Roaming\Qt\qtaccount.ini |
Configuration file: qtlicd.ini
The table below summarizes the available configuration options.
| Option | Default | Description |
|---|---|---|
server_addr | Empty | Address and port of an on-premises Qt License Server. If you're using an on-premises Qt License Server, set the address accordingly. Address and port must be in format <server IP address>:<port> or <server url>:<port>. |
ca_bundle_path | auto | Path to a CA bundle file containing root and intermediate certificates. Set an absolute path or auto to attempt auto-detection of the CA bundle path. If a valid CA bundle cannot be found, /etc/ssl/certs is used as a fallback. Change only if Qt License Service cannot find the CA bundle path from the default location or you use a self-signed certificate for the server.Note: This setting will only have effect on Linux. |
tcp_listening_port | 0 | TCP/IP port where Qt License Service is listening for requests. Set the value to 0 to automatically find and assign to a free port based on an operating system specific range. Set a positive value to manually set the port. |
queue_min_retry_interval | 1000 | The server can be temporarily overloaded. This is the minimum time in milliseconds after which queued requests are performed again. |
queue_max_retry_time | 10000 | Maximum retry interval time after each reservation attempt in milliseconds. After each reservation attempt, queue_interval_increment increments the time. |
queue_interval_increment | 1000 | Time added to the retry interval after each reservation attempt in milliseconds. |
on_demand_shutdown_timeout | 60 | Maximum time in seconds between requests after which Qt License Service in on-demand mode will automatically shut down. |
hw_id | Empty | Hardware ID of the host machine. Qt License Service sets this automatically on the first run. To reset it, remove the value and restart Qt License Service. Warning: Qt License Service sets this automatically. Do not edit the value. |
On-demand startup registration file: installations.ini
The installations.ini file is maintained automatically. The file should look like this:
[_home_user_some_path_qtlicd] path=/home/<user>/<some_path_here>/qtlicd(.exe) source=qt_installer timestamp=2024-02-14 08:21:09 version=3.2.1
If the Qt License Service executable is not listed in this file, register it manually by:
<QtSDK>/Tools/LicenseService/qtlicd --register
<QtSDK>/Tools/LicenseService/qtlicd --register
<QtSDK>\Tools\LicenseService\qtlicd.exe --register
On-demand TCP port configuration file: port.ini
You do not need to touch the port.ini file. It is generated and maintained automatically.
If the automatic on-demand TCP port configuration file cleanup fails, delete the file.
License cache
Qt License Service caches your license reservations in a cache folder. This allows you to continue your work even if there is a network outage.
Warning: Do not alter the contents of this folder.
To manually purge your current reservations:
<QtSDK>/Tools/LicenseService/qtlicensetool --clear-reservations
<QtSDK>/Tools/LicenseService/qtlicensetool --clear-reservations
<QtSDK>\Tools\LicenseService\qtlicensetool.exe --clear-reservations
This clears your local license cache and attempts to release those on Qt License Server as well.
Qt Account configuration file: qtaccount.ini
The Qt Account login's JSON Web Token (JWT) is stored in the qtaccount.ini file. The JWT is used for authenticating the license reservation requests. If the JWT expires, refresh it by logging into your Qt Account:
- Using Qt Online Installer or Qt Maintenance Tool.
- From the command line:
<QtSDK>/Tools/LicenseService/qtlicensetool --login
<QtSDK>/Tools/LicenseService/qtlicensetool --login
<QtSDK>\Tools\LicenseService\qtlicensetool.exe --login
See also Qt License Service operation and Install Qt License Service manually.
© 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.
