2022-06-23 21:57:52 +02:00
---
2022-07-20 10:07:03 +03:00
# maubot is a plugin-based Matrix bot system.
# Project source code URL: https://mau.dev/maubot/maubot
2022-06-23 21:57:52 +02:00
matrix_bot_maubot_enabled : true
2024-01-07 10:16:42 +02:00
2024-06-19 13:58:10 +02:00
matrix_bot_maubot_login : bot.maubot
2024-06-22 14:43:04 +03:00
2024-06-19 13:58:10 +02:00
# This is just initial password and it will not manage subsequent password changes.
# Use a tool like synapse-admin if you need to change it.
2024-06-22 14:43:04 +03:00
matrix_bot_maubot_initial_password : ''
2024-06-19 13:58:10 +02:00
2024-01-07 10:16:42 +02:00
matrix_bot_maubot_scheme : https
matrix_bot_maubot_hostname : ''
matrix_bot_maubot_path_prefix : /_matrix/maubot
2022-06-23 21:57:52 +02:00
matrix_bot_maubot_container_image_self_build : false
matrix_bot_maubot_docker_repo : "https://mau.dev/maubot/maubot.git"
2022-07-20 08:55:10 +02:00
matrix_bot_maubot_docker_repo_version : "{{ 'master' if matrix_bot_maubot_version == 'latest' else matrix_bot_maubot_version }}"
2023-10-06 14:14:03 +02:00
# renovate: datasource=docker depName=dock.mau.dev/maubot/maubot
2024-08-24 09:37:56 +00:00
matrix_bot_maubot_version : v0.5.0
2023-01-14 15:26:58 +02:00
matrix_bot_maubot_docker_image : "{{ matrix_bot_maubot_docker_image_name_prefix }}maubot/maubot:{{ matrix_bot_maubot_version }}"
matrix_bot_maubot_docker_image_name_prefix : "{{ 'localhost/' if matrix_bot_maubot_container_image_self_build else 'dock.mau.dev/' }}"
2022-06-23 21:57:52 +02:00
matrix_bot_maubot_docker_image_force_pull : "{{ matrix_bot_maubot_docker_image.endswith(':latest') }}"
2024-12-28 10:24:34 +02:00
# matrix_bot_maubot_docker_image_customized is the name of the locally built maubot image
# which adds various customizations on top of the original (upstream) maubot image.
# This image will be based on the upstream `matrix_bot_maubot_docker_image` image, only if `matrix_bot_maubot_container_image_customizations_enabled: true`.
matrix_bot_maubot_docker_image_customized : "localhost/maubot/maubot:{{ matrix_bot_maubot_version }}-customized"
# Controls whether the customized image (`matrix_bot_maubot_docker_image_customized`) is to be force-built without layer caching enabled.
matrix_bot_maubot_docker_image_customized_build_nocache : false
# Controls whether the customized image (`matrix_bot_maubot_docker_image_customized`) is to be built, even if it already exists.
# Related to: matrix_bot_maubot_docker_image_customized_build_nocache
matrix_bot_maubot_docker_image_customized_force_source : "{{ matrix_bot_maubot_docker_image_customized_build_nocache }}"
# matrix_bot_maubot_docker_image_final holds the name of the maubot image to run depending on whether or not customizations are enabled.
matrix_bot_maubot_docker_image_final : "{{ matrix_bot_maubot_docker_image_customized if matrix_bot_maubot_container_image_customizations_enabled else matrix_bot_maubot_docker_image }} "
2022-06-23 21:57:52 +02:00
matrix_bot_maubot_base_path : "{{ matrix_base_data_path }}/maubot"
matrix_bot_maubot_data_path : "{{ matrix_bot_maubot_base_path }}/data"
2022-06-24 11:50:52 +02:00
matrix_bot_maubot_config_path : "{{ matrix_bot_maubot_base_path }}/config"
2024-12-28 10:24:34 +02:00
matrix_bot_maubot_docker_src_files_path : "{{ matrix_bot_maubot_base_path }}/docker-src"
matrix_bot_maubot_customized_docker_src_files_path : "{{ matrix_bot_maubot_base_path }}/customized-docker-src"
2022-06-23 21:57:52 +02:00
2024-01-07 10:16:42 +02:00
matrix_bot_maubot_bot_server_public_url : "{{ matrix_bot_maubot_scheme }}://{{ matrix_bot_maubot_hostname }}"
matrix_bot_maubot_bot_server_base_path : "{{ matrix_bot_maubot_path_prefix }}/v1"
matrix_bot_maubot_bot_server_ui_base_path : "{{ matrix_bot_maubot_path_prefix }}"
matrix_bot_maubot_bot_server_plugin_base_path : "{{ matrix_bot_maubot_path_prefix }}/plugin/"
matrix_bot_maubot_bot_server_appservice_base_path : "{{ matrix_bot_maubot_bot_server_base_path }}"
2022-07-20 11:23:32 +02:00
matrix_bot_maubot_proxy_management_interface : true
2022-06-23 21:57:52 +02:00
2022-07-09 11:55:49 +02:00
matrix_bot_maubot_database_engine : sqlite
matrix_bot_maubot_sqlite_database_path_local : "{{ matrix_bot_maubot_data_path }}/maubot.db"
matrix_bot_maubot_sqlite_database_path_in_container : "/data/maubot.db"
matrix_bot_maubot_database_username : matrix_bot_maubot
matrix_bot_maubot_database_password : ~
2022-11-27 08:23:43 +02:00
matrix_bot_maubot_database_hostname : ''
2022-07-09 11:55:49 +02:00
matrix_bot_maubot_database_port : 5432
matrix_bot_maubot_database_name : matrix_bot_maubot
2023-08-22 19:38:11 +03:00
matrix_bot_maubot_database_sslmode : disable
2022-07-10 09:51:27 +02:00
2023-08-22 19:38:11 +03:00
matrix_bot_maubot_database_connection_string : postgres://{{ matrix_bot_maubot_database_username }}:{{ matrix_bot_maubot_database_password }}@{{ matrix_bot_maubot_database_hostname }}:{{ matrix_bot_maubot_database_port }}/{{ matrix_bot_maubot_database_name }}?sslmode={{ matrix_bot_maubot_database_sslmode }}
2022-07-10 09:51:27 +02:00
matrix_bot_maubot_database_uri : "{{
{
'sqlite' : ('sqlite:///' + matrix_bot_maubot_sqlite_database_path_in_container),
'postgres' : matrix_bot_maubot_database_connection_string,
}[ matrix_bot_maubot_database_engine]
}}"
2022-07-09 11:55:49 +02:00
2022-07-10 13:33:29 +02:00
# Defines the port number where the management interface is
2024-01-07 10:16:42 +02:00
# To actually expose the management interface outside of the container, use `matrix_bot_maubot_container_management_interface_http_bind_port`
matrix_bot_maubot_server_port : 29316
matrix_bot_maubot_unshared_secret : 'generate'
2024-01-13 18:04:21 +02:00
matrix_bot_maubot_homeserver_name : "{{ matrix_domain }}"
matrix_bot_maubot_homeserver_url : ""
matrix_bot_maubot_homeserver_secret : ""
2024-01-13 18:00:19 +02:00
matrix_bot_maubot_admins : [ ]
2024-01-07 10:16:42 +02:00
# Specifies the default log level for all bot loggers.
matrix_bot_maubot_logging_level : WARNING
2022-07-10 13:33:29 +02:00
# Controls whether the maubot container exposes its HTTP management interface port (tcp/29316 in the container).
#
# Takes an "<ip>:<port>" or "<port>" value (e.g. "127.0.0.1:29316"), or empty string to not expose.
2024-01-07 10:16:42 +02:00
# If you'll be setting this at all, it should be defined in terms of `matrix_bot_maubot_server_port`.
2022-07-10 13:33:29 +02:00
# Example:
2024-01-07 10:16:42 +02:00
# matrix_bot_maubot_container_management_interface_http_bind_port: "127.0.0.1:{{ matrix_bot_maubot_server_port }}"
matrix_bot_maubot_container_management_interface_http_bind_port : ''
2022-07-10 13:33:29 +02:00
2024-01-07 10:16:42 +02:00
matrix_bot_maubot_container_network : ""
2022-07-10 13:33:29 +02:00
2024-01-07 10:16:42 +02:00
matrix_bot_maubot_container_additional_networks : "{{ matrix_bot_maubot_container_additional_networks_auto + matrix_bot_maubot_container_additional_networks_custom }}"
matrix_bot_maubot_container_additional_networks_auto : [ ]
matrix_bot_maubot_container_additional_networks_custom : [ ]
2022-06-23 21:57:52 +02:00
2024-12-28 10:24:34 +02:00
# matrix_bot_maubot_container_image_customizations_enabled controls whether a customized maubot image will be built.
#
# We toggle this variable to `true` when certain features which require a custom build are enabled.
# Feel free to toggle this to `true` yourself and specify build steps in `matrix_bot_maubot_container_image_customizations_dockerfile_body_custom`.
#
# See:
# - `roles/custom/matrix-bot-maubot/templates/maubot/customizations/Dockerfile.j2`
# - `matrix_bot_maubot_container_image_customizations_dockerfile_body_custom`
# - `matrix_bot_maubot_docker_image_customized`
# - `matrix_bot_maubot_docker_image_final`
matrix_bot_maubot_container_image_customizations_enabled : false
# matrix_bot_maubot_container_image_customizations_dockerfile_body contains your custom Dockerfile steps
# for building your customized maubot image based on the original (upstream) image (`matrix_bot_maubot_docker_image`).
# A `FROM …` clause is included automatically so you don't have to.
#
# Example:
# matrix_bot_maubot_container_image_customizations_dockerfile_body_custom: |
# RUN echo 'This is a custom step for building the customized container image for maubot.'
# RUN echo 'You can override matrix_bot_maubot_container_image_customizations_dockerfile_body_custom to add your own steps.'
# RUN echo 'You do NOT need to include a FROM clause yourself.'
matrix_bot_maubot_container_image_customizations_dockerfile_body_custom : ''
2024-01-07 10:16:42 +02:00
# matrix_bot_maubot_container_labels_traefik_enabled controls whether labels to assist a Traefik reverse-proxy will be attached to the container.
# See `../templates/labels.j2` for details.
#
# To inject your own other container labels, see `matrix_bot_maubot_container_labels_additional_labels`.
matrix_bot_maubot_container_labels_traefik_enabled : true
matrix_bot_maubot_container_labels_traefik_docker_network : "{{ matrix_bot_maubot_container_network }}"
matrix_bot_maubot_container_labels_traefik_entrypoints : web-secure
matrix_bot_maubot_container_labels_traefik_tls_certResolver : default # noqa var-naming
# Controls whether labels will be added that expose maubot's management endpoints
matrix_bot_maubot_container_labels_management_enabled : true
matrix_bot_maubot_container_labels_management_hostname : "{{ matrix_bot_maubot_hostname }}"
matrix_bot_maubot_container_labels_management_prefix : "{{ matrix_bot_maubot_path_prefix }}"
matrix_bot_maubot_container_labels_management_traefik_rule : "Host(`{{ matrix_bot_maubot_container_labels_management_hostname }}`) && PathPrefix(`{{ matrix_bot_maubot_path_prefix }}`)"
matrix_bot_maubot_container_labels_management_traefik_priority : 0
matrix_bot_maubot_container_labels_management_traefik_entrypoints : "{{ matrix_bot_maubot_container_labels_traefik_entrypoints }}"
matrix_bot_maubot_container_labels_management_traefik_tls : "{{ matrix_bot_maubot_container_labels_management_traefik_entrypoints != 'web' }}"
matrix_bot_maubot_container_labels_management_traefik_tls_certResolver : "{{ matrix_bot_maubot_container_labels_traefik_tls_certResolver }}" # noqa var-naming
# matrix_bot_maubot_container_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_maubot_container_labels_additional_labels: |
# my.label=1
# another.label="here"
matrix_bot_maubot_container_labels_additional_labels : ''
2022-07-20 13:03:50 +03:00
2022-06-23 21:57:52 +02:00
# A list of extra arguments to pass to the container
matrix_bot_maubot_container_extra_arguments : [ ]
2022-06-24 13:15:34 +02:00
# List of systemd services that matrix-bot-maubot.service depends on
2024-01-07 10:16:42 +02:00
matrix_bot_maubot_systemd_required_services_list : "{{ matrix_bot_maubot_systemd_required_services_list_default + matrix_bot_maubot_systemd_required_services_list_auto + matrix_bot_maubot_systemd_required_services_list_custom }}"
2024-06-04 13:14:34 +03:00
matrix_bot_maubot_systemd_required_services_list_default : "{{ [devture_systemd_docker_base_docker_service_name] if devture_systemd_docker_base_docker_service_name else [] }}"
2024-01-07 10:16:42 +02:00
matrix_bot_maubot_systemd_required_services_list_auto : [ ]
matrix_bot_maubot_systemd_required_services_list_custom : [ ]
2022-06-23 21:57:52 +02:00
2022-06-24 13:15:34 +02:00
# List of systemd services that matrix-bot-maubot.service wants
2022-06-23 21:57:52 +02:00
matrix_bot_maubot_systemd_wanted_services_list : [ ]