Generate a custom offline installer for Qt License Server

Follow these instructions to ensure the generated offline installer is compatible with your On-Prem Qt License Server or Offline Qt License Server instance.

Note: This is relevant if your organization wants to create the offline installer, and instead of using Qt Account based license check, you can configure offline installer to use On-Prem Qt License Server or Offline Qt License Server for license checks.

Get the license information

Ensure you have a list of the license numbers to use with the offline installer.

With On-Prem Qt License Server, verify the license information from your Qt Customer Portal.

With Offline Qt License Server, verify the license information from the entitlement.json file in the root folder of the Offline Qt License Server installation directory.

Note: On-Prem Qt License Server is available in version 3.3.0 or later.

Generate offline installer

Note: Use Qt Online Installer 4.8.1 or later.

The generated offline installer contains the license ID. By default, the license ID is from the used Qt Account (--email). Override this with --license-id.

To generate the offline installer, enter the following command:

qt-unified-linux-x64-4.8.0-online.run create-offline qt.qt5.5158.gcc_64
    --confirm-command
    --auto-answer telemetry-question=Yes,AssociateCommonFiletypes=Yes
    --default-answer
    --accept-licenses
    --root $HOME/MyOfflineInstallerFolder
    --offline-installer-name myOfflineInstallerName
    --license-id <license id>
    --proxy-url <server URL>
    --email <account@email.com>
    --pw <password>
qt-online-installer-windows-x64-4.8.1.exe create-offline qt.qt5.5158.gcc_64
    --confirm-command
    --auto-answer telemetry-question=Yes,AssociateCommonFiletypes=Yes
    --default-answer
    --accept-licenses
    --root C:\Users\<username>\MyOfflineInstallerFolder
    --offline-installer-name myOfflineInstallerName
    --license-id <license id>
    --proxy-url <server URL>
    --email <account@email.com>
    --pw <password>

For the component names, see Component names for installation.

Use offline installer

To use the generated offline installer, enter the following command:

$HOME/<installer name>/offlineInstaller.run install qt.qt5.5158.gcc_64
    --confirm-command
    --auto-answer telemetry-question=Yes,AssociateCommonFiletypes=Yes
    --default-answer
    --accept-licenses
    --root $HOME/InstallationDestinationPath
    --license-id <license id>
C:\Users\<username>\<installer name>\offlineInstaller\offlineInstaller.exe install qt.qt5.5158.gcc_64
    --confirm-command
    --auto-answer telemetry-question=Yes,AssociateCommonFiletypes=Yes
    --default-answer
    --accept-licenses
    --root C:\Users\<username>\InstallationDestinationPath
    --license-id <license id>

Note: As the end-user of the offline installer, you can override the license IDs from Qt Account by using the --license-id option. Use this if the license ID hosted by Qt License Server has changed.

Options

OptionPossible valuesDescription
--confirm-commandNoneFor unattended usage.
--auto-answer
  • telemetry-question=Yes|No
  • AssociateCommonFiletypes=Yes|No
Answers installer prompted questions automatically with given values.
--default-answerNoneAnswers all message queries with their default answer.
--accept-licensesNoneAutomatically accepts all license agreements required by the components to be installed.
--rootFile pathDefines the path for the offline installer.
--offline-installer-nameFile nameDefines a name for the offline installer.
--license-idLicense idOverrides the license ID from Qt Account. Optional.
--proxy-urlURLDefines the full address of the On-Prem Qt License Server or Offline Qt License Server instance. Use format: https://my.server.com:8080. Only for generating the offline installer.
--emailEmailSets your Qt Account email. Only for generating the offline installer.
--pwPasswordSets your Qt Account password. Only for generating the offline installer.

For more information, see Unattended Usage.

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