matrix-docker-ansible-deploy/docs/container-images.md
Suguru Hirahara c8ee67aa3b
Update README.md and docs/container-images.md: move up Exim as default service
Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
2024-11-04 13:10:26 +09:00

21 KiB

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 x 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 x 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 vectorim/element-web Web UI, which is configured to connect to your own Synapse server by default
Hydrogen element-hq/hydrogen-web x Lightweight Matrix client with legacy and mobile browser support
Cinny ajbura/cinny x Simple, elegant and secure web client
SchildiChat etke.cc/schildichat-web x Based on Element, 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 x Matrix Identity Server
ddclient linuxserver/ddclient x 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) x REST authentication password provider module
matrix-synapse-shared-secret-auth (N/A) x Password provider module
matrix-synapse-ldap3 (advanced) (N/A) x LDAP Auth password provider module
matrix-ldap-registration-proxy activism.international/matrix_ldap_registration_proxy x A proxy that handles Matrix registration requests and forwards them to LDAP.
matrix-registration zeratax/matrix-registration x A simple python application to have a token based Matrix registration
Matrix User Verification Service (UVS) matrixdotorg/matrix-user-verification-service x Service to verify details of a user based on an Open ID token

File Storage

Use alternative file storage to the default media_store folder.

Service Container image Default? Description
Goofys ewoutp/goofys x Amazon S3 (or other S3-compatible object store) storage for Synapse's content repository (media_store) files
synapse-s3-storage-provider (N/A) x Amazon S3 (or other S3-compatible object store) storage for Synapse's content repository (media_store) files
matrix-media-repo t2bot/matrix-media-repo x 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 x Bridge to Discord
mautrix-slack mautrix/slack x Bridge to Slack
mautrix-telegram mautrix/telegram x Bridge to Telegram
mautrix-gmessages mautrix/gmessages x Bridge to Google Messages
mautrix-whatsapp mautrix/whatsapp x Bridge to WhatsApp
mautrix-wsproxy mautrix/wsproxy x Bridge to Android SMS or Apple iMessage
mautrix-twitter mautrix/twitter x Bridge to Twitter
mautrix-googlechat mautrix/googlechat x Bridge to Google Chat
mautrix-meta (for Messenger and Instagram) mautrix/meta x Bridge to Messenger and Instagram
mautrix-signal mautrix/signal x Bridge to Signal
beeper-linkedin beeper/linkedin x Bridge to LinkedIn
matrix-appservice-irc matrixdotorg/matrix-appservice-irc x Bridge to IRC
matrix-appservice-kakaotalk Self-building x Bridge to Kakaotalk
matrix-appservice-discord matrix-org/matrix-appservice-discord x Bridge to Discord
matrix-appservice-slack matrixdotorg/matrix-appservice-slack x Bridge to Slack
matrix-hookshot halfshot/matrix-hookshot x 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 x Bridge to SMS
matrix-wechat lxduo/matrix-wechat x Bridge to WeChat
Heisenbridge hif1/heisenbridge x Bouncer-style bridge to IRC
go-skype-bridge nodefyme/go-skype-bridge x Bridge to Skype
mx-puppet-slack mx-puppet/slack/mx-puppet-slack x Bridge to Slack
mx-puppet-instagram sorunome/mx-puppet-instagram x Bridge for Instagram-DMs (Instagram)
mx-puppet-twitter sorunome/mx-puppet-twitter x Bridge for Twitter-DMs (Twitter)
mx-puppet-discord mx-puppet/discord/mx-puppet-discord x Bridge to Discord
mx-puppet-groupme xangelix/mx-puppet-groupme x Bridge to GroupMe
mx-puppet-steam icewind1991/mx-puppet-steam x Bridge to Steam
Email2Matrix devture/email2matrix x Bridge for relaying emails to Matrix rooms
Postmoogle etke.cc/postmoogle x Email to Matrix bridge

Bots

Bots provide various additional functionality to your installation.

Service Container image Default? Description
baibot etke.cc/baibot x A bot that exposes the power of AI / Large Language Models to you
matrix-reminder-bot anoa/matrix-reminder-bot x Bot for scheduling one-off & recurring reminders and alarms
matrix-registration-bot moanos/matrix-registration-bot x Bot for invitations by creating and managing registration tokens
maubot dock.mau.dev/maubot/maubot x A plugin-based Matrix bot system
Honoroit etke.cc/honoroit x A helpdesk bot
Mjolnir matrixdotorg/mjolnir x A moderation tool for Matrix
Draupnir gnuxie/draupnir x A moderation tool for Matrix (Fork of Mjolnir)
Buscarron etke.cc/buscarron x 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 x Prometheus' Alertmanager client
Matrix Authentication Service element-hq/matrix-authentication-service x OAuth 2.0 and OpenID Provider server
synapse-admin etke.cc/synapse-admin x A web UI tool for administrating users and rooms on your Matrix server
Metrics and Graphs prom/prometheus x Prometheus time-series database server
Metrics and Graphs prom/node-exporter x Prometheus node-exporter host metrics exporter
Metrics and Graphs grafana/grafana x 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 x Addon for Prometheus that gathers access logs from various nginx reverse-proxies
Borg (N/A) x Backups
rageshake matrix-org/rageshake x Bug report server
synapse-usage-exporter Self-building x 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 x Sliding Sync support for clients which require it (e.g. Element X)
synapse_auto_accept_invite (N/A) x A Synapse module to automatically accept invites.
synapse_auto_compressor etke.cc/rust-synapse-compress-state x A cli tool that automatically compresses state_groups database table in background.
synapse-simple-antispam (advanced) (N/A) x A spam checker module
Matrix Corporal (advanced) devture/matrix-corporal x Reconciliator and gateway for a managed Matrix server
Etherpad etherpad/etherpad x An open source collaborative text editor
Jitsi jitsi/web x the Jitsi web UI
Jitsi jitsi/jicofo x the Jitsi Focus component
Jitsi jitsi/prosody x the Jitsi Prosody XMPP server component
Jitsi jitsi/jvb x the Jitsi Video Bridge component
Cactus Comments cactuscomments/cactus-appservice x A federated comment system built on Matrix
Cactus Comments joseluisq/static-web-server x A federated comment system built on Matrix
Pantalaimon matrixdotorg/pantalaimon x An E2EE aware proxy daemon
Sygnal matrixdotorg/sygnal x Reference Push Gateway for Matrix
ntfy binwiederhier/ntfy x 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 x Bridge for slack compatible webhooks (ConcourseCI, Slack etc. pp.)
Dimension turt2live/matrix-dimension x An open source integration manager for Matrix clients
Go-NEB matrixdotorg/go-neb x A multi functional bot written in Go
matrix-chatgpt-bot matrixgpt/matrix-chatgpt-bot x Accessing ChatGPT via your favourite Matrix client
mautrix-facebook mautrix/facebook x Bridge to Facebook
mautrix-hangouts mautrix/hangouts x Bridge to Google Hangouts
mautrix-instagram mautrix/instagram x Bridge to Instagram