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.
10805 Commits
13 Branches
36 MiB
 
 
Tree: 4310fb83c1
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '4310fb83c1'
${ noResults }
matrix-docker-ansible-deploy/roles/custom/matrix_playbook_migration/tasks/validate_config.yml

713 lines
52 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. - name: (Deprecation) Catch and report matrix_postgres variables

  84.   ansible.builtin.fail:

  85.     msg: |-

  86.       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).

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

  88. 

  89.       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).

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

  91. 

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

  93. 

  94.       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.

  95. 

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

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

  98. 

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

  100.   ansible.builtin.fail:

  101.     msg: |-

  102.       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).

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

  104. 

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

  106. 

  107.       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.

  108. 

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

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

  111. 

  112. - when: matrix_playbook_migration_matrix_prometheus_node_exporter_migration_validation_enabled | bool

  113.   block:

  114.     - ansible.builtin.set_fact:

  115.         matrix_playbook_migration_matrix_prometheus_node_exporter_migration_vars: |-

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

  117. 

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

  119.       ansible.builtin.fail:

  120.         msg: >-

  121.           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.

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

  123. 

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

  125. 

  126.           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.

  127. 

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

  129.       when: "matrix_playbook_migration_matrix_prometheus_node_exporter_migration_vars | length > 0"

  130. 

  131. - when: matrix_playbook_migration_matrix_prometheus_postgres_exporter_migration_validation_enabled | bool

  132.   block:

  133.     - ansible.builtin.set_fact:

  134.         matrix_playbook_migration_matrix_prometheus_postgres_exporter_migration_vars: |-

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

  136. 

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

  138.       ansible.builtin.fail:

  139.         msg: >-

  140.           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.

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

  142. 

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

  144. 

  145.           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.

  146. 

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

  148.       when: "matrix_playbook_migration_matrix_prometheus_postgres_exporter_migration_vars | length > 0"

  149. 

  150. - when: matrix_playbook_migration_matrix_backup_borg_migration_validation_enabled | bool

  151.   block:

  152.     - ansible.builtin.set_fact:

  153.         matrix_playbook_migration_backup_borg_migration_vars: |-

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

  155. 

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

  157.       ansible.builtin.fail:

  158.         msg: >-

  159.           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.

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

  161. 

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

  163. 

  164.           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.

  165. 

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

  167.       when: "matrix_playbook_migration_backup_borg_migration_vars | length > 0"

  168. 

  169. - when: matrix_playbook_migration_matrix_grafana_migration_validation_enabled | bool

  170.   block:

  171.     - ansible.builtin.set_fact:

  172.         matrix_playbook_migration_grafana_migration_vars: |-

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

  174. 

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

  176.       ansible.builtin.fail:

  177.         msg: >-

  178.           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.

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

  180. 

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

  182. 

  183.           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.

  184. 

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

  186.       when: "matrix_playbook_migration_grafana_migration_vars | length > 0"

  187. 

  188. - when: matrix_playbook_migration_matrix_ntfy_migration_validation_enabled | bool

  189.   block:

  190.     - ansible.builtin.set_fact:

  191.         matrix_playbook_migration_ntfy_migration_vars: |-

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

  193. 

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

  195.       ansible.builtin.fail:

  196.         msg: >-

  197.           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.

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

  199. 

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

  201. 

  202.           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.

  203. 

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

  205.       when: "matrix_playbook_migration_ntfy_migration_vars | length > 0"

  206. 

  207. - when: matrix_playbook_migration_matrix_redis_migration_validation_enabled | bool

  208.   block:

  209.     - ansible.builtin.set_fact:

  210.         matrix_playbook_migration_redis_migration_vars: |-

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

  212. 

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

  214.       ansible.builtin.fail:

  215.         msg: >-

  216.           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.

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

  218. 

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

  220. 

  221.           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.

  222. 

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

  224.       when: "matrix_playbook_migration_redis_migration_vars | length > 0"

  225. 

  226. - when: matrix_playbook_migration_redis_valkey_migration_validation_enabled | bool

  227.   block:

  228.     - ansible.builtin.set_fact:

  229.         matrix_playbook_migration_redis_migration_vars: |-

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

  231. 

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

  233.       ansible.builtin.fail:

  234.         msg: >-

  235.           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.

  236. 

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

  238. 

  239.           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.

  240. 

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

  242.       when: "matrix_playbook_migration_redis_migration_vars | length > 0"

  243. 

  244. - when: matrix_playbook_migration_keydb_valkey_migration_validation_enabled | bool

  245.   block:

  246.     - ansible.builtin.set_fact:

  247.         matrix_playbook_migration_keydb_migration_vars: |-

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

  249. 

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

  251.       ansible.builtin.fail:

  252.         msg: >-

  253.           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.

  254. 

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

  256. 

  257.           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.

  258. 

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

  260.       when: "matrix_playbook_migration_keydb_migration_vars | length > 0"

  261. 

  262. - when: matrix_playbook_migration_matrix_etherpad_migration_validation_enabled | bool

  263.   block:

  264.     - ansible.builtin.set_fact:

  265.         matrix_playbook_migration_etherpad_migration_vars: |-

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

  267. 

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

  269.       ansible.builtin.fail:

  270.         msg: >-

  271.           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.

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

  273. 

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

  275. 

  276.           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.

  277. 

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

  279.       when: "matrix_playbook_migration_etherpad_migration_vars | length > 0"

  280. 

  281. - when: matrix_playbook_migration_matrix_aux_migration_validation_enabled | bool

  282.   block:

  283.     - ansible.builtin.set_fact:

  284.         matrix_playbook_migration_aux_migration_vars: |-

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

  286. 

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

  288.       ansible.builtin.fail:

  289.         msg: >-

  290.           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.

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

  292. 

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

  294. 

  295.           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.

  296. 

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

  298.       when: "matrix_playbook_migration_aux_migration_vars | length > 0"

  299. 

  300. - when: matrix_playbook_migration_matrix_jitsi_migration_validation_enabled | bool

  301.   block:

  302.     - ansible.builtin.set_fact:

  303.         matrix_playbook_migration_jitsi_migration_vars: |-

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

  305. 

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

  307.       ansible.builtin.fail:

  308.         msg: >-

  309.           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.

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

  311. 

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

  313. 

  314.           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.

  315. 

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

  317.       when: "matrix_playbook_migration_jitsi_migration_vars | length > 0"

  318. 

  319. - when: matrix_playbook_migration_matrix_postmoogle_migration_validation_enabled | bool

  320.   block:

  321.     - ansible.builtin.set_fact:

  322.         matrix_playbook_migration_postmoogle_migration_vars: |-

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

  324. 

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

  326.       ansible.builtin.fail:

  327.         msg: >-

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

  329. 

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

  331. 

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

  333.       when: "matrix_playbook_migration_postmoogle_migration_vars | length > 0"

  334. 

  335. - when: matrix_playbook_migration_matrix_nginx_proxy_elimination_variable_transition_checks_enabled | bool

  336.   block:

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

  338.       ansible.builtin.fail:

  339.         msg: >-

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

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

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

  343.       with_items:

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

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

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

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

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

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

  350.         - {'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>'}

  351.         - {'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>'}

  352. 

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

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

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

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

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

  358.         - {'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'}

  359.         - {'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'}

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

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

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

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

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

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

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

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

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

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

  370.         - {'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>'}

  371.         - {'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>'}

  372.         - {'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>'}

  373.         - {'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>'}

  374.         - {'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'}

  375.         - {'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>'}

  376.         - {'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'}

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

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

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

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

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

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

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

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

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

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

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

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

  389.         - {'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>'}

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

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

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

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

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

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

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

  397.         - {'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>'}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  420.         - {'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.>'}

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

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

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

  424. 

  425. - when: matrix_playbook_migration_matrix_nginx_proxy_leftover_variable_validation_checks_enabled | bool

  426.   block:

  427.     - ansible.builtin.set_fact:

  428.         matrix_playbook_migration_nginx_proxy_migration_vars: |-

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

  430. 

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

  432.       ansible.builtin.fail:

  433.         msg: >-

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

  435. 

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

  437. 

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

  439.       when: "matrix_playbook_migration_nginx_proxy_migration_vars | length > 0"

  440. 

  441. - when: matrix_playbook_migration_matrix_ssl_leftover_variable_checks_enabled | bool

  442.   block:

  443.     - ansible.builtin.set_fact:

  444.         matrix_playbook_migration_ssl_migration_vars: |-

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

  446. 

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

  448.       ansible.builtin.fail:

  449.         msg: >-

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

  451. 

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

  453. 

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

  455.       when: "matrix_playbook_migration_ssl_migration_vars | length > 0"

  456. 

  457. - block:

  458.     - ansible.builtin.set_fact:

  459.         matrix_playbook_migration_matrix_synapse_container_labels_public_client_synapse_oidc_vars: |-

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

  461. 

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

  463.       ansible.builtin.fail:

  464.         msg: >-

  465.           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(', ') }}

  466.       when: "matrix_playbook_migration_matrix_synapse_container_labels_public_client_synapse_oidc_vars | length > 0"

  467. 

  468. - block:

  469.     - ansible.builtin.set_fact:

  470.         matrix_playbook_migration_matrix_synapse_reverse_proxy_companion_container_labels_public_client_synapse_oidc_vars: |-

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

  472. 

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

  474.       ansible.builtin.fail:

  475.         msg: >-

  476.           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(', ') }}

  477.       when: "matrix_playbook_migration_matrix_synapse_reverse_proxy_companion_container_labels_public_client_synapse_oidc_vars | length > 0"

  478. 

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

  480.   ansible.builtin.fail:

  481.     msg: |-

  482.       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).

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

  484. 

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

  486. 

  487.       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.

  488. 

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

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

  491. 

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

  493.   ansible.builtin.fail:

  494.     msg: |-

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

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

  497. 

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

  499. 

  500.       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.

  501. 

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

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

  504. 

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

  506.   ansible.builtin.fail:

  507.     msg: |-

  508.       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).

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

  510. 

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

  512. 

  513.       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.

  514. 

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

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

  517. 

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

  519.   ansible.builtin.fail:

  520.     msg: |-

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

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

  523. 

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

  525. 

  526.       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.

  527. 

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

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

  530. 

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

  532.   ansible.builtin.fail:

  533.     msg: |-

  534.       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).

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

  536. 

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

  538. 

  539.       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.

  540. 

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

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

  543. 

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

  545.   ansible.builtin.fail:

  546.     msg: |-

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

  548. 

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

  550. 

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

  552. 

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

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

  555. 

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

  557.   ansible.builtin.fail:

  558.     msg: |-

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

  560. 

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

  562. 

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

  564. 

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

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

  567. 

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

  569.   ansible.builtin.fail:

  570.     msg: |-

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

  572. 

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

  574. 

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

  576. 

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

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

  579. 

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

  581.   ansible.builtin.fail:

  582.     msg: |-

  583.       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).

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

  585. 

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

  587. 

  588.       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.

  589. 

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

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

  592. 

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

  594.   ansible.builtin.fail:

  595.     msg: |-

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

  597. 

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

  599. 

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

  601. 

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

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

  604. 

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

  606.   ansible.builtin.fail:

  607.     msg: |-

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

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

  610. 

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

  612. 

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

  614. 

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

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

  617. 

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

  619.   ansible.builtin.fail:

  620.     msg: |-

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

  622. 

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

  624. 

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

  626. 

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

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

  629. 

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

  631.   ansible.builtin.fail:

  632.     msg: |-

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

  634. 

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

  636. 

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

  638. 

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

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

  641. 

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

  643.   ansible.builtin.fail:

  644.     msg: |-

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

  646. 

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

  648. 

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

  650. 

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

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

  653. 

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

  655.   ansible.builtin.fail:

  656.     msg: |-

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

  658. 

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

  660. 

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

  662. 

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

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

  665. 

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

  667.   ansible.builtin.fail:

  668.     msg: |-

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

  670. 

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

  672. 

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

  674. 

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

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

  677. 

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

  679.   ansible.builtin.fail:

  680.     msg: |-

  681.       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.

  682. 

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

  684. 

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

  686. 

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

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

  689. 

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

  691.   ansible.builtin.fail:

  692.     msg: |-

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

  694. 

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

  696. 

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

  698. 

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

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

  701. 

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

  703.   ansible.builtin.fail:

  704.     msg: |-

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

  706. 

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

  708. 

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

  710. 

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

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