Diagnose Qt License Service

Qt License Service is a background process that handles license reservation requests. Qt License Service is started on-demand and normally it doesn't require any actions or maintenance from the user.

However, if you're having issues with license reservations, try diagnosing the problem with these steps.

If you have a specific issue, see Troubleshooting Qt License Service.

Check Qt License Service logs

Qt License Service keeps a log of its operation. To investigate possible issues, check the logs from the Tools/LicenseService/ directory.

If the excisting info level logs do not provide any details about the issue, increase the logging level:

  1. Start Qt License Service with debug or silly logging level.
    qtlicd --mode cli --log-level silly
  2. Try making license reservations (for example, start Qt Creator).
  3. Check the logs.
  1. Start Qt License Service with debug or silly logging level.
    qtlicd --mode cli --log-level silly
  2. Try making license reservations (for example, start Qt Creator).
  3. Check the logs.
  1. Start Qt License Service with debug or silly logging level.
    qtlicd.exe --mode cli --log-level silly
  2. Try making license reservations (for example, start Qt Creator).
  3. Check the logs.

To control the logging feature, use the following options.

OptionDescription
--log-level <none|error|warning|info|debug|silly>Sets the logging level
--nologfileDisables logging in the file
--nostdoutDisables logging in stdout

Check server address

If you're using an on-premises Qt License Server, make sure you have configured the server address correctly. For more information, see Configure the server address.

Check local license cache

Check if there are issues in the Qt License Service license cache. For more information, see License cache.

Verify Qt License Service installation

Make sure the Qt License Service installation is registered correctly. Open the installations.ini file and check that it contains the installation path. For more information, see Configuration file locations.

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