mirror of
https://github.com/famedly/ansible-collection-matrix
synced 2024-09-21 06:21:54 +00:00
2.1 KiB
2.1 KiB
matrix-synapse
Install a matrix synapse server.
Requirements
The following should be present on the target system
pipsystemdrsyslogdlogrotate
Role Variables
Mandatory Variables
| Name | Type | Description |
|---|---|---|
| matrix_server_name | string | |
| matrix_synapse_tls_cert | string | server's TLS certificate chain (when matrix_synapse_skip_tls not set) |
| matrix_synapse_tls_key | string | server's TLS key (when matrix_synapse_skip_tls not set) |
| matrix_synapse_report_stats | bool | Report the stats to matrix.org |
| matrix_synapse_pg_host | sting | postgresql server |
| matrix_synapse_pg_user | string | postgresql user |
| matrix_synapse_pg_pass | string | postgresql user's password |
| matrix_synapse_pg_db | string | postgresql database |
| matrix_synapse_macaroon_secret_key | string | matrix's macaroon key (make sure not to change it!) |
| matrix_synapse_registration_secret | string | matrix's registration secret |
Optional Variables
| Name | Value | Description |
|---|---|---|
| matrix_synapse_extra_config | None | configuration parameters as given in the synapse configuration file |
| matrix_synapse_dh_path | "/opt/synapse/tls/{{ matrix_server_name }}.dh" | |
| matrix_synapse_baseurl | "https://{{ matrix_server_name }}" | |
| matrix_synapse_signing_key_path | "/opt/synapse/ssl/{{ matrix_server_name }}.signing.key" | |
| matrix_synapse_version | "v0.99.1.1" | |
| matrix_synapse_log_days_keep | 30 | |
| matrix_synapse_deployment_method | pip | Either pip or docker ¹ |
| matrix_synapse_supervision_method | systemd | Either systemd, runit or docker ¹ |
¹: Docker must be used for both or neither deployment and supervision
Dependencies
None.
Example Playbook
#TODO: Add example
License
Apache 2.0
Author Information
- Michael Kaye
- Jan Christian Grünhage
- Emmanouil Kampitakis