3.5 KiB
		
	
	
	
	
	
	
	
			
		
		
	
	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 follow these steps inside the playbook directory:
- 
create a directory to hold your configuration ( mkdir inventory/host_vars/matrix.<your-domain>)
- 
copy the sample configuration file ( cp examples/host-vars.yml inventory/host_vars/matrix.<your-domain>/vars.yml)
- 
edit the configuration file ( inventory/host_vars/matrix.<your-domain>/vars.yml) to your liking. You may also take a look at the variousroles/ROLE_NAME_HERE/defaults/main.ymlfiles and see if there's something you'd like to copy over and override in yourvars.ymlconfiguration file.
- 
copy the sample inventory hosts file ( cp examples/hosts inventory/hosts)
- 
edit the inventory hosts file ( inventory/hosts) to your liking
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)
Core service adjustments
- 
Storing Matrix media files on Amazon S3 (optional) 
- 
Using an external PostgreSQL server (optional) 
- 
Adjusting SSL certificate retrieval (optional, advanced) 
- 
Serving your base domain using this playbook's nginx server (optional) 
- 
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 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 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 Appservice IRC bridging (optional) 
- 
Setting up Appservice Discord bridging (optional)