Skip to content

qgis-deployment/qgis-deployment-toolbelt-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

QGIS Deployment Toolbelt (QDT)

Code style: black flake8 Imports: isort pre-commit pre-commit.ci status security: bandit Quality Gate Status

🎳 Tester codecov 📦 Build & 🚀 Release

PyPi version badge PyPI - Downloads PyPI - Python Version

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

✨ Features

  • Manage QGIS profiles easily: define, store, and deploy profiles with a simple profile.json file.
  • 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.

QGIS - List of profiles with ones added by QDT demonstration scenario

Splash screen when launching the Demo Profile:

QGIS splash screen - QDT Demo Profile

Splash screen for the Viewer Profile:

QGIS splash screen - QDT 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 📚.

🤝 Contribute

Want to help?

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

About

Cross-platform (but focused on Windows) CLI to perform deployment operations: profiles, plugins, etc.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors 9

Languages