On-Prem: Register licenses

After installing and setting up your On-Prem Qt License Server instance, you need to register the licenses you want to use from your Qt Account. You can register licenses as the license manager, administrator, or deputy license manager. You can edit the users of a license in Qt Customer Portal. For more information, see On-Prem: Assign roles for license management.

After the licenses are registered, the On-Prem Qt License Server instance syncs licenses from the Qt cloud regularly. If the host computer or the On-Prem Qt License Server instance is restarted for any reason, the previously used licenses are automatically re-registered by the instance.

For more information about the license registration logic, special cases, and possible license conflicts, see On-Prem: License registrations.

Prerequisites

Before you register licenses for your On-Prem Qt License Server instance, ensure that:

• You have valid site or floating licenses in your Qt Account.
• Your On-Prem Qt License Server instance is set up and running.
• You know the URL of your On-Prem Qt License Server instance.

Optionally, you can set up environment variables for your Qt Account credentials instead of using the --email and --password options:

• QLS_QT_ACCOUNT_LOGIN_EMAIL
• QLS_QT_ACCOUNT_LOGIN_PASSWORD

Register all licenses

To implicitly register all applicable licenses in the given Qt Account for your On-Prem Qt License Server instance, run:

qt-license-server register --email <email> --password <pass> --url <instance URL>

qt-license-server.exe register --email <email> --password <pass> --url <instance URL>

Then, review the changes and confirm your action when prompted to proceed. To bypass the confirmation prompt, add the --force option to the command.

Register specific licenses

To explicitly register only specific licenses in the given Qt Account with a license ID, run:

qt-license-server register --email <email> --password <pass> --url <instance URL> --licenses <license number1> <license number2>

qt-license-server.exe register --email <email> --password <pass> --url <instance URL> --licenses <license number 1> <license number 2>

Then, review the changes and confirm your action when prompted to proceed. To bypass the confirmation prompt, add the --force option to the command.

Validate registered licenses

To verify the currently registered licenses with your On-Prem Qt License Server instance, run:

./qt-license-server status --url <URL>

.\qt-license-server.exe status --url <URL>

In case the registered licenses are not updated as expected, check the logs. Contact Qt Support if the issue persists.