qgis-deployment-toolbelt 0.41.1

QGIS deployment toolbelt is a CLI (Command Line Interface) to perform redundant operations after a QGIS deployment, managing QGIS profiles, plugins, environment variables, start menu / desktop shortcuts and many things to rationalize your QGIS installations.

QGIS Deployment Toolbelt (QDT)

QGIS Deployment Toolbelt (QDT) is a cross-platform (primarily Windows-focused) command-line tool that streamlines the deployment and management of QGIS profiles, plugins, and related settings within organizations.

It helps standardize user environments, simplify updates, and integrate with IT deployment strategies like GPO, SCCM, or InTune.

⭐ Why QDT?

• Save hours of manual QGIS configuration and profile management
• Reduce configuration errors and user friction
• Scale QGIS deployments in professional environments easily
• Reconciling GIS service expectations and IT constraints
• Community driven development and developed by experienced QGIS teams (especially Oslandia)

Come, talk and ask, we're a friendly (small) group of persons behind:

• GitHub Issues and Discussions
• Matrix channel: https://matrix.to/#/#qdt:matrix.org

🚀 They use and trust QDT

Here comes some of known organization which do use QDT to deploy QGIS profiles seamlessly:

ISL Ingénierie	EP Loire	Métropole Grand Lyon	Département de la Loire	Grenoble Alpes Métropole	LPO Auvergne Rhône Alpes	ANFSI	EP Eaux et Vilaine	Métropole Aix Marseille Provence	Eurométropole de Strasbourg	Clermont Auvergne Métropole	Opale

See more in documentation.

✨ Features

• Manage QGIS profiles easily: define, store, and deploy profiles with a simple profile.json file. You can also use the Profile Manager plugin to export your existing profiles right from QGIS.
• Version control integration: Git-powered backend for tracking changes and enabling collaborative profile management.
• IT-friendly: designed to work with Active Directory, GPOs, SCCM, InTune, and other enterprise tools.
• Seamless user experience: deliver a consistent QGIS experience across your organization with minimal friction.
• Advanced configuration handling: use variabilized QGIS3.ini files to handle dynamic or environment-specific settings.
• Conditional deployments: deploy specific profiles based on rules, environment variables, or user criteria.
• Optimized plugin management: reduce bandwidth usage by rationalizing plugin downloads and installations.

🚀 Try it quickly

You have multiple options to try QDT:

• Using Python and the official modern CLI installer pipx:

  pipx run qgis-deployment-toolbelt -s https://github.com/qgis-deployment/qgis-deployment-toolbelt-cli/raw/main/examples/scenarios/demo-scenario.qdt.yml
  

• Using Python and the official package installer pip:

  pip install qgis-deployment-toolbelt
  qdt -s https://github.com/qgis-deployment/qgis-deployment-toolbelt-cli/raw/main/examples/scenarios/demo-scenario.qdt.yml
  

• Using a pre-built executable (downloadable through releases assets). For example on Windows:

  ./Windows_QGISDeploymentToolbelt_0-37-0.exe  -s https://github.com/qgis-deployment/qgis-deployment-toolbelt-cli/raw/main/examples/scenarios/demo-scenario.qdt.yml
  

Once completed, check:

• The Start menu / Desktop for new shortcuts.
• The QGIS Profiles menu for new profiles.

Splash screen when launching the Demo Profile:

Splash screen for the Viewer Profile:

Have you tried it on Linux? Well, you should find an additional profile simply named "QDT Only Linux".

[!TIP] Interested? For further details, read the documentation :books:.

🤝 Contribute

Want to help? Come on it's definitely open, everything here is under Apache 2.0 license.

Check out the contribution guide and "Development" section in the documentation.