Setting up Offline Qt License Server (QLS) for Squish

Last edited on

General

Starting with Squish 9.2.0 the new Qt License Server (QLS) is supported. QLS is used for serving licenses for several products from the Qt Group (Coco, Qt Creator, Squish).

The general documentation for QLS can be found here .

This article provides step by step instructions for a streamlined setup of QLS...

License Deployment Modes

The classic Floating License Server (FLS), which so far had been used for serving Squish licenses, could only be used on-premise offline, which means that the license server runs on a computer within your network ("on-premise"), and that it hosts the licenses without requiring an internet connection ("offline").

With the new Qt License Server, Squish licenses can be hosted in the same way. This is a setting called License Deployment Mode, which needs to be configured for each license.

On Premise Offline is not the default

Because the default deployment mode for new Squish licenses is not On-Premise Qt License Server (Offline Mode), please contact our technical support to request changing modes of your licenses as needed for this guide.

After this high level overview we will now explain the exact steps for the setup.

Installing Qt License Server

Install the license server

  1. Download the Qt License server from your Qt Account. Only the License Manager and Deputy License Managers can download the license server. If you do not have the correct permissions, please reach out to the License Manager in your company.

  2. Go to "Software Quality > Qt License Server" in your Qt Account and download the Qt License Server on premise installer for your operating system.

  3. Run the installer and follow the flow until the installation is finished. On Linux run the Installer in User space and not as root.

Configure the license server

To configure the license server go to the install location on your system, see the current defaults below:

Linux:

    /opt/QtLicenseServer-*.*.*/LicenseManagementTools/QtLicenseServer/*.*.*/QtLicenseServer/Linux_*

Windows:

    C:\Program Files\QtLicenseServer-*.*.*\LicenseManagementTools\QtLicenseServer\*.*.*\QtLicenseServer\Windows10_x86_64

Depending on the system running the license server you need to look for different files:

Linux:

    qt-license-server.service

Windows:

    qt-service.xml
  1. Configure the QLS_PORT key to the port you want the QLS to respond to clients on. You will need to know this port for Squish setups later on, to tell Squish which port the QLS is responding on.
  1. The SSL support in the license server can be configured via the QLS_ENABLE_SSL key. Set this to "no" if you do not have an SSL cert from your IT that could be used for the machine hosting the license server.

If the cert is obtained from a real CA authority then you only need to place the cert on the license server machine in the install location. If you have a self-signed certificate you will need to distribute it to all client machines.

  1. The key QLS_OPERATION_MODE key needs to be set to the value offline.

Install QLS as a system service

After you have configured the license server, we recommend to install the license server as a system service. For this to go the install directory of the license server and open a shell or terminal there.

Linux - Run installer.sh with root permissions. For example:

    sudo ./installer

Windows - Run qt-service.exe in a terminal with elevated permissions:

    qt-service.exe install

Start the service

On Windows you need to launch the service yourself with this command...

    sc start qtlicserver

...from a terminal with elevated permissions.

On Linux the installer.sh script launches the service automatically. To query the status:

    systemctl status qt-license-server.service

Install licenses in this QLS installation

  1. Acquire a fingerprint Id from the machine that will be running the QLS, for this execute the qt-license-server as below.

    qt-license-server generate-server-fingerprint

  2. With the generated Id, go to your Qt Account and on the License page (Licenses > My Licenses > License Details), insert it in the activation field and perform the activation. Choose the port you used in the configuration file before.

  3. Download the file entitlements.json file: Alt text

    Windows:

        Place the file in the install location of the license server (C:\Program Files\QtLicenseServer-*.*.*\LicenseManagementTools\QtLicenseServer\*.*.*\QtLicenseServer\Windows10_x86_64).

    Linux:

        Place the file in /opt/qt-license-server.

  4. (Optional) If you have an existing offline license from a different product that should be served on the same server, you can merge the content. Please find more details on this here .

  5. Restart the service for the license server so that the license is picked up.

    Windows:

         qt-service.exe stop
         qt-service.exe start
    

    Linux:

         systemctl daemon-reload
         systemctl restart qt-license-server.service
    
  6. Once you have done this, verify the registration with the status command :

    qt-license-server status -u http://localhost:QLS_PORT

If everything was performed correctly you will see an output similar to the one below in your terminal

License: xxxxxxxx-E | Name: | Seat amount: 1 | In use: 0 | Free: 1 | Usage rate: 0.00%
License: xxxxxxxx-T | Name: | Seat amount: 10 | In use: 0 | Free: 10 | Usage rate: 0.00%

With this the setup is complete.

Verification of connection with client

A simple way to verify if you can connect to the QLS from another machine is to use curl

    curl QLS_URL:QLS_PORT/api/v2/ping

Replace QLS_URL and QLS_PORT as appropriate for your setup.

If the command is correct you will get a JSON response similar to the output below:

{"message":"Pong","version":"3.6.3","SHA":"XXXXXXXXXXXXXXX","build_date":"2026-06-09"}

Usage of older Squish versions

Install Bridge Floating License Server

For Squish versions 9.1.0 and earlier you need to use a bridge floating-license server to connect to the QLS. This is an addition to the QLS Setup described above and can not be used alone.

  1. Download the latest Squish Floating License Server version from the Customer Portal under Downloads > Archived Versions.

  2. Run the installer and finish the installation with default paths.

  3. Use the configuration file you can get from here fls_bridge_license.cfg . The Port in this configuration can be changed as needed.

  1. Place the license file in the respective folder for the Floating license server

  2. Launch the FLS service or restart if it was running so that the correct license is picked up.

Install the qtlicd Service

Because the bridge will be running as a system service, you need to install the license daemon as a system service as well.

  1. Download the Qt License Service installer from your Qt Account from the same location where you got the license server.

  2. Run the installer and finish the installation. Ignore the URL, this will be configured later.

  3. With the installation completed find the Install Folder, see the defaults below.

    Linux:

         $HOME/LicenseService-3.6.3
    

    Windows:

         C:\LicenseService-3.6.3
    
  4. Install the service by running the command below.

    Linux:

         sudo ./installer.sh
    

    Windows:

         qtlicd --install
    
  5. Reboot your system, the service is launched on restart.

  6. After the reboot go to the qtlicd install folder and run the command below

     qtlicensetool.exe --accept-terms-and-conditions
    
  7. In the qtlicd.ini set the server_addr value to the URL of your QLS (example http://localhost:QLS_PORT). See the locations below as to where to find the qtlicd.ini file

    Linux:

         /opt/qtlicd
    

    Windows:

         C:\Program Files\qtlicd
    
  8. Restart the qtlicd service so that the correct information is picked up.

With this the setup is complete.