overmind
/
matrix-docker-ansible-deploy
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Fork 0
Code Issues 0 Releases 0 Wiki Activity
Matrix Docker Ansible eploy
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
10883 Commits
13 Branches
36 MiB
 
 
Tree: e5b48f22db
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'e5b48f22db'
${ noResults }
matrix-docker-ansible-deploy/roles/custom/matrix_playbook_migration/tasks/validate_config.yml

846 lines
61 KiB
Raw Blame History 

  1. # SPDX-FileCopyrightText: 2022-2025 Slavi Pantaleev

  2. # SPDX-FileCopyrightText: 2024, 2025 MDAD project contributors

  3. # SPDX-FileCopyrightText: 2024-2026 Suguru Hirahara

  4. #

  5. # SPDX-License-Identifier: AGPL-3.0-or-later

  6. 

  7. ---

  8. 

  9. - name: (Deprecation) Catch and report renamed Matrix playbook settings

  10.   ansible.builtin.fail:

  11.     msg: >-

  12.       Your configuration contains a variable, which now has a different name.

  13.       Please rename the variable (`{{ item.old }}` -> `{{ item.new }}`) on your configuration file (vars.yml).

  14.   when: "lookup('ansible.builtin.varnames', ('^' + item.old + '$'), wantlist=True) | length > 0"

  15.   with_items:

  16.     - {'old': 'matrix_vars_yml_snapshotting_enabled', 'new': 'devture_playbook_state_preserver_vars_preservation_enabled'}

  17.     - {'old': 'matrix_vars_yml_snapshotting_src', 'new': 'devture_playbook_state_preserver_vars_preservation_src'}

  18.     - {'old': 'matrix_playbook_commit_hash_preservation_enabled', 'new': 'devture_playbook_state_preserver_commit_hash_preservation_enabled'}

  19. 

  20.     - {'old': 'matrix_ntpd_package', 'new': 'devture_timesync_ntpd_package'}

  21.     - {'old': 'matrix_ntpd_service', 'new': 'devture_timesync_ntpd_service'}

  22. 

  23.     - {'old': 'matrix_systemd_unit_home_path', 'new': 'devture_systemd_docker_base_systemd_unit_home_path'}

  24.     - {'old': 'matrix_systemd_path', 'new': 'devture_systemd_docker_base_systemd_path'}

  25.     - {'old': 'matrix_host_command_docker', 'new': 'devture_systemd_docker_base_host_command_docker'}

  26.     - {'old': 'matrix_host_command_sh', 'new': 'devture_systemd_docker_base_host_command_sh'}

  27.     - {'old': 'matrix_host_command_systemctl', 'new': 'devture_systemd_docker_base_host_command_systemctl'}

  28. 

  29.     - {'old': 'matrix_container_retries_count', 'new': 'devture_playbook_help_container_retries_count'}

  30.     - {'old': 'matrix_container_retries_delay', 'new': 'devture_playbook_help_container_retries_delay'}

  31.     - {'old': 'matrix_geturl_retries_count', 'new': 'devture_playbook_help_geturl_retries_count'}

  32.     - {'old': 'matrix_geturl_retries_delay', 'new': 'devture_playbook_help_geturl_retries_delay'}

  33. 

  34.     - {'old': 'matrix_nginx_proxy_synapse_cache_path', 'new': 'matrix_synapse_reverse_proxy_companion_synapse_cache_path'}

  35.     - {'old': 'matrix_nginx_proxy_synapse_cache_enabled', 'new': 'matrix_synapse_reverse_proxy_companion_synapse_cache_enabled'}

  36. 

  37.     - {'old': 'matrix_docker_installation_enabled', 'new': 'matrix_playbook_docker_installation_enabled'}

  38.     - {'old': 'matrix_docker_package_name', 'new': '<Not applicable. Docker is installed using https://github.com/geerlingguy/ansible-role-docker now>'}

  39. 

  40.     - {'old': 'matrix_systemd_services_list', 'new': 'devture_systemd_service_manager_services_list_additional'}

  41.     - {'old': 'matrix_common_after_systemd_service_start_wait_for_timeout_seconds', 'new': 'devture_systemd_service_manager_up_verification_delay_seconds'}

  42.     - {'old': 'matrix_systemd_services_autostart_enabled', 'new': 'devture_systemd_service_manager_services_autostart_enabled'}

  43.     - {'old': 'matrix_prometheus_node_exporter_metrics_proxying_enabled', 'new': '<prometheus_node_exporter_container_labels_traefik_enabled or matrix_metrics_exposure_enabled>'}

  44.     - {'old': 'matrix_prometheus_postgres_exporter_metrics_proxying_enabled', 'new': '<prometheus_postgres_exporter_container_labels_traefik_enabled or matrix_metrics_exposure_enabled>'}

  45.     - {'old': 'matrix_playbook_traefik_certs_dumper_role_enabled', 'new': 'traefik_certs_dumper_enabled'}

  46.     - {'old': 'matrix_playbook_traefik_role_enabled', 'new': 'traefik_enabled'}

  47. 

  48.     # Most important variables from the old Prometheus role here, for people who miss the changelog entry

  49.     - {'old': 'matrix_prometheus_enabled', 'new': 'prometheus_enabled'}

  50.     - {'old': 'matrix_prometheus_process_default_arguments', 'new': 'prometheus_process_default_arguments'}

  51.     - {'old': 'matrix_prometheus_process_extra_arguments', 'new': 'prometheus_process_extra_arguments'}

  52.     - {'old': 'matrix_prometheus_configuration_extension_yaml', 'new': 'prometheus_configuration_extension_yaml'}

  53.     - {'old': 'matrix_prometheus_scraper_synapse_enabled', 'new': 'matrix_prometheus_services_connect_synapse_enabled'}

  54.     - {'old': 'matrix_prometheus_scraper_synapse_targets', 'new': '<superseded by matrix_prometheus_services_connect_scraper_synapse_main_process_static_configs_target>'}

  55.     - {'old': 'matrix_prometheus_scraper_synapse_workers_enabled_list', 'new': 'matrix_prometheus_services_connect_scraper_synapse_workers_enabled_list'}

  56.     - {'old': 'matrix_prometheus_scraper_synapse_rules_synapse_tag', 'new': 'matrix_prometheus_services_connect_synapse_rules_download_synapse_tag'}

  57.     - {'old': 'matrix_prometheus_scraper_node_enabled', 'new': 'prometheus_self_node_scraper_enabled'}

  58.     - {'old': 'matrix_prometheus_scraper_node_targets', 'new': '<superseded by prometheus_self_node_scraper_static_configs_target>'}

  59.     - {'old': 'matrix_prometheus_scraper_postgres_enabled', 'new': 'matrix_prometheus_services_connect_scraper_postgres_enabled'}

  60.     - {'old': 'matrix_prometheus_scraper_postgres_targets', 'new': '<superseded by matrix_prometheus_services_connect_scraper_postgres_static_configs_target>'}

  61.     - {'old': 'matrix_prometheus_scraper_hookshot_enabled', 'new': 'matrix_prometheus_services_connect_scraper_hookshot_enabled'}

  62.     - {'old': 'matrix_prometheus_scraper_hookshot_targets', 'new': '<superseded by matrix_prometheus_services_connect_scraper_hookshot_static_configs_target>'}

  63.     - {'old': 'matrix_prometheus_scraper_nginxlog_enabled', 'new': 'matrix_prometheus_services_connect_scraper_nginxlog_enabled'}

  64.     - {'old': 'matrix_prometheus_scraper_nginxlog_server_port', 'new': 'matrix_prometheus_services_connect_scraper_nginxlog_static_configs_target'}

  65. 

  66.     - {'old': 'matrix_prosody_jitsi_max_participants', 'new': 'jitsi_prosody_max_participants'}

  67.     - {'old': 'jitsi_require_well_known', 'new': 'jitsi_web_well_known_element_jitsi_enabled'}

  68.     - {'old': 'jitsi_wellknown_element_jitsi_json', 'new': 'jitsi_web_well_known_element_jitsi_json'}

  69.     - {'old': 'exim_relay_docker_image', 'new': 'exim_relay_container_image'}

  70.     - {'old': 'exim_relay_docker_image_name_prefix', 'new': 'exim_relay_container_image_name_prefix'}

  71.     - {'old': 'exim_relay_docker_image_force_pull', 'new': 'exim_relay_container_image_force_pull'}

  72. 

  73.     - {'old': 'matrix_playbook_reverse_proxy_traefik_middleware_compession_enabled', 'new': 'matrix_playbook_reverse_proxy_traefik_middleware_compression_enabled'}

  74.     - {'old': 'matrix_playbook_reverse_proxy_traefik_middleware_compession_name', 'new': 'matrix_playbook_reverse_proxy_traefik_middleware_compression_name'}

  75. 

  76.     - {'old': 'matrix_synapse_account_threepid_delegates_msisdn_mas1sd_url', 'new': '<removed>'}

  77. 

  78.     - {'old': 'cinny_docker_image', 'new': 'cinny_container_image'}

  79.     - {'old': 'cinny_docker_image_registry_prefix', 'new': 'cinny_container_image_registry_prefix'}

  80.     - {'old': 'cinny_docker_image_registry_prefix_upstream', 'new': 'cinny_container_image_registry_prefix_upstream'}

  81.     - {'old': 'cinny_docker_image_registry_prefix_upstream_default', 'new': 'cinny_container_image_registry_prefix_upstream_default'}

  82. 

  83.     - {'old': 'coturn_docker_image', 'new': 'coturn_container_image'}

  84.     - {'old': 'coturn_docker_image_registry_prefix', 'new': 'coturn_container_image_registry_prefix'}

  85.     - {'old': 'coturn_docker_image_registry_prefix_upstream', 'new': 'coturn_container_image_registry_prefix_upstream'}

  86.     - {'old': 'coturn_docker_image_registry_prefix_upstream_default', 'new': 'coturn_container_image_registry_prefix_upstream_default'}

  87. 

  88.     - {'old': 'ddclient_docker_image', 'new': 'ddclient_container_image'}

  89.     - {'old': 'ddclient_docker_image_registry_prefix', 'new': 'ddclient_container_image_registry_prefix'}

  90.     - {'old': 'ddclient_docker_image_registry_prefix_upstream', 'new': 'ddclient_container_image_registry_prefix_upstream'}

  91.     - {'old': 'ddclient_docker_image_registry_prefix_upstream_default', 'new': 'ddclient_container_image_registry_prefix_upstream_default'}

  92. 

  93.     - {'old': 'hydrogen_docker_image', 'new': 'hydrogen_container_image'}

  94.     - {'old': 'hydrogen_docker_image_registry_prefix', 'new': 'hydrogen_container_image_registry_prefix'}

  95.     - {'old': 'hydrogen_docker_image_registry_prefix_upstream', 'new': 'hydrogen_container_image_registry_prefix_upstream'}

  96.     - {'old': 'hydrogen_docker_image_registry_prefix_upstream_default', 'new': 'hydrogen_container_image_registry_prefix_upstream_default'}

  97. 

  98.     - {'old': 'prometheus_nginxlog_exporter_docker_image', 'new': 'prometheus_nginxlog_exporter_container_image'}

  99.     - {'old': 'prometheus_nginxlog_exporter_docker_image_registry_prefix', 'new': 'prometheus_nginxlog_exporter_container_image_registry_prefix'}

  100.     - {'old': 'prometheus_nginxlog_exporter_docker_image_registry_prefix_upstream', 'new': 'prometheus_nginxlog_exporter_container_image_registry_prefix_upstream'}

  101.     - {'old': 'prometheus_nginxlog_exporter_docker_image_registry_prefix_upstream_default', 'new': 'prometheus_nginxlog_exporter_container_image_registry_prefix_upstream_default'}

  102.     - {'old': 'prometheus_nginxlog_exporter_docker_image_arch_check_enabled', 'new': 'prometheus_nginxlog_exporter_container_image_arch_check_enabled'}

  103.     - {'old': 'prometheus_nginxlog_exporter_metrics_proxying_enabled', 'new': 'prometheus_nginxlog_exporter_container_labels_traefik_enabled'}

  104.     - {'old': 'prometheus_nginxlog_exporter_metrics_proxying_hostname', 'new': 'prometheus_nginxlog_exporter_container_labels_traefik_hostname'}

  105.     - {'old': 'prometheus_nginxlog_exporter_metrics_proxying_path_prefix', 'new': 'prometheus_nginxlog_exporter_container_labels_traefik_path_prefix'}

  106.     - {'old': 'prometheus_nginxlog_exporter_config_namespaces_matrix_source_tags_custom', 'new': 'prometheus_nginxlog_exporter_config_namespaces_source_tags_custom'}

  107. 

  108. - name: (Deprecation) Catch and report matrix_postgres variables

  109.   ansible.builtin.fail:

  110.     msg: |-

  111.       The matrix-postgres role in the playbook has been replaced with the ansible-role-postgres role (https://github.com/mother-of-all-self-hosting/ansible-role-postgres).

  112.       The new role is pretty much the same, but uses differently named variables.

  113. 

  114.       The matrix-postgres-backup role in the playbook has been replaced with the ansible-role-postgres-backup role (https://github.com/mother-of-all-self-hosting/ansible-role-postgres-backup).

  115.       The new role is pretty much the same, but uses differently named variables.

  116. 

  117.       Please rename all `matrix_postgres`-prefixed variables (`matrix_postgres_*` -> `postgres_*`) on your configuration file (vars.yml).

  118. 

  119.       After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  120. 

  121.       The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^matrix_postgres_.+', wantlist=True) | join(', ') }}

  122.   when: "lookup('ansible.builtin.varnames', '^matrix_postgres_.+', wantlist=True) | length > 0"

  123. 

  124. - name: (Deprecation) Catch and report matrix_mailer_ variables

  125.   ansible.builtin.fail:

  126.     msg: |-

  127.       The matrix-mailer role in the playbook has been replaced with the exim-relay role (https://github.com/mother-of-all-self-hosting/ansible-role-exim-relay).

  128.       The new role is pretty much the same, but uses differently named variables.

  129. 

  130.       Please rename all `matrix_mailer`-prefixed variables (`matrix_mailer_*` -> `exim_relay_*`) on your configuration file (vars.yml).

  131. 

  132.       After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  133. 

  134.       The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^matrix_mailer_.+', wantlist=True) | join(', ') }}

  135.   when: "lookup('ansible.builtin.varnames', '^matrix_mailer_.+', wantlist=True) | length > 0"

  136. 

  137. - when: matrix_playbook_migration_matrix_prometheus_nginxlog_exporter_migration_validation_enabled | bool

  138.   block:

  139.     - ansible.builtin.set_fact:

  140.         matrix_playbook_migration_matrix_prometheus_nginxlog_exporter_migration_vars: |-

  141.           {{ lookup('ansible.builtin.varnames', '^matrix_prometheus_nginxlog_exporter_.+', wantlist=True) }}

  142. 

  143.     - name: (Deprecation) Catch and report matrix_prometheus_nginxlog_exporter variables

  144.       ansible.builtin.fail:

  145.         msg: >-

  146.           The matrix-prometheus-nginxlog-exporter role that used to be part of this playbook has been replaced by https://github.com/mother-of-all-self-hosting/ansible-role-prometheus-nginxlog-exporter.

  147.           The new role is compatible with the old one, but uses different names for its variables.

  148. 

  149.           Please rename all variables (`matrix_prometheus_nginxlog_exporter_` -> `prometheus_nginxlog_exporter_`) on your configuration file (vars.yml).

  150. 

  151.           After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  152. 

  153.           The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_matrix_prometheus_nginxlog_exporter_migration_vars | join(', ') }}

  154.       when: "matrix_playbook_migration_matrix_prometheus_nginxlog_exporter_migration_vars | length > 0"

  155. 

  156. - when: matrix_playbook_migration_matrix_prometheus_node_exporter_migration_validation_enabled | bool

  157.   block:

  158.     - ansible.builtin.set_fact:

  159.         matrix_playbook_migration_matrix_prometheus_node_exporter_migration_vars: |-

  160.           {{ lookup('ansible.builtin.varnames', '^matrix_prometheus_node_exporter_.+', wantlist=True) }}

  161. 

  162.     - name: (Deprecation) Catch and report matrix_prometheus_node_exporter variables

  163.       ansible.builtin.fail:

  164.         msg: >-

  165.           The matrix-prometheus-node-exporter role that used to be part of this playbook has been replaced by https://github.com/mother-of-all-self-hosting/ansible-role-prometheus-node-exporter.

  166.           The new role is compatible with the old one, but uses different names for its variables.

  167. 

  168.           Please rename all variables (`matrix_prometheus_node_exporter_` -> `prometheus_node_exporter_`) on your configuration file (vars.yml).

  169. 

  170.           After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  171. 

  172.           The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_matrix_prometheus_node_exporter_migration_vars | join(', ') }}

  173.       when: "matrix_playbook_migration_matrix_prometheus_node_exporter_migration_vars | length > 0"

  174. 

  175. - when: matrix_playbook_migration_matrix_prometheus_postgres_exporter_migration_validation_enabled | bool

  176.   block:

  177.     - ansible.builtin.set_fact:

  178.         matrix_playbook_migration_matrix_prometheus_postgres_exporter_migration_vars: |-

  179.           {{ lookup('ansible.builtin.varnames', '^matrix_prometheus_postgres_exporter_.+', wantlist=True) }}

  180. 

  181.     - name: (Deprecation) Catch and report matrix_prometheus_postgres_exporter variables

  182.       ansible.builtin.fail:

  183.         msg: >-

  184.           The matrix-prometheus-postgres-exporter role that used to be part of this playbook has been replaced by https://github.com/mother-of-all-self-hosting/ansible-role-prometheus-postgres-exporter.

  185.           The new role is compatible with the old one, but uses different names for its variables.

  186. 

  187.           Please rename all variables (`matrix_prometheus_postgres_exporter_` -> `prometheus_postgres_exporter_`) on your configuration file (vars.yml).

  188. 

  189.           After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  190. 

  191.           The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_matrix_prometheus_postgres_exporter_migration_vars.keys() | join(', ') }}

  192.       when: "matrix_playbook_migration_matrix_prometheus_postgres_exporter_migration_vars | length > 0"

  193. 

  194. - when: matrix_playbook_migration_matrix_backup_borg_migration_validation_enabled | bool

  195.   block:

  196.     - ansible.builtin.set_fact:

  197.         matrix_playbook_migration_backup_borg_migration_vars: |-

  198.           {{ lookup('ansible.builtin.varnames', '^matrix_backup_borg_.+', wantlist=True) }}

  199. 

  200.     - name: (Deprecation) Catch and report matrix_backup_borg variables

  201.       ansible.builtin.fail:

  202.         msg: >-

  203.           The matrix-backup-borg role that used to be part of this playbook has been replaced by https://github.com/mother-of-all-self-hosting/ansible-role-backup_borg.

  204.           The new role is compatible with the old one, but uses different names for its variables.

  205. 

  206.           Please rename all variables (`matrix_backup_borg_` -> `backup_borg_`) on your configuration file (vars.yml).

  207. 

  208.           After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  209. 

  210.           The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_backup_borg_migration_vars.keys() | join(', ') }}

  211.       when: "matrix_playbook_migration_backup_borg_migration_vars | length > 0"

  212. 

  213. - when: matrix_playbook_migration_matrix_grafana_migration_validation_enabled | bool

  214.   block:

  215.     - ansible.builtin.set_fact:

  216.         matrix_playbook_migration_grafana_migration_vars: |-

  217.           {{ lookup('ansible.builtin.varnames', '^matrix_grafana_.+', wantlist=True) }}

  218. 

  219.     - name: (Deprecation) Catch and report matrix_grafana variables

  220.       ansible.builtin.fail:

  221.         msg: >-

  222.           The matrix-grafana role that used to be part of this playbook has been replaced by https://github.com/mother-of-all-self-hosting/ansible-role-grafana.

  223.           The new role is compatible with the old one, but uses different names for its variables.

  224. 

  225.           Please rename all variables (`matrix_grafana_` -> `grafana_`) on your configuration file (vars.yml).

  226. 

  227.           After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  228. 

  229.           The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_grafana_migration_vars.keys() | join(', ') }}

  230.       when: "matrix_playbook_migration_grafana_migration_vars | length > 0"

  231. 

  232. - when: matrix_playbook_migration_matrix_ntfy_migration_validation_enabled | bool

  233.   block:

  234.     - ansible.builtin.set_fact:

  235.         matrix_playbook_migration_ntfy_migration_vars: |-

  236.           {{ lookup('ansible.builtin.varnames', '^matrix_ntfy_.+', wantlist=True) }}

  237. 

  238.     - name: (Deprecation) Catch and report matrix_ntfy variables

  239.       ansible.builtin.fail:

  240.         msg: >-

  241.           The matrix-ntfy role that used to be part of this playbook has been replaced by https://github.com/mother-of-all-self-hosting/ansible-role-ntfy.

  242.           The new role is compatible with the old one, but uses different names for its variables.

  243. 

  244.           Please rename all variables (`matrix_ntfy_` -> `ntfy_`) on your configuration file (vars.yml).

  245. 

  246.           After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  247. 

  248.           The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_ntfy_migration_vars.keys() | join(', ') }}

  249.       when: "matrix_playbook_migration_ntfy_migration_vars | length > 0"

  250. 

  251. - when: matrix_playbook_migration_matrix_redis_migration_validation_enabled | bool

  252.   block:

  253.     - ansible.builtin.set_fact:

  254.         matrix_playbook_migration_redis_migration_vars: |-

  255.           {{ lookup('ansible.builtin.varnames', '^matrix_redis_.+', wantlist=True) }}

  256. 

  257.     - name: (Deprecation) Catch and report matrix_redis variables

  258.       ansible.builtin.fail:

  259.         msg: >-

  260.           The matrix-redis role that used to be part of this playbook has been replaced by https://github.com/mother-of-all-self-hosting/ansible-role-redis.

  261.           The new role is compatible with the old one, but uses different names for its variables.

  262. 

  263.           Please rename all variables (`matrix_redis_` -> `redis_`) on your configuration file (vars.yml).

  264. 

  265.           After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  266. 

  267.           The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_redis_migration_vars.keys() | join(', ') }}

  268.       when: "matrix_playbook_migration_redis_migration_vars | length > 0"

  269. 

  270. - when: matrix_playbook_migration_redis_valkey_migration_validation_enabled | bool

  271.   block:

  272.     - ansible.builtin.set_fact:

  273.         matrix_playbook_migration_redis_migration_vars: |-

  274.           {{ lookup('ansible.builtin.varnames', '^redis_.+', wantlist=True) }}

  275. 

  276.     - name: (Deprecation) Catch and report matrix_redis variables

  277.       ansible.builtin.fail:

  278.         msg: >-

  279.           The Redis role that used to be part of this playbook has been superseded by https://github.com/mother-of-all-self-hosting/ansible-role-valkey.

  280. 

  281.           Please rename all variables (`redis_` -> `valkey_`) on your configuration file (vars.yml).

  282. 

  283.           After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  284. 

  285.           The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_redis_migration_vars.keys() | join(', ') }}

  286.       when: "matrix_playbook_migration_redis_migration_vars | length > 0"

  287. 

  288. - when: matrix_playbook_migration_keydb_valkey_migration_validation_enabled | bool

  289.   block:

  290.     - ansible.builtin.set_fact:

  291.         matrix_playbook_migration_keydb_migration_vars: |-

  292.           {{ lookup('ansible.builtin.varnames', '^keydb_.+', wantlist=True) }}

  293. 

  294.     - name: (Deprecation) Catch and report matrix_redis variables

  295.       ansible.builtin.fail:

  296.         msg: >-

  297.           The KeyDB role that used to be part of this playbook has been superseded by https://github.com/mother-of-all-self-hosting/ansible-role-valkey.

  298. 

  299.           Please rename all variables (`keydb_` -> `valkey_`) on your configuration file (vars.yml).

  300. 

  301.           After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  302. 

  303.           The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_keydb_migration_vars.keys() | join(', ') }}

  304.       when: "matrix_playbook_migration_keydb_migration_vars | length > 0"

  305. 

  306. - when: matrix_playbook_migration_matrix_etherpad_migration_validation_enabled | bool

  307.   block:

  308.     - ansible.builtin.set_fact:

  309.         matrix_playbook_migration_etherpad_migration_vars: |-

  310.           {{ lookup('ansible.builtin.varnames', '^matrix_etherpad_.+', wantlist=True) }}

  311. 

  312.     - name: (Deprecation) Catch and report matrix_etherpad variables

  313.       ansible.builtin.fail:

  314.         msg: >-

  315.           The matrix-etherpad role that used to be part of this playbook has been replaced by https://github.com/mother-of-all-self-hosting/ansible-role-etherpad.

  316.           The new role is compatible with the old one, but uses different names for its variables.

  317. 

  318.           Please rename all variables (`matrix_etherpad_` -> `etherpad_`) on your configuration file (vars.yml).

  319. 

  320.           After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  321. 

  322.           The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_etherpad_migration_vars.keys() | join(', ') }}

  323.       when: "matrix_playbook_migration_etherpad_migration_vars | length > 0"

  324. 

  325. - when: matrix_playbook_migration_matrix_aux_migration_validation_enabled | bool

  326.   block:

  327.     - ansible.builtin.set_fact:

  328.         matrix_playbook_migration_aux_migration_vars: |-

  329.           {{ lookup('ansible.builtin.varnames', '^matrix_aux_.+', wantlist=True) }}

  330. 

  331.     - name: (Deprecation) Catch and report matrix_aux variables

  332.       ansible.builtin.fail:

  333.         msg: >-

  334.           The matrix-aux role that used to be part of this playbook has been replaced by https://github.com/mother-of-all-self-hosting/ansible-role-aux.

  335.           The new role is compatible with the old one, but uses different names for its variables.

  336. 

  337.           Please rename all variables (`matrix_aux_` -> `aux_`) on your configuration file (vars.yml).

  338. 

  339.           After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  340. 

  341.           The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_aux_migration_vars.keys() | join(', ') }}

  342.       when: "matrix_playbook_migration_aux_migration_vars | length > 0"

  343. 

  344. - when: matrix_playbook_migration_matrix_jitsi_migration_validation_enabled | bool

  345.   block:

  346.     - ansible.builtin.set_fact:

  347.         matrix_playbook_migration_jitsi_migration_vars: |-

  348.           {{ lookup('ansible.builtin.varnames', '^matrix_jitsi_.+', wantlist=True) }}

  349. 

  350.     - name: (Deprecation) Catch and report matrix_jitsi variables

  351.       ansible.builtin.fail:

  352.         msg: >-

  353.           The matrix-jitsi role that used to be part of this playbook has been replaced by https://github.com/mother-of-all-self-hosting/ansible-role-jitsi.

  354.           The new role is compatible with the old one, but uses different names for its variables.

  355. 

  356.           Please rename all variables (`matrix_jitsi_` -> `jitsi_`) on your configuration file (vars.yml).

  357. 

  358.           After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  359. 

  360.           The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_jitsi_migration_vars.keys() | join(', ') }}

  361.       when: "matrix_playbook_migration_jitsi_migration_vars | length > 0"

  362. 

  363. - when: matrix_playbook_migration_matrix_postmoogle_migration_validation_enabled | bool

  364.   block:

  365.     - ansible.builtin.set_fact:

  366.         matrix_playbook_migration_postmoogle_migration_vars: |-

  367.           {{ lookup('ansible.builtin.varnames', '^matrix_bot_postmoogle_.+', wantlist=True) }}

  368. 

  369.     - name: (Deprecation) Catch and report matrix_bot_postmoogle variables

  370.       ansible.builtin.fail:

  371.         msg: >-

  372.           Your configuration contains a variable, which now has a different name.

  373. 

  374.           Please rename all variables (`matrix_bot_postmoogle_` -> `matrix_postmoogle_`) on your configuration file (vars.yml).

  375. 

  376.           The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_postmoogle_migration_vars.keys() | join(', ') }}

  377.       when: "matrix_playbook_migration_postmoogle_migration_vars | length > 0"

  378. 

  379. - when: matrix_playbook_migration_matrix_nginx_proxy_elimination_variable_transition_checks_enabled | bool

  380.   block:

  381.     - name: (Deprecation) Catch and report transitioned playbook settings during the matrix-nginx-proxy elimination

  382.       ansible.builtin.fail:

  383.         msg: >-

  384.           Your configuration contains a variable, which now has a different name.

  385.           Please rename the variable (`{{ item.old }}` -> `{{ item.new }}`) on your configuration file (vars.yml).

  386.       when: "lookup('ansible.builtin.varnames', ('^' + item.old + '$'), wantlist=True) | length > 0"

  387.       with_items:

  388.         - {'old': 'matrix_nginx_proxy_proxy_matrix_metrics_enabled', 'new': 'matrix_metrics_exposure_enabled'}

  389.         - {'old': 'matrix_nginx_proxy_proxy_matrix_metrics_basic_auth_enabled', 'new': 'matrix_metrics_exposure_http_basic_auth_enabled'}

  390.         - {'old': 'matrix_nginx_proxy_proxy_matrix_metrics_basic_auth_username', 'new': '<superseded by matrix_metrics_exposure_http_basic_auth_users>'}

  391.         - {'old': 'matrix_nginx_proxy_proxy_matrix_metrics_basic_auth_password', 'new': '<superseded by matrix_metrics_exposure_http_basic_auth_users>'}

  392.         - {'old': 'matrix_nginx_proxy_proxy_matrix_metrics_basic_auth_raw_content', 'new': '<superseded by matrix_metrics_exposure_http_basic_auth_users>'}

  393.         - {'old': 'matrix_nginx_proxy_proxy_matrix_metrics_additional_location_configuration_blocks', 'new': '<superseded by adding labels to each individual service that you care about>'}

  394.         - {'old': 'matrix_nginx_proxy_proxy_matrix_metrics_additional_system_location_configuration_blocks', 'new': '<superseded by adding labels to each individual service that you care about>'}

  395.         - {'old': 'matrix_nginx_proxy_proxy_matrix_metrics_additional_user_location_configuration_blocks', 'new': '<superseded by adding labels to each individual service that you care about>'}

  396. 

  397.         - {'old': 'matrix_well_known_matrix_server_enabled', 'new': 'matrix_static_files_file_matrix_server_enabled'}

  398.         - {'old': 'matrix_well_known_matrix_support_enabled', 'new': 'matrix_static_files_file_matrix_support_enabled'}

  399.         - {'old': 'matrix_homeserver_admin_contacts', 'new': 'matrix_static_files_file_matrix_support_property_m_contacts'}

  400.         - {'old': 'matrix_homeserver_support_url', 'new': 'matrix_static_files_file_matrix_support_property_m_support_page'}

  401.         - {'old': 'matrix_well_known_matrix_client_io_element_e2ee_default', 'new': 'matrix_static_files_file_matrix_client_property_io_element_e2ee_default'}

  402.         - {'old': 'matrix_well_known_matrix_client_io_element_e2ee_secure_backup_required', 'new': 'matrix_static_files_file_matrix_client_property_io_element_e2ee_secure_backup_required'}

  403.         - {'old': 'matrix_well_known_matrix_client_io_element_e2ee_secure_backup_setup_methods', 'new': 'matrix_static_files_file_matrix_client_property_io_element_e2ee_secure_backup_setup_methods'}

  404.         - {'old': 'matrix_well_known_matrix_client_configuration_extension_json', 'new': 'matrix_static_files_file_matrix_client_configuration_extension_json'}

  405.         - {'old': 'matrix_well_known_matrix_server_configuration_extension_json', 'new': 'matrix_static_files_file_matrix_server_configuration_extension_json'}

  406.         - {'old': 'matrix_well_known_matrix_support_configuration_extension_json', 'new': 'matrix_static_files_file_matrix_support_configuration_extension_json'}

  407.         - {'old': 'matrix_nginx_proxy_self_check_validate_certificates', 'new': 'matrix_static_files_self_check_validate_certificates'}

  408.         - {'old': 'matrix_nginx_proxy_self_check_well_known_matrix_client_follow_redirects', 'new': 'matrix_static_files_self_check_well_known_matrix_client_follow_redirects'}

  409.         - {'old': 'matrix_nginx_proxy_base_domain_serving_enabled', 'new': 'matrix_static_files_container_labels_base_domain_enabled'}

  410.         - {'old': 'matrix_nginx_proxy_base_domain_hostname', 'new': 'matrix_static_files_container_labels_base_domain_traefik_hostname'}

  411.         - {'old': 'matrix_nginx_proxy_base_domain_homepage_enabled', 'new': 'matrix_static_files_file_index_html_enabled'}

  412.         - {'old': 'matrix_nginx_proxy_base_domain_homepage_template', 'new': 'matrix_static_files_file_index_html_template'}

  413.         - {'old': 'matrix_nginx_proxy_base_domain_create_directory', 'new': '<no longer necessary; see matrix_static_files_file_index_html_enabled>'}

  414.         - {'old': 'matrix_nginx_proxy_proxy_riot_compat_redirect_enabled', 'new': '<redirecting the Riot domain to an Element domain is no longer supported - you can implement it yourself using matrix_client_element_container_labels_additional_labels>'}

  415.         - {'old': 'matrix_nginx_proxy_proxy_riot_compat_redirect_hostname', 'new': '<redirecting the Riot domain to an Element domain is no longer supported - you can implement it yourself using matrix_client_element_container_labels_additional_labels>'}

  416.         - {'old': 'matrix_nginx_proxy_proxy_matrix_client_redirect_enabled', 'new': '<superseded by matrix_synapse_container_labels_public_client_root_redirection_enabled or other equivalent variables based on the homeserver implementation you use>'}

  417.         - {'old': 'matrix_nginx_proxy_proxy_matrix_client_redirect_root_uri_to_domain', 'new': '<superseded by matrix_synapse_container_labels_public_client_root_redirection_url or other equivalent variables based on the homeserver implementation you use>'}

  418.         - {'old': 'matrix_nginx_proxy_proxy_matrix_client_api_forwarded_location_synapse_client_api_enabled', 'new': 'matrix_synapse_container_labels_public_client_synapse_client_api_enabled'}

  419.         - {'old': 'matrix_nginx_proxy_proxy_matrix_client_api_forwarded_location_synapse_oidc_api_enabled', 'new': '<replaced by matrix_synapse_container_labels_public_client_synapse_oidc_api_enabled, but if you use matrix_synapse_oidc_enabled then it would be toggled automatically; see the new recommended OIDC example configuration in docs/configuring-playbook-synapse.md>'}

  420.         - {'old': 'matrix_nginx_proxy_proxy_matrix_client_api_forwarded_location_synapse_admin_api_enabled', 'new': 'matrix_synapse_container_labels_public_client_synapse_admin_api_enabled'}

  421.         - {'old': 'matrix_nginx_proxy_proxy_matrix_identity_api_enabled', 'new': '<removed>'}

  422.         - {'old': 'matrix_nginx_proxy_proxy_matrix_identity_api_addr_with_container', 'new': '<removed>'}

  423.         - {'old': 'matrix_nginx_proxy_proxy_matrix_identity_api_addr_sans_container', 'new': '<removed>'}

  424.         - {'old': 'matrix_nginx_proxy_proxy_matrix_user_directory_search_enabled', 'new': '<removed>'}

  425.         - {'old': 'matrix_nginx_proxy_proxy_matrix_user_directory_search_addr_with_container', 'new': '<removed>'}

  426.         - {'old': 'matrix_nginx_proxy_proxy_matrix_user_directory_search_addr_sans_container', 'new': '<removed>'}

  427.         - {'old': 'matrix_nginx_proxy_proxy_matrix_user_directory_search_v3_to_r0_redirect_enabled', 'new': '<removed>'}

  428.         - {'old': 'matrix_nginx_proxy_proxy_matrix_3pid_registration_enabled', 'new': '<removed>'}

  429.         - {'old': 'matrix_nginx_proxy_proxy_matrix_3pid_registration_addr_with_container', 'new': '<removed>'}

  430.         - {'old': 'matrix_nginx_proxy_proxy_matrix_3pid_registration_addr_sans_container', 'new': '<removed>'}

  431.         - {'old': 'matrix_nginx_proxy_proxy_matrix_3pid_registration_v3_to_r0_redirect_enabled', 'new': '<removed>'}

  432.         - {'old': 'matrix_nginx_proxy_proxy_conduit_enabled', 'new': 'matrix_conduit_container_labels_traefik_enabled'}

  433.         - {'old': 'matrix_nginx_proxy_proxy_conduit_block_federation_api_on_client_port', 'new': '<not supported anymore - the /_matrix/federation endpoints are now also being served on the Client-Server API port>'}

  434.         - {'old': 'matrix_nginx_proxy_proxy_conduit_federation_api_enabled', 'new': 'matrix_conduit_container_labels_public_federation_api_enabled'}

  435.         - {'old': 'matrix_nginx_proxy_proxy_conduit_client_api_addr_with_container', 'new': '<removed>'}

  436.         - {'old': 'matrix_nginx_proxy_proxy_conduit_client_api_addr_sans_container', 'new': '<removed>'}

  437.         - {'old': 'matrix_nginx_proxy_proxy_conduit_federation_api_addr_with_container', 'new': '<removed>'}

  438.         - {'old': 'matrix_nginx_proxy_proxy_conduit_federation_api_addr_sans_container', 'new': '<removed>'}

  439.         - {'old': 'matrix_nginx_proxy_proxy_conduit_additional_server_configuration_blocks', 'new': '<removed>'}

  440.         - {'old': 'matrix_nginx_proxy_proxy_dendrite_enabled', 'new': 'matrix_dendrite_container_labels_traefik_enabled'}

  441.         - {'old': 'matrix_nginx_proxy_proxy_dendrite_block_federation_api_on_client_port', 'new': '<not supported anymore - the /_matrix/federation endpoints are now also being served on the Client-Server API port>'}

  442.         - {'old': 'matrix_nginx_proxy_proxy_dendrite_federation_api_enabled', 'new': 'matrix_dendrite_container_labels_public_federation_api_enabled'}

  443.         - {'old': 'matrix_nginx_proxy_proxy_dendrite_client_api_addr_with_container', 'new': '<removed>'}

  444.         - {'old': 'matrix_nginx_proxy_proxy_dendrite_client_api_addr_sans_container', 'new': '<removed>'}

  445.         - {'old': 'matrix_nginx_proxy_proxy_dendrite_federation_api_addr_with_container', 'new': '<removed>'}

  446.         - {'old': 'matrix_nginx_proxy_proxy_dendrite_federation_api_addr_sans_container', 'new': '<removed>'}

  447.         - {'old': 'matrix_nginx_proxy_proxy_dendrite_additional_server_configuration_blocks', 'new': '<removed>'}

  448.         - {'old': 'matrix_nginx_proxy_proxy_synapse_enabled', 'new': 'matrix_synapse_container_labels_traefik_enabled'}

  449.         - {'old': 'matrix_nginx_proxy_proxy_synapse_federation_api_enabled', 'new': 'matrix_synapse_container_labels_public_federation_api_enabled'}

  450.         - {'old': 'matrix_nginx_proxy_proxy_synapse_client_api_addr_with_container', 'new': '<removed>'}

  451.         - {'old': 'matrix_nginx_proxy_proxy_synapse_client_api_addr_sans_container', 'new': '<removed>'}

  452.         - {'old': 'matrix_nginx_proxy_proxy_synapse_federation_api_addr_with_container', 'new': '<removed>'}

  453.         - {'old': 'matrix_nginx_proxy_proxy_synapse_federation_api_addr_sans_container', 'new': '<removed>'}

  454.         - {'old': 'matrix_nginx_proxy_proxy_synapse_additional_server_configuration_blocks', 'new': '<removed>'}

  455.         - {'old': 'matrix_nginx_proxy_proxy_matrix_additional_server_configuration_blocks', 'new': '<removed>'}

  456.         - {'old': 'matrix_nginx_proxy_access_log_enabled', 'new': 'traefik_config_accessLog_enabled'}

  457.         - {'old': 'matrix_nginx_proxy_container_labels_traefik_proxy_matrix_federation_hostname', 'new': 'matrix_server_fqn_matrix_federation'}

  458.         - {'old': 'etherpad_nginx_proxy_dimension_integration_enabled', 'new': '<removed>'}

  459.         - {'old': 'etherpad_nginx_proxy_dimension_integration_path_prefix', 'new': '<removed>'}

  460.         - {'old': 'matrix_prometheus_services_proxy_connect_prometheus_node_exporter_metrics_proxying_enabled', 'new': '<removed>'}

  461.         - {'old': 'matrix_prometheus_services_proxy_connect_prometheus_node_exporter_matrix_nginx_proxy_not_enabled_proxy_pass_host', 'new': '<removed>'}

  462.         - {'old': 'matrix_prometheus_services_proxy_connect_prometheus_postgres_exporter_metrics_proxying_enabled', 'new': '<removed>'}

  463.         - {'old': 'matrix_prometheus_services_proxy_connect_prometheus_postgres_exporter_matrix_nginx_proxy_not_enabled_proxy_pass_host', 'new': '<removed>'}

  464.         - {'old': 'matrix_docker_network', 'new': '<removed in favor of various other variables - matrix_addons_container_network, matrix_monitoring_container_network, matrix_homeserver_container_network, etc.>'}

  465.         - {'old': 'matrix_playbook_ssl_retrieval_method', 'new': '<removed; see docs/configuring-playbook-ssl-certificates.md for alternatives>'}

  466.         - {'old': 'matrix_ssl_lets_encrypt_support_email', 'new': 'traefik_config_certificatesResolvers_acme_email'}

  467.         - {'old': 'matrix_federation_traefik_entrypoint', 'new': 'matrix_federation_traefik_entrypoint_name'}

  468. 

  469. - when: matrix_playbook_migration_matrix_nginx_proxy_leftover_variable_validation_checks_enabled | bool

  470.   block:

  471.     - ansible.builtin.set_fact:

  472.         matrix_playbook_migration_nginx_proxy_migration_vars: |-

  473.           {{ lookup('ansible.builtin.varnames', '^matrix_nginx_proxy_.+', wantlist=True) }}

  474. 

  475.     - name: (Deprecation) Catch and report leftover matrix_nginx_proxy variables

  476.       ansible.builtin.fail:

  477.         msg: >-

  478.           The matrix-nginx-proxy role that used to be part of this playbook has been removed.

  479. 

  480.           You should remove all its variables (`matrix_nginx_proxy_*`) from your configuration file (vars.yml).

  481. 

  482.           The following variables in your configuration should be renamed: {{ matrix_playbook_migration_nginx_proxy_migration_vars.keys() | join(', ') }}

  483.       when: "matrix_playbook_migration_nginx_proxy_migration_vars | length > 0"

  484. 

  485. - when: matrix_playbook_migration_matrix_ssl_leftover_variable_checks_enabled | bool

  486.   block:

  487.     - ansible.builtin.set_fact:

  488.         matrix_playbook_migration_ssl_migration_vars: |-

  489.           {{ lookup('ansible.builtin.varnames', '^matrix_ssl_.+', wantlist=True) }}

  490. 

  491.     - name: (Deprecation) Catch and report matrix_ssl variables

  492.       ansible.builtin.fail:

  493.         msg: >-

  494.           The matrix-nginx-proxy role that used to be part of this playbook has been removed.

  495. 

  496.           You should remove all its variables (`matrix_ssl_*`) from your configuration file (vars.yml).

  497. 

  498.           The following variables in your configuration should be renamed: {{ matrix_playbook_migration_ssl_migration_vars.keys() | join(', ') }}

  499.       when: "matrix_playbook_migration_ssl_migration_vars | length > 0"

  500. 

  501. - block:

  502.     - ansible.builtin.set_fact:

  503.         matrix_playbook_migration_matrix_synapse_container_labels_public_client_synapse_oidc_vars: |-

  504.           {{ lookup('ansible.builtin.varnames', '^matrix_synapse_container_labels_public_client_synapse_oidc_.+', wantlist=True) }}

  505. 

  506.     - name: (Deprecation) Catch and report matrix_ssl variables

  507.       ansible.builtin.fail:

  508.         msg: >-

  509.           We found usage of the following variables which are now removed: {{ matrix_playbook_migration_matrix_synapse_container_labels_public_client_synapse_oidc_vars.keys() | join(', ') }}

  510.       when: "matrix_playbook_migration_matrix_synapse_container_labels_public_client_synapse_oidc_vars | length > 0"

  511. 

  512. - block:

  513.     - ansible.builtin.set_fact:

  514.         matrix_playbook_migration_matrix_synapse_reverse_proxy_companion_container_labels_public_client_synapse_oidc_vars: |-

  515.           {{ lookup('ansible.builtin.varnames', '^matrix_synapse_reverse_proxy_companion_container_labels_public_client_synapse_oidc_.+', wantlist=True) }}

  516. 

  517.     - name: (Deprecation) Catch and report matrix_ssl variables

  518.       ansible.builtin.fail:

  519.         msg: >-

  520.           We found usage of the following variables which are now removed: {{ matrix_playbook_migration_matrix_synapse_reverse_proxy_companion_container_labels_public_client_synapse_oidc_vars.keys() | join(', ') }}

  521.       when: "matrix_playbook_migration_matrix_synapse_reverse_proxy_companion_container_labels_public_client_synapse_oidc_vars | length > 0"

  522. 

  523. - name: (Deprecation) Catch and report devture_postgres_backup variables

  524.   ansible.builtin.fail:

  525.     msg: |-

  526.       The postgres-backup role in the playbook now lives under the MASH organization (https://github.com/mother-of-all-self-hosting/ansible-role-postgres-backup).

  527.       The new role is pretty much the same, but uses differently named variables.

  528. 

  529.       Please rename all `devture_postgres_backup_`-prefixed variables (`devture_postgres_backup_*` -> `postgres_backup_*`) on your configuration file (vars.yml).

  530. 

  531.       After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  532. 

  533.       The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^devture_postgres_backup_.+', wantlist=True) | join(', ') }}

  534.   when: "lookup('ansible.builtin.varnames', '^devture_postgres_backup_.+', wantlist=True) | length > 0"

  535. 

  536. - name: (Deprecation) Catch and report devture_postgres variables

  537.   ansible.builtin.fail:

  538.     msg: |-

  539.       The Postgres role in the playbook now lives under the MASH organization (https://github.com/mother-of-all-self-hosting/ansible-role-postgres).

  540.       The new role is pretty much the same, but uses differently named variables.

  541. 

  542.       Please rename all `devture_postgres_`-prefixed variables (`devture_postgres_*` -> `postgres_*`) on your configuration file (vars.yml).

  543. 

  544.       After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  545. 

  546.       The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^devture_postgres_.+', wantlist=True) | join(', ') }}

  547.   when: "lookup('ansible.builtin.varnames', '^devture_postgres_.+', wantlist=True) | length > 0"

  548. 

  549. - name: (Deprecation) Catch and report traefik_certs_dumper variables

  550.   ansible.builtin.fail:

  551.     msg: |-

  552.       The traefik-certs-dumper role in the playbook now lives under the MASH organization (https://github.com/mother-of-all-self-hosting/ansible-role-traefik-certs-dumper).

  553.       The new role is pretty much the same, but uses differently named variables.

  554. 

  555.       Please rename all `devture_traefik_certs_dumper_`-prefixed variables (`devture_traefik_certs_dumper_*` -> `traefik_certs_dumper_*`) on your configuration file (vars.yml).

  556. 

  557.       After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  558. 

  559.       The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^devture_traefik_certs_dumper_.+', wantlist=True) | join(', ') }}

  560.   when: "lookup('ansible.builtin.varnames', '^devture_traefik_certs_dumper_.+', wantlist=True) | length > 0"

  561. 

  562. - name: (Deprecation) Catch and report devture_traefik variables

  563.   ansible.builtin.fail:

  564.     msg: |-

  565.       The traefik role in the playbook now lives under the MASH organization (https://github.com/mother-of-all-self-hosting/ansible-role-traefik).

  566.       The new role is pretty much the same, but uses differently named variables.

  567. 

  568.       Please rename all `devture_traefik_`-prefixed variables (`devture_traefik_*` -> `traefik_*`) on your configuration file (vars.yml).

  569. 

  570.       After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  571. 

  572.       The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^devture_traefik_.+', wantlist=True) | join(', ') }}

  573.   when: "lookup('ansible.builtin.varnames', '^devture_traefik_.+', wantlist=True) | length > 0"

  574. 

  575. - name: (Deprecation) Catch and report devture_container_socket_proxy variables

  576.   ansible.builtin.fail:

  577.     msg: |-

  578.       The container-socket-proxy role in the playbook now lives under the MASH organization (https://github.com/mother-of-all-self-hosting/ansible-role-container-socket-proxy).

  579.       The new role is pretty much the same, but uses differently named variables.

  580. 

  581.       Please rename all `devture_container_socket_proxy_`-prefixed variables (`devture_container_socket_proxy_*` -> `container_socket_proxy_*`) on your configuration file (vars.yml).

  582. 

  583.       After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  584. 

  585.       The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^devture_container_socket_proxy_.+', wantlist=True) | join(', ') }}

  586.   when: "lookup('ansible.builtin.varnames', '^devture_container_socket_proxy_.+', wantlist=True) | length > 0"

  587. 

  588. - name: (Deprecation) Catch and report ma1sd variables

  589.   ansible.builtin.fail:

  590.     msg: |-

  591.       ma1sd was completely removed from the playbook in February 2026.

  592. 

  593.       Please remove all `matrix_ma1sd_*` variables from your configuration file (vars.yml).

  594. 

  595.       You may also wish to uninstall the component manually. See `docs/configuring-playbook-ma1sd.md` for more information.

  596. 

  597.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_ma1sd_.+', wantlist=True) | join(', ') }}

  598.   when: "lookup('ansible.builtin.varnames', '^matrix_ma1sd_.+', wantlist=True) | length > 0"

  599. 

  600. - name: (Deprecation) Catch and report matrix-appservice-slack variables

  601.   ansible.builtin.fail:

  602.     msg: |-

  603.       matrix-appservice-slack was completely removed from the playbook in February 2026.

  604. 

  605.       Please remove all `matrix_appservice_slack_*` variables from your configuration file (vars.yml).

  606. 

  607.       You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-appservice-slack.md` for more information.

  608. 

  609.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_appservice_slack_.+', wantlist=True) | join(', ') }}

  610. 

  611.       You might probably wish to have a look at mautrix-slack, another bridge to Slack. Refer to `docs/configuring-playbook-bridge-mautrix-slack.md` for more information.

  612.   when: "lookup('ansible.builtin.varnames', '^matrix_appservice_slack_.+', wantlist=True) | length > 0"

  613. 

  614. - name: (Deprecation) Catch and report matrix-appservice-webhooks variables

  615.   ansible.builtin.fail:

  616.     msg: |-

  617.       matrix-appservice-webhooks was completely removed from the playbook in November 2025.

  618. 

  619.       Please remove all `matrix_appservice_webhooks_*` variables from your configuration file (vars.yml).

  620. 

  621.       You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-appservice-webhooks.md` for more information.

  622. 

  623.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_appservice_webhooks_.+', wantlist=True) | join(', ') }}

  624.   when: "lookup('ansible.builtin.varnames', '^matrix_appservice_webhooks_.+', wantlist=True) | length > 0"

  625. 

  626. - name: (Deprecation) Catch and report matrix-chatgpt-bot variables

  627.   ansible.builtin.fail:

  628.     msg: |-

  629.       matrix-chatgpt-bot was completely removed from the playbook in November 2025.

  630. 

  631.       Please remove all `matrix_bot_chatgpt_*` variables from your configuration file (vars.yml).

  632. 

  633.       You may also wish to uninstall the bot manually. See `docs/configuring-playbook-bot-chatgpt.md` for more information.

  634. 

  635.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_bot_chatgpt_.+', wantlist=True) | join(', ') }}

  636.   when: "lookup('ansible.builtin.varnames', '^matrix_bot_chatgpt_.+', wantlist=True) | length > 0"

  637. 

  638. - name: (Deprecation) Catch and report matrix-client-cinny variables

  639.   ansible.builtin.fail:

  640.     msg: |-

  641.       The matrix-client-cinny role in the playbook now lives under the MASH organization (https://github.com/mother-of-all-self-hosting/ansible-role-cinny).

  642.       The new role is pretty much the same, but uses differently named variables.

  643. 

  644.       Please rename all `matrix_client_cinny_`-prefixed variables (`matrix_client_cinny_*` -> `cinny_*`) on your configuration file (vars.yml).

  645. 

  646.       After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  647. 

  648.       The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^matrix_client_cinny_.+', wantlist=True) | join(', ') }}

  649.   when: "lookup('ansible.builtin.varnames', '^matrix_client_cinny_.+', wantlist=True) | length > 0"

  650. 

  651. - name: (Deprecation) Catch and report matrix-client-hydrogen variables

  652.   ansible.builtin.fail:

  653.     msg: |-

  654.       The matrix-client-hydrogen role in the playbook now lives under the MASH organization (https://github.com/mother-of-all-self-hosting/ansible-role-hydrogen).

  655.       The new role is pretty much the same, but uses differently named variables.

  656. 

  657.       Please rename all `matrix_client_hydrogen_`-prefixed variables (`matrix_client_hydrogen_*` -> `hydrogen_*`) on your configuration file (vars.yml).

  658. 

  659.       After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  660. 

  661.       The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^matrix_client_hydrogen_.+', wantlist=True) | join(', ') }}

  662.   when: "lookup('ansible.builtin.varnames', '^matrix_client_hydrogen_.+', wantlist=True) | length > 0"

  663. 

  664. - name: (Deprecation) Catch and report matrix-coturn variables

  665.   ansible.builtin.fail:

  666.     msg: |-

  667.       The matrix-coturn role in the playbook now lives under the MASH organization (https://github.com/mother-of-all-self-hosting/ansible-role-coturn).

  668.       The new role is pretty much the same, but uses differently named variables.

  669. 

  670.       Please rename all `matrix_coturn_`-prefixed variables (`matrix_coturn_*` -> `coturn_*`) on your configuration file (vars.yml).

  671. 

  672.       After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  673. 

  674.       The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^matrix_coturn_.+', wantlist=True) | join(', ') }}

  675.   when: "lookup('ansible.builtin.varnames', '^matrix_coturn_.+', wantlist=True) | length > 0"

  676. 

  677. - name: (Deprecation) Catch and report matrix-conduwuit variables

  678.   ansible.builtin.fail:

  679.     msg: |-

  680.       matrix-conduwuit was completely removed from the playbook in February 2026.

  681. 

  682.       Please remove all `matrix_conduwuit*` variables from your configuration file (vars.yml).

  683. 

  684.       You may wish to migrate to Continuwuity, a drop-in replacement for conduwuit. See `docs/configuring-playbook-continuwuity.md` for more information.

  685. 

  686.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_conduwuit.+', wantlist=True) | join(', ') }}

  687.   when: "lookup('ansible.builtin.varnames', '^matrix_conduwuit.+', wantlist=True) | length > 0"

  688. 

  689. - name: (Deprecation) Catch and report matrix-dynamic-dns variables

  690.   ansible.builtin.fail:

  691.     msg: |-

  692.       The matrix-dynamic-dns role in the playbook now lives under the MASH organization (https://github.com/mother-of-all-self-hosting/ansible-role-ddclient).

  693.       The new role is pretty much the same, but uses differently named variables.

  694. 

  695.       Please rename all `matrix_dynamic_dns_`-prefixed variables (`matrix_dynamic_dns_*` -> `ddclient_*`) on your configuration file (vars.yml).

  696. 

  697.       After renaming them, please do not forget to fetch the Ansible role. See docs/maintenance-upgrading-services.md for details about how to do so.

  698. 

  699.       The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^matrix_dynamic_dns_.+', wantlist=True) | join(', ') }}

  700.   when: "lookup('ansible.builtin.varnames', '^matrix_dynamic_dns_.+', wantlist=True) | length > 0"

  701. 

  702. - name: (Deprecation) Catch and report mautrix-facebook variables

  703.   ansible.builtin.fail:

  704.     msg: |-

  705.       mautrix-facebook was completely removed from the playbook in November 2025.

  706. 

  707.       Please remove all `matrix_mautrix_facebook_*` variables from your configuration file (vars.yml).

  708. 

  709.       You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-mautrix-facebook.md` for more information.

  710. 

  711.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_mautrix_facebook_.+', wantlist=True) | join(', ') }}

  712.   when: "lookup('ansible.builtin.varnames', '^matrix_mautrix_facebook_.+', wantlist=True) | length > 0"

  713. 

  714. - name: (Deprecation) Catch and report mautrix-hangouts variables

  715.   ansible.builtin.fail:

  716.     msg: |-

  717.       The Google Hangouts service was discontinued on 1st of November 2022.

  718.       The mautrix-hangouts bridge has been deprecated in the playbook since December 2024 and was completely removed from the playbook in February 2025.

  719. 

  720.       Please remove all `matrix_mautrix_hangouts_*` variables from your configuration file (vars.yml).

  721. 

  722.       You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-mautrix-hangouts.md` for more information.

  723. 

  724.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_mautrix_hangouts_.+', wantlist=True) | join(', ') }}

  725.   when: "lookup('ansible.builtin.varnames', '^matrix_mautrix_hangouts_.+', wantlist=True) | length > 0"

  726. 

  727. - name: (Deprecation) Catch and report mautrix-instagram variables

  728.   ansible.builtin.fail:

  729.     msg: |-

  730.       mautrix-instagram was completely removed from the playbook in November 2025.

  731. 

  732.       Please remove all `matrix_mautrix_instagram_*` variables from your configuration file (vars.yml).

  733. 

  734.       You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-mautrix-instagram.md` for more information.

  735. 

  736.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_mautrix_instagram_.+', wantlist=True) | join(', ') }}

  737.   when: "lookup('ansible.builtin.varnames', '^matrix_mautrix_instagram_.+', wantlist=True) | length > 0"

  738. 

  739. - name: (Deprecation) Catch and report mx-puppet-discord variables

  740.   ansible.builtin.fail:

  741.     msg: |-

  742.       The MX Puppet Discord bridge was completely removed from the playbook in November 2025.

  743. 

  744.       Please remove all `matrix_mx_puppet_discord_*` variables from your configuration file (vars.yml).

  745. 

  746.       You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-mx-puppet-discord.md` for more information.

  747. 

  748.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_mx_puppet_discord_.+', wantlist=True) | join(', ') }}

  749.   when: "lookup('ansible.builtin.varnames', '^matrix_mx_puppet_discord_.+', wantlist=True) | length > 0"

  750. 

  751. - name: (Deprecation) Catch and report mx-puppet-instagram variables

  752.   ansible.builtin.fail:

  753.     msg: |-

  754.       The MX Puppet Instagram bridge was completely removed from the playbook in November 2025.

  755. 

  756.       Please remove all `matrix_mx_puppet_instagram_*` variables from your configuration file (vars.yml).

  757. 

  758.       You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-mx-puppet-instagram.md` for more information.

  759. 

  760.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_mx_puppet_instagram_.+', wantlist=True) | join(', ') }}

  761.   when: "lookup('ansible.builtin.varnames', '^matrix_mx_puppet_instagram_.+', wantlist=True) | length > 0"

  762. 

  763. - name: (Deprecation) Catch and report mx-puppet-slack variables

  764.   ansible.builtin.fail:

  765.     msg: |-

  766.       The MX Puppet Slack bridge was completely removed from the playbook in November 2025.

  767. 

  768.       Please remove all `matrix_mx_puppet_slack_*` variables from your configuration file (vars.yml).

  769. 

  770.       You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-mx-puppet-slack.md` for more information.

  771. 

  772.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_mx_puppet_slack_.+', wantlist=True) | join(', ') }}

  773.   when: "lookup('ansible.builtin.varnames', '^matrix_mx_puppet_slack_.+', wantlist=True) | length > 0"

  774. 

  775. - name: (Deprecation) Catch and report mx-puppet-twitter variables

  776.   ansible.builtin.fail:

  777.     msg: |-

  778.       The MX Puppet Twitter bridge was completely removed from the playbook in November 2025.

  779. 

  780.       Please remove all `matrix_mx_puppet_twitter_*` variables from your configuration file (vars.yml).

  781. 

  782.       You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-mx-puppet-twitter.md` for more information.

  783. 

  784.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_mx_puppet_twitter_.+', wantlist=True) | join(', ') }}

  785.   when: "lookup('ansible.builtin.varnames', '^matrix_mx_puppet_twitter_.+', wantlist=True) | length > 0"

  786. 

  787. - name: (Deprecation) Catch and report the Dimension integration manager variables

  788.   ansible.builtin.fail:

  789.     msg: |-

  790.       The Dimension integration manager was completely removed from the playbook in February 2026.

  791. 

  792.       Please remove all `matrix_dimension_*` variables from your configuration file (vars.yml).

  793. 

  794.       You may also wish to uninstall the component manually. See `docs/configuring-playbook-dimension.md` for more information.

  795. 

  796.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_dimension_.+', wantlist=True) | join(', ') }}

  797.   when: "lookup('ansible.builtin.varnames', '^matrix_dimension_.+', wantlist=True) | length > 0"

  798. 

  799. - name: (Deprecation) Catch and report Email2Matrix variables

  800.   ansible.builtin.fail:

  801.     msg: |-

  802.       The Email2Matrix service has been superseded by the Postmoogle bridge for a long time now and was completely removed from the playbook in February 2025.

  803. 

  804.       Please remove all `matrix_email2matrix_*` variables from your configuration file (vars.yml).

  805. 

  806.       You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-email2matrix.md` for more information.

  807. 

  808.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_email2matrix_.+', wantlist=True) | join(', ') }}

  809.   when: "lookup('ansible.builtin.varnames', '^matrix_email2matrix_.+', wantlist=True) | length > 0"

  810. 

  811. - name: (Deprecation) Catch and report go-skype-bridge variables

  812.   ansible.builtin.fail:

  813.     msg: |-

  814.       The go-skype-bridge was completely removed from the playbook in November 2025, as Skype has been discontinued since May 2025.

  815. 

  816.       Please remove all `matrix_go_skype_bridge_*` variables from your configuration file (vars.yml).

  817. 

  818.       You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-go-skype-bridge.md` for more information.

  819. 

  820.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_go_skype_bridge_.+', wantlist=True) | join(', ') }}

  821.   when: "lookup('ansible.builtin.varnames', '^matrix_go_skype_bridge_.+', wantlist=True) | length > 0"

  822. 

  823. - name: (Deprecation) Catch and report the Sliding Sync proxy variables

  824.   ansible.builtin.fail:

  825.     msg: |-

  826.       The Sliding Sync proxy was completely removed from the playbook in November 2025.

  827. 

  828.       Please remove all `matrix_sliding_sync_*` variables from your configuration file (vars.yml).

  829. 

  830.       You may also wish to uninstall the proxy manually. See `docs/configuring-playbook-sliding-sync-proxy.md` for more information.

  831. 

  832.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_sliding_sync_.+', wantlist=True) | join(', ') }}

  833.   when: "lookup('ansible.builtin.varnames', '^matrix_sliding_sync_.+', wantlist=True) | length > 0"

  834. 

  835. - name: (Deprecation) Catch and report the synapse-auto-invite-accept variables

  836.   ansible.builtin.fail:

  837.     msg: |-

  838.       synapse-auto-invite-accept was completely removed from the playbook in February 2026, as the same functionality is available since Synapse v1.109.0.

  839. 

  840.       Please remove all `matrix_synapse_ext_synapse_auto_accept_invite_*` variables from your configuration file (vars.yml).

  841. 

  842.       To enable the native feature, see `docs/configuring-playbook-synapse-auto-accept-invite.md` for more information.

  843. 

  844.       The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_synapse_ext_synapse_auto_accept_invite_.+', wantlist=True) | join(', ') }}

  845.   when: "lookup('ansible.builtin.varnames', '^matrix_synapse_ext_synapse_auto_accept_invite_.+', wantlist=True) | length > 0"