Manage license reservations manually with Qt License Service

By default, Qt License Service automatically finds the most suitable license for each user depending on the consumer application. This means you don't need to manually manage license reservations for most use cases. For more information, see License reservation logic.

However, if the license check integration is not available for the tool you use, you can reserve, renew, and release license reservations manually. You can use qtlicensetool (qtlicensetool.exe) with any Qt License Server type for this purpose.

Get qtlicensetool

If you installed your Qt or QA products using Qt Online Installer, qtlicensetool is automatically installed. You can find it in the following location depending on your operating system.

If you installed Qt License Service separately, you can find qtlicensetool in the installation directory of Qt License Service. For more information, see Install Qt License Service manually.

Reserve a license

To reserve a license manually, run:

./qtlicensetool --reserve <consumer_id> <consumer_version>

.\qtlicensetool.exe --reserve <consumer_id> <consumer_version>

The reservation command requires the consumer_id and consumer_version parameters. consumer_id is the ID of the consumer application. The following table lists the supported consumer IDs.

consumer_version is the version number of the consumer application. You can find the version information from the About dialog of the application or from the Qt Maintenance Tool.

Example reservation

In the following example, we reserve a license for Qt Framework 6.11.1.

./qtlicensetool --reserve qtframework 6.11.1

.\qtlicensetool.exe --reserve qtframework 6.11.1

Renew a license

Instead of letting Qt License Service automatically renew licenses, you can manually renew the currently cached reservations that have not yet expired.

To renew a license, run:

./qtlicensetool --renew-reservations

.\qtlicensetool.exe --renew-reservations

Release a license

You can release license reservations from the local cache before the lease time ends, but the reservations are not released from the server. Qt License Server releases the reservations for named and pool licenses when the lease time of the reservation expires. Reservations with floating licenses are released immediately once the consuming application terminates. For more information, see License types.

To release a license reservation, run:

./qtlicensetool --clear-reservations

.\qtlicensetool.exe --clear-reservations