2024-12-07 17:34:44 +01:00
# SPDX-FileCopyrightText: 2024 MDAD Team and contributors
#
# SPDX-License-Identifier: AGPL-3.0-or-later
2023-02-08 16:44:30 +01:00
---
# A moderation tool for Matrix
2023-09-07 19:33:25 +02:00
# Project source code URL: https://github.com/the-draupnir-project/Draupnir
2023-02-08 16:44:30 +01:00
matrix_bot_draupnir_enabled : true
2023-10-06 14:14:03 +02:00
# renovate: datasource=docker depName=gnuxie/draupnir
2024-03-24 21:03:56 +01:00
matrix_bot_draupnir_version : "v1.87.0"
2023-02-08 16:44:30 +01:00
matrix_bot_draupnir_container_image_self_build : false
2023-09-07 19:08:33 +02:00
matrix_bot_draupnir_container_image_self_build_repo : "https://github.com/the-draupnir-project/Draupnir.git"
2023-02-08 16:44:30 +01:00
matrix_bot_draupnir_docker_image : "{{ matrix_bot_draupnir_docker_image_name_prefix }}gnuxie/draupnir:{{ matrix_bot_draupnir_version }}"
matrix_bot_draupnir_docker_image_name_prefix : "{{ 'localhost/' if matrix_bot_draupnir_container_image_self_build else matrix_container_global_registry_prefix }}"
matrix_bot_draupnir_docker_image_force_pull : "{{ matrix_bot_draupnir_docker_image.endswith(':latest') }}"
matrix_bot_draupnir_base_path : "{{ matrix_base_data_path }}/draupnir"
matrix_bot_draupnir_config_path : "{{ matrix_bot_draupnir_base_path }}/config"
matrix_bot_draupnir_data_path : "{{ matrix_bot_draupnir_base_path }}/data"
matrix_bot_draupnir_docker_src_files_path : "{{ matrix_bot_draupnir_base_path }}/docker-src"
2024-08-08 05:41:45 +02:00
matrix_bot_draupnir_abuse_reporting_enabled : false
matrix_bot_draupnir_web_enabled : "{{ matrix_bot_draupnir_abuse_reporting_enabled }}"
matrix_bot_draupnir_display_reports : "{{ matrix_bot_draupnir_abuse_reporting_enabled }}"
2024-01-07 08:04:27 +01:00
matrix_bot_draupnir_container_network : ""
matrix_bot_draupnir_container_additional_networks : "{{ matrix_bot_draupnir_container_additional_networks_auto + matrix_bot_draupnir_container_additional_networks_custom }}"
matrix_bot_draupnir_container_additional_networks_auto : [ ]
matrix_bot_draupnir_container_additional_networks_custom : [ ]
2024-08-08 05:41:45 +02:00
# Controls whether the matrix-bot-draupnir container exposes its HTTP port (tcp/80 in the container).
#
# Takes an "<ip>:<port>" or "<port>" value (e.g. "127.0.0.1:8766"), or empty string to not expose.
matrix_bot_draupnir_container_http_host_bind_port : ''
2023-02-08 16:44:30 +01:00
# A list of extra arguments to pass to the container
matrix_bot_draupnir_container_extra_arguments : [ ]
# List of systemd services that matrix-bot-draupnir.service depends on
2024-01-07 08:04:27 +01:00
matrix_bot_draupnir_systemd_required_services_list : "{{ matrix_bot_draupnir_systemd_required_services_list_default + matrix_bot_draupnir_systemd_required_services_list_auto + matrix_bot_draupnir_systemd_required_services_list_custom }}"
2024-06-04 12:14:34 +02:00
matrix_bot_draupnir_systemd_required_services_list_default : "{{ [devture_systemd_docker_base_docker_service_name] if devture_systemd_docker_base_docker_service_name else [] }}"
2024-01-07 08:04:27 +01:00
matrix_bot_draupnir_systemd_required_services_list_auto : [ ]
matrix_bot_draupnir_systemd_required_services_list_custom : [ ]
2023-02-08 16:44:30 +01:00
# List of systemd services that matrix-bot-draupnir.service wants
matrix_bot_draupnir_systemd_wanted_services_list : [ ]
2024-03-24 17:25:19 +01:00
# Whether Draupnir should talk to the homeserver through Pantalaimon
# If true, then other variables must be provided including pointing
# `matrix_bot_draupnir_homeserver_url` to the Pantalaimon URL.
matrix_bot_draupnir_pantalaimon_use : false
# The access token for the bot user. Required when NOT using Pantalaimon.
# (Otherwise provide `matrix_bot_draupnir_pantalaimon_username` and `matrix_bot_draupnir_pantalaimon_password` instead.)
2023-02-08 16:44:30 +01:00
matrix_bot_draupnir_access_token : ""
2024-03-24 17:25:19 +01:00
# User name and password for the bot. Required when using Pantalaimon.
# (Otherwise provide `matrix_bot_draupnir_access_token` instead.)
2024-03-24 21:55:21 +01:00
matrix_bot_draupnir_pantalaimon_username : ""
2024-03-24 17:25:19 +01:00
matrix_bot_draupnir_pantalaimon_password : ""
2023-02-08 16:44:30 +01:00
# The room ID where people can use the bot. The bot has no access controls, so
# anyone in this room can use the bot - secure your room!
# This should be a room alias or room ID - not a matrix.to URL.
2024-03-24 21:55:21 +01:00
# Note: Draupnir is fairly verbose - expect a lot of messages from it.
2023-02-08 16:44:30 +01:00
matrix_bot_draupnir_management_room : ""
2024-10-18 16:28:00 +02:00
# Endpoint URL that Draupnir uses to interact with the Matrix homeserver (client-server API).
2024-03-24 17:25:19 +01:00
# Set this to the pantalaimon URL if you're using that.
matrix_bot_draupnir_homeserver_url : ""
# Endpoint URL that Draupnir could use to fetch events related to reports (client-server API and /_synapse/),
# only set this to the public-internet homeserver client API URL, do NOT set this to the pantalaimon URL.
matrix_bot_draupnir_raw_homeserver_url : ""
2023-09-07 19:19:11 +02:00
# Disable Server ACL is used if you want to not give the bot the right to apply Server ACLs in rooms without complaints from the bot.
2023-09-07 19:36:49 +02:00
# This setting is described the following way in the Configuration.
2023-09-07 19:19:11 +02:00
#
# Whether or not Draupnir should apply `m.room.server_acl` events.
# DO NOT change this to `true` unless you are very confident that you know what you are doing.
#
# Please follow the advice of upstream and only change this value if you know what your doing.
# Its Exposed here because its common enough to be valid to expose.
2023-09-07 19:36:49 +02:00
matrix_bot_draupnir_disable_server_acl : "false"
2023-09-07 19:19:11 +02:00
2023-02-08 16:44:30 +01:00
# Default 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_bot_draupnir_configuration_extension_yaml`)
# or completely replace this variable with your own template.
matrix_bot_draupnir_configuration_yaml : "{{ lookup('template', 'templates/production.yaml.j2') }}"
matrix_bot_draupnir_configuration_extension_yaml : |
# Your custom YAML configuration goes here.
# This configuration extends the default starting configuration (`matrix_bot_draupnir_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_bot_draupnir_configuration_yaml`.
matrix_bot_draupnir_configuration_extension : "{{ matrix_bot_draupnir_configuration_extension_yaml | from_yaml if matrix_bot_draupnir_configuration_extension_yaml | from_yaml is mapping else {} }}"
# Holds the final configuration (a combination of the default and its extension).
# You most likely don't need to touch this variable. Instead, see `matrix_bot_draupnir_configuration_yaml`.
matrix_bot_draupnir_configuration : "{{ matrix_bot_draupnir_configuration_yaml | from_yaml | combine(matrix_bot_draupnir_configuration_extension, recursive=True) }}"
2024-08-08 05:41:45 +02:00
2024-11-03 08:52:40 +01:00
# Controls whether labels will be added that redirect the /_matrix/client/../rooms/../report paths to Draupnir
2024-08-08 05:41:45 +02:00
# Following these recommendations (https://github.com/element-hq/synapse/blob/master/docs/reverse_proxy.md), by default, we don't.
# Regardless of whether this is enabled, it may or may not take effect due to the value of other variables.
# See `matrix_synapse_container_labels_traefik_enabled` or `matrix_synapse_container_labels_matrix_related_labels_enabled`
matrix_bot_draupnir_container_labels_traefik_enabled : false
matrix_bot_draupnir_container_labels_traefik_docker_network : "{{ matrix_draupnir_bot_container_network }}"
matrix_bot_draupnir_container_labels_traefik_hostname : "{{ matrix_synapse_container_labels_traefik_hostname }}"
matrix_bot_draupnir_container_labels_traefik_path_regexp : "^/_matrix/client/(r0|v3)/rooms/([^/]*)/report/"
matrix_bot_draupnir_container_labels_traefik_rule : "Host(`{{ matrix_bot_draupnir_container_labels_traefik_hostname }}`) && PathRegexp(`{{ matrix_bot_draupnir_container_labels_traefik_path_regexp }}`)"
matrix_bot_draupnir_container_labels_traefik_priority : 0
matrix_bot_draupnir_container_labels_traefik_entrypoints : "{{ matrix_synapse_container_labels_traefik_entrypoints }}"
matrix_bot_draupnir_container_labels_traefik_tls : "{{ matrix_bot_draupnir_container_labels_traefik_entrypoints != 'web' }}"
matrix_bot_draupnir_container_labels_traefik_tls_certResolver : "{{ matrix_synapse_container_labels_traefik_tls_certResolver }}" # noqa var-naming
# matrix_bot_draupnir_container_labels_traefik_labels_additional_labels contains a multiline string with additional labels to add to the container label file.
# See `../templates/labels.j2` for details.
#
# Example:
# matrix_bot_draupnir_container_labels_traefik_labels_additional_labels: |
# my.label=1
# another.label="here"
matrix_bot_draupnir_container_labels_traefik_labels_additional_labels : ''