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.
| Service | Container image | Default? | Description |
|---|---|---|---|
| Synapse | element-hq/synapse | ✅ | Storing your data and managing your presence in the Matrix network |
| Conduit | matrixconduit/matrix-conduit | ❌ | Storing 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 |
| Dendrite | matrixdotorg/dendrite-monolith | ❌ | Storing your data and managing your presence in the Matrix network. Dendrite is a second-generation Matrix homeserver written in Go, an alternative to Synapse. |
Web clients for Matrix that you can host on your own domains.
| Service | Container image | Default? | Description |
|---|---|---|---|
| Element Web | vectorim/element-web | ✅ | Default Matrix web client, configured to connect to your own Synapse server |
| Hydrogen | element-hq/hydrogen-web | ❌ | Lightweight Matrix client with legacy and mobile browser support |
| Cinny | ajbura/cinny | ❌ | Simple, elegant and secure web client |
| SchildiChat Web | etke.cc/schildichat-web | ❌ | Based on Element Web, with a more traditional instant messaging experience |
Services that run on the server to make the various parts of your installation work.
| Service | Container image | Default? | Description |
|---|---|---|---|
| PostgreSQL | postgres | ✅ | Database for Synapse. Using an external PostgreSQL server is also possible. |
| Coturn | coturn/coturn | ✅ | STUN/TURN server for WebRTC audio/video calls |
| Traefik | Traefik | ✅ | Web server, listening on ports 80, 443 and 8448 - standing in front of all the other services. Using your own webserver is possible |
| Let's Encrypt | certbot/certbot | ✅ | The certbot tool for obtaining SSL certificates from Let's Encrypt |
| Exim | devture/exim-relay | ✅ | Mail server, through which all Matrix services send outgoing email (can be configured to relay through another SMTP server) |
| ma1sd | ma1uta/ma1sd | ❌ | Matrix Identity Server |
| ddclient | linuxserver/ddclient | ❌ | Update dynamic DNS entries for accounts on Dynamic DNS Network Service Provider |
Extend and modify how users are authenticated on your homeserver.
| Service | Container image | Default? | 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-ldap-registration-proxy | activism.international/matrix_ldap_registration_proxy | ❌ | A proxy that handles Matrix registration requests and forwards them to LDAP. |
| matrix-registration | zeratax/matrix-registration | ❌ | A simple python application to have a token based Matrix registration |
| Matrix User Verification Service (UVS) | matrixdotorg/matrix-user-verification-service | ❌ | Service to verify details of a user based on an Open ID token |
| synapse-simple-antispam (advanced) | (N/A) | ❌ | A spam checker module |
Use alternative file storage to the default media_store folder.
| Service | Container image | Default? | Description |
|---|---|---|---|
| Goofys | ewoutp/goofys | ❌ | Amazon 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-repo | t2bot/matrix-media-repo | ❌ | matrix-media-repo is a highly 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 can be used to connect your Matrix installation with third-party communication networks.
Bots provide various additional functionality to your installation.
| Service | Container image | Default? | Description |
|---|---|---|---|
| baibot | etke.cc/baibot | ❌ | A bot that exposes the power of AI / Large Language Models to you |
| matrix-reminder-bot | anoa/matrix-reminder-bot | ❌ | Bot for scheduling one-off & recurring reminders and alarms |
| matrix-registration-bot | moanos/matrix-registration-bot | ❌ | Bot for invitations by creating and managing registration tokens |
| maubot | dock.mau.dev/maubot/maubot | ❌ | A plugin-based Matrix bot system |
| Honoroit | etke.cc/honoroit | ❌ | A helpdesk bot |
| Mjolnir | matrixdotorg/mjolnir | ❌ | A moderation tool for Matrix |
| Draupnir | gnuxie/draupnir | ❌ | A moderation tool for Matrix (Fork of Mjolnir) |
| Buscarron | etke.cc/buscarron | ❌ | Web forms (HTTP POST) to Matrix |
Services that help you in administrating and monitoring your Matrix installation.
| Service | Container image | Default? | Description |
|---|---|---|---|
| matrix-alertmanager-receiver | metio/matrix-alertmanager-receiver | ❌ | Prometheus' Alertmanager client |
| Matrix Authentication Service | element-hq/matrix-authentication-service | ❌ | OAuth 2.0 and OpenID Provider server |
| synapse-admin | etke.cc/synapse-admin | ❌ | A web UI tool for administrating users and rooms on your Matrix server |
| Metrics and Graphs | prom/prometheus | ❌ | Prometheus time-series database server |
| Metrics and Graphs | prom/node-exporter | ❌ | Prometheus node-exporter host metrics exporter |
| Metrics and Graphs | grafana/grafana | ❌ | Graphing tool that works well with the above two images. Our playbook also adds two dashboards for Synapse and Node Exporter |
| Metrics and Graphs | martin-helmich/prometheus-nginxlog-exporter/exporter | ❌ | Addon for Prometheus that gathers access logs from various nginx reverse-proxies |
| Borg | (N/A) | ❌ | Backups |
| rageshake | matrix-org/rageshake | ❌ | Bug report server |
| synapse-usage-exporter | Self-building | ❌ | Export the usage statistics of a Synapse homeserver to be scraped by Prometheus. |
Various services that don't fit any other categories.
| Service | Container image | Default? | Description |
|---|---|---|---|
| sliding-sync | matrix-org/sliding-sync | ❌ | Sliding 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) | ❌ | A Synapse module to automatically accept invites. |
| synapse_auto_compressor | etke.cc/rust-synapse-compress-state | ❌ | A cli tool that automatically compresses state_groups database table in background. |
| Matrix Corporal (advanced) | devture/matrix-corporal | ❌ | Reconciliator and gateway for a managed Matrix server |
| Etherpad | etherpad/etherpad | ❌ | An open source collaborative text editor |
| Jitsi | jitsi/web | ❌ | the Jitsi web UI |
| Jitsi | jitsi/jicofo | ❌ | the Jitsi Focus component |
| Jitsi | jitsi/prosody | ❌ | the Jitsi Prosody XMPP server component |
| Jitsi | jitsi/jvb | ❌ | the Jitsi Video Bridge component |
| Cactus Comments | cactuscomments/cactus-appservice | ❌ | A federated comment system built on Matrix |
| Cactus Comments | joseluisq/static-web-server | ❌ | A federated comment system built on Matrix |
| Pantalaimon | matrixdotorg/pantalaimon | ❌ | An E2EE aware proxy daemon |
| Sygnal | matrixdotorg/sygnal | ❌ | Reference Push Gateway for Matrix |
| ntfy | binwiederhier/ntfy | ❌ | Self-hosted, UnifiedPush-compatible push notifications server |
The list of the deprecated or unmaintained services is available here.
| Service | Container image | Default? | Description |
|---|---|---|---|
| matrix-appservice-webhooks | turt2live/matrix-appservice-webhooks | ❌ | Bridge for slack compatible webhooks (ConcourseCI, Slack etc. pp.) |
| Dimension | turt2live/matrix-dimension | ❌ | An open source integration manager for Matrix clients |
| Go-NEB | matrixdotorg/go-neb | ❌ | A multi functional bot written in Go |
| matrix-chatgpt-bot | matrixgpt/matrix-chatgpt-bot | ❌ | Accessing ChatGPT via your favourite Matrix client |
| mautrix-facebook | mautrix/facebook | ❌ | Bridge to Facebook |
| mautrix-hangouts | mautrix/hangouts | ❌ | Bridge to Google Hangouts |
| mautrix-instagram | mautrix/instagram | ❌ | Bridge to Instagram |