On-Prem: Deregister licenses

To remove licenses from an On-Prem Qt License Server instance, you need to deregister the licenses. You can manage 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.

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

Prerequisites

Before you deregister licenses from your On-Prem Qt License Server instance, ensure that you know the URL of your On-Prem Qt License Server instance and which licenses you want to deregister.

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

• QLS_QT_ACCOUNT_LOGIN_EMAIL
• QLS_QT_ACCOUNT_LOGIN_PASSWORD

Deregister all licenses

To implicitly deregister all currently registered licenses, run:

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

qt-license-server.exe deregister --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.

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.