aqtinstall
can be configured through a configuration file. A default configuration is stored in aqt/settings.ini
file.
You can specify custom configuration file through AQT_CONFIG
environment variable or "-c" or "--config" command line option.
A file is like as follows:
[DEFAULTS]
[aqt]
concurrency: 4
connection_timeout: 3.5
response_timeout: 30
baseurl: https://download.qt.io
7zcmd: 7z
[mirrors]
blacklist:
http://mirrors.ustc.edu.cn
http://mirrors.tuna.tsinghua.edu.cn
http://mirrors.geekpie.club
fallbacks:
https://mirrors.ocf.berkeley.edu/qt
https://ftp.jaist.ac.jp/pub/qtproject
http://ftp1.nluug.nl/languages/qt
https://mirrors.dotsrc.org/qtproject
An [aqt]
section is a configuration for basic behavior.
- concurrency:
concurrency
is a setting how many download concurrently starts. It should be a integer value.- connection_timeout:
connection_timeout
is a timeout in second for connection. It is passed torequests
library.- response_timeout:
response_timeout
is a timeout in second how much time waiting for response. It is passed torequests
library.- baseurl:
baseurl
is a URL of Qt download site. When you have your own Qt download site repository, you can set it here. It is as same as--base
option.- 7zcmd:
It is a command name of 7-zip. When
aqtinstall
is installed without recommended librarypy7zr
, it is used to extract archive instead ofpy7zr
library. When--external
option specified, a value is override with option's one.
A [mirrors]
section is a configuration for mirror handling.
- blacklist:
It is a list of URL where is a problematic mirror site. Some mirror sites ignore a connection from IP addresses out of their preffered one. It will cause connection error or connection timeout. There are some known mirror sites in default. When you are happy with the default sites, you can override with your custom settings.
- fallbacks:
It is a list of URL where is a good for access. When mirror site cause an error, aqt use fallbacks when possible.