xoxys.matrix/index.md
Robert Kaussow f5fbbe9645 commit 00bedc54ed
Author: Robert Kaussow <mail@geeklabor.de>
Date:   Mon Apr 5 17:05:39 2021 +0200

    add option matrix_signing_key to deploy existings signing key
2021-04-05 15:09:15 +00:00

9.2 KiB

title type
matrix docs

Source Code Build Status License: MIT

Setup a matrix-synapse chat server. Matrix is an ambitious new ecosystem for open federated Instant Messaging and VoIP.


Default Variables

matrix_base_dir

Default value

matrix_base_dir: /opt/matrix

matrix_client_url

Default value

matrix_client_url: https://matrix.example.com

matrix_conf_dir

Default value

matrix_conf_dir: '{{ matrix_base_dir }}/config'

matrix_data_dir

Default value

matrix_data_dir: '{{ matrix_base_dir }}/data'

matrix_db_name

Default value

matrix_db_name: matrix

matrix_db_password

Default value

matrix_db_password: secure

matrix_db_port

Default value

matrix_db_port: 5432

matrix_db_server

Default value

matrix_db_server: localhost

matrix_db_ssl_mode

Default value

matrix_db_ssl_mode: disable

matrix_db_ssl_root_cert

Default value

matrix_db_ssl_root_cert: /etc/pki/tls/certs/ca-bundle.trust.crt

matrix_db_type

Sopported values are pgsql and sqlite.

Default value

matrix_db_type: pgsql

matrix_db_user

Default value

matrix_db_user: pgmatrix

matrix_extra_groups

Default value

matrix_extra_groups: []

matrix_filter_timeline_limit

Default value

matrix_filter_timeline_limit: -1

matrix_form_secret

Default value

matrix_form_secret: oFP3m&,r^wJ=Tr#=Ruww5+h0e;-DZqcuVGXV4XgRZIAt~Gv2YF

matrix_group

Default value

matrix_group: '{{ matrix_user }}'

matrix_http_bind_ips

Default value

matrix_http_bind_ips:
  - 127.0.0.1

matrix_http_bind_port

Default value

matrix_http_bind_port: 8008

matrix_https_bind_ips

Default value

matrix_https_bind_ips: []

matrix_https_bind_port

Default value

matrix_https_bind_port: 8448

matrix_ldap_auth_basedn

Default value

matrix_ldap_auth_basedn: ou=users,dc=example,dc=com

matrix_ldap_auth_enabled

Default value

matrix_ldap_auth_enabled: false

matrix_ldap_auth_mail_attr

Default value

matrix_ldap_auth_mail_attr: email

matrix_ldap_auth_name_attr

Default value

matrix_ldap_auth_name_attr: cn

matrix_ldap_auth_server

Default value

matrix_ldap_auth_server: ldaps://ldap.example.com:636

matrix_ldap_auth_uid_attr

Default value

matrix_ldap_auth_uid_attr: uid

matrix_ldap_auth_use_starttls

Default value

matrix_ldap_auth_use_starttls: 'false'

matrix_log_console_level

Default value

matrix_log_console_level: ERROR

matrix_log_dir

Default value

matrix_log_dir: '{{ matrix_base_dir }}/log'

matrix_log_file_level

Default value

matrix_log_file_level: INFO

matrix_log_ldap_auth_level

Default value

matrix_log_ldap_auth_level: INFO

matrix_log_ldap_level

Default value

matrix_log_ldap_level: INFO

matrix_log_synapse_level

Default value

matrix_log_synapse_level: INFO

matrix_log_synapse_sql_level

Default value

matrix_log_synapse_sql_level: INFO

matrix_macaroon_secret_key

Default value

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

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

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

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

matrix_rc_login_address:
  per_second: 0.17
  burst_count: 3

matrix_restart_policy

Default value

matrix_restart_policy: on-failure

matrix_server_url

Default value

matrix_server_url: example.com

matrix_signing_key

Default value

matrix_signing_key: _unset_

matrix_tls_cert_path

Default value

matrix_tls_cert_path: '{{ matrix_base_dir }}/tls/certs/mycert.pem'

matrix_tls_cert_source

Default value

matrix_tls_cert_source: mycert.pem

matrix_tls_dhparam_path

Default value

matrix_tls_dhparam_path: '{{ matrix_base_dir }}/tls/dhparam.pem'

matrix_tls_dhparam_size

Default value

matrix_tls_dhparam_size: 2048

matrix_tls_enabled

Default value

matrix_tls_enabled: false

matrix_tls_key_path

Default value

matrix_tls_key_path: '{{ matrix_base_dir }}/tls/private/mykey.pem'

matrix_tls_key_source

Default value

matrix_tls_key_source: mykey.pem

matrix_url_preview_enabled

Default value

matrix_url_preview_enabled: false

matrix_url_preview_max_spider_size

Default value

matrix_url_preview_max_spider_size: 10M

matrix_user

Default value

matrix_user: matrix

matrix_user_home

Default value

matrix_user_home: /home/{{ matrix_user }}

matrix_version

Default value

matrix_version: 1.26.0

matrix_web_client_location

Default value

matrix_web_client_location: /path/to/web/root

Dependencies

None.