matrix-docker-ansible-deploy/docs/configuring-playbook.md

Configuring the Ansible playbook

To configure the playbook, you need to have done the following things:

• have a server where Matrix services will run
• configured your DNS records
• retrieved the playbook’s source code to your computer

You can then initialize the configuration files vars.yml and hosts by running ./initialize.sh. If you need to change the variables, you can opt to run the script again.

For a basic Matrix installation, that’s all you need. For a more custom setup, see the Other configuration options below.

When you’re done with all the configuration you’d like to do, continue with Installing.

Other configuration options

Additional useful services

• Setting up the Dimension Integration Manager (optional, but recommended; after installing)

• Setting up the Jitsi video-conferencing platform (optional)

• Setting up Dynamic DNS (optional)

• Enabling metrics and graphs (Prometheus, Grafana) for your Matrix server (optional)

Core service adjustments

• Configuring Synapse (optional)

• Configuring Element (optional)

• Storing Matrix media files on Amazon S3 (optional)

• Using an external PostgreSQL server (optional)

• Adjusting ma1sd Identity Server configuration (optional)

• Adjusting SSL certificate retrieval (optional, advanced)

• Serving your base domain using this playbook’s nginx server (optional)

• Configure Nginx (optional, advanced) (optional, advanced)

• Using your own webserver, instead of this playbook’s nginx proxy (optional, advanced)

• Adjusting TURN server configuration (optional, advanced)

Server connectivity

• Enabling Telemetry for your Matrix server (optional)

• Controlling Matrix federation (optional)

• Adjusting email-sending settings (optional)

Authentication and user-related

• Setting up Synapse Admin (optional)

• Setting up matrix-registration (optional)

• Setting up the REST authentication password provider module (optional, advanced)

• Setting up the Shared Secret Auth password provider module (optional, advanced)

• Setting up the LDAP password provider module (optional, advanced)

• Setting up Synapse Simple Antispam (optional, advanced)

• Setting up Matrix Corporal (optional, advanced)

Bridging other networks

• Setting up Mautrix Telegram bridging (optional)

• Setting up Mautrix Whatsapp bridging (optional)

• Setting up Mautrix Facebook bridging (optional)

• Setting up Mautrix Hangouts bridging (optional)

• Setting up Mautrix Instagram bridging (optional)

• Setting up Mautrix Signal bridging (optional)

• Setting up Appservice IRC bridging (optional)

• Setting up Appservice Discord bridging (optional)

• Setting up Appservice Slack bridging (optional)

• Setting up Appservice Webhooks bridging (optional)

• Setting up MX Puppet Skype bridging (optional)

• Setting up MX Puppet Slack bridging (optional)

• Setting up MX Puppet Instagram bridging (optional)

• Setting up MX Puppet Twitter bridging (optional)

• Setting up MX Puppet Discord bridging (optional)

• Setting up MX Puppet GroupMe bridging (optional)

• Setting up MX Puppet Steam bridging (optional)

• Setting up Email2Matrix (optional)

• Setting up Matrix SMS bridging (optional)

Bots

• Setting up matrix-reminder-bot (optional)