Qt Commercial Installation Commands
Important
You can only install for the OS running the CLI
All commands require authentication:
It first looks into the folder of your OS where the file
qtaccount.ini
can be:Windows:
C:\Users\<username>\AppData\Roaming\Qt\qtaccount.ini
Linux:
/home/<username>/.local/share/Qt/qtaccount.ini
MacOS:
/Users/<username>/Library/Application Support/Qt/qtaccount.ini
This file is automatically created when you use the
MaintenanceTool
binary and log in using the GUI. It is also created the first time you use the CLI or any mean to authenticate. You can simply copy the file that you have on your PC to your CI server, it will work across platforms. Just treat it as a password. Refer to this page for more details.It will also check the value of the environment variable
QT_INSTALLER_JWT_TOKEN
and use the token if provided.If neither are present, you will need to provide
--user <email> --password <password>
. Note that if--user
and--password
are provided, they will supersede theqtaccount.ini
and the JWT token account. Those also get superseded by--override --email --pw
in the CLI
install-qt-commercial
Install Qt commercial packages using the official Qt installer.
aqt install-qt-commercial <target> <arch> <version> [options]
Arguments
target
- Target platform (desktop, android, ios)arch
- Target architectureversion
- Qt version to install
Options
--user <username>
- Qt account username--password <password>
- Qt account password--modules <module1> <module2> ...
- Additional Qt modules to installVery broad meaning, aka
packages
orcomponents
(see here). Extensions, wasm, src… are ‘modules’If none are inputed, the package
qtX.Y.Z-essentials
is downloaded (default Qt install, includesqtcreator
…)If
all
is inputed, the packageqtX.Y.Z-full
is downloaded (includes everything)
--outputdir <path>
- Installation directory (default: current directory)--override <args...>
- Pass all remaining arguments directly to the Qt installer CLI
list-qt-commercial
Search available Qt commercial packages.
aqt list-qt-commercial [search_terms] [options]
Options
--user <username>
- Qt account username--password <password>
- Qt account passwordsearch_terms
- Terms to search for in package names (grabs all that is not other options)
Override Mode
install-qt-commercial
supports an override mode that passes all arguments after --override
directly to the Qt installer CLI, and will ignore all the other params except --user
and --password
if given prior to it
aqt install-qt-commercial --override [installer_args... --email email --pw password]
aqt install-qt-commercial --user user --password pass --override [installer_args...]
When using override mode:
All standard command options are ignored
Arguments are passed directly to the Qt installer
The
--email
/--pw
flags in the override arguments are used for authenticationRegular
--user
/--password
can still provide fallback authentication
Examples
# Standard installation
aqt install-qt-commercial desktop linux_gcc_64 6.8.0 --user user@example.com --password pass
# Installation with modules
aqt install-qt-commercial desktop linux_gcc_64 6.8.0 --user user@example.com --password pass --modules qtcharts qtnetworkauth
# List packages containing 'wasm'
aqt list-qt-commercial wasm --user user@example.com --password pass
# Override mode
aqt install-qt-commercial --override install qt.qt6.680.gcc_64 --email user@example.com --pw pass
Advanced configs
The file located in ./aqt/settings.ini
can be edited in the [qtcommercial]
part to fine tune the official installer (more details here):
[qtcommercial]
unattended : True # Removes needs of user interaction, and simplifies the --override option as well by passing flags by default to remain unattended
installer_timeout : 1800
operation_does_not_exist_error : Ignore
overwrite_target_directory : No
stop_processes_for_updates : Ignore
installation_error_with_cancel : Ignore
installation_error_with_ignore : Ignore
associate_common_filetypes : Yes
telemetry : No
cache_path : # When empty, will use ~/.local/share/aqt/cache or equivalent for your OS
temp_dir : # When empty, will use ~/.local/share/aqt/tmp or equivalent for your OS