Robert Kaussow
8dd9f1faf7
Author: Robert Kaussow <mail@geeklabor.de>
Date: Tue Mar 24 14:37:55 2020 +0100
use synapse v1.12.0 as default and add min twisted package version
533 lines
9.0 KiB
Markdown
533 lines
9.0 KiB
Markdown
---
|
|
title: matrix
|
|
type: docs
|
|
---
|
|
|
|
[](https://gitea.rknet.org/ansible/xoxys.matrix) [](https://drone.rknet.org/ansible/xoxys.matrix) [](LICENSE)
|
|
|
|
Setup a [matrix-synapse](https://github.com/matrix-org/synapse) chat server. Matrix is an ambitious new ecosystem for open federated Instant Messaging and VoIP.
|
|
|
|
* [Default Variables](#default-variables)
|
|
* [matrix_base_dir](#matrix-base-dir)
|
|
* [matrix_client_url](#matrix-client-url)
|
|
* [matrix_conf_dir](#matrix-conf-dir)
|
|
* [matrix_data_dir](#matrix-data-dir)
|
|
* [matrix_db_name](#matrix-db-name)
|
|
* [matrix_db_password](#matrix-db-password)
|
|
* [matrix_db_port](#matrix-db-port)
|
|
* [matrix_db_server](#matrix-db-server)
|
|
* [matrix_db_ssl_mode](#matrix-db-ssl-mode)
|
|
* [matrix_db_ssl_root_cert](#matrix-db-ssl-root-cert)
|
|
* [matrix_db_type](#matrix-db-type)
|
|
* [matrix_db_user](#matrix-db-user)
|
|
* [matrix_extra_groups](#matrix-extra-groups)
|
|
* [matrix_filter_timeline_limit](#matrix-filter-timeline-limit)
|
|
* [matrix_form_secret](#matrix-form-secret)
|
|
* [matrix_group](#matrix-group)
|
|
* [matrix_http_bind_ips](#matrix-http-bind-ips)
|
|
* [matrix_http_bind_port](#matrix-http-bind-port)
|
|
* [matrix_https_bind_ips](#matrix-https-bind-ips)
|
|
* [matrix_https_bind_port](#matrix-https-bind-port)
|
|
* [matrix_ldap_auth_basedn](#matrix-ldap-auth-basedn)
|
|
* [matrix_ldap_auth_enabled](#matrix-ldap-auth-enabled)
|
|
* [matrix_ldap_auth_mail_attr](#matrix-ldap-auth-mail-attr)
|
|
* [matrix_ldap_auth_name_attr](#matrix-ldap-auth-name-attr)
|
|
* [matrix_ldap_auth_server](#matrix-ldap-auth-server)
|
|
* [matrix_ldap_auth_uid_attr](#matrix-ldap-auth-uid-attr)
|
|
* [matrix_ldap_auth_use_starttls](#matrix-ldap-auth-use-starttls)
|
|
* [matrix_log_console_level](#matrix-log-console-level)
|
|
* [matrix_log_dir](#matrix-log-dir)
|
|
* [matrix_log_file_level](#matrix-log-file-level)
|
|
* [matrix_log_ldap_auth_level](#matrix-log-ldap-auth-level)
|
|
* [matrix_log_ldap_level](#matrix-log-ldap-level)
|
|
* [matrix_log_synapse_level](#matrix-log-synapse-level)
|
|
* [matrix_log_synapse_sql_level](#matrix-log-synapse-sql-level)
|
|
* [matrix_macaroon_secret_key](#matrix-macaroon-secret-key)
|
|
* [matrix_packages](#matrix-packages)
|
|
* [matrix_packages_extra](#matrix-packages-extra)
|
|
* [matrix_rc_login_account](#matrix-rc-login-account)
|
|
* [matrix_rc_login_address](#matrix-rc-login-address)
|
|
* [matrix_restart_policy](#matrix-restart-policy)
|
|
* [matrix_server_url](#matrix-server-url)
|
|
* [matrix_tls_cert_path](#matrix-tls-cert-path)
|
|
* [matrix_tls_cert_source](#matrix-tls-cert-source)
|
|
* [matrix_tls_dhparam_path](#matrix-tls-dhparam-path)
|
|
* [matrix_tls_dhparam_size](#matrix-tls-dhparam-size)
|
|
* [matrix_tls_enabled](#matrix-tls-enabled)
|
|
* [matrix_tls_key_path](#matrix-tls-key-path)
|
|
* [matrix_tls_key_source](#matrix-tls-key-source)
|
|
* [matrix_url_preview_enabled](#matrix-url-preview-enabled)
|
|
* [matrix_url_preview_max_spider_size](#matrix-url-preview-max-spider-size)
|
|
* [matrix_user](#matrix-user)
|
|
* [matrix_user_home](#matrix-user-home)
|
|
* [matrix_version](#matrix-version)
|
|
* [matrix_web_client_location](#matrix-web-client-location)
|
|
* [Dependencies](#dependencies)
|
|
|
|
---
|
|
|
|
## Default Variables
|
|
|
|
### matrix_base_dir
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_base_dir: /opt/matrix
|
|
```
|
|
|
|
### matrix_client_url
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_client_url: https://matrix.example.com
|
|
```
|
|
|
|
### matrix_conf_dir
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_conf_dir: '{{ matrix_base_dir }}/config'
|
|
```
|
|
|
|
### matrix_data_dir
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_data_dir: '{{ matrix_base_dir }}/data'
|
|
```
|
|
|
|
### matrix_db_name
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_db_name: matrix
|
|
```
|
|
|
|
### matrix_db_password
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_db_password: secure
|
|
```
|
|
|
|
### matrix_db_port
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_db_port: 5432
|
|
```
|
|
|
|
### matrix_db_server
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_db_server: localhost
|
|
```
|
|
|
|
### matrix_db_ssl_mode
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_db_ssl_mode: disable
|
|
```
|
|
|
|
### matrix_db_ssl_root_cert
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_db_ssl_root_cert: /etc/pki/tls/certs/ca-bundle.trust.crt
|
|
```
|
|
|
|
### matrix_db_type
|
|
|
|
Sopported values are `pgsql` and `sqlite`.
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_db_type: pgsql
|
|
```
|
|
|
|
### matrix_db_user
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_db_user: pgmatrix
|
|
```
|
|
|
|
### matrix_extra_groups
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_extra_groups: []
|
|
```
|
|
|
|
### matrix_filter_timeline_limit
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_filter_timeline_limit: -1
|
|
```
|
|
|
|
### matrix_form_secret
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_form_secret: oFP3m&,r^wJ=Tr#=Ruww5+h0e;-DZqcuVGXV4XgRZIAt~Gv2YF
|
|
```
|
|
|
|
### matrix_group
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_group: '{{ matrix_user }}'
|
|
```
|
|
|
|
### matrix_http_bind_ips
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_http_bind_ips:
|
|
- '::'
|
|
- 0.0.0.0
|
|
```
|
|
|
|
### matrix_http_bind_port
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_http_bind_port: 8008
|
|
```
|
|
|
|
### matrix_https_bind_ips
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_https_bind_ips: '{{ matrix_http_bind_ips }}'
|
|
```
|
|
|
|
### matrix_https_bind_port
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_https_bind_port: 8448
|
|
```
|
|
|
|
### matrix_ldap_auth_basedn
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_ldap_auth_basedn: ou=users,dc=example,dc=com
|
|
```
|
|
|
|
### matrix_ldap_auth_enabled
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_ldap_auth_enabled: false
|
|
```
|
|
|
|
### matrix_ldap_auth_mail_attr
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_ldap_auth_mail_attr: email
|
|
```
|
|
|
|
### matrix_ldap_auth_name_attr
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_ldap_auth_name_attr: cn
|
|
```
|
|
|
|
### matrix_ldap_auth_server
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_ldap_auth_server: ldaps://ldap.example.com:636
|
|
```
|
|
|
|
### matrix_ldap_auth_uid_attr
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_ldap_auth_uid_attr: uid
|
|
```
|
|
|
|
### matrix_ldap_auth_use_starttls
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_ldap_auth_use_starttls: 'false'
|
|
```
|
|
|
|
### matrix_log_console_level
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_log_console_level: ERROR
|
|
```
|
|
|
|
### matrix_log_dir
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_log_dir: '{{ matrix_base_dir }}/log'
|
|
```
|
|
|
|
### matrix_log_file_level
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_log_file_level: INFO
|
|
```
|
|
|
|
### matrix_log_ldap_auth_level
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_log_ldap_auth_level: INFO
|
|
```
|
|
|
|
### matrix_log_ldap_level
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_log_ldap_level: INFO
|
|
```
|
|
|
|
### matrix_log_synapse_level
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_log_synapse_level: INFO
|
|
```
|
|
|
|
### matrix_log_synapse_sql_level
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_log_synapse_sql_level: INFO
|
|
```
|
|
|
|
### matrix_macaroon_secret_key
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_macaroon_secret_key: jr;vhMlW=+U8pwBhVE^=6.,M94Gcyg_07Z-nNAsgj4ZZ:ew:HV
|
|
```
|
|
|
|
### matrix_packages
|
|
|
|
Ensure EPEL repo is available at this server
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_packages:
|
|
- '@Development tools'
|
|
- libtiff-devel
|
|
- libjpeg-devel
|
|
- libzip-devel
|
|
- freetype-devel
|
|
- lcms2-devel
|
|
- libwebp-devel
|
|
- tcl-devel
|
|
- tk-devel
|
|
- redhat-rpm-config
|
|
- python36-devel
|
|
- libffi-devel
|
|
- openssl-devel
|
|
```
|
|
|
|
### matrix_packages_extra
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_packages_extra: []
|
|
```
|
|
|
|
### matrix_rc_login_account
|
|
|
|
Ratelimiting settings for login requests based on the account the client is attempting to log into.
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_rc_login_account:
|
|
per_second: 0.17
|
|
burst_count: 3
|
|
```
|
|
|
|
### matrix_rc_login_address
|
|
|
|
Ratelimiting settings for login requests based on the client's IP address.
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_rc_login_address:
|
|
per_second: 0.17
|
|
burst_count: 3
|
|
```
|
|
|
|
### matrix_restart_policy
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_restart_policy: on-failure
|
|
```
|
|
|
|
### matrix_server_url
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_server_url: example.com
|
|
```
|
|
|
|
### matrix_tls_cert_path
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_tls_cert_path: '{{ matrix_base_dir }}/tls/certs/mycert.pem'
|
|
```
|
|
|
|
### matrix_tls_cert_source
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_tls_cert_source: mycert.pem
|
|
```
|
|
|
|
### matrix_tls_dhparam_path
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_tls_dhparam_path: '{{ matrix_base_dir }}/tls/dhparam.pem'
|
|
```
|
|
|
|
### matrix_tls_dhparam_size
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_tls_dhparam_size: 2048
|
|
```
|
|
|
|
### matrix_tls_enabled
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_tls_enabled: false
|
|
```
|
|
|
|
### matrix_tls_key_path
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_tls_key_path: '{{ matrix_base_dir }}/tls/private/mykey.pem'
|
|
```
|
|
|
|
### matrix_tls_key_source
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_tls_key_source: mykey.pem
|
|
```
|
|
|
|
### matrix_url_preview_enabled
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_url_preview_enabled: false
|
|
```
|
|
|
|
### matrix_url_preview_max_spider_size
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_url_preview_max_spider_size: 10M
|
|
```
|
|
|
|
### matrix_user
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_user: matrix
|
|
```
|
|
|
|
### matrix_user_home
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_user_home: /home/{{ matrix_user }}
|
|
```
|
|
|
|
### matrix_version
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_version: 1.12.0
|
|
```
|
|
|
|
### matrix_web_client_location
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
matrix_web_client_location: /path/to/web/root
|
|
```
|
|
|
|
## Dependencies
|
|
|
|
None.
|