Matrix Architecture¶
Compose 🐳¶
flowchart LR
subgraph role [web-app-matrix]
svc_matrix["matrix<br>built here<br>http 8008"]
svc_synapse["synapse<br>matrixdotorg/synapse:v1.164.2<br>http 8008"]
svc_element["element<br>vectorim/element-web:v1.12.33<br>http 80"]
svc_mautrix__["mautrix-*<br>built here"]
svc_matrix_chatgpt_bot["matrix-chatgpt-bot<br>ghcr.io/matrixgpt/matrix-chatgpt-bot:3.1.5"]
end
Swarm 🐝¶
flowchart LR
svc_matrix["matrix"]
svc_matrix --> rep_matrix["replicas: from the host group"]
svc_matrix --> plc_matrix["node.role == manager"]:::pinned
svc_synapse["synapse"]
svc_synapse --> rep_synapse["replicas: from the host group"]
svc_synapse --> plc_synapse["node.role == manager"]:::pinned
svc_element["element"]
svc_element --> rep_element["replicas: from the host group"]
svc_element --> plc_element["node.role == manager"]:::pinned
svc_mautrix__["mautrix-*"]
svc_mautrix__ --> rep_mautrix__["replicas: from the host group"]
svc_mautrix__ --> plc_mautrix__["node.role == manager"]:::pinned
svc_matrix_chatgpt_bot["matrix-chatgpt-bot"]
svc_matrix_chatgpt_bot --> rep_matrix_chatgpt_bot["replicas: from the host group"]
svc_matrix_chatgpt_bot --> plc_matrix_chatgpt_bot["node.role == manager"]:::pinned
classDef pinned fill:#fef7e0,stroke:#b06000,color:#3d2600;
Volumes¶
flowchart LR
vol_synapse_data["matrix_synapse_data"]
vol_synapse_data -->|"role is manager-pinned"| local_synapse_data["node-local on the manager"]:::local
vol_chatgpt_data["matrix_chatgpt_data"]
vol_chatgpt_data -->|"role is manager-pinned"| local_chatgpt_data["node-local on the manager"]:::local
vol_matrix_mdad_docker["matrix_mdad_docker"]
vol_matrix_mdad_docker -->|"role is manager-pinned"| local_matrix_mdad_docker["node-local on the manager"]:::local
vol_matrix_mdad_state["matrix_mdad_state"]
vol_matrix_mdad_state -->|"role is manager-pinned"| local_matrix_mdad_state["node-local on the manager"]:::local
vol_matrix_mdad_matrix["matrix_mdad_matrix"]
vol_matrix_mdad_matrix -->|"role is manager-pinned"| local_matrix_mdad_matrix["node-local on the manager"]:::local
classDef shared fill:#e6f4ea,stroke:#137333,color:#0b2e13;
classDef local fill:#fef7e0,stroke:#b06000,color:#3d2600;
Condition |
Effect |
|---|---|
swarm, |
shared over NFS |
any one of those missing |
node-local |
All four conditions must hold, so pinning a role takes every one of its volumes node-local. Only the role’s primary entry counts as pinned here: a placement on any other service pins that service alone and leaves the backing of every volume unchanged. The chain is drawn rather than its result, because that coupling is what makes a placement change move data without saying so.
Dependencies¶
flowchart LR
subgraph deps [Dependencies]
dep_svc_ai_litellm["svc-ai-litellm 🐳🐝"]
dep_svc_bkp_volume_2_local["svc-bkp-volume-2-local 💻"]
dep_svc_db_openldap["svc-db-openldap 🐳🐝"]
dep_svc_db_postgres["svc-db-postgres 🐳🐝"]
dep_svc_net_tor["svc-net-tor 🐳🐝"]
dep_web_app_dashboard["web-app-dashboard 🐳🐝"]
dep_web_app_docs["web-app-docs 🐳🐝"]
dep_web_app_gitlab["web-app-gitlab 🐳🐝"]
dep_web_app_jitsi["web-app-jitsi 🐳🐝"]
dep_web_app_keycloak["web-app-keycloak 🐳🐝"]
dep_web_app_matomo["web-app-matomo 🐳🐝"]
dep_web_app_n8n["web-app-n8n 🐳🐝"]
dep_web_app_prometheus["web-app-prometheus 🐳🐝"]
dep_web_app_stalwart["web-app-stalwart 🐳🐝"]
dep_web_svc_coturn["web-svc-coturn 🐳🐝"]
dep_web_svc_design["web-svc-design 💻"]
dep_web_svc_logout["web-svc-logout 🐳🐝"]
dep_web_svc_seaweedfs["web-svc-seaweedfs 🐳🐝"]
end
subgraph role [web-app-matrix 🐳🐝]
svc_litellm["litellm"]
svc_sso["sso"]
svc_ldap["ldap"]
svc_logout["logout"]
svc_dashboard["dashboard"]
svc_matomo["matomo"]
svc_email["email"]
svc_gitlab["gitlab"]
svc_jira["jira ❌"]
svc_n8n["n8n"]
svc_coturn["coturn"]
svc_jitsi["jitsi"]
svc_livekit["livekit"]
svc_livekit_jwt["livekit_jwt"]
svc_postgres["postgres"]
svc_synapse["synapse"]
svc_element["element"]
svc_matrix_chatgpt_bot["matrix-chatgpt-bot"]
svc_seaweedfs["seaweedfs"]
svc_design["design"]
svc_prometheus["prometheus"]
svc_matrix["matrix"]
svc_tor["tor"]
svc_container_backup["container_backup"]
svc_docs["docs"]
end
subgraph dependents [Dependents]
dpt_web_app_discourse["web-app-discourse 🐳🐝"]
dpt_web_app_gitlab["web-app-gitlab 🐳🐝"]
dpt_web_app_moodle["web-app-moodle 🐳🐝"]
dpt_web_app_nextcloud["web-app-nextcloud 🐳🐝"]
end
dep_svc_ai_litellm -. "0..1" .-> svc_litellm
dep_svc_bkp_volume_2_local -. "0..1" .-> svc_container_backup
dep_svc_db_openldap -. "0..1" .-> svc_ldap
dep_svc_db_postgres -. "0..1" .-> svc_postgres
dep_svc_net_tor -. "0..1" .-> svc_tor
dep_web_app_dashboard -. "0..1" .-> svc_dashboard
dep_web_app_docs -. "0..1" .-> svc_docs
dep_web_app_gitlab -. "0..1" .-> svc_gitlab
dep_web_app_jitsi -. "0..1" .-> svc_jitsi
dep_web_app_keycloak -. "0..1" .-> svc_sso
dep_web_app_matomo -. "0..1" .-> svc_matomo
dep_web_app_n8n -. "0..1" .-> svc_n8n
dep_web_app_prometheus -. "0..1" .-> svc_prometheus
dep_web_app_stalwart -. "0..1" .-> svc_email
dep_web_svc_coturn -. "0..1" .-> svc_coturn
dep_web_svc_design -. "0..1" .-> svc_design
dep_web_svc_logout -. "0..1" .-> svc_logout
dep_web_svc_seaweedfs -. "0..1" .-> svc_seaweedfs
svc_litellm -. "0..1" .-> dpt_web_app_discourse
svc_litellm -. "0..1" .-> dpt_web_app_gitlab
svc_litellm -. "0..1" .-> dpt_web_app_moodle
svc_litellm -. "0..1" .-> dpt_web_app_nextcloud
Symbol |
Meaning |
|---|---|
|
fixed relationship |
|
conditional, enabled only in matching deployments |
|
declared but turned off in this role |
💻 |
deploys to the host |
🐳 |
deploys under compose |
🐝 |
deploys under swarm |
❌ |
service explicitly turned off |
⚙️ |
Ansible role dependency from |
Every dependency and dependent is listed; the graph is not truncated.