Contribute to Waldur

Waldur is open source under the MIT license. Fixes, features, documentation and translations are welcome. Read the contribution guidelines first: keep each merge request to one clear scope, follow the code conventions, and make sure linters and tests pass.

Set up a development environment

• Backend (MasterMind): Installation guide, either with Dev Containers or from source with uv.
• Frontend (HomePort): Development setup.

Before you open a merge request

• Build, test and lint commands
• Code style
• Testing guide

Code repositories

Repository	What it is
waldur-mastermind	Backend: REST API, orchestration, marketplace, billing
waldur-homeport	Web interface
waldur-site-agent	Agent that connects service provider backends such as SLURM to Waldur
waldur-helm	Helm chart for Kubernetes
waldur-docker-compose	Docker Compose deployment
py-client	Python SDK (waldur-api-client on PyPI)
ansible-waldur-module	Ansible modules for the Waldur API

Where to go next

• Developer guide: architecture, core concepts and internals
• Governance
• Reporting issues