Container images used by the playbook

May 23, 2026 · View on GitHub

This page summarizes the container (Docker) images used by the playbook when setting up your server.

We try to stick to official images (provided by their respective projects) as much as possible.

Homeserver

ServiceContainer imageDefault?Description
Synapseelement-hq/synapseStoring your data and managing your presence in the Matrix network
Conduitmatrixconduit/matrix-conduitStoring your data and managing your presence in the Matrix network. Conduit is a lightweight open-source server implementation of the Matrix Specification with a focus on easy setup and low system requirements
continuwuitycontinuwuation/continuwuityStoring your data and managing your presence in the Matrix network. continuwuity is a continuation of conduwuit.
Tuwunelmatrix-construct/tuwunelStoring your data and managing your presence in the Matrix network. Tuwunel is the official successor to conduwuit.
Dendritematrixdotorg/dendrite-monolithStoring your data and managing your presence in the Matrix network. Dendrite is a second-generation Matrix homeserver written in Go, an alternative to Synapse.

Clients

Web clients for Matrix that you can host on your own domains.

ServiceContainer imageDefault?Description
Element Webvectorim/element-webDefault Matrix web client, configured to connect to your own Synapse server
Hydrogenelement-hq/hydrogen-webLightweight Matrix client with legacy and mobile browser support
Cinnyajbura/cinnySimple, elegant and secure web client
Sable7w1/sableSimple, elegant and secure web client
SchildiChat Webetke.cc/schildichat-webBased on Element Web, with a more traditional instant messaging experience

Server Components

Services that run on the server to make the various parts of your installation work.

ServiceContainer imageDefault?Description
PostgreSQLpostgresDatabase for Synapse. Using an external PostgreSQL server is also possible.
coturncoturn/coturnSTUN/TURN server for WebRTC audio/video calls
TraefikTraefikWeb server, listening on ports 80, 443 and 8448 — standing in front of all the other services. Using your own webserver is also possible.
Let's Encryptcertbot/certbotCertbot tool for obtaining SSL certificates from Let's Encrypt
Eximdevture/exim-relayMail server, through which all Matrix services send outgoing email (can be configured to relay through another SMTP server)
ddclientlinuxserver/ddclientUpdate dynamic DNS entries for accounts on Dynamic DNS Network Service Provider
LiveKit Serverlivekit/livekit-serverWebRTC server for audio/video calls
Livekit JWT Serviceelement-hq/lk-jwt-serviceJWT service for integrating Element Call with LiveKit Server

Authentication

Extend and modify how users are authenticated on your homeserver.

ServiceContainer imageDefault?Description
matrix-synapse-rest-auth(N/A)REST authentication password provider module
matrix-synapse-shared-secret-auth(N/A)Password provider module
matrix-synapse-ldap3 (advanced)(N/A)LDAP Auth password provider module
Matrix User Verification Servicematrixdotorg/matrix-user-verification-serviceService to verify details of a user based on an Open ID token
synapse-simple-antispam (advanced)(N/A)Spam checker module

File Storage

Use alternative file storage to the default media_store folder.

ServiceContainer imageDefault?Description
Goofysewoutp/goofysAmazon S3 (or other S3-compatible object store) storage for Synapse's content repository (media_store) files
synapse-s3-storage-provider(N/A)Amazon S3 (or other S3-compatible object store) storage for Synapse's content repository (media_store) files
matrix-media-repot2bot/matrix-media-repoHighly customizable multi-domain media repository for Matrix. Intended for medium to large deployments, this media repo de-duplicates media while being fully compliant with the specification.

Bridges

Bridges can be used to connect your Matrix installation with third-party communication networks.

ServiceContainer imageDefault?Description
mautrix-blueskymautrix/blueskyBridge to Bluesky
mautrix-discordmautrix/discordBridge to Discord
mautrix-slackmautrix/slackBridge to Slack
mautrix-telegrammautrix/telegramBridge to Telegram
mautrix-gmessagesmautrix/gmessagesBridge to Google Messages
mautrix-whatsappmautrix/whatsappBridge to WhatsApp
mautrix-wsproxymautrix/wsproxyBridge to Android SMS or Apple iMessage
mautrix-twittermautrix/twitterBridge to Twitter
mautrix-googlechatmautrix/googlechatBridge to Google Chat
mautrix-meta (for Messenger and Instagram)mautrix/metaBridge to Messenger and Instagram
mautrix-signalmautrix/signalBridge to Signal
beeper-linkedinbeeper/linkedinBridge to LinkedIn
matrix-appservice-ircmatrixdotorg/matrix-appservice-ircBridge to IRC
matrix-appservice-kakaotalkSelf-buildingBridge to Kakaotalk
matrix-appservice-discordmatrix-org/matrix-appservice-discordBridge to Discord
matrix-hookshothalfshot/matrix-hookshotBridge for generic webhooks and multiple project management services, such as GitHub, GitLab, Figma, and Jira in particular
matrix-sms-bridgefolivonet/matrix-sms-bridgeBridge to SMS
matrix-wechatlxduo/matrix-wechatBridge to WeChat
Heisenbridgehif1/heisenbridgeBouncer-style bridge to IRC
mx-puppet-groupmexangelix/mx-puppet-groupmeBridge to GroupMe
matrix-steam-bridgejasonlaguidice/matrix-steam-bridgeBridge to Steam
mx-puppet-steamicewind1991/mx-puppet-steamBridge to Steam
Postmoogleetke.cc/postmoogleEmail to Matrix bridge

Bots

Bots provide various additional functionality to your installation.

ServiceContainer imageDefault?Description
baibotetke.cc/baibotBot that exposes the power of AI / Large Language Models to you
matrix-reminder-botanoa/matrix-reminder-botBot for scheduling one-off & recurring reminders and alarms
matrix-registration-botmoanos/matrix-registration-botBot for invitations by creating and managing registration tokens
maubotdock.mau.dev/maubot/maubotPlugin-based Matrix bot system
Honoroitetke.cc/honoroitHelpdesk bot
Mjolnirmatrixdotorg/mjolnirModeration tool for Matrix
Draupnirgnuxie/draupnirModeration tool for Matrix (Fork of Mjolnir)
Buscarronetke.cc/buscarronWeb forms (HTTP POST) to Matrix

Administration

Services that help you in administrating and monitoring your Matrix installation.

ServiceContainer imageDefault?Description
matrix-alertmanager-receivermetio/matrix-alertmanager-receiverPrometheus' Alertmanager client
Matrix Authentication Serviceelement-hq/matrix-authentication-serviceOAuth 2.0 and OpenID Provider server
Ketesaetkecc/ketesaFully-featured web UI for administrating your Matrix homeserver — users, rooms, media, sessions, and more
Metrics and Graphsprom/prometheusPrometheus time-series database server
Metrics and Graphsprom/node-exporterPrometheus node-exporter host metrics exporter
Metrics and Graphsgrafana/grafanaGraphing tool that works well with the above two images. Our playbook also adds two dashboards for Synapse and Node Exporter
Metrics and Graphsmartin-helmich/prometheus-nginxlog-exporter/exporterAddon for Prometheus that gathers access logs from various nginx reverse-proxies
Borg(N/A)Backups
postgres-backup-localprodrigestivill/postgres-backup-localCreate automatic database backups
rageshakematrix-org/rageshakeBug report server
synapse-usage-exporterSelf-buildingExport the usage statistics of a Synapse homeserver to be scraped by Prometheus.

Misc

Various services that don't fit any other categories.

ServiceContainer imageDefault?Description
synapse_auto_compressormb-saces/rust-synapse-toolsCli tool that automatically compresses Synapse's state_groups database table in background
Matrix Corporal (advanced)devture/matrix-corporalReconciliator and gateway for a managed Matrix server
Etherpadetherpad/etherpadOpen source collaborative text editor
Jitsijitsi/webJitsi web UI
Jitsijitsi/jicofoJitsi Focus component
Jitsijitsi/prosodyJitsi Prosody XMPP server component
Jitsijitsi/jvbJitsi Video Bridge component
Cactus Commentscactuscomments/cactus-appserviceFederated comment system built on Matrix
Cactus Commentsjoseluisq/static-web-serverFederated comment system built on Matrix
Pantalaimonmatrixdotorg/pantalaimonE2EE aware proxy daemon
Sygnalmatrixdotorg/sygnalReference Push Gateway for Matrix
ntfybinwiederhier/ntfySelf-hosted, UnifiedPush-compatible push notifications server
Element Callelement-hq/element-callA native Matrix video conferencing application

Container images of deprecated / unmaintained services

The list of the deprecated or unmaintained services is available here.

ServiceContainer imageDefault?Description
conduwuitgirlbossceo/conduwuitStoring your data and managing your presence in the Matrix network. conduwuit was a fork of Conduit.
Dimensionturt2live/matrix-dimensionOpen source integration manager for Matrix clients
Email2Matrixdevture/email2matrixBridge for relaying emails to Matrix rooms
Go-NEBmatrixdotorg/go-nebMulti functional bot written in Go
ma1sdma1uta/ma1sdMatrix Identity Server
matrix-appservice-slackmatrixdotorg/matrix-appservice-slackBridge to Slack
matrix-appservice-webhooksturt2live/matrix-appservice-webhooksBridge for slack compatible webhooks (ConcourseCI, Slack etc. pp.)
matrix-chatgpt-botmatrixgpt/matrix-chatgpt-botAccessing ChatGPT via your favourite Matrix client
matrix-ldap-registration-proxyactivism.international/matrix_ldap_registration_proxyProxy that handles Matrix registration requests and forwards them to LDAP
matrix-registrationzeratax/matrix-registrationSimple python application to have a token based Matrix registration
mautrix-facebookmautrix/facebookBridge to Facebook
mautrix-instagrammautrix/instagramBridge to Instagram
mx-puppet-discordmx-puppet/discord/mx-puppet-discordBridge to Discord
mx-puppet-instagramsorunome/mx-puppet-instagramBridge for Instagram-DMs (Instagram)
mx-puppet-slackmx-puppet/slack/mx-puppet-slackBridge to Slack
mx-puppet-twittersorunome/mx-puppet-twitterBridge for Twitter-DMs (Twitter)
sliding-syncmatrix-org/sliding-syncSliding Sync support for clients which require it (like old Element X versions, before it got switched to Simplified Sliding Sync)
synapse_auto_accept_invite(N/A)Synapse module to automatically accept invites