Qt License Service operation
Qt Online Installer installs and configures Qt License Service automatically. You do not need to use or start it manually. The default operation mode is on-demand mode which means that Qt License Service is launched automatically in the background if an application requires a license and Qt License Service is not running yet. If an application that uses a license is running, Qt License Service remains active. However, when the last application requiring a license is closed Qt License Service shuts down after 60 seconds of inactivity.
To debug or diagnose potential issues, you can start Qt License Service manually:
./qtlicd --mode cli --log-level error|warning|info|debug|silly
.\qtlicd.exe --mode cli --log-level error|warning|info|debug|silly
Usage
To use qtlicd, enter the following command:
./qtlicd [option] [value]
For example, to set the log level to debug from the command line, enter:
./qtlicd --log-level debug --mode cli
.\qtlicd.exe [option] [value]
For example, to set the log level to debug from the command line, enter:
.\qtlicd.exe --log-level debug --mode cli
Note: If you launch qtlicd from the command line, the --mode option is required.
Help
To view an up-to-date list of options and values, enter:
./qtlicd --help
.\qtlicd.exe --help
Options
The following table summarizes the available options and their arguments.
| Option | Value | Description |
|---|---|---|
--version | None | Lists qtlicd version number, revision, and build date. |
--mode | The operating mode:
| Sets the operating mode. |
--log-level | Log level:
| Sets the logging level. |
--port | <port number> | Sets the TCP/IP server port. Leave empty to use the default port. |
--nologfile | None | Do not record logs into a file. |
--nostdout | None | Do not print logs to stdout. |
--register | None | Only for on-demand mode: adds the qtlicd executable into the installations.ini file of a Qt License Service that you installed manually and run as an on-demand service.If you use another user ID than the one that comes from the operating system by default, set it as the value of this command. For example, admin or john. |
--add-key-value | <key=value> | Adds a key-value pair to the installations.ini file when using the --register option. |
--deregister | None | Only for on-demand mode: removes the qtlicd executable from the installations.ini file. |
--install | None | Installs the qtlicd executable as a system service. |
--delete | None | Removes the qtlicd executable from system services. |
Environment variables
Use environment variables according to your preferences.
| Environment variable | Description |
|---|---|
QTLICD_CLIENT_USERNAME | Force a different username. Default is the current host machine's logged-in username. |
QTLICD_LICENSE_IMPORT_PATH | Override the path to import local license files from, for offline usage only. |
QTLICD_CLIENT_LOG_TO_STDOUT=true|false | Allow logging in stdout. |
QTLICD_CLIENT_LOG_TO_FILE=<filepath> | Allow logging into a file. |
QTLICD_LOG_LEVEL <error|warning|info|debug|silly> | Set license Service debug level. |
Importing local license files
You can download your named licenses from Qt Customer Portal. In the zipped folder, the license_<license-id>.json file is the license file.
You can save the folder to the root directory or use the QTLICD_LICENSE_IMPORT_PATH environment variable. Then Qt License Service imports the license automatically and you can use Qt and QA products without a network connection.
See also Install Qt License Service manually and Qt License Service configuration.
© 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.
