matrix-docker-ansible-deploy

cqrenet/matrix-docker-ansible-deploy

Fork 0

mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy.git synced 2026-10-22 14:24:17 +00:00

Files

T

History

QEDeDandSlavi Pantaleev d69bf26d67 Restart all targeted services on start and restart runs again

Conditional restart is enabled whenever no setup-* tag is selected, so it
also applies to runs with only start or restart tags. These runs skip
the install tasks that set each role's *_restart_necessary, so every
service whose value is false is only started. When the rule was added,
only Traefik tracked its changes this way; now most roles do, so
`just start-all` and `just start-group` restart almost nothing, contrary
to docs/just.md.

Enable conditional restart only when an install-* tag is selected and no
setup-* tag. install-* runs keep conditional restart and setup-* runs are
unchanged; runs with only start or restart tags restart their targeted
services unconditionally again. Show the restart behavior of each
standard recipe in docs/just.md and announce the change in CHANGELOG.md.

2026-10-19 09:10:11 +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

Update ghcr.io/devture/ansible Docker tag to v14.0.0-r0-8

2026-10-09 02:11:07 +00: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

Fix link in docs

2026-08-19 21:26:57 +03: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

Upgrade baibot to v1.28.0 and use GPT-6.1 Sol by default

2026-09-30 21:40:28 +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

Document Meowlnir's per-management-room scoping

2026-08-20 18:40:09 +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

Decouple mautrix-meta-instagram from mautrix-meta-messenger and fix Instagram self-building

2026-08-16 19:14:03 +03:00

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

Decouple mautrix-meta-instagram from mautrix-meta-messenger and fix Instagram self-building

2026-08-16 19:14:03 +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

Update Continuwuity to v26.9.0 and validate retired registration setting

2026-09-17 22:06:19 +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-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

Upgrade LiveKit JWT Service to 0.7.0

2026-09-18 00:28:20 +03:00

configuring-playbook-livekit-server.md

livekit: expose ALPN protocols for s/turn via playbook-managed-traefik

2026-09-22 23:21:01 +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

Document that Matrix RTC requires the federation port even with federation disabled

2026-09-29 22:36:35 +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

Replace URLs to Sygnal

2026-10-13 01:40:07 -07: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-system-cleanup.md

Add the system cleanup role

2026-10-10 15:44:55 +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 the system cleanup role

2026-10-10 15:44:55 +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

Update ddclient role to v4.0.0-8 and document GHCR image

2026-09-29 14:44:22 +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

Restart all targeted services on start and restart runs again

2026-10-19 09:10:11 +03:00

maintenance-and-troubleshooting.md

Add the system cleanup role

2026-10-10 15:44:55 +03: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

molecule-testing.md

Select Molecule scenarios by shared dependency usage

2026-09-19 08:32:06 +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

Document that Matrix RTC requires the federation port even with federation disabled

2026-09-29 22:36:35 +03:00

quick-start.md

Add add-inventory-host command for bootstrapping the inventory

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

README.md

Restore Renovate runner and test runtime before upgrades

2026-09-16 17:54:19 +03:00

registering-users.md

Remove matrix-registration (#4919 )

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

renovate.md

Review Ansible role updates before merging

2026-09-25 19:05:36 +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