No description
Find a file
Emmanouil Kampitakis d4570e0363
Merge pull request #15 from jcgruenhage/fix/defaults-and-readme-tls
fix serveral documentation mistakes
2019-04-08 23:36:18 +02:00
defaults Merge branch 'master' into fix/defaults-and-readme-tls 2019-04-08 23:35:40 +02:00
files make log dir configurable 2019-03-24 16:51:22 +01:00
handlers Docker containers do not support restarted statement 2019-02-17 23:50:22 +01:00
library Extract signing key creation to module 2019-02-15 03:10:38 +01:00
meta moved role out of matrix-ansible 2018-07-30 16:56:33 +02:00
tasks make log dir configurable 2019-03-24 16:51:22 +01:00
templates make log dir configurable 2019-03-24 16:51:22 +01:00
tests Add retries to the http connection test and flush handlers 2019-04-08 23:12:17 +02:00
vars Use matrix base path in task files 2019-02-21 23:17:57 +01:00
.editorconfig Make the ansible linter happy 2019-02-18 00:27:45 +01:00
.gitignore Add the testroles directory 2019-02-15 03:14:21 +01:00
.gitlab-ci.yml Fix typo in gitlab-ci docker 2019-02-18 00:41:46 +01:00
README.md Merge branch 'master' into fix/defaults-and-readme-tls 2019-04-08 23:35:40 +02:00
TODO.md Add handler todo 2019-03-15 00:24:22 +01:00

matrix-synapse

Install a matrix synapse server.

Requirements

The following should be present on the target system

  • pip
  • systemd
  • rsyslogd
  • logrotate

Role Variables

Mandatory Variables

Name Type Description
matrix_server_name string
matrix_synapse_tls_cert string server's TLS certificate chain (when matrix_synapse_extra_config.no_tls is set to true)
matrix_synapse_tls_key string server's TLS key (when matrix_synapse_extra_config.no_tls is set to true)
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

Optional Variables

Name Value Description
matrix_synapse_base_path "/opt/synapse"
matrix_synapse_secrets_path "{{ matrix_synapse_base_path }}/secrets"
matrix_synapse_extra_config None configuration parameters as given in the synapse configuration file
matrix_synapse_dh_path "{{ matrix_synapse_base_path }}/tls/{{ matrix_server_name }}.dh"
matrix_synapse_baseurl "https://{{ matrix_server_name }}"
matrix_synapse_signing_key_path "{{ matrix_synapse_base_path }}/ssl/{{ matrix_server_name }}.signing.key"
matrix_synapse_version "v0.99.3"
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 ¹
matrix_synapse_python_version 3 Default python version (2, 3) to be used

¹: 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