matrix-docker-ansible-deploy

mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy.git synced 2026-08-14 04:40:51 +00:00

Files

T

Slavi Pantaleev 1cda13f39a Document that Draupnir needs a Moderator power level in a hand-created management room

Draupnir stores each protection's settings as custom state events in the
management room, which requires a power level of 50 by default. A bot left
at the default power level of 0 cannot save any protection settings.

The failure is silent and has an expensive symptom: the
PolicyChangeNotification protection cannot remember its notifications room,
so it creates a brand new one on every restart of the bot. With the
playbook restarting the bot on every installation run, this litters the
server with abandoned rooms (90 of them observed on one deployment over
6 months).

Zero Touch Deployment is unaffected, since the bot creates and owns the
management room itself.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-08-13 10:10:28 +03:00

assets

Add license information for obtain_admin_access_token_element_web.png

2025-03-05 00:27:17 +09:00

alternative-architectures.md

Update docs/alternative-architectures.md: add a copyright header

2025-02-23 14:59:25 +09:00

ansible.md

Document SSH host key and passphrase prompts breaking with Ansible 2.21

2026-07-28 07:57:07 +03:00

configuring-captcha.md

Add dedicated CAPTCHA variables to matrix-authentication-service

2026-07-15 07:29:35 +03:00

configuring-dns.md

docs/configuring-playbook-ipv6.md -> docs/configuring-ipv6.md

2025-03-08 15:42:50 +02:00

configuring-ipv6.md

Minor adjustment in docs/configuring-ipv6.md

2025-03-15 07:54:52 +02:00

configuring-playbook-alertmanager-receiver.md

Update docs: remove descriptions about the ensure-matrix-users-created

2025-03-15 09:58:43 +02:00

configuring-playbook-appservice-double-puppet.md

Update docs: remove descriptions about the ensure-matrix-users-created

2025-03-15 09:58:43 +02:00

configuring-playbook-appservice-draupnir-for-all.md

Update Draupnir from 3.0.0 to 3.1.0 and introduce Zero Touch Deployment to mdad. (#5205 )

2026-05-07 16:59:53 +03:00

configuring-playbook-backup-borg.md

Update docs: configuring-playbook-ntfy.md and others (#4160 )

2025-03-10 10:36:17 +02:00

configuring-playbook-base-domain-serving.md

Add copyright header to docs/configuring-playbook-base-domain-serving.md

2025-02-27 14:02:52 +09:00

configuring-playbook-bot-baibot.md

baibot: add venice wiring

2026-06-28 19:50:08 +03:00

configuring-playbook-bot-buscarron.md

Synapse Admin is Ketesa now! (#5113 )

2026-04-03 15:26:18 +01:00

configuring-playbook-bot-chatgpt.md

Remove matrix-chatgpt-bot

2025-11-07 14:06:41 +02:00

configuring-playbook-bot-draupnir.md

Document that Draupnir needs a Moderator power level in a hand-created management room

2026-08-13 10:10:28 +03:00

configuring-playbook-bot-go-neb.md

Remove Go-NEB

2026-05-23 08:22:12 +03:00

configuring-playbook-bot-honoroit.md

Synapse Admin is Ketesa now! (#5113 )

2026-04-03 15:26:18 +01:00

configuring-playbook-bot-matrix-registration-bot.md

Update docs

2026-07-10 02:05:47 -04:00

configuring-playbook-bot-matrix-reminder-bot.md

Synapse Admin is Ketesa now! (#5113 )

2026-04-03 15:26:18 +01:00

configuring-playbook-bot-maubot.md

Synapse Admin is Ketesa now! (#5113 )

2026-04-03 15:26:18 +01:00

configuring-playbook-bot-meowlnir.md

Add support for Meowlnir

2026-08-13 06:05:30 +03:00

configuring-playbook-bot-mjolnir.md

Add support for Meowlnir

2026-08-13 06:05:30 +03:00

configuring-playbook-bridge-appservice-discord.md

Rename matrix_appservice_discord_* variables to matrix_bridge_appservice_discord_*

2026-07-16 16:12:13 +03:00

configuring-playbook-bridge-appservice-irc.md

Rename matrix_appservice_irc_* variables to matrix_bridge_appservice_irc_*

2026-07-16 16:12:13 +03:00

configuring-playbook-bridge-appservice-kakaotalk.md

Remove the appservice-kakaotalk bridge

2026-07-15 13:31:41 +03:00

configuring-playbook-bridge-appservice-slack.md

Remove matrix-appservice-slack (#4931 )

2026-02-16 14:53:33 +02:00

configuring-playbook-bridge-appservice-webhooks.md

Remove matrix-bridge-appservice-webhooks

2025-11-09 10:34:23 +02:00

configuring-playbook-bridge-beeper-line.md

Correct beeper-line's login instructions

2026-07-28 21:54:33 +03:00

configuring-playbook-bridge-beeper-linkedin.md

Link to authors and repositories in the mautrix-linkedin announcement

2026-07-28 17:07:31 +03:00

configuring-playbook-bridge-go-skype-bridge.md

Fix cli-non-interactive syntax in uninstallation docs (add -c flag)

2026-02-07 10:52:56 +02:00

configuring-playbook-bridge-heisenbridge.md

Rename matrix_heisenbridge_* variables to matrix_bridge_heisenbridge_*

2026-07-16 16:12:13 +03:00

configuring-playbook-bridge-hookshot.md

Enable the appservice encryption MSCs on Synapse for Hookshot too

2026-08-13 08:01:51 +03:00

configuring-playbook-bridge-matrix-bridge-sms.md

Rename matrix_sms_bridge_* variables to matrix_bridge_sms_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-mautrix-bluesky.md

Rename matrix_mautrix_bluesky_* variables to matrix_bridge_mautrix_bluesky_*

2026-07-16 16:12:13 +03:00

configuring-playbook-bridge-mautrix-bridges.md

Update generic bridge variable references for the new naming scheme

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-mautrix-discord.md

Rename matrix_mautrix_discord_* variables to matrix_bridge_mautrix_discord_*

2026-07-16 16:12:13 +03:00

configuring-playbook-bridge-mautrix-facebook.md

Fix cli-non-interactive syntax in uninstallation docs (add -c flag)

2026-02-07 10:52:56 +02:00

configuring-playbook-bridge-mautrix-gmessages.md

Rename matrix_mautrix_gmessages_* variables to matrix_bridge_mautrix_gmessages_*

2026-07-16 16:12:13 +03:00

configuring-playbook-bridge-mautrix-googlechat.md

Rename matrix_mautrix_googlechat_* variables to matrix_bridge_mautrix_googlechat_*

2026-07-16 16:12:13 +03:00

configuring-playbook-bridge-mautrix-gvoice.md

Rename matrix_mautrix_gvoice_* variables to matrix_bridge_mautrix_gvoice_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-mautrix-hangouts.md

Fix cli-non-interactive syntax in uninstallation docs (add -c flag)

2026-02-07 10:52:56 +02:00

configuring-playbook-bridge-mautrix-instagram.md

Fix cli-non-interactive syntax in uninstallation docs (add -c flag)

2026-02-07 10:52:56 +02:00

configuring-playbook-bridge-mautrix-linkedin.md

Reword parts of the mautrix-linkedin documentation page

2026-07-28 16:58:29 +03:00

configuring-playbook-bridge-mautrix-meta-instagram.md

Rename matrix_mautrix_meta_instagram_* variables to matrix_bridge_mautrix_meta_instagram_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-mautrix-meta-messenger.md

Rename matrix_mautrix_meta_messenger_* variables to matrix_bridge_mautrix_meta_messenger_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-mautrix-signal.md

Rename matrix_mautrix_signal_* variables to matrix_bridge_mautrix_signal_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-mautrix-slack.md

Rename matrix_mautrix_slack_* variables to matrix_bridge_mautrix_slack_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-mautrix-telegram.md

Rename matrix_mautrix_telegram_* variables to matrix_bridge_mautrix_telegram_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-mautrix-twitter.md

Rename matrix_mautrix_twitter_* variables to matrix_bridge_mautrix_twitter_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-mautrix-whatsapp.md

Rename matrix_mautrix_whatsapp_* variables to matrix_bridge_mautrix_whatsapp_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-mautrix-wsproxy.md

Rename matrix_mautrix_wsproxy_* variables to matrix_bridge_mautrix_wsproxy_*

2026-07-16 16:12:13 +03:00

configuring-playbook-bridge-meshtastic-relay.md

Rename matrix_meshtastic_relay_* variables to matrix_bridge_meshtastic_relay_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-mx-puppet-discord.md

Fix cli-non-interactive syntax in uninstallation docs (add -c flag)

2026-02-07 10:52:56 +02:00

configuring-playbook-bridge-mx-puppet-groupme.md

Rename matrix_mx_puppet_groupme_* variables to matrix_bridge_mx_puppet_groupme_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-mx-puppet-instagram.md

Fix cli-non-interactive syntax in uninstallation docs (add -c flag)

2026-02-07 10:52:56 +02:00

configuring-playbook-bridge-mx-puppet-skype.md

Remove Go Skype Bridge

2025-11-04 09:55:32 +02:00

configuring-playbook-bridge-mx-puppet-slack.md

Fix cli-non-interactive syntax in uninstallation docs (add -c flag)

2026-02-07 10:52:56 +02:00

configuring-playbook-bridge-mx-puppet-steam.md

Rename matrix_mx_puppet_steam_* variables to matrix_bridge_mx_puppet_steam_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-mx-puppet-twitter.md

Fix cli-non-interactive syntax in uninstallation docs (add -c flag)

2026-02-07 10:52:56 +02:00

configuring-playbook-bridge-postmoogle.md

Rename matrix_postmoogle_* variables to matrix_bridge_postmoogle_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-rustpush.md

Rename matrix_rustpush_bridge_* variables to matrix_bridge_rustpush_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-steam.md

Rename matrix_steam_bridge_* variables to matrix_bridge_steam_*

2026-07-16 16:12:14 +03:00

configuring-playbook-bridge-wechat.md

Rename matrix_wechat_* variables to matrix_bridge_wechat_*

2026-07-16 16:12:14 +03:00

configuring-playbook-cactus-comments.md

Update docs: remove descriptions about the ensure-matrix-users-created

2025-03-15 09:58:43 +02:00

configuring-playbook-client-cinny.md

Relocate Cinny role to MASH organization (#4900 )

2026-02-07 11:01:04 +02:00

configuring-playbook-client-commet.md

• docs: add Commet client guide

2026-03-04 10:28:55 -05:00

configuring-playbook-client-element-web.md

Add license information to files for matrix-client-element

2025-03-03 17:58:12 +09:00

configuring-playbook-client-fluffychat-web.md

Update the link to the FluffyChat website

2025-11-20 17:16:05 +09:00

configuring-playbook-client-hydrogen.md

Merge pull request #4915 from luixxiul/hydrogen

2026-02-12 15:00:21 +02:00

configuring-playbook-client-sable.md

Update links to the Sable repository

2026-06-04 23:57:39 -04:00

configuring-playbook-client-schildichat-web.md

Add license information to files for matrix-client-schildichat

2025-02-28 21:24:22 +09:00

configuring-playbook-conduit.md

Remove conduwuit (#4913 )

2026-02-11 15:03:56 +02:00

configuring-playbook-conduwuit.md

Attribute Tuwunel's status as the conduwuit successor

2026-05-07 14:15:11 +03:00

configuring-playbook-continuwuity.md

Auto-wire Continuwuity SMTP and well-known defaults

2026-04-18 07:49:49 +03:00

configuring-playbook-dendrite.md

Re-run "reuse annotate" to sort statements

2025-03-05 12:43:41 +09:00

configuring-playbook-dimension.md

Remove Dimension (#4916 )

2026-02-12 20:05:51 +02:00

configuring-playbook-dynamic-dns.md

Relocate ddclient role to MASH organization (#4902 )

2026-02-08 16:34:35 +02:00

configuring-playbook-element-admin.md

Synapse Admin is Ketesa now! (#5113 )

2026-04-03 15:26:18 +01:00

configuring-playbook-element-call.md

Run codespell --write-changes

2025-06-03 10:36:00 +03:00

configuring-playbook-email2matrix.md

Re-run "reuse annotate" to sort statements

2025-03-05 12:43:41 +09:00

configuring-playbook-email.md

Auto-wire Continuwuity SMTP and well-known defaults

2026-04-18 07:49:49 +03:00

configuring-playbook-etherpad.md

Update docs: remove descriptions about the ensure-matrix-users-created

2025-03-15 09:58:43 +02:00

configuring-playbook-external-postgres.md

Update docs/configuring-playbook-external-postgres.md: add a copyright header

2025-03-05 00:26:36 +09:00

configuring-playbook-federation.md

Clarify when disabling the federation port applies in the CDN guide

2026-07-15 13:31:41 +03:00

configuring-playbook-jitsi.md

Do not auto-enable Coturn by default

2026-02-21 17:16:29 +02:00

configuring-playbook-jwt-service.md

Add Element Call support

2025-03-15 08:34:48 +02:00

configuring-playbook-ketesa.md

matrix-tuwunel: add labels to expose the Synapse-compatible admin API

2026-07-19 06:40:58 +03:00

configuring-playbook-ldap-auth.md

Update docs

2026-05-23 21:24:46 +03:00

configuring-playbook-livekit-jwt-service.md

Enable pre-commit

2025-06-03 10:36:00 +03:00

configuring-playbook-livekit-server.md

Update LiveKit Server role to v1.12.0-0

2026-05-18 09:25:30 +03:00

configuring-playbook-ma1sd.md

Remove ma1sd (#4898 )

2026-02-08 09:35:51 +02:00

configuring-playbook-matrix-authentication-service.md

Synapse Admin is Ketesa now! (#5113 )

2026-04-03 15:26:18 +01:00

configuring-playbook-matrix-corporal.md

Run codespell --write-changes

2025-06-03 10:36:00 +03:00

configuring-playbook-matrix-ldap-registration-proxy.md

Update docs

2026-05-23 21:24:46 +03:00

configuring-playbook-matrix-media-repo.md

Remove passlib dependency by making matrix-media-repo datastore IDs user-provided

2026-02-09 16:56:51 +02:00

configuring-playbook-matrix-registration.md

Remove matrix-registration (#4919 )

2026-05-19 10:40:00 +03:00

configuring-playbook-matrix-rtc.md

Add nginx reverse-proxy example for Matrix RTC (#5086 )

2026-04-24 09:14:07 +03:00

configuring-playbook-matrixto.md

Add Matrix.to (#4750 )

2025-11-23 06:53:37 +02:00

configuring-playbook-nginx.md

Add copyright header to docs/configuring-playbook-nginx.md

2025-02-27 14:10:58 +09:00

configuring-playbook-ntfy.md

Run codespell --write-changes

2025-06-03 10:36:00 +03:00

configuring-playbook-own-webserver.md

fix: migrate Traefik Cert Dumper configuration

2025-12-09 09:30:53 +02:00

configuring-playbook-pantalaimon.md

Re-run "reuse annotate" to sort statements

2025-03-05 12:43:41 +09:00

configuring-playbook-postgres-backup.md

Update docs: configuring-playbook-ntfy.md and others (#4160 )

2025-03-10 10:36:17 +02:00

configuring-playbook-prometheus-grafana.md

Expose synapse-usage-exporter metrics like the metrics of other services

2026-07-28 15:14:39 +03:00

configuring-playbook-rageshake.md

Add license information to files for matrix-rageshake

2025-02-27 18:31:49 +09:00

configuring-playbook-rest-auth.md

Remove ma1sd (#4898 )

2026-02-08 09:35:51 +02:00

configuring-playbook-riot-web.md

Update docs/configuring-playbook-riot-web.md: add a copyright header

2025-03-05 00:26:49 +09:00

configuring-playbook-s3-goofys.md

Update docs: add "Synapse" to the title of configuring-playbook-s3-goofys.md

2025-03-04 21:29:29 +09:00

configuring-playbook-s3.md

Update configuring-playbook-s3.md: Storj introducing minimum charge

2025-05-31 17:52:43 +09:00

configuring-playbook-shared-secret-auth.md

Update docs for components related to authentication: adopt the common descriptions

2025-02-28 22:25:08 +09:00

configuring-playbook-sliding-sync-proxy.md

Fix cli-non-interactive syntax in uninstallation docs (add -c flag)

2026-02-07 10:52:56 +02:00

configuring-playbook-ssl-certificates.md

Update notes about self-hosting services with the MASH playbook

2026-02-10 22:31:11 +09:00

configuring-playbook-sygnal.md

Rename variable (matrix_user_groupname -> matrix_group_name)

2025-04-29 10:39:41 +03:00

configuring-playbook-synapse-auto-accept-invite.md

Remove synapse-auto-invite-accept (#4943 )

2026-02-17 14:37:46 +02:00

configuring-playbook-synapse-auto-compressor.md

Randomize matrix-synapse-auto-compressor.timer start with a RandomizedDelaySec (defaults to 6h)

2025-03-29 10:34:37 +02:00

configuring-playbook-synapse-s3-storage-provider.md

feat: prune empty dir when migrate to s3 storage

2026-03-01 01:04:22 +02:00

configuring-playbook-synapse-simple-antispam.md

Typo

2025-05-17 21:58:30 +03:00

configuring-playbook-synapse-usage-exporter.md

Expose synapse-usage-exporter metrics like the metrics of other services

2026-07-28 15:14:39 +03:00

configuring-playbook-synapse.md

Synapse Admin is Ketesa now! (#5113 )

2026-04-03 15:26:18 +01:00

configuring-playbook-synology.md

Add Synology DSM support (#5315 )

2026-06-29 19:45:01 +03:00

configuring-playbook-telemetry.md

Add copyright header to docs/configuring-playbook-telemetry.md

2025-02-27 14:12:00 +09:00

configuring-playbook-traefik.md

Slightly clarify Traefik Dashboard instructions

2026-04-15 12:09:57 +03:00

configuring-playbook-turn.md

chore: bump livekit role and document TURN relay ports

2026-03-03 09:51:53 +02:00

configuring-playbook-tuwunel.md

matrix-tuwunel: add labels to expose the /_tuwunel API path

2026-07-19 06:40:58 +03:00

configuring-playbook-user-verification-service.md

Add license information to files for matrix-user-verification-service

2025-03-03 12:14:23 +09:00

configuring-playbook.md

Add support for Meowlnir

2026-08-13 06:05:30 +03:00

configuring-well-known.md

Add Content-Type hint for manually-copied well-known files

2026-07-21 07:47:47 +03:00

container-images.md

Add support for Meowlnir

2026-08-13 06:05:30 +03:00

faq.md

Update faq.md: add a section about removed roles

2026-07-12 14:44:27 +03:00

getting-the-playbook.md

Update docs: title of the document for configuring DNS settings

2025-02-25 23:09:19 +09:00

howto-server-delegation.md

fixed typo in link to chapter

2026-06-01 20:00:22 +03:00

howto-srv-server-delegation.md

Fix Traefik router name in SRV server delegation docs

2026-07-13 15:30:58 +03:00

importing-postgres.md

Document Synapse database restore pitfalls per the official backup guide

2026-07-14 14:34:45 +03:00

importing-synapse-media-store.md

Document rsync as a server-side prerequisite for media store import

2026-07-13 15:03:05 +03:00

importing-synapse-sqlite.md

Add copyright header to docs/importing-synapse-sqlite.md

2025-02-27 14:41:48 +09:00

installing.md

Document pulling the sudo password from pass via the passwordstore lookup

2026-07-12 16:52:18 +03:00

just.md

Auto-detect conditional restart based on playbook tags and add CHANGELOG entry

2026-02-13 14:21:07 +02:00

maintenance-and-troubleshooting.md

Re-run "reuse annotate" to sort statements

2025-03-05 12:43:41 +09:00

maintenance-migrating.md

Fix rsync flags, -r is redundant when specifying -a

2026-08-01 20:14:31 +03:00

maintenance-postgres.md

Document Synapse database restore pitfalls per the official backup guide

2026-07-14 14:34:45 +03:00

maintenance-synapse.md

Document that Synapse cache autotuning limits apply per process

2026-07-14 14:56:48 +03:00

maintenance-upgrading-services.md

Update maintenance-upgrading-services.md: add a section about the migration validation system

2026-05-06 16:58:20 +03:00

obtaining-access-tokens.md

Re-run "reuse annotate" to sort statements

2025-03-05 12:43:41 +09:00

playbook-tags.md

Add comments to ensure-matrix-users-created

2025-03-15 09:58:43 +02:00

prerequisites.md

Do not auto-enable Coturn by default

2026-02-21 17:16:29 +02:00

quick-start.md

Add add-inventory-host command for bootstrapping the inventory

2026-07-12 16:08:09 +03:00

README.md

Add style guide for playbook developers

2026-07-18 06:14:12 +03:00

registering-users.md

Remove matrix-registration (#4919 )

2026-05-19 10:40:00 +03:00

self-building.md

Merge pull request #5462 from c00/beeper-line

2026-07-28 22:10:02 +03:00

style-guide.md

Add style guide for playbook developers

2026-07-18 06:14:12 +03:00

uninstalling.md

Update docs: add copyright headers for reusing them at the MASH project

2025-02-21 12:23:26 +09:00

updating-users-passwords.md

Add copyright header to docs/updating-users-passwords.md

2025-02-27 14:42:23 +09:00

README.md

⬇️ Installation guides

There are two installation guides available for beginners and advanced users.

⚡ Quick start (for beginners): this is recommended for those who do not have an existing Matrix server and want to start quickly with "opinionated defaults".
Full installation guide (for advanced users): if you need to import an existing Matrix server's data into the new server or want to learn more while setting up the server, follow this guide.

🛠️ Configuration options

You can check useful documentation for configuring components here: Configuring the playbook

Administration — services that help you in administrating and monitoring your Matrix installation
Authentication and user-related — extend and modify how users are authenticated on your homeserver
Bots — bots provide various additional functionality to your installation
Bridges — bridges can be used to connect your Matrix installation with third-party communication networks
Clients — web clients for Matrix that you can host on your own domains
Core service adjustments — backbone of your Matrix system
File Storage — use alternative file storage to the default media_store folder

Other specialized services — various services that don't fit any other categories

👨‍🔧 Maintenance

If your server and services experience issues, feel free to come to our support room and ask for help.

README.md

Table of Contents

⬇️ Installation guides

🛠️ Configuration options

👨‍🔧 Maintenance

Other documentation pages

README.md Unescape Escape

Table of Contents

⬇️ Installation guides

🛠️ Configuration options

👨‍🔧 Maintenance

Other documentation pages

README.md