mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2026-08-14 04:40:51 +00:00
Slavi Pantaleev
aef0fad8b5
Hookshot's end-to-bridge encryption needs MSC2409 and MSC3202 enabled on the homeserver, but the playbook only turned them on for Meowlnir. Hookshot's encryption defaults to the playbook-wide `matrix_bridges_encryption_enabled` toggle, so turning that on gave Hookshot encryption against a Synapse which was not set up for it, and Hookshot then struggled in encrypted rooms. The playbook already wires up Hookshot's other encryption prerequisite (Valkey) and fails the run when the Redis settings are missing, so being only half-automatic here was the odd one out. Synapse sends the extra data only to appservices which ask for it in their registration file, so turning these on affects no other component. The documentation told Hookshot users to set the two Synapse variables by hand, and argued they should be enabled deliberately. That contradicted what we already do for Meowlnir, so it is gone; the note now matches the Meowlnir one and points out that other homeserver implementations still need arranging by hand. Closes https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/5506 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Table of Contents
⬇️ 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_storefolder
- 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.
Other documentation pages
- ℹ️ FAQ — various Frequently Asked Questions about Matrix, with a focus on this Ansible playbook