Generate a custom offline installer
If your organization creates its own offline installer, you can configure the installer to use your On-Prem Qt License Server or Offline Qt License Server instance for license checks instead of the Qt Account based license check. Follow these instructions to ensure the generated offline installer is compatible with your Qt License Server instance.
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.
Note: On-Prem Qt License Server is available in version 3.3.0 or later.
- With Offline Qt License Server, verify the license information from the
entitlement.jsonfile in the root folder of the Offline Qt License Server installation directory. For more information, see Compose entitlement.json from multiple licenses.
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
| Option | Possible values | Description |
|---|---|---|
--confirm-command | None | For unattended usage. |
--auto-answer |
| Answers installer prompted questions automatically with given values. |
--default-answer | None | Answers all message queries with their default answer. |
--accept-licenses | None | Automatically accepts all license agreements required by the components to be installed. |
--root | File path | Defines the path for the offline installer. |
--offline-installer-name | File name | Defines a name for the offline installer. |
--license-id | License id | Overrides the license ID from Qt Account. Optional. |
--proxy-url | URL | Defines the full address of the Qt License Server instance. Use format: https://my.server.com:8080. Only for generating the offline installer. |
--email | Sets your Qt Account email. Only for generating the offline installer. | |
--pw | Password | Sets your Qt Account password. Only for generating the offline installer. |
For more information, see Unattended Usage.
See also On-Prem Qt License Server and Offline Qt License Server.
© 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.