--- # Dendrite is a second-generation Matrix homeserver currently in Beta # See: https://github.com/matrix-org/dendrite matrix_conduit_enabled: true matrix_conduit_docker_image: "{{ matrix_conduit_docker_image_name_prefix }}matrixconduit/matrix-conduit:{{ matrix_conduit_docker_image_tag }}" matrix_conduit_docker_image_name_prefix: "docker.io/" matrix_conduit_docker_image_tag: "v0.5.1" matrix_conduit_docker_image_force_pull: "{{ matrix_conduit_docker_image.endswith(':latest') }}" matrix_conduit_base_path: "{{ matrix_base_data_path }}/dendrite" matrix_conduit_config_dir_path: "{{ matrix_conduit_base_path }}/config" matrix_conduit_storage_path: "{{ matrix_conduit_base_path }}/storage" matrix_conduit_media_store_path: "{{ matrix_conduit_storage_path }}/media-store" matrix_conduit_ext_path: "{{ matrix_conduit_base_path }}/ext" # By default, we make Dendrite only serve HTTP (not HTTPS). # HTTPS is usually served at the reverse-proxy side (usually via `matrix-nginx-proxy`). # # To enable HTTPS serving by Dendrite (directly): # - `matrix_conduit_https_bind_port` must be set # - `-tls-cert` and `-tls-key` must be passed to Dendrite via `matrix_conduit_process_extra_arguments` # - the TLS certificate files must be mounted into the container using `matrix_conduit_container_additional_volumes` matrix_conduit_http_bind_port: 8008 matrix_conduit_https_bind_port: ~ # This is passed as an `-http-bind-address` flag to the Dendrite server in the container matrix_conduit_http_bind_address: "{{ (':' + matrix_conduit_http_bind_port|string) if matrix_conduit_http_bind_port else '' }}" # This is passed as an `-https-bind-address` flag to the Dendrite server in the container matrix_conduit_https_bind_address: "{{ (':' + matrix_conduit_https_bind_port|string) if matrix_conduit_https_bind_port else '' }}" # Controls whether the matrix-dendrite container exposes the HTTP port (tcp/{{ matrix_conduit_http_bind_port }} in the container). # # Takes an ":" or "" value (e.g. "127.0.0.1:8008"), or empty string to not expose. matrix_conduit_container_http_host_bind_address: "" # Controls whether the matrix-dendrite container exposes the HTTPS port (tcp/{{ matrix_conduit_https_bind_port }} in the container). # # Takes an ":" or "" value (e.g. "127.0.0.1:8448"), or empty string to not expose. matrix_conduit_container_https_host_bind_address: "" # A list of extra arguments to pass to the container (`docker run` command) matrix_conduit_container_extra_arguments: [] # A list of extra arguments to pass to the container process (`dendrite-monolith` command) # Example: # matrix_conduit_process_extra_arguments: # - "-tls-cert /some/path.crt" # - "-tls-key /some/path.pem" matrix_conduit_process_extra_arguments: [] # List of systemd services that matrix-dendrite.service depends on matrix_conduit_systemd_required_services_list: ["docker.service"] # List of systemd services that matrix-dendrite.service wants matrix_conduit_systemd_wanted_services_list: [] # Specifies which template files to use when configuring Dendrite. # If you'd like to have your own different configuration, feel free to copy and paste # the original files into your inventory (e.g. in `inventory/host_vars//`) # and then change the specific host's `vars.yaml` file like this: # matrix_conduit_template_conduit_config: "{{ playbook_dir }}/inventory/host_vars//dendrite.yaml.j2" matrix_conduit_template_conduit_config: "{{ role_path }}/templates/dendrite/dendrite.yaml.j2" matrix_conduit_registration_shared_secret: '' matrix_conduit_allow_guest_access: false matrix_conduit_max_file_size_bytes: 10485760 # Controls which HTTP header (e.g. 'X-Forwarded-For', 'X-Real-IP') to inspect to find the real remote IP address of the client. # This is likely required if Dendrite is running behind a reverse proxy server. matrix_conduit_sync_api_real_ip_header: '' # The tmpfs at /tmp needs to be large enough to handle multiple concurrent file uploads. matrix_conduit_tmp_directory_size_mb: 500 # Rate limits matrix_conduit_rate_limiting_enabled: true matrix_conduit_rate_limiting_threshold: 5 matrix_conduit_rate_limiting_cooloff_ms: 500 # Controls whether people with access to the homeserver can register by themselves. matrix_conduit_registration_disabled: false # reCAPTCHA API for validating registration attempts matrix_conduit_enable_registration_captcha: false matrix_conduit_recaptcha_public_key: "" matrix_conduit_recaptcha_private_key: "" # A list of additional "volumes" to mount in the container. # This list gets populated dynamically based on Dendrite extensions that have been enabled. # Contains definition objects like this: `{"src": "/outside", "dst": "/inside", "options": "rw|ro|slave|.."} # # Note: internally, this uses the `-v` flag for mounting the specified volumes. # It's better (safer) to use the `--mount` flag for mounting volumes. # To use `--mount`, specify it in `matrix_conduit_container_extra_arguments`. # Example: `matrix_conduit_container_extra_arguments: ['--mount type=bind,src=/outside,dst=/inside,ro'] matrix_conduit_container_additional_volumes: [] # A list of appservice config files (in-container filesystem paths). # This list gets populated dynamically based on Dendrite extensions that have been enabled. # You may wish to use this together with `matrix_conduit_container_additional_volumes` or `matrix_conduit_container_extra_arguments`. matrix_conduit_app_service_config_files: [] # Enable exposure of metrics matrix_conduit_metrics_enabled: false matrix_conduit_metrics_username: "metrics" matrix_conduit_metrics_password: "metrics" # Postgres database information matrix_conduit_database_str: "postgresql://{{ matrix_conduit_database_user }}:{{ matrix_conduit_database_password }}@{{ matrix_conduit_database_hostname }}" matrix_conduit_database_hostname: "matrix-postgres" matrix_conduit_database_user: "dendrite" matrix_conduit_database_password: "itsasecret" matrix_conduit_naffka_database: "dendrite_naffka" matrix_conduit_appservice_database: "dendrite_appservice" matrix_conduit_federationsender_database: "dendrite_federationsender" matrix_conduit_keyserver_database: "dendrite_keyserver" matrix_conduit_mediaapi_database: "dendrite_mediaapi" matrix_conduit_room_database: "dendrite_room" matrix_conduit_singingkeyserver_database: "dendrite_sigingkeyserver" matrix_conduit_syncapi_database: "dendrite_syncapi" matrix_conduit_account_database: "dendrite_account" matrix_conduit_device_database: "dendrite_device" matrix_conduit_mscs_database: "dendrite_mscs" matrix_conduit_turn_uris: [] matrix_conduit_turn_shared_secret: "" matrix_conduit_turn_allow_guests: false # Controls whether the self-check feature should validate TLS certificates. matrix_conduit_disable_tls_validation: false matrix_conduit_trusted_id_servers: - "matrix.org" - "vector.im" # Controls whether Dendrite will federate at all. # Disable this to completely isolate your server from the rest of the Matrix network. matrix_conduit_federation_enabled: true # Controls whether the self-check feature should validate SSL certificates. matrix_conduit_self_check_validate_certificates: true # Default Dendrite configuration template which covers the generic use case. # You can customize it by controlling the various variables inside it. # # For a more advanced customization, you can extend the default (see `matrix_conduit_configuration_extension_yaml`) # or completely replace this variable with your own template. matrix_conduit_configuration_yaml: "{{ lookup('template', 'templates/dendrite/dendrite.yaml.j2') }}" matrix_conduit_configuration_extension_yaml: | # Your custom YAML configuration for Dendrite goes here. # This configuration extends the default starting configuration (`matrix_conduit_configuration_yaml`). # # You can override individual variables from the default configuration, or introduce new ones. # # If you need something more special, you can take full control by # completely redefining `matrix_conduit_configuration_yaml`. # # Example configuration extension follows: # # server_notices: # system_mxid_localpart: notices # system_mxid_display_name: "Server Notices" # system_mxid_avatar_url: "mxc://server.com/oumMVlgDnLYFaPVkExemNVVZ" # room_name: "Server Notices" matrix_conduit_configuration_extension: "{{ matrix_conduit_configuration_extension_yaml|from_yaml if matrix_conduit_configuration_extension_yaml|from_yaml is mapping else {} }}" # Holds the final Dendrite configuration (a combination of the default and its extension). # You most likely don't need to touch this variable. Instead, see `matrix_conduit_configuration_yaml`. matrix_conduit_configuration: "{{ matrix_conduit_configuration_yaml|from_yaml|combine(matrix_conduit_configuration_extension, recursive=True) }}"