Keycloak Architecture

Compose 🐳

flowchart LR
    subgraph role [web-app-keycloak]
        svc_keycloak["keycloak<br>quay.io/keycloak/keycloak:26.8.2<br>http 8080 · management 9000"]
    end

Swarm 🐝

flowchart LR
    svc_keycloak["keycloak"]
    svc_keycloak --> rep_keycloak["replicas: from the host group"]
    classDef pinned fill:#fef7e0,stroke:#b06000,color:#3d2600;

Volumes

flowchart LR
    none["web-app-keycloak declares no volume"]

Condition	Effect
swarm, storage.backend: nfs, no nfs: false, role not pinned	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_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_matomo["web-app-matomo 🐳🐝"]
        dep_web_app_prometheus["web-app-prometheus 🐳🐝"]
        dep_web_app_stalwart["web-app-stalwart 🐳🐝"]
        dep_web_svc_design["web-svc-design 💻"]
        dep_web_svc_logout["web-svc-logout 🐳🐝"]
    end
    subgraph role [web-app-keycloak 🐳🐝]
        svc_logout["logout ❌"]
        svc_ldap["ldap"]
        svc_dashboard["dashboard"]
        svc_matomo["matomo"]
        svc_email["email"]
        svc_javascript["javascript"]
        svc_keycloak["keycloak"]
        svc_sso_proxy["sso_proxy"]
        svc_postgres["postgres"]
        svc_design["design"]
        svc_recaptcha["recaptcha"]
        svc_prometheus["prometheus"]
        svc_tor["tor"]
        svc_docs["docs"]
    end
    subgraph dependents [Dependents]
        dpt_svc_ai_agent_broker["svc-ai-agent-broker 🐳🐝"]
        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_chess["web-app-chess 🐳🐝"]
        dpt_web_app_confluence["web-app-confluence 🐳🐝"]
        dpt_web_app_dashboard["web-app-dashboard 🐳🐝"]
        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_hermes["web-app-hermes 🐳🐝"]
        dpt_web_app_homeassistant["web-app-homeassistant 🐳🐝"]
        dpt_web_app_hugo["web-app-hugo 🐳🐝"]
        dpt_web_app_jellyfin["web-app-jellyfin 🐳🐝"]
        dpt_web_app_jenkins["web-app-jenkins 🐳🐝"]
        dpt_web_app_jira["web-app-jira 🐳🐝"]
        dpt_web_app_jitsi["web-app-jitsi 🐳🐝"]
        dpt_web_app_joomla["web-app-joomla 🐳🐝"]
        dpt_web_app_kix["web-app-kix 🐳🐝"]
        dpt_web_app_lam["web-app-lam 🐳🐝"]
        dpt_web_app_listmonk["web-app-listmonk 🐳🐝"]
        dpt_web_app_litellm["web-app-litellm 💻"]
        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_matomo["web-app-matomo 🐳🐝"]
        dpt_web_app_matrix["web-app-matrix 🐳🐝"]
        dpt_web_app_mattermost["web-app-mattermost 🐳🐝"]
        dpt_web_app_mediawiki["web-app-mediawiki 🐳🐝"]
        dpt_web_app_meta["web-app-meta 🐳🐝"]
        dpt_web_app_mini_qr["web-app-mini-qr 🐳🐝"]
        dpt_web_app_minio["web-app-minio 🐳🐝"]
        dpt_web_app_mobilizon["web-app-mobilizon 🐳🐝"]
        dpt_web_app_moodle["web-app-moodle 🐳🐝"]
        dpt_web_app_n8n["web-app-n8n 🐳🐝"]
        dpt_web_app_navigator["web-app-navigator 🐳🐝"]
        dpt_web_app_nextcloud["web-app-nextcloud 🐳🐝"]
        dpt_web_app_odoo["web-app-odoo 🐳🐝"]
        dpt_web_app_openbao["web-app-openbao 🐳🐝"]
        dpt_web_app_openclaw["web-app-openclaw 🐳🐝"]
        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_phpldapadmin["web-app-phpldapadmin 🐳🐝"]
        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_seaweedfs["web-app-seaweedfs 🐳🐝"]
        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_socialhome["web-app-socialhome 🐳🐝"]
        dpt_web_app_stalwart["web-app-stalwart 🐳🐝"]
        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 🐳🐝"]
        dpt_web_svc_libretranslate["web-svc-libretranslate 🐳🐝"]
        dpt_web_svc_simpleicons["web-svc-simpleicons 🐳🐝"]
        dpt_web_svc_translate["web-svc-translate 🐳🐝"]
        dpt_web_svc_xmpp["web-svc-xmpp 🐳🐝"]
    end
    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_matomo -. "0..1" .-> svc_matomo
    dep_web_app_prometheus -. "0..1" .-> svc_prometheus
    dep_web_app_stalwart -. "0..1" .-> svc_email
    dep_web_svc_design -. "0..1" .-> svc_design
    dep_web_svc_logout -. "0..1" .-> svc_javascript
    svc_keycloak -- "1:1" --> dpt_svc_ai_agent_broker
    svc_keycloak -. "0..1" .-> dpt_web_app_akaunting
    svc_keycloak -. "0..1" .-> dpt_web_app_baserow
    svc_keycloak -. "0..1" .-> dpt_web_app_bigbluebutton
    svc_keycloak -. "0..1" .-> dpt_web_app_bluesky
    svc_keycloak -. "0..1" .-> dpt_web_app_bookwyrm
    svc_keycloak -- "0..0" --> dpt_web_app_bridgy_fed
    svc_keycloak -. "0..1" .-> dpt_web_app_checkmk
    svc_keycloak -- "0..0" --> dpt_web_app_chess
    svc_keycloak -- "0..0" --> dpt_web_app_confluence
    svc_keycloak -. "0..1" .-> dpt_web_app_dashboard
    svc_keycloak -. "0..1" .-> dpt_web_app_decidim
    svc_keycloak -. "0..1" .-> dpt_web_app_discourse
    svc_keycloak -- "0..0" --> dpt_web_app_docs
    svc_keycloak -. "0..1" .-> dpt_web_app_erpnext
    svc_keycloak -. "0..1" .-> dpt_web_app_espocrm
    svc_keycloak -- "0..0" --> dpt_web_app_fediwall
    svc_keycloak -. "0..1" .-> dpt_web_app_fider
    svc_keycloak -. "0..1" .-> dpt_web_app_flowise
    svc_keycloak -. "0..1" .-> dpt_web_app_friendica
    svc_keycloak -. "0..1" .-> dpt_web_app_funkwhale
    svc_keycloak -. "0..1" .-> dpt_web_app_fusiondirectory
    svc_keycloak -. "0..1" .-> dpt_web_app_gitea
    svc_keycloak -. "0..1" .-> dpt_web_app_gitlab
    svc_keycloak -. "0..1" .-> dpt_web_app_hermes
    svc_keycloak -- "0..0" --> dpt_web_app_homeassistant
    svc_keycloak -- "0..0" --> dpt_web_app_hugo
    svc_keycloak -. "0..1" .-> dpt_web_app_jellyfin
    svc_keycloak -. "0..1" .-> dpt_web_app_jenkins
    svc_keycloak -- "0..0" --> dpt_web_app_jira
    svc_keycloak -. "0..1" .-> dpt_web_app_jitsi
    svc_keycloak -. "0..1" .-> dpt_web_app_joomla
    svc_keycloak -. "0..1" .-> dpt_web_app_kix
    svc_keycloak -. "0..1" .-> dpt_web_app_lam
    svc_keycloak -. "0..1" .-> dpt_web_app_listmonk
    svc_keycloak -. "0..1" .-> dpt_web_app_litellm
    svc_keycloak -- "0..0" --> dpt_web_app_littlejs
    svc_keycloak -. "0..1" .-> dpt_web_app_magento
    svc_keycloak -. "0..1" .-> dpt_web_app_mailu
    svc_keycloak -. "0..1" .-> dpt_web_app_mastodon
    svc_keycloak -- "0..0" --> dpt_web_app_matomo
    svc_keycloak -. "0..1" .-> dpt_web_app_matrix
    svc_keycloak -. "0..1" .-> dpt_web_app_mattermost
    svc_keycloak -. "0..1" .-> dpt_web_app_mediawiki
    svc_keycloak -- "0..0" --> dpt_web_app_meta
    svc_keycloak -- "0..0" --> dpt_web_app_mini_qr
    svc_keycloak -. "0..1" .-> dpt_web_app_minio
    svc_keycloak -. "0..1" .-> dpt_web_app_mobilizon
    svc_keycloak -. "0..1" .-> dpt_web_app_moodle
    svc_keycloak -. "0..1" .-> dpt_web_app_n8n
    svc_keycloak -- "0..0" --> dpt_web_app_navigator
    svc_keycloak -. "0..1" .-> dpt_web_app_nextcloud
    svc_keycloak -. "0..1" .-> dpt_web_app_odoo
    svc_keycloak -. "0..1" .-> dpt_web_app_openbao
    svc_keycloak -. "0..1" .-> dpt_web_app_openclaw
    svc_keycloak -. "0..1" .-> dpt_web_app_opencloud
    svc_keycloak -. "0..1" .-> dpt_web_app_openproject
    svc_keycloak -- "1:1" --> dpt_web_app_opentalk
    svc_keycloak -. "0..1" .-> dpt_web_app_openwebui
    svc_keycloak -. "0..1" .-> dpt_web_app_peertube
    svc_keycloak -. "0..1" .-> dpt_web_app_penpot
    svc_keycloak -. "0..1" .-> dpt_web_app_pgadmin
    svc_keycloak -. "0..1" .-> dpt_web_app_phpldapadmin
    svc_keycloak -. "0..1" .-> dpt_web_app_phpmyadmin
    svc_keycloak -. "0..1" .-> dpt_web_app_pihole
    svc_keycloak -. "0..1" .-> dpt_web_app_pixelfed
    svc_keycloak -. "0..1" .-> dpt_web_app_postmarks
    svc_keycloak -. "0..1" .-> dpt_web_app_pretix
    svc_keycloak -. "0..1" .-> dpt_web_app_prometheus
    svc_keycloak -- "0..0" --> dpt_web_app_roulette_wheel
    svc_keycloak -. "0..1" .-> dpt_web_app_seaweedfs
    svc_keycloak -. "0..1" .-> dpt_web_app_semaphore
    svc_keycloak -. "0..1" .-> dpt_web_app_shopware
    svc_keycloak -. "0..1" .-> dpt_web_app_snipe_it
    svc_keycloak -- "0..0" --> dpt_web_app_socialhome
    svc_keycloak -. "0..1" .-> dpt_web_app_stalwart
    svc_keycloak -. "0..1" .-> dpt_web_app_suitecrm
    svc_keycloak -. "0..1" .-> dpt_web_app_taiga
    svc_keycloak -. "0..1" .-> dpt_web_app_wazuh
    svc_keycloak -. "0..1" .-> dpt_web_app_weblate
    svc_keycloak -. "0..1" .-> dpt_web_app_wordpress
    svc_keycloak -. "0..1" .-> dpt_web_app_xwiki
    svc_keycloak -. "0..1" .-> dpt_web_app_yourls
    svc_keycloak -. "0..1" .-> dpt_web_app_zammad
    svc_keycloak -- "0..0" --> dpt_web_svc_api
    svc_keycloak -. "0..1" .-> dpt_web_svc_libretranslate
    svc_keycloak -- "0..0" --> dpt_web_svc_simpleicons
    svc_keycloak -. "0..1" .-> dpt_web_svc_translate
    svc_keycloak -. "0..1" .-> dpt_web_svc_xmpp
    linkStyle 16,18,19,23,26,35,36,39,46,50,54,55,60,79,84,94,96 stroke:red;

Symbol	Meaning
1:1 solid	fixed relationship
0..1 dashed	conditional, enabled only in matching deployments
0..0 red	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 meta/main.yml

Every dependency and dependent is listed; the graph is not truncated.