Stalwart Architecture¶
Compose 🐳¶
flowchart LR
subgraph role [web-app-stalwart]
svc_stalwart["stalwart<br>stalwartlabs/stalwart:v1.0.3<br>http 8080 · smtp 25 · smtps 465 · pop3s 995 · imaps 993 · sieve 4190"]
svc_webmail["webmail<br>roundcube/roundcubemail:1.7.5-apache<br>http 80"]
svc_clamav["clamav<br>clamav/clamav-debian:1.5.4<br>milter 7357"]
end
Swarm 🐝¶
flowchart LR
svc_stalwart["stalwart"]
svc_stalwart --> rep_stalwart["replicas: from the host group"]
svc_stalwart --> plc_stalwart["node.role == manager"]:::pinned
svc_webmail["webmail"]
svc_webmail --> rep_webmail["replicas: from the host group"]
svc_webmail --> plc_webmail["node.role == manager"]:::pinned
svc_clamav["clamav"]
svc_clamav --> rep_clamav["replicas: from the host group"]
svc_clamav --> plc_clamav["node.role == manager"]:::pinned
classDef pinned fill:#fef7e0,stroke:#b06000,color:#3d2600;
Volumes¶
flowchart LR
vol_data["stalwart_data"]
vol_data -->|"role is manager-pinned"| local_data["node-local on the manager"]:::local
vol_config["stalwart_config"]
vol_config -->|"role is manager-pinned"| local_config["node-local on the manager"]:::local
vol_webmail_data["stalwart_webmail_data"]
vol_webmail_data -->|"role is manager-pinned"| local_webmail_data["node-local on the manager"]:::local
vol_clamav_data["stalwart_clamav_data"]
vol_clamav_data -->|"role is manager-pinned"| local_clamav_data["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_bkp_volume_2_local["svc-bkp-volume-2-local 💻"]
dep_svc_db_postgres["svc-db-postgres 🐳🐝"]
dep_svc_net_tor["svc-net-tor 🐳🐝"]
dep_svc_net_tor_smtp["svc-net-tor-smtp 🐳🐝"]
dep_web_app_dashboard["web-app-dashboard 🐳🐝"]
dep_web_app_docs["web-app-docs 🐳🐝"]
dep_web_app_keycloak["web-app-keycloak 🐳🐝"]
dep_web_app_matomo["web-app-matomo 🐳🐝"]
dep_web_app_prometheus["web-app-prometheus 🐳🐝"]
dep_web_svc_design["web-svc-design 💻"]
dep_web_svc_logout["web-svc-logout 🐳🐝"]
end
subgraph role [web-app-stalwart 🐳🐝]
svc_sso["sso"]
svc_logout["logout"]
svc_dashboard["dashboard"]
svc_matomo["matomo"]
svc_container_backup["container_backup"]
svc_stalwart["stalwart"]
svc_postgres["postgres"]
svc_webmail["webmail"]
svc_clamav["clamav"]
svc_stalwart_migrate["stalwart_migrate ❌"]
svc_design["design"]
svc_prometheus["prometheus"]
svc_tor["tor"]
svc_tor_smtp["tor-smtp"]
svc_docs["docs"]
end
subgraph dependents [Dependents]
dpt_sys_ctl_alm_email["sys-ctl-alm-email 💻"]
dpt_web_app_akaunting["web-app-akaunting 🐳🐝"]
dpt_web_app_baserow["web-app-baserow 🐳🐝"]
dpt_web_app_bigbluebutton["web-app-bigbluebutton 🐳🐝"]
dpt_web_app_bluesky["web-app-bluesky 🐳🐝"]
dpt_web_app_bookwyrm["web-app-bookwyrm 🐳🐝"]
dpt_web_app_bridgy_fed["web-app-bridgy-fed 🐳🐝"]
dpt_web_app_checkmk["web-app-checkmk 🐳🐝"]
dpt_web_app_confluence["web-app-confluence 🐳🐝"]
dpt_web_app_decidim["web-app-decidim 🐳🐝"]
dpt_web_app_discourse["web-app-discourse 🐳🐝"]
dpt_web_app_docs["web-app-docs 🐳🐝"]
dpt_web_app_erpnext["web-app-erpnext 🐳🐝"]
dpt_web_app_espocrm["web-app-espocrm 🐳🐝"]
dpt_web_app_fediwall["web-app-fediwall 🐳🐝"]
dpt_web_app_fider["web-app-fider 🐳🐝"]
dpt_web_app_flowise["web-app-flowise 🐳🐝"]
dpt_web_app_friendica["web-app-friendica 🐳🐝"]
dpt_web_app_funkwhale["web-app-funkwhale 🐳🐝"]
dpt_web_app_fusiondirectory["web-app-fusiondirectory 🐳🐝"]
dpt_web_app_gitea["web-app-gitea 🐳🐝"]
dpt_web_app_gitlab["web-app-gitlab 🐳🐝"]
dpt_web_app_hugo["web-app-hugo 🐳🐝"]
dpt_web_app_jira["web-app-jira 🐳🐝"]
dpt_web_app_jitsi["web-app-jitsi 🐳🐝"]
dpt_web_app_joomla["web-app-joomla 🐳🐝"]
dpt_web_app_keycloak["web-app-keycloak 🐳🐝"]
dpt_web_app_kix["web-app-kix 🐳🐝"]
dpt_web_app_listmonk["web-app-listmonk 🐳🐝"]
dpt_web_app_littlejs["web-app-littlejs 🐳🐝"]
dpt_web_app_magento["web-app-magento 🐳🐝"]
dpt_web_app_mailu["web-app-mailu 🐳🐝"]
dpt_web_app_mastodon["web-app-mastodon 🐳🐝"]
dpt_web_app_matrix["web-app-matrix 🐳🐝"]
dpt_web_app_mattermost["web-app-mattermost 🐳🐝"]
dpt_web_app_mediawiki["web-app-mediawiki 🐳🐝"]
dpt_web_app_mobilizon["web-app-mobilizon 🐳🐝"]
dpt_web_app_moodle["web-app-moodle 🐳🐝"]
dpt_web_app_n8n["web-app-n8n 🐳🐝"]
dpt_web_app_nextcloud["web-app-nextcloud 🐳🐝"]
dpt_web_app_odoo["web-app-odoo 🐳🐝"]
dpt_web_app_openbao["web-app-openbao 🐳🐝"]
dpt_web_app_opencloud["web-app-opencloud 🐳🐝"]
dpt_web_app_openproject["web-app-openproject 🐳🐝"]
dpt_web_app_opentalk["web-app-opentalk 🐳🐝"]
dpt_web_app_openwebui["web-app-openwebui 🐳🐝"]
dpt_web_app_peertube["web-app-peertube 🐳🐝"]
dpt_web_app_penpot["web-app-penpot 🐳🐝"]
dpt_web_app_pgadmin["web-app-pgadmin 🐳🐝"]
dpt_web_app_phpmyadmin["web-app-phpmyadmin 🐳🐝"]
dpt_web_app_pihole["web-app-pihole 🐳"]
dpt_web_app_pixelfed["web-app-pixelfed 🐳🐝"]
dpt_web_app_postmarks["web-app-postmarks 🐳🐝"]
dpt_web_app_pretix["web-app-pretix 🐳🐝"]
dpt_web_app_prometheus["web-app-prometheus 🐳🐝"]
dpt_web_app_roulette_wheel["web-app-roulette-wheel 🐳🐝"]
dpt_web_app_semaphore["web-app-semaphore 🐳🐝"]
dpt_web_app_shopware["web-app-shopware 🐳🐝"]
dpt_web_app_snipe_it["web-app-snipe-it 🐳🐝"]
dpt_web_app_suitecrm["web-app-suitecrm 🐳🐝"]
dpt_web_app_taiga["web-app-taiga 🐳🐝"]
dpt_web_app_wazuh["web-app-wazuh 🐳🐝"]
dpt_web_app_weblate["web-app-weblate 🐳🐝"]
dpt_web_app_wordpress["web-app-wordpress 🐳🐝"]
dpt_web_app_xwiki["web-app-xwiki 🐳🐝"]
dpt_web_app_yourls["web-app-yourls 🐳🐝"]
dpt_web_app_zammad["web-app-zammad 🐳🐝"]
dpt_web_svc_api["web-svc-api 🐳🐝"]
end
dep_svc_bkp_volume_2_local -. "0..1" .-> svc_container_backup
dep_svc_db_postgres -. "0..1" .-> svc_postgres
dep_svc_net_tor -. "0..1" .-> svc_tor
dep_svc_net_tor -. "0..1" .-> svc_tor_smtp
dep_svc_net_tor_smtp -. "0..1" .-> svc_tor_smtp
dep_web_app_dashboard -. "0..1" .-> svc_dashboard
dep_web_app_docs -. "0..1" .-> svc_docs
dep_web_app_keycloak -. "0..1" .-> svc_sso
dep_web_app_matomo -. "0..1" .-> svc_matomo
dep_web_app_prometheus -. "0..1" .-> svc_prometheus
dep_web_svc_design -. "0..1" .-> svc_design
dep_web_svc_logout -. "0..1" .-> svc_logout
svc_stalwart -- "1:1" --> dpt_sys_ctl_alm_email
svc_stalwart -. "0..1" .-> dpt_web_app_akaunting
svc_stalwart -. "0..1" .-> dpt_web_app_baserow
svc_stalwart -. "0..1" .-> dpt_web_app_bigbluebutton
svc_stalwart -. "0..1" .-> dpt_web_app_bluesky
svc_stalwart -. "0..1" .-> dpt_web_app_bookwyrm
svc_stalwart -- "0..0" --> dpt_web_app_bridgy_fed
svc_stalwart -. "0..1" .-> dpt_web_app_checkmk
svc_stalwart -- "0..0" --> dpt_web_app_confluence
svc_stalwart -. "0..1" .-> dpt_web_app_decidim
svc_stalwart -. "0..1" .-> dpt_web_app_discourse
svc_stalwart -- "0..0" --> dpt_web_app_docs
svc_stalwart -. "0..1" .-> dpt_web_app_erpnext
svc_stalwart -. "0..1" .-> dpt_web_app_espocrm
svc_stalwart -- "0..0" --> dpt_web_app_fediwall
svc_stalwart -. "0..1" .-> dpt_web_app_fider
svc_stalwart -. "0..1" .-> dpt_web_app_flowise
svc_stalwart -. "0..1" .-> dpt_web_app_friendica
svc_stalwart -. "0..1" .-> dpt_web_app_funkwhale
svc_stalwart -. "0..1" .-> dpt_web_app_fusiondirectory
svc_stalwart -. "0..1" .-> dpt_web_app_gitea
svc_stalwart -. "0..1" .-> dpt_web_app_gitlab
svc_stalwart -- "0..0" --> dpt_web_app_hugo
svc_stalwart -- "0..0" --> dpt_web_app_jira
svc_stalwart -. "0..1" .-> dpt_web_app_jitsi
svc_stalwart -. "0..1" .-> dpt_web_app_joomla
svc_stalwart -. "0..1" .-> dpt_web_app_keycloak
svc_stalwart -. "0..1" .-> dpt_web_app_kix
svc_stalwart -. "0..1" .-> dpt_web_app_listmonk
svc_stalwart -- "0..0" --> dpt_web_app_littlejs
svc_stalwart -. "0..1" .-> dpt_web_app_magento
svc_stalwart -. "0..1" .-> dpt_web_app_mailu
svc_stalwart -. "0..1" .-> dpt_web_app_mastodon
svc_stalwart -. "0..1" .-> dpt_web_app_matrix
svc_stalwart -. "0..1" .-> dpt_web_app_mattermost
svc_stalwart -. "0..1" .-> dpt_web_app_mediawiki
svc_stalwart -. "0..1" .-> dpt_web_app_mobilizon
svc_stalwart -. "0..1" .-> dpt_web_app_moodle
svc_stalwart -. "0..1" .-> dpt_web_app_n8n
svc_stalwart -. "0..1" .-> dpt_web_app_nextcloud
svc_stalwart -. "0..1" .-> dpt_web_app_odoo
svc_stalwart -- "0..0" --> dpt_web_app_openbao
svc_stalwart -. "0..1" .-> dpt_web_app_opencloud
svc_stalwart -. "0..1" .-> dpt_web_app_openproject
svc_stalwart -. "0..1" .-> dpt_web_app_opentalk
svc_stalwart -. "0..1" .-> dpt_web_app_openwebui
svc_stalwart -. "0..1" .-> dpt_web_app_peertube
svc_stalwart -. "0..1" .-> dpt_web_app_penpot
svc_stalwart -. "0..1" .-> dpt_web_app_pgadmin
svc_stalwart -- "0..0" --> dpt_web_app_phpmyadmin
svc_stalwart -- "0..0" --> dpt_web_app_pihole
svc_stalwart -. "0..1" .-> dpt_web_app_pixelfed
svc_stalwart -- "0..0" --> dpt_web_app_postmarks
svc_stalwart -. "0..1" .-> dpt_web_app_pretix
svc_stalwart -. "0..1" .-> dpt_web_app_prometheus
svc_stalwart -- "0..0" --> dpt_web_app_roulette_wheel
svc_stalwart -. "0..1" .-> dpt_web_app_semaphore
svc_stalwart -. "0..1" .-> dpt_web_app_shopware
svc_stalwart -. "0..1" .-> dpt_web_app_snipe_it
svc_stalwart -. "0..1" .-> dpt_web_app_suitecrm
svc_stalwart -. "0..1" .-> dpt_web_app_taiga
svc_stalwart -- "0..0" --> dpt_web_app_wazuh
svc_stalwart -. "0..1" .-> dpt_web_app_weblate
svc_stalwart -. "0..1" .-> dpt_web_app_wordpress
svc_stalwart -. "0..1" .-> dpt_web_app_xwiki
svc_stalwart -- "0..0" --> dpt_web_app_yourls
svc_stalwart -. "0..1" .-> dpt_web_app_zammad
svc_stalwart -- "0..0" --> dpt_web_svc_api
linkStyle 18,20,23,26,34,35,41,53,61,62,64,67,73,77,79 stroke:red;
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.