infrastructure/roles/matrix/README.md
saibotk a1ee824f84
matrix: Remove delegate config
BREAKING: Please use the new matrix_delegate role for this.
2021-09-22 02:48:46 +02:00

36 lines
1.2 KiB
Markdown

Matrix
=========
This will setup a Matrix (Synapse) instance using their official docker container and traefik as a reverse proxy.
Additionally, you may need to configure delegation, to do so take a look at the matrix_delegation role.
Requirements
------------
You will need to have docker, docker-compose and traefik installed or declared as dependencies with their respective roles.
**This role assumes that you have setup traefik with an endpoint called `websecure`.**
Role Variables
--------------
**Please look at the [defaults/main.yml](defaults/main.yml) for all available variables and their description.**
**Note: Lines that are commented out via `#` are usually still valid/used variables, but they are not defined by default, so they might enable a feature, when uncommenting/defining them!**
### Global variables, that are used:
- `proxy_network`: Defined by the local traefik installation, this is the shared proxy network used by traefik to reach the containers. (optional)
- `proxy_hiddenservice`: Defined by the local traefik installation, this is used to generate the alt-svc header for the alternative Tor domain. (optional)
Dependencies
------------
- docker
- docker-compose
- traefik
License
-------
GPL-3.0-only