matrix-docker-ansible-deploy/docs/container-images.md

Container images used by the playbook

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

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.

Clients

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

Server Components

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

Authentication

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

File Storage

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

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

Service	Container image	Default?	Description
mautrix-discord	mautrix/discord	❌	Bridge to Discord
mautrix-slack	mautrix/slack	❌	Bridge to Slack
mautrix-telegram	mautrix/telegram	❌	Bridge to Telegram
mautrix-gmessages	mautrix/gmessages	❌	Bridge to Google Messages
mautrix-whatsapp	mautrix/whatsapp	❌	Bridge to WhatsApp
mautrix-wsproxy	mautrix/wsproxy	❌	Bridge to Android SMS or Apple iMessage
mautrix-twitter	mautrix/twitter	❌	Bridge to Twitter
mautrix-googlechat	mautrix/googlechat	❌	Bridge to Google Chat
mautrix-meta (for Messenger and Instagram)	mautrix/meta	❌	Bridge to Messenger and Instagram
mautrix-signal	mautrix/signal	❌	Bridge to Signal
beeper-linkedin	beeper/linkedin	❌	Bridge to LinkedIn
matrix-appservice-irc	matrixdotorg/matrix-appservice-irc	❌	Bridge to IRC
matrix-appservice-kakaotalk	Self-building	❌	Bridge to Kakaotalk
matrix-appservice-discord	matrix-org/matrix-appservice-discord	❌	Bridge to Discord
matrix-appservice-slack	matrixdotorg/matrix-appservice-slack	❌	Bridge to Slack
matrix-hookshot	halfshot/matrix-hookshot	❌	Bridge for generic webhooks and multiple project management services, such as GitHub, GitLab, Figma, and Jira in particular
matrix-sms-bridge	folivonet/matrix-sms-bridge	❌	Bridge to SMS
matrix-wechat	lxduo/matrix-wechat	❌	Bridge to WeChat
Heisenbridge	hif1/heisenbridge	❌	Bouncer-style bridge to IRC
go-skype-bridge	nodefyme/go-skype-bridge	❌	Bridge to Skype
mx-puppet-slack	mx-puppet/slack/mx-puppet-slack	❌	Bridge to Slack
mx-puppet-instagram	sorunome/mx-puppet-instagram	❌	Bridge for Instagram-DMs (Instagram)
mx-puppet-twitter	sorunome/mx-puppet-twitter	❌	Bridge for Twitter-DMs (Twitter)
mx-puppet-discord	mx-puppet/discord/mx-puppet-discord	❌	Bridge to Discord
mx-puppet-groupme	xangelix/mx-puppet-groupme	❌	Bridge to GroupMe
mx-puppet-steam	icewind1991/mx-puppet-steam	❌	Bridge to Steam
Email2Matrix	devture/email2matrix	❌	Bridge for relaying emails to Matrix rooms
Postmoogle	etke.cc/postmoogle	❌	Email to Matrix bridge

Bots

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

Administration

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.

Misc

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

Container images of deprecated / unmaintained services

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