Configuration#

Using environment variables#

CLI arguments#

Some options and arguments can be set with environment variables.

Variable name

Corresponding CLI argument

Default value

QDT_LOGS_LEVEL

-v, --verbose

1 (= logging.WARNING). Must be an integer.

QDT_PROXY_HTTP

--proxy-http

No proxy.

QDT_SCENARIO_PATH

--scenario in deploy

scenario.qdt.yml

QDT_UPGRADE_CHECK_ONLY

-c, --check-only in upgrade

False

QDT_UPGRADE_DISPLAY_RELEASE_NOTES

-n, --dont-show-release-notes in upgrade

True

QDT_UPGRADE_DOWNLOAD_FOLDER

-w, --where in upgrade

./ (current folder)

Others#

Some others parameters can be set using environment variables.

Variable name

Description

Default value

QDT_LOCAL_WORK_DIR

Local folder where QDT download remote resources (profiles, plugins, etc.)

~/.cache/qgis-deployment-toolbelt/default/

QDT_LOGS_DIR

Folder where QDT writes the log files, which are automatically rotated.

~/.cache/qgis-deployment-toolbelt/logs/

QDT_QGIS_EXE_PATH

Path to the QGIS executable to use. Used in shortcuts.

/usr/bin/qgis on Linux and MacOS, %PROGRAMFILES%/QGIS 3.28/bin/qgis-ltr-bin.exe on Windows.


QGIS environment variables#

Some of the QGIS environment variable applies to QDT:

Variable name

Description

QGIS_CUSTOM_CONFIG_PATH

Used to customize the path to the folder where QGIS stores the user’s profiles. See upstream documentation.