{"id":39032787,"url":"https://github.com/dbinfrago/capella-collab-manager","last_synced_at":"2026-01-17T17:41:50.265Z","repository":{"id":37084588,"uuid":"448972168","full_name":"dbinfrago/capella-collab-manager","owner":"dbinfrago","description":"A web application for running Capella and other related MBSE tools in a browser, improving collaboration between companies and automating tasks throughout the system lifecycle.","archived":false,"fork":false,"pushed_at":"2025-10-06T12:51:33.000Z","size":317414,"stargazers_count":31,"open_issues_count":115,"forks_count":6,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-10-06T14:37:14.889Z","etag":null,"topics":["docker","hacktoberfest","kubernetes","mbse"],"latest_commit_sha":null,"homepage":"https://dbinfrago.github.io/capella-collab-manager/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dbinfrago.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSES/.license_header_apache.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-01-17T16:42:09.000Z","updated_at":"2025-10-06T12:41:22.000Z","dependencies_parsed_at":"2023-10-02T08:59:46.478Z","dependency_job_id":"73f0a96a-97a0-435c-9f74-ca4b83981cba","html_url":"https://github.com/dbinfrago/capella-collab-manager","commit_stats":null,"previous_names":["dbinfrago/capella-collab-manager"],"tags_count":137,"template":false,"template_full_name":null,"purl":"pkg:github/dbinfrago/capella-collab-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbinfrago%2Fcapella-collab-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbinfrago%2Fcapella-collab-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbinfrago%2Fcapella-collab-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbinfrago%2Fcapella-collab-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dbinfrago","download_url":"https://codeload.github.com/dbinfrago/capella-collab-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbinfrago%2Fcapella-collab-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28513972,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T13:38:16.342Z","status":"ssl_error","status_checked_at":"2026-01-17T13:37:44.060Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","hacktoberfest","kubernetes","mbse"],"created_at":"2026-01-17T17:41:50.162Z","updated_at":"2026-01-17T17:41:50.243Z","avatar_url":"https://github.com/dbinfrago.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n ~ SPDX-FileCopyrightText: Copyright DB InfraGO AG and contributors\n ~ SPDX-License-Identifier: Apache-2.0\n --\u003e\n\n# Capella Collaboration Manager\n\n[![REUSE status](https://api.reuse.software/badge/github.com/dbinfrago/capella-collab-manager)](https://api.reuse.software/info/github.com/dbinfrago/capella-collab-manager)\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n![lint](https://github.com/dbinfrago/capella-collab-manager/actions/workflows/lint.yml/badge.svg)\n![tests](https://github.com/dbinfrago/capella-collab-manager/actions/workflows/tests.yml/badge.svg)\n![push](https://github.com/dbinfrago/capella-collab-manager/actions/workflows/push.yml/badge.svg)\n[![codecov](https://codecov.io/github/dbinfrago/capella-collab-manager/branch/main/graph/badge.svg?token=1UZHL2H54F)](https://codecov.io/github/dbinfrago/capella-collab-manager)\n[![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/capella-collab-manager)](https://artifacthub.io/packages/search?repo=capella-collab-manager)\n\nA web platform for collaboration on MBSE and\n[Capella](https://www.eclipse.org/capella/) projects.\n\n**Copyright 2021 - 2025 [DB InfraGO AG](https://dbinfrago.com/), licensed under\nApache 2.0 License (see full text [here](./LICENSES/Apache-2.0.txt))**\n\nTurn your local MBSE and Capella experience into a browser-based collaboration\nplatform for model-based projects. Designed to enable co-working across\nmultiple organizations. Here are some of the key features:\n\n- Run MBSE related tools (Capella, Papyrus, Eclipse, pure::variants, Jupyter,\n  etc.) in a browser\n- Supports both Git and\n  [Team for Capella](https://www.obeosoft.com/en/team-for-capella) co-working\n  models\n- Single sign-on (SSO) via [OAuth2](https://oauth.net/2/)\n- No need to install or maintain local Capella clients - clients are made on\n  demand in an underlying [Kubernetes](https://kubernetes.io/) cluster\n- Access to projects and models is self-managed by project admins, model owners\n  or delegates\n- Within a project a user could have read or read \u0026 write access. Read-only\n  users don't consume licenses in Team for Capella projects.\n- Integration with Git repository management for backup and workflow automation\n  around the models.\n- Diagram cache integration: Display Capella diagrams in the browser within\n  seconds.\n- Model badge integration: Each model displays an automatically generated model\n  complexity badge.\n- Automatic \"garbage collection\": Unused sessions are terminated to free up\n  resources and reduce cost.\n- Jupyter integration to talk to Capella models from the workspace and to\n  automate tasks.\n\nIn addition, we have integrated commercial products:\n\n- [Team for Capella](https://www.obeosoft.com/en/team-for-capella):\n  - Automatic repository monitoring\n  - UI to create and delete models\n  - Automatic license injection into sessions.\n  - Synchronization from TeamForCapella repositories to Git repositories\n  - Automatic access management via session tokens.\n\n- [pure::variants](https://www.pure-systems.com/purevariants)\n  - Automatic license injection\n  - Access to licenses is self-managed by project admins\n\nWe've prepared a small video, where we showcase the diagram cache feature and\nshow how you can use Capella and Jupyter in split view in the browser:\n\nhttps://github.com/dbinfrago/capella-collab-manager/assets/23395732/01c5dc34-7792-4858-a87a-3205927b3d00\n\n## Getting Started\n\n### Running Locally with k3d\n\nThe following instructions are not suitable for a production deployment, but\ncan be used to try out the features of the Collaboration Manager locally. You\ncan find the installation guide for a production deployment in the\n[general documentation](https://dbinfrago.github.io/capella-collab-manager/admin/installation/).\n\n#### Prerequisites\n\nTo deploy the application you need:\n\n- [Docker](https://docs.docker.com/engine/install/ubuntu/) \u003e= 20.10.X\n- [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/) \u003e=\n  1.24 (Stargazer)\n- [helm](https://helm.sh/docs/intro/install/) \u003e= 3.9.X\n- [Make](https://www.gnu.org/software/make/manual/make.html) \u003e= 3.82,\n  recommended 4.X\n- [Python](https://www.python.org/downloads/) \u003e= 3.10\n\nIf you'd like to run it locally, these tools are additionally required:\n\n- [k3d](https://k3d.io/) - a lightweight k8s cluster\n\nWhen you have all that installed you can do the following:\n\n```zsh\ngit clone --recurse-submodules https://github.com/dbinfrago/capella-collab-manager.git\ncd capella-collab-manager\n\n# Create a local k3d cluster and test the registry reachability\nmake create-cluster reach-registry\n```\n\nThen, choose one of the four options and run the corresponding command. The\noptions can be changed at any time later:\n\n\u003c!-- prettier-ignore --\u003e\n\u003e [!NOTE]\n\u003e Currently, we only provide amd64 images. If you want to run the\n\u003e application on arm64, you need to build the images yourself (option 3 or 4).\n\n\u003c!-- prettier-ignore --\u003e\n\u003e [!NOTE]\n\u003e Since version v4.21.0, Guacamole is no longer deployed by default in local environments.\n\u003e If you want to use Guacamole, you need to set the environment variable `DEPLOY_GUACAMOLE=1`.\n\n1. Fetch management portal and session images from GitHub (without\n   TeamForCapella support). This option is recommended for the first\n   deployment.\n\n   ```zsh\n   export DOCKER_REGISTRY=ghcr.io/dbinfrago/capella-collab-manager\n   export CAPELLACOLLAB_SESSIONS_REGISTRY=ghcr.io/dbinfrago/capella-dockerimages\n   DEVELOPMENT_MODE=1 make helm-deploy open\n   ```\n\n1. Build management portal images and fetch session images from GitHub (without\n   initial TeamForCapella support)\n\n   ```zsh\n   export CAPELLACOLLAB_SESSIONS_REGISTRY=ghcr.io/dbinfrago/capella-dockerimages\n   DEVELOPMENT_MODE=1 make build helm-deploy open rollout\n   ```\n\n1. Build management portal and session images locally (without initial\n   TeamForCapella support) \\\n   To reduce the build time, the default configuration only builds images for\n   Capella 6.0.0. If you want to build more images for different versions, set\n   the environment variable `CAPELLA_VERSIONS` with a space-separated list of\n   semantic Capella versions.\n\n   ```\n   export CAPELLA_VERSIONS=\"6.0.0 6.1.0\"\n   export BUILD_ARCHITECTURE=amd64 # or arm64\n   ```\n\n   Then, run the following command:\n\n   ```\n   DEVELOPMENT_MODE=1 make deploy\n   ```\n\n1. Build Capella and TeamForCapella images locally (with initial TeamForCapella\n   support)\n\n   Read and execute the preparation in the Capella Docker images documentation:\n   [TeamForCapella client base](https://dbinfrago.github.io/capella-dockerimages/capella/t4c/base/#preparation).\n\n   Then, run the following command:\n\n   ```\n   DEVELOPMENT_MODE=1 make deploy-t4c\n   ```\n\nIt can take a long time to run, but shouldn't take more than 5 minutes. Please\nwait until all services are in the \"Running\" state.\n\nIf all goes well, you should find Capella Collaboration Manager running on\n\u003chttps://localhost:443/\u003e.\n\nIf you want to see the individual services in the web-based Kubernetes\ndashboard, you can run the following command:\n\n```zsh\nmake dashboard\n```\n\nIf something goes wrong, please open an issue on GitHub.\n\nTo clean up the environment, run:\n\n```zsh\nmake delete-cluster\nk3d registry delete k3d-myregistry.localhost\n```\n\n#### Starting a Session\n\nOnce the cluster is installed and all services are running\n(`kubectl get pods`), you can get started. Follow our\n[Getting started guide](https://dbinfrago.github.io/capella-collab-manager/admin/getting_started/getting_started/)\nand be up and running in a few minutes.\n\n## How it Works\n\nThe Capella Collaboration Manager consists of a couple of components:\n\n- A frontend - what you see in the browser\n- A backend service - for managing projects, users and sessions\n- [Guacamole](https://guacamole.apache.org/), to expose the sessions via the\n  browser\n- Databases, for state persistence\n- Prometheus for session monitoring\n- Grafana Loki for logs management\n\nExternal software can also be linked. These parts can be installed separately:\n\n- Optional: A Git server (used for read-only sessions and Git backups)\n- Optional: A Team for Capella server\n- Optional: A pure::variants server\n\n## Contributing\n\nWe'd love to see your bug reports and improvement suggestions! Please take a\nlook at our\n[developer documentation](https://dbinfrago.github.io/capella-collab-manager/development/).\nYou'll also find instructions on how to set up a local development environment.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdbinfrago%2Fcapella-collab-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdbinfrago%2Fcapella-collab-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdbinfrago%2Fcapella-collab-manager/lists"}