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.
 
 

830 lines
60 KiB

  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. - name: (Deprecation) Catch and report renamed Matrix playbook settings
  8. ansible.builtin.fail:
  9. msg: >-
  10. Your configuration contains a variable, which now has a different name.
  11. Please rename the variable (`{{ item.old }}` -> `{{ item.new }}`) on your configuration file (vars.yml).
  12. when: "lookup('ansible.builtin.varnames', ('^' + item.old + '$'), wantlist=True) | length > 0"
  13. with_items:
  14. - {'old': 'matrix_vars_yml_snapshotting_enabled', 'new': 'devture_playbook_state_preserver_vars_preservation_enabled'}
  15. - {'old': 'matrix_vars_yml_snapshotting_src', 'new': 'devture_playbook_state_preserver_vars_preservation_src'}
  16. - {'old': 'matrix_playbook_commit_hash_preservation_enabled', 'new': 'devture_playbook_state_preserver_commit_hash_preservation_enabled'}
  17. - {'old': 'matrix_ntpd_package', 'new': 'devture_timesync_ntpd_package'}
  18. - {'old': 'matrix_ntpd_service', 'new': 'devture_timesync_ntpd_service'}
  19. - {'old': 'matrix_systemd_unit_home_path', 'new': 'devture_systemd_docker_base_systemd_unit_home_path'}
  20. - {'old': 'matrix_systemd_path', 'new': 'devture_systemd_docker_base_systemd_path'}
  21. - {'old': 'matrix_host_command_docker', 'new': 'devture_systemd_docker_base_host_command_docker'}
  22. - {'old': 'matrix_host_command_sh', 'new': 'devture_systemd_docker_base_host_command_sh'}
  23. - {'old': 'matrix_host_command_systemctl', 'new': 'devture_systemd_docker_base_host_command_systemctl'}
  24. - {'old': 'matrix_container_retries_count', 'new': 'devture_playbook_help_container_retries_count'}
  25. - {'old': 'matrix_container_retries_delay', 'new': 'devture_playbook_help_container_retries_delay'}
  26. - {'old': 'matrix_geturl_retries_count', 'new': 'devture_playbook_help_geturl_retries_count'}
  27. - {'old': 'matrix_geturl_retries_delay', 'new': 'devture_playbook_help_geturl_retries_delay'}
  28. - {'old': 'matrix_nginx_proxy_synapse_cache_path', 'new': 'matrix_synapse_reverse_proxy_companion_synapse_cache_path'}
  29. - {'old': 'matrix_nginx_proxy_synapse_cache_enabled', 'new': 'matrix_synapse_reverse_proxy_companion_synapse_cache_enabled'}
  30. - {'old': 'matrix_docker_installation_enabled', 'new': 'matrix_playbook_docker_installation_enabled'}
  31. - {'old': 'matrix_docker_package_name', 'new': '<Not applicable. Docker is installed using https://github.com/geerlingguy/ansible-role-docker now>'}
  32. - {'old': 'matrix_systemd_services_list', 'new': 'devture_systemd_service_manager_services_list_additional'}
  33. - {'old': 'matrix_common_after_systemd_service_start_wait_for_timeout_seconds', 'new': 'devture_systemd_service_manager_up_verification_delay_seconds'}
  34. - {'old': 'matrix_systemd_services_autostart_enabled', 'new': 'devture_systemd_service_manager_services_autostart_enabled'}
  35. - {'old': 'matrix_prometheus_node_exporter_metrics_proxying_enabled', 'new': '<prometheus_node_exporter_container_labels_traefik_enabled or matrix_metrics_exposure_enabled>'}
  36. - {'old': 'matrix_prometheus_postgres_exporter_metrics_proxying_enabled', 'new': '<prometheus_postgres_exporter_container_labels_traefik_enabled or matrix_metrics_exposure_enabled>'}
  37. - {'old': 'matrix_playbook_traefik_certs_dumper_role_enabled', 'new': 'traefik_certs_dumper_enabled'}
  38. - {'old': 'matrix_playbook_traefik_role_enabled', 'new': 'traefik_enabled'}
  39. # Most important variables from the old Prometheus role here, for people who miss the changelog entry
  40. - {'old': 'matrix_prometheus_enabled', 'new': 'prometheus_enabled'}
  41. - {'old': 'matrix_prometheus_process_default_arguments', 'new': 'prometheus_process_default_arguments'}
  42. - {'old': 'matrix_prometheus_process_extra_arguments', 'new': 'prometheus_process_extra_arguments'}
  43. - {'old': 'matrix_prometheus_configuration_extension_yaml', 'new': 'prometheus_configuration_extension_yaml'}
  44. - {'old': 'matrix_prometheus_scraper_synapse_enabled', 'new': 'matrix_prometheus_services_connect_synapse_enabled'}
  45. - {'old': 'matrix_prometheus_scraper_synapse_targets', 'new': '<superseded by matrix_prometheus_services_connect_scraper_synapse_main_process_static_configs_target>'}
  46. - {'old': 'matrix_prometheus_scraper_synapse_workers_enabled_list', 'new': 'matrix_prometheus_services_connect_scraper_synapse_workers_enabled_list'}
  47. - {'old': 'matrix_prometheus_scraper_synapse_rules_synapse_tag', 'new': 'matrix_prometheus_services_connect_synapse_rules_download_synapse_tag'}
  48. - {'old': 'matrix_prometheus_scraper_node_enabled', 'new': 'prometheus_self_node_scraper_enabled'}
  49. - {'old': 'matrix_prometheus_scraper_node_targets', 'new': '<superseded by prometheus_self_node_scraper_static_configs_target>'}
  50. - {'old': 'matrix_prometheus_scraper_postgres_enabled', 'new': 'matrix_prometheus_services_connect_scraper_postgres_enabled'}
  51. - {'old': 'matrix_prometheus_scraper_postgres_targets', 'new': '<superseded by matrix_prometheus_services_connect_scraper_postgres_static_configs_target>'}
  52. - {'old': 'matrix_prometheus_scraper_hookshot_enabled', 'new': 'matrix_prometheus_services_connect_scraper_hookshot_enabled'}
  53. - {'old': 'matrix_prometheus_scraper_hookshot_targets', 'new': '<superseded by matrix_prometheus_services_connect_scraper_hookshot_static_configs_target>'}
  54. - {'old': 'matrix_prometheus_scraper_nginxlog_enabled', 'new': 'matrix_prometheus_services_connect_scraper_nginxlog_enabled'}
  55. - {'old': 'matrix_prometheus_scraper_nginxlog_server_port', 'new': 'matrix_prometheus_services_connect_scraper_nginxlog_static_configs_target'}
  56. - {'old': 'matrix_prosody_jitsi_max_participants', 'new': 'jitsi_prosody_max_participants'}
  57. - {'old': 'jitsi_require_well_known', 'new': 'jitsi_web_well_known_element_jitsi_enabled'}
  58. - {'old': 'jitsi_wellknown_element_jitsi_json', 'new': 'jitsi_web_well_known_element_jitsi_json'}
  59. - {'old': 'exim_relay_docker_image', 'new': 'exim_relay_container_image'}
  60. - {'old': 'exim_relay_docker_image_name_prefix', 'new': 'exim_relay_container_image_name_prefix'}
  61. - {'old': 'exim_relay_docker_image_force_pull', 'new': 'exim_relay_container_image_force_pull'}
  62. - {'old': 'matrix_playbook_reverse_proxy_traefik_middleware_compession_enabled', 'new': 'matrix_playbook_reverse_proxy_traefik_middleware_compression_enabled'}
  63. - {'old': 'matrix_playbook_reverse_proxy_traefik_middleware_compession_name', 'new': 'matrix_playbook_reverse_proxy_traefik_middleware_compression_name'}
  64. - {'old': 'matrix_synapse_account_threepid_delegates_msisdn_mas1sd_url', 'new': '<removed>'}
  65. - {'old': 'cinny_docker_image', 'new': 'cinny_container_image'}
  66. - {'old': 'cinny_docker_image_registry_prefix', 'new': 'cinny_container_image_registry_prefix'}
  67. - {'old': 'cinny_docker_image_registry_prefix_upstream', 'new': 'cinny_container_image_registry_prefix_upstream'}
  68. - {'old': 'cinny_docker_image_registry_prefix_upstream_default', 'new': 'cinny_container_image_registry_prefix_upstream_default'}
  69. - {'old': 'coturn_docker_image', 'new': 'coturn_container_image'}
  70. - {'old': 'coturn_docker_image_registry_prefix', 'new': 'coturn_container_image_registry_prefix'}
  71. - {'old': 'coturn_docker_image_registry_prefix_upstream', 'new': 'coturn_container_image_registry_prefix_upstream'}
  72. - {'old': 'coturn_docker_image_registry_prefix_upstream_default', 'new': 'coturn_container_image_registry_prefix_upstream_default'}
  73. - {'old': 'ddclient_docker_image', 'new': 'ddclient_container_image'}
  74. - {'old': 'ddclient_docker_image_registry_prefix', 'new': 'ddclient_container_image_registry_prefix'}
  75. - {'old': 'ddclient_docker_image_registry_prefix_upstream', 'new': 'ddclient_container_image_registry_prefix_upstream'}
  76. - {'old': 'ddclient_docker_image_registry_prefix_upstream_default', 'new': 'ddclient_container_image_registry_prefix_upstream_default'}
  77. - {'old': 'hydrogen_docker_image', 'new': 'hydrogen_container_image'}
  78. - {'old': 'hydrogen_docker_image_registry_prefix', 'new': 'hydrogen_container_image_registry_prefix'}
  79. - {'old': 'hydrogen_docker_image_registry_prefix_upstream', 'new': 'hydrogen_container_image_registry_prefix_upstream'}
  80. - {'old': 'hydrogen_docker_image_registry_prefix_upstream_default', 'new': 'hydrogen_container_image_registry_prefix_upstream_default'}
  81. - {'old': 'prometheus_nginxlog_exporter_docker_image', 'new': 'prometheus_nginxlog_exporter_container_image'}
  82. - {'old': 'prometheus_nginxlog_exporter_docker_image_registry_prefix', 'new': 'prometheus_nginxlog_exporter_container_image_registry_prefix'}
  83. - {'old': 'prometheus_nginxlog_exporter_docker_image_registry_prefix_upstream', 'new': 'prometheus_nginxlog_exporter_container_image_registry_prefix_upstream'}
  84. - {'old': 'prometheus_nginxlog_exporter_docker_image_registry_prefix_upstream_default', 'new': 'prometheus_nginxlog_exporter_container_image_registry_prefix_upstream_default'}
  85. - {'old': 'prometheus_nginxlog_exporter_docker_image_arch_check_enabled', 'new': 'prometheus_nginxlog_exporter_container_image_arch_check_enabled'}
  86. - name: (Deprecation) Catch and report matrix_postgres variables
  87. ansible.builtin.fail:
  88. msg: |-
  89. 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).
  90. The new role is pretty much the same, but uses differently named variables.
  91. 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).
  92. The new role is pretty much the same, but uses differently named variables.
  93. Please rename all `matrix_postgres`-prefixed variables (`matrix_postgres_*` -> `postgres_*`) on your configuration file (vars.yml).
  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. The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^matrix_postgres_.+', wantlist=True) | join(', ') }}
  96. when: "lookup('ansible.builtin.varnames', '^matrix_postgres_.+', wantlist=True) | length > 0"
  97. - name: (Deprecation) Catch and report matrix_mailer_ variables
  98. ansible.builtin.fail:
  99. msg: |-
  100. 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).
  101. The new role is pretty much the same, but uses differently named variables.
  102. Please rename all `matrix_mailer`-prefixed variables (`matrix_mailer_*` -> `exim_relay_*`) on your configuration file (vars.yml).
  103. 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.
  104. The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^matrix_mailer_.+', wantlist=True) | join(', ') }}
  105. when: "lookup('ansible.builtin.varnames', '^matrix_mailer_.+', wantlist=True) | length > 0"
  106. - when: matrix_playbook_migration_matrix_prometheus_nginxlog_exporter_migration_validation_enabled | bool
  107. block:
  108. - ansible.builtin.set_fact:
  109. matrix_playbook_migration_matrix_prometheus_nginxlog_exporter_migration_vars: |-
  110. {{ lookup('ansible.builtin.varnames', '^matrix_prometheus_nginxlog_exporter_.+', wantlist=True) }}
  111. - name: (Deprecation) Catch and report matrix_prometheus_nginxlog_exporter variables
  112. ansible.builtin.fail:
  113. msg: >-
  114. 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.
  115. The new role is compatible with the old one, but uses different names for its variables.
  116. Please rename all variables (`matrix_prometheus_nginxlog_exporter_` -> `prometheus_nginxlog_exporter_`) on your configuration file (vars.yml).
  117. 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.
  118. The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_matrix_prometheus_nginxlog_exporter_migration_vars | join(', ') }}
  119. when: "matrix_playbook_migration_matrix_prometheus_nginxlog_exporter_migration_vars | length > 0"
  120. - when: matrix_playbook_migration_matrix_prometheus_node_exporter_migration_validation_enabled | bool
  121. block:
  122. - ansible.builtin.set_fact:
  123. matrix_playbook_migration_matrix_prometheus_node_exporter_migration_vars: |-
  124. {{ lookup('ansible.builtin.varnames', '^matrix_prometheus_node_exporter_.+', wantlist=True) }}
  125. - name: (Deprecation) Catch and report matrix_prometheus_node_exporter variables
  126. ansible.builtin.fail:
  127. msg: >-
  128. 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.
  129. The new role is compatible with the old one, but uses different names for its variables.
  130. Please rename all variables (`matrix_prometheus_node_exporter_` -> `prometheus_node_exporter_`) on your configuration file (vars.yml).
  131. 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.
  132. The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_matrix_prometheus_node_exporter_migration_vars | join(', ') }}
  133. when: "matrix_playbook_migration_matrix_prometheus_node_exporter_migration_vars | length > 0"
  134. - when: matrix_playbook_migration_matrix_prometheus_postgres_exporter_migration_validation_enabled | bool
  135. block:
  136. - ansible.builtin.set_fact:
  137. matrix_playbook_migration_matrix_prometheus_postgres_exporter_migration_vars: |-
  138. {{ lookup('ansible.builtin.varnames', '^matrix_prometheus_postgres_exporter_.+', wantlist=True) }}
  139. - name: (Deprecation) Catch and report matrix_prometheus_postgres_exporter variables
  140. ansible.builtin.fail:
  141. msg: >-
  142. 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.
  143. The new role is compatible with the old one, but uses different names for its variables.
  144. Please rename all variables (`matrix_prometheus_postgres_exporter_` -> `prometheus_postgres_exporter_`) on your configuration file (vars.yml).
  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. The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_matrix_prometheus_postgres_exporter_migration_vars.keys() | join(', ') }}
  147. when: "matrix_playbook_migration_matrix_prometheus_postgres_exporter_migration_vars | length > 0"
  148. - when: matrix_playbook_migration_matrix_backup_borg_migration_validation_enabled | bool
  149. block:
  150. - ansible.builtin.set_fact:
  151. matrix_playbook_migration_backup_borg_migration_vars: |-
  152. {{ lookup('ansible.builtin.varnames', '^matrix_backup_borg_.+', wantlist=True) }}
  153. - name: (Deprecation) Catch and report matrix_backup_borg variables
  154. ansible.builtin.fail:
  155. msg: >-
  156. 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.
  157. The new role is compatible with the old one, but uses different names for its variables.
  158. Please rename all variables (`matrix_backup_borg_` -> `backup_borg_`) on your configuration file (vars.yml).
  159. 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.
  160. The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_backup_borg_migration_vars.keys() | join(', ') }}
  161. when: "matrix_playbook_migration_backup_borg_migration_vars | length > 0"
  162. - when: matrix_playbook_migration_matrix_grafana_migration_validation_enabled | bool
  163. block:
  164. - ansible.builtin.set_fact:
  165. matrix_playbook_migration_grafana_migration_vars: |-
  166. {{ lookup('ansible.builtin.varnames', '^matrix_grafana_.+', wantlist=True) }}
  167. - name: (Deprecation) Catch and report matrix_grafana variables
  168. ansible.builtin.fail:
  169. msg: >-
  170. 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.
  171. The new role is compatible with the old one, but uses different names for its variables.
  172. Please rename all variables (`matrix_grafana_` -> `grafana_`) on your configuration file (vars.yml).
  173. 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.
  174. The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_grafana_migration_vars.keys() | join(', ') }}
  175. when: "matrix_playbook_migration_grafana_migration_vars | length > 0"
  176. - when: matrix_playbook_migration_matrix_ntfy_migration_validation_enabled | bool
  177. block:
  178. - ansible.builtin.set_fact:
  179. matrix_playbook_migration_ntfy_migration_vars: |-
  180. {{ lookup('ansible.builtin.varnames', '^matrix_ntfy_.+', wantlist=True) }}
  181. - name: (Deprecation) Catch and report matrix_ntfy variables
  182. ansible.builtin.fail:
  183. msg: >-
  184. 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.
  185. The new role is compatible with the old one, but uses different names for its variables.
  186. Please rename all variables (`matrix_ntfy_` -> `ntfy_`) on your configuration file (vars.yml).
  187. 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.
  188. The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_ntfy_migration_vars.keys() | join(', ') }}
  189. when: "matrix_playbook_migration_ntfy_migration_vars | length > 0"
  190. - when: matrix_playbook_migration_matrix_redis_migration_validation_enabled | bool
  191. block:
  192. - ansible.builtin.set_fact:
  193. matrix_playbook_migration_redis_migration_vars: |-
  194. {{ lookup('ansible.builtin.varnames', '^matrix_redis_.+', wantlist=True) }}
  195. - name: (Deprecation) Catch and report matrix_redis variables
  196. ansible.builtin.fail:
  197. msg: >-
  198. 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.
  199. The new role is compatible with the old one, but uses different names for its variables.
  200. Please rename all variables (`matrix_redis_` -> `redis_`) on your configuration file (vars.yml).
  201. 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.
  202. The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_redis_migration_vars.keys() | join(', ') }}
  203. when: "matrix_playbook_migration_redis_migration_vars | length > 0"
  204. - when: matrix_playbook_migration_redis_valkey_migration_validation_enabled | bool
  205. block:
  206. - ansible.builtin.set_fact:
  207. matrix_playbook_migration_redis_migration_vars: |-
  208. {{ lookup('ansible.builtin.varnames', '^redis_.+', wantlist=True) }}
  209. - name: (Deprecation) Catch and report matrix_redis variables
  210. ansible.builtin.fail:
  211. msg: >-
  212. 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.
  213. Please rename all variables (`redis_` -> `valkey_`) on your configuration file (vars.yml).
  214. 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.
  215. The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_redis_migration_vars.keys() | join(', ') }}
  216. when: "matrix_playbook_migration_redis_migration_vars | length > 0"
  217. - when: matrix_playbook_migration_keydb_valkey_migration_validation_enabled | bool
  218. block:
  219. - ansible.builtin.set_fact:
  220. matrix_playbook_migration_keydb_migration_vars: |-
  221. {{ lookup('ansible.builtin.varnames', '^keydb_.+', wantlist=True) }}
  222. - name: (Deprecation) Catch and report matrix_redis variables
  223. ansible.builtin.fail:
  224. msg: >-
  225. 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.
  226. Please rename all variables (`keydb_` -> `valkey_`) on your configuration file (vars.yml).
  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. The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_keydb_migration_vars.keys() | join(', ') }}
  229. when: "matrix_playbook_migration_keydb_migration_vars | length > 0"
  230. - when: matrix_playbook_migration_matrix_etherpad_migration_validation_enabled | bool
  231. block:
  232. - ansible.builtin.set_fact:
  233. matrix_playbook_migration_etherpad_migration_vars: |-
  234. {{ lookup('ansible.builtin.varnames', '^matrix_etherpad_.+', wantlist=True) }}
  235. - name: (Deprecation) Catch and report matrix_etherpad variables
  236. ansible.builtin.fail:
  237. msg: >-
  238. 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.
  239. The new role is compatible with the old one, but uses different names for its variables.
  240. Please rename all variables (`matrix_etherpad_` -> `etherpad_`) on your configuration file (vars.yml).
  241. 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.
  242. The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_etherpad_migration_vars.keys() | join(', ') }}
  243. when: "matrix_playbook_migration_etherpad_migration_vars | length > 0"
  244. - when: matrix_playbook_migration_matrix_aux_migration_validation_enabled | bool
  245. block:
  246. - ansible.builtin.set_fact:
  247. matrix_playbook_migration_aux_migration_vars: |-
  248. {{ lookup('ansible.builtin.varnames', '^matrix_aux_.+', wantlist=True) }}
  249. - name: (Deprecation) Catch and report matrix_aux variables
  250. ansible.builtin.fail:
  251. msg: >-
  252. 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.
  253. The new role is compatible with the old one, but uses different names for its variables.
  254. Please rename all variables (`matrix_aux_` -> `aux_`) on your configuration file (vars.yml).
  255. 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.
  256. The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_aux_migration_vars.keys() | join(', ') }}
  257. when: "matrix_playbook_migration_aux_migration_vars | length > 0"
  258. - when: matrix_playbook_migration_matrix_jitsi_migration_validation_enabled | bool
  259. block:
  260. - ansible.builtin.set_fact:
  261. matrix_playbook_migration_jitsi_migration_vars: |-
  262. {{ lookup('ansible.builtin.varnames', '^matrix_jitsi_.+', wantlist=True) }}
  263. - name: (Deprecation) Catch and report matrix_jitsi variables
  264. ansible.builtin.fail:
  265. msg: >-
  266. 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.
  267. The new role is compatible with the old one, but uses different names for its variables.
  268. Please rename all variables (`matrix_jitsi_` -> `jitsi_`) on your configuration file (vars.yml).
  269. 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.
  270. The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_jitsi_migration_vars.keys() | join(', ') }}
  271. when: "matrix_playbook_migration_jitsi_migration_vars | length > 0"
  272. - when: matrix_playbook_migration_matrix_postmoogle_migration_validation_enabled | bool
  273. block:
  274. - ansible.builtin.set_fact:
  275. matrix_playbook_migration_postmoogle_migration_vars: |-
  276. {{ lookup('ansible.builtin.varnames', '^matrix_bot_postmoogle_.+', wantlist=True) }}
  277. - name: (Deprecation) Catch and report matrix_bot_postmoogle variables
  278. ansible.builtin.fail:
  279. msg: >-
  280. Your configuration contains a variable, which now has a different name.
  281. Please rename all variables (`matrix_bot_postmoogle_` -> `matrix_postmoogle_`) on your configuration file (vars.yml).
  282. The following variables in your configuration need to be renamed: {{ matrix_playbook_migration_postmoogle_migration_vars.keys() | join(', ') }}
  283. when: "matrix_playbook_migration_postmoogle_migration_vars | length > 0"
  284. - when: matrix_playbook_migration_matrix_nginx_proxy_elimination_variable_transition_checks_enabled | bool
  285. block:
  286. - name: (Deprecation) Catch and report transitioned playbook settings during the matrix-nginx-proxy elimination
  287. ansible.builtin.fail:
  288. msg: >-
  289. Your configuration contains a variable, which now has a different name.
  290. Please rename the variable (`{{ item.old }}` -> `{{ item.new }}`) on your configuration file (vars.yml).
  291. when: "lookup('ansible.builtin.varnames', ('^' + item.old + '$'), wantlist=True) | length > 0"
  292. with_items:
  293. - {'old': 'matrix_nginx_proxy_proxy_matrix_metrics_enabled', 'new': 'matrix_metrics_exposure_enabled'}
  294. - {'old': 'matrix_nginx_proxy_proxy_matrix_metrics_basic_auth_enabled', 'new': 'matrix_metrics_exposure_http_basic_auth_enabled'}
  295. - {'old': 'matrix_nginx_proxy_proxy_matrix_metrics_basic_auth_username', 'new': '<superseded by matrix_metrics_exposure_http_basic_auth_users>'}
  296. - {'old': 'matrix_nginx_proxy_proxy_matrix_metrics_basic_auth_password', 'new': '<superseded by matrix_metrics_exposure_http_basic_auth_users>'}
  297. - {'old': 'matrix_nginx_proxy_proxy_matrix_metrics_basic_auth_raw_content', 'new': '<superseded by matrix_metrics_exposure_http_basic_auth_users>'}
  298. - {'old': 'matrix_nginx_proxy_proxy_matrix_metrics_additional_location_configuration_blocks', 'new': '<superseded by adding labels to each individual service that you care about>'}
  299. - {'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>'}
  300. - {'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>'}
  301. - {'old': 'matrix_well_known_matrix_server_enabled', 'new': 'matrix_static_files_file_matrix_server_enabled'}
  302. - {'old': 'matrix_well_known_matrix_support_enabled', 'new': 'matrix_static_files_file_matrix_support_enabled'}
  303. - {'old': 'matrix_homeserver_admin_contacts', 'new': 'matrix_static_files_file_matrix_support_property_m_contacts'}
  304. - {'old': 'matrix_homeserver_support_url', 'new': 'matrix_static_files_file_matrix_support_property_m_support_page'}
  305. - {'old': 'matrix_well_known_matrix_client_io_element_e2ee_default', 'new': 'matrix_static_files_file_matrix_client_property_io_element_e2ee_default'}
  306. - {'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'}
  307. - {'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'}
  308. - {'old': 'matrix_well_known_matrix_client_configuration_extension_json', 'new': 'matrix_static_files_file_matrix_client_configuration_extension_json'}
  309. - {'old': 'matrix_well_known_matrix_server_configuration_extension_json', 'new': 'matrix_static_files_file_matrix_server_configuration_extension_json'}
  310. - {'old': 'matrix_well_known_matrix_support_configuration_extension_json', 'new': 'matrix_static_files_file_matrix_support_configuration_extension_json'}
  311. - {'old': 'matrix_nginx_proxy_self_check_validate_certificates', 'new': 'matrix_static_files_self_check_validate_certificates'}
  312. - {'old': 'matrix_nginx_proxy_self_check_well_known_matrix_client_follow_redirects', 'new': 'matrix_static_files_self_check_well_known_matrix_client_follow_redirects'}
  313. - {'old': 'matrix_nginx_proxy_base_domain_serving_enabled', 'new': 'matrix_static_files_container_labels_base_domain_enabled'}
  314. - {'old': 'matrix_nginx_proxy_base_domain_hostname', 'new': 'matrix_static_files_container_labels_base_domain_traefik_hostname'}
  315. - {'old': 'matrix_nginx_proxy_base_domain_homepage_enabled', 'new': 'matrix_static_files_file_index_html_enabled'}
  316. - {'old': 'matrix_nginx_proxy_base_domain_homepage_template', 'new': 'matrix_static_files_file_index_html_template'}
  317. - {'old': 'matrix_nginx_proxy_base_domain_create_directory', 'new': '<no longer necessary; see matrix_static_files_file_index_html_enabled>'}
  318. - {'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>'}
  319. - {'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>'}
  320. - {'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>'}
  321. - {'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>'}
  322. - {'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'}
  323. - {'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>'}
  324. - {'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'}
  325. - {'old': 'matrix_nginx_proxy_proxy_matrix_identity_api_enabled', 'new': '<removed>'}
  326. - {'old': 'matrix_nginx_proxy_proxy_matrix_identity_api_addr_with_container', 'new': '<removed>'}
  327. - {'old': 'matrix_nginx_proxy_proxy_matrix_identity_api_addr_sans_container', 'new': '<removed>'}
  328. - {'old': 'matrix_nginx_proxy_proxy_matrix_user_directory_search_enabled', 'new': '<removed>'}
  329. - {'old': 'matrix_nginx_proxy_proxy_matrix_user_directory_search_addr_with_container', 'new': '<removed>'}
  330. - {'old': 'matrix_nginx_proxy_proxy_matrix_user_directory_search_addr_sans_container', 'new': '<removed>'}
  331. - {'old': 'matrix_nginx_proxy_proxy_matrix_user_directory_search_v3_to_r0_redirect_enabled', 'new': '<removed>'}
  332. - {'old': 'matrix_nginx_proxy_proxy_matrix_3pid_registration_enabled', 'new': '<removed>'}
  333. - {'old': 'matrix_nginx_proxy_proxy_matrix_3pid_registration_addr_with_container', 'new': '<removed>'}
  334. - {'old': 'matrix_nginx_proxy_proxy_matrix_3pid_registration_addr_sans_container', 'new': '<removed>'}
  335. - {'old': 'matrix_nginx_proxy_proxy_matrix_3pid_registration_v3_to_r0_redirect_enabled', 'new': '<removed>'}
  336. - {'old': 'matrix_nginx_proxy_proxy_conduit_enabled', 'new': 'matrix_conduit_container_labels_traefik_enabled'}
  337. - {'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>'}
  338. - {'old': 'matrix_nginx_proxy_proxy_conduit_federation_api_enabled', 'new': 'matrix_conduit_container_labels_public_federation_api_enabled'}
  339. - {'old': 'matrix_nginx_proxy_proxy_conduit_client_api_addr_with_container', 'new': '<removed>'}
  340. - {'old': 'matrix_nginx_proxy_proxy_conduit_client_api_addr_sans_container', 'new': '<removed>'}
  341. - {'old': 'matrix_nginx_proxy_proxy_conduit_federation_api_addr_with_container', 'new': '<removed>'}
  342. - {'old': 'matrix_nginx_proxy_proxy_conduit_federation_api_addr_sans_container', 'new': '<removed>'}
  343. - {'old': 'matrix_nginx_proxy_proxy_conduit_additional_server_configuration_blocks', 'new': '<removed>'}
  344. - {'old': 'matrix_nginx_proxy_proxy_dendrite_enabled', 'new': 'matrix_dendrite_container_labels_traefik_enabled'}
  345. - {'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>'}
  346. - {'old': 'matrix_nginx_proxy_proxy_dendrite_federation_api_enabled', 'new': 'matrix_dendrite_container_labels_public_federation_api_enabled'}
  347. - {'old': 'matrix_nginx_proxy_proxy_dendrite_client_api_addr_with_container', 'new': '<removed>'}
  348. - {'old': 'matrix_nginx_proxy_proxy_dendrite_client_api_addr_sans_container', 'new': '<removed>'}
  349. - {'old': 'matrix_nginx_proxy_proxy_dendrite_federation_api_addr_with_container', 'new': '<removed>'}
  350. - {'old': 'matrix_nginx_proxy_proxy_dendrite_federation_api_addr_sans_container', 'new': '<removed>'}
  351. - {'old': 'matrix_nginx_proxy_proxy_dendrite_additional_server_configuration_blocks', 'new': '<removed>'}
  352. - {'old': 'matrix_nginx_proxy_proxy_synapse_enabled', 'new': 'matrix_synapse_container_labels_traefik_enabled'}
  353. - {'old': 'matrix_nginx_proxy_proxy_synapse_federation_api_enabled', 'new': 'matrix_synapse_container_labels_public_federation_api_enabled'}
  354. - {'old': 'matrix_nginx_proxy_proxy_synapse_client_api_addr_with_container', 'new': '<removed>'}
  355. - {'old': 'matrix_nginx_proxy_proxy_synapse_client_api_addr_sans_container', 'new': '<removed>'}
  356. - {'old': 'matrix_nginx_proxy_proxy_synapse_federation_api_addr_with_container', 'new': '<removed>'}
  357. - {'old': 'matrix_nginx_proxy_proxy_synapse_federation_api_addr_sans_container', 'new': '<removed>'}
  358. - {'old': 'matrix_nginx_proxy_proxy_synapse_additional_server_configuration_blocks', 'new': '<removed>'}
  359. - {'old': 'matrix_nginx_proxy_proxy_matrix_additional_server_configuration_blocks', 'new': '<removed>'}
  360. - {'old': 'matrix_nginx_proxy_access_log_enabled', 'new': 'traefik_config_accessLog_enabled'}
  361. - {'old': 'matrix_nginx_proxy_container_labels_traefik_proxy_matrix_federation_hostname', 'new': 'matrix_server_fqn_matrix_federation'}
  362. - {'old': 'etherpad_nginx_proxy_dimension_integration_enabled', 'new': '<removed>'}
  363. - {'old': 'etherpad_nginx_proxy_dimension_integration_path_prefix', 'new': '<removed>'}
  364. - {'old': 'matrix_prometheus_services_proxy_connect_prometheus_node_exporter_metrics_proxying_enabled', 'new': '<removed>'}
  365. - {'old': 'matrix_prometheus_services_proxy_connect_prometheus_node_exporter_matrix_nginx_proxy_not_enabled_proxy_pass_host', 'new': '<removed>'}
  366. - {'old': 'matrix_prometheus_services_proxy_connect_prometheus_postgres_exporter_metrics_proxying_enabled', 'new': '<removed>'}
  367. - {'old': 'matrix_prometheus_services_proxy_connect_prometheus_postgres_exporter_matrix_nginx_proxy_not_enabled_proxy_pass_host', 'new': '<removed>'}
  368. - {'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.>'}
  369. - {'old': 'matrix_playbook_ssl_retrieval_method', 'new': '<removed; see docs/configuring-playbook-ssl-certificates.md for alternatives>'}
  370. - {'old': 'matrix_ssl_lets_encrypt_support_email', 'new': 'traefik_config_certificatesResolvers_acme_email'}
  371. - {'old': 'matrix_federation_traefik_entrypoint', 'new': 'matrix_federation_traefik_entrypoint_name'}
  372. - when: matrix_playbook_migration_matrix_nginx_proxy_leftover_variable_validation_checks_enabled | bool
  373. block:
  374. - ansible.builtin.set_fact:
  375. matrix_playbook_migration_nginx_proxy_migration_vars: |-
  376. {{ lookup('ansible.builtin.varnames', '^matrix_nginx_proxy_.+', wantlist=True) }}
  377. - name: (Deprecation) Catch and report leftover matrix_nginx_proxy variables
  378. ansible.builtin.fail:
  379. msg: >-
  380. The matrix-nginx-proxy role that used to be part of this playbook has been removed.
  381. You should remove all its variables (`matrix_nginx_proxy_*`) from your configuration file (vars.yml).
  382. The following variables in your configuration should be renamed: {{ matrix_playbook_migration_nginx_proxy_migration_vars.keys() | join(', ') }}
  383. when: "matrix_playbook_migration_nginx_proxy_migration_vars | length > 0"
  384. - when: matrix_playbook_migration_matrix_ssl_leftover_variable_checks_enabled | bool
  385. block:
  386. - ansible.builtin.set_fact:
  387. matrix_playbook_migration_ssl_migration_vars: |-
  388. {{ lookup('ansible.builtin.varnames', '^matrix_ssl_.+', wantlist=True) }}
  389. - name: (Deprecation) Catch and report matrix_ssl variables
  390. ansible.builtin.fail:
  391. msg: >-
  392. The matrix-nginx-proxy role that used to be part of this playbook has been removed.
  393. You should remove all its variables (`matrix_ssl_*`) from your configuration file (vars.yml).
  394. The following variables in your configuration should be renamed: {{ matrix_playbook_migration_ssl_migration_vars.keys() | join(', ') }}
  395. when: "matrix_playbook_migration_ssl_migration_vars | length > 0"
  396. - block:
  397. - ansible.builtin.set_fact:
  398. matrix_playbook_migration_matrix_synapse_container_labels_public_client_synapse_oidc_vars: |-
  399. {{ lookup('ansible.builtin.varnames', '^matrix_synapse_container_labels_public_client_synapse_oidc_.+', wantlist=True) }}
  400. - name: (Deprecation) Catch and report matrix_ssl variables
  401. ansible.builtin.fail:
  402. msg: >-
  403. 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(', ') }}
  404. when: "matrix_playbook_migration_matrix_synapse_container_labels_public_client_synapse_oidc_vars | length > 0"
  405. - block:
  406. - ansible.builtin.set_fact:
  407. matrix_playbook_migration_matrix_synapse_reverse_proxy_companion_container_labels_public_client_synapse_oidc_vars: |-
  408. {{ lookup('ansible.builtin.varnames', '^matrix_synapse_reverse_proxy_companion_container_labels_public_client_synapse_oidc_.+', wantlist=True) }}
  409. - name: (Deprecation) Catch and report matrix_ssl variables
  410. ansible.builtin.fail:
  411. msg: >-
  412. 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(', ') }}
  413. when: "matrix_playbook_migration_matrix_synapse_reverse_proxy_companion_container_labels_public_client_synapse_oidc_vars | length > 0"
  414. - name: (Deprecation) Catch and report devture_postgres_backup variables
  415. ansible.builtin.fail:
  416. msg: |-
  417. 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).
  418. The new role is pretty much the same, but uses differently named variables.
  419. Please rename all `devture_postgres_backup_`-prefixed variables (`devture_postgres_backup_*` -> `postgres_backup_*`) on your configuration file (vars.yml).
  420. 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.
  421. The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^devture_postgres_backup_.+', wantlist=True) | join(', ') }}
  422. when: "lookup('ansible.builtin.varnames', '^devture_postgres_backup_.+', wantlist=True) | length > 0"
  423. - name: (Deprecation) Catch and report devture_postgres variables
  424. ansible.builtin.fail:
  425. msg: |-
  426. The Postgres role in the playbook now lives under the MASH organization (https://github.com/mother-of-all-self-hosting/ansible-role-postgres).
  427. The new role is pretty much the same, but uses differently named variables.
  428. Please rename all `devture_postgres_`-prefixed variables (`devture_postgres_*` -> `postgres_*`) on your configuration file (vars.yml).
  429. 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.
  430. The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^devture_postgres_.+', wantlist=True) | join(', ') }}
  431. when: "lookup('ansible.builtin.varnames', '^devture_postgres_.+', wantlist=True) | length > 0"
  432. - name: (Deprecation) Catch and report traefik_certs_dumper variables
  433. ansible.builtin.fail:
  434. msg: |-
  435. 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).
  436. The new role is pretty much the same, but uses differently named variables.
  437. Please rename all `devture_traefik_certs_dumper_`-prefixed variables (`devture_traefik_certs_dumper_*` -> `traefik_certs_dumper_*`) on your configuration file (vars.yml).
  438. 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.
  439. The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^devture_traefik_certs_dumper_.+', wantlist=True) | join(', ') }}
  440. when: "lookup('ansible.builtin.varnames', '^devture_traefik_certs_dumper_.+', wantlist=True) | length > 0"
  441. - name: (Deprecation) Catch and report devture_traefik variables
  442. ansible.builtin.fail:
  443. msg: |-
  444. The traefik role in the playbook now lives under the MASH organization (https://github.com/mother-of-all-self-hosting/ansible-role-traefik).
  445. The new role is pretty much the same, but uses differently named variables.
  446. Please rename all `devture_traefik_`-prefixed variables (`devture_traefik_*` -> `traefik_*`) on your configuration file (vars.yml).
  447. 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.
  448. The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^devture_traefik_.+', wantlist=True) | join(', ') }}
  449. when: "lookup('ansible.builtin.varnames', '^devture_traefik_.+', wantlist=True) | length > 0"
  450. - name: (Deprecation) Catch and report devture_container_socket_proxy variables
  451. ansible.builtin.fail:
  452. msg: |-
  453. 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).
  454. The new role is pretty much the same, but uses differently named variables.
  455. Please rename all `devture_container_socket_proxy_`-prefixed variables (`devture_container_socket_proxy_*` -> `container_socket_proxy_*`) on your configuration file (vars.yml).
  456. 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.
  457. The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^devture_container_socket_proxy_.+', wantlist=True) | join(', ') }}
  458. when: "lookup('ansible.builtin.varnames', '^devture_container_socket_proxy_.+', wantlist=True) | length > 0"
  459. - name: (Deprecation) Catch and report ma1sd variables
  460. ansible.builtin.fail:
  461. msg: |-
  462. ma1sd was completely removed from the playbook in February 2026.
  463. Please remove all `matrix_ma1sd_*` variables from your configuration file (vars.yml).
  464. You may also wish to uninstall the component manually. See `docs/configuring-playbook-ma1sd.md` for more information.
  465. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_ma1sd_.+', wantlist=True) | join(', ') }}
  466. when: "lookup('ansible.builtin.varnames', '^matrix_ma1sd_.+', wantlist=True) | length > 0"
  467. - name: (Deprecation) Catch and report matrix-appservice-slack variables
  468. ansible.builtin.fail:
  469. msg: |-
  470. matrix-appservice-slack was completely removed from the playbook in February 2026.
  471. Please remove all `matrix_appservice_slack_*` variables from your configuration file (vars.yml).
  472. You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-appservice-slack.md` for more information.
  473. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_appservice_slack_.+', wantlist=True) | join(', ') }}
  474. 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.
  475. when: "lookup('ansible.builtin.varnames', '^matrix_appservice_slack_.+', wantlist=True) | length > 0"
  476. - name: (Deprecation) Catch and report matrix-appservice-webhooks variables
  477. ansible.builtin.fail:
  478. msg: |-
  479. matrix-appservice-webhooks was completely removed from the playbook in November 2025.
  480. Please remove all `matrix_appservice_webhooks_*` variables from your configuration file (vars.yml).
  481. You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-appservice-webhooks.md` for more information.
  482. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_appservice_webhooks_.+', wantlist=True) | join(', ') }}
  483. when: "lookup('ansible.builtin.varnames', '^matrix_appservice_webhooks_.+', wantlist=True) | length > 0"
  484. - name: (Deprecation) Catch and report matrix-chatgpt-bot variables
  485. ansible.builtin.fail:
  486. msg: |-
  487. matrix-chatgpt-bot was completely removed from the playbook in November 2025.
  488. Please remove all `matrix_bot_chatgpt_*` variables from your configuration file (vars.yml).
  489. You may also wish to uninstall the bot manually. See `docs/configuring-playbook-bot-chatgpt.md` for more information.
  490. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_bot_chatgpt_.+', wantlist=True) | join(', ') }}
  491. when: "lookup('ansible.builtin.varnames', '^matrix_bot_chatgpt_.+', wantlist=True) | length > 0"
  492. - name: (Deprecation) Catch and report matrix-client-cinny variables
  493. ansible.builtin.fail:
  494. msg: |-
  495. 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).
  496. The new role is pretty much the same, but uses differently named variables.
  497. Please rename all `matrix_client_cinny_`-prefixed variables (`matrix_client_cinny_*` -> `cinny_*`) on your configuration file (vars.yml).
  498. 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.
  499. The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^matrix_client_cinny_.+', wantlist=True) | join(', ') }}
  500. when: "lookup('ansible.builtin.varnames', '^matrix_client_cinny_.+', wantlist=True) | length > 0"
  501. - name: (Deprecation) Catch and report matrix-client-hydrogen variables
  502. ansible.builtin.fail:
  503. msg: |-
  504. 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).
  505. The new role is pretty much the same, but uses differently named variables.
  506. Please rename all `matrix_client_hydrogen_`-prefixed variables (`matrix_client_hydrogen_*` -> `hydrogen_*`) on your configuration file (vars.yml).
  507. 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.
  508. The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^matrix_client_hydrogen_.+', wantlist=True) | join(', ') }}
  509. when: "lookup('ansible.builtin.varnames', '^matrix_client_hydrogen_.+', wantlist=True) | length > 0"
  510. - name: (Deprecation) Catch and report matrix-coturn variables
  511. ansible.builtin.fail:
  512. msg: |-
  513. The matrix-coturn role in the playbook now lives under the MASH organization (https://github.com/mother-of-all-self-hosting/ansible-role-coturn).
  514. The new role is pretty much the same, but uses differently named variables.
  515. Please rename all `matrix_coturn_`-prefixed variables (`matrix_coturn_*` -> `coturn_*`) on your configuration file (vars.yml).
  516. 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.
  517. The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^matrix_coturn_.+', wantlist=True) | join(', ') }}
  518. when: "lookup('ansible.builtin.varnames', '^matrix_coturn_.+', wantlist=True) | length > 0"
  519. - name: (Deprecation) Catch and report matrix-conduwuit variables
  520. ansible.builtin.fail:
  521. msg: |-
  522. matrix-conduwuit was completely removed from the playbook in February 2026.
  523. Please remove all `matrix_conduwuit*` variables from your configuration file (vars.yml).
  524. You may wish to migrate to Continuwuity, a drop-in replacement for conduwuit. See `docs/configuring-playbook-continuwuity.md` for more information.
  525. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_conduwuit.+', wantlist=True) | join(', ') }}
  526. when: "lookup('ansible.builtin.varnames', '^matrix_conduwuit.+', wantlist=True) | length > 0"
  527. - name: (Deprecation) Catch and report matrix-dynamic-dns variables
  528. ansible.builtin.fail:
  529. msg: |-
  530. 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).
  531. The new role is pretty much the same, but uses differently named variables.
  532. Please rename all `matrix_dynamic_dns_`-prefixed variables (`matrix_dynamic_dns_*` -> `ddclient_*`) on your configuration file (vars.yml).
  533. 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.
  534. The following variables in your configuration need to be renamed: {{ lookup('ansible.builtin.varnames', '^matrix_dynamic_dns_.+', wantlist=True) | join(', ') }}
  535. when: "lookup('ansible.builtin.varnames', '^matrix_dynamic_dns_.+', wantlist=True) | length > 0"
  536. - name: (Deprecation) Catch and report mautrix-facebook variables
  537. ansible.builtin.fail:
  538. msg: |-
  539. mautrix-facebook was completely removed from the playbook in November 2025.
  540. Please remove all `matrix_mautrix_facebook_*` variables from your configuration file (vars.yml).
  541. You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-mautrix-facebook.md` for more information.
  542. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_mautrix_facebook_.+', wantlist=True) | join(', ') }}
  543. when: "lookup('ansible.builtin.varnames', '^matrix_mautrix_facebook_.+', wantlist=True) | length > 0"
  544. - name: (Deprecation) Catch and report mautrix-hangouts variables
  545. ansible.builtin.fail:
  546. msg: |-
  547. The Google Hangouts service was discontinued on 1st of November 2022.
  548. The mautrix-hangouts bridge has been deprecated in the playbook since December 2024 and was completely removed from the playbook in February 2025.
  549. Please remove all `matrix_mautrix_hangouts_*` variables from your configuration file (vars.yml).
  550. You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-mautrix-hangouts.md` for more information.
  551. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_mautrix_hangouts_.+', wantlist=True) | join(', ') }}
  552. when: "lookup('ansible.builtin.varnames', '^matrix_mautrix_hangouts_.+', wantlist=True) | length > 0"
  553. - name: (Deprecation) Catch and report mautrix-instagram variables
  554. ansible.builtin.fail:
  555. msg: |-
  556. mautrix-instagram was completely removed from the playbook in November 2025.
  557. Please remove all `matrix_mautrix_instagram_*` variables from your configuration file (vars.yml).
  558. You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-mautrix-instagram.md` for more information.
  559. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_mautrix_instagram_.+', wantlist=True) | join(', ') }}
  560. when: "lookup('ansible.builtin.varnames', '^matrix_mautrix_instagram_.+', wantlist=True) | length > 0"
  561. - name: (Deprecation) Catch and report mx-puppet-discord variables
  562. ansible.builtin.fail:
  563. msg: |-
  564. The MX Puppet Discord bridge was completely removed from the playbook in November 2025.
  565. Please remove all `matrix_mx_puppet_discord_*` variables from your configuration file (vars.yml).
  566. You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-mx-puppet-discord.md` for more information.
  567. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_mx_puppet_discord_.+', wantlist=True) | join(', ') }}
  568. when: "lookup('ansible.builtin.varnames', '^matrix_mx_puppet_discord_.+', wantlist=True) | length > 0"
  569. - name: (Deprecation) Catch and report mx-puppet-instagram variables
  570. ansible.builtin.fail:
  571. msg: |-
  572. The MX Puppet Instagram bridge was completely removed from the playbook in November 2025.
  573. Please remove all `matrix_mx_puppet_instagram_*` variables from your configuration file (vars.yml).
  574. You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-mx-puppet-instagram.md` for more information.
  575. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_mx_puppet_instagram_.+', wantlist=True) | join(', ') }}
  576. when: "lookup('ansible.builtin.varnames', '^matrix_mx_puppet_instagram_.+', wantlist=True) | length > 0"
  577. - name: (Deprecation) Catch and report mx-puppet-slack variables
  578. ansible.builtin.fail:
  579. msg: |-
  580. The MX Puppet Slack bridge was completely removed from the playbook in November 2025.
  581. Please remove all `matrix_mx_puppet_slack_*` variables from your configuration file (vars.yml).
  582. You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-mx-puppet-slack.md` for more information.
  583. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_mx_puppet_slack_.+', wantlist=True) | join(', ') }}
  584. when: "lookup('ansible.builtin.varnames', '^matrix_mx_puppet_slack_.+', wantlist=True) | length > 0"
  585. - name: (Deprecation) Catch and report mx-puppet-twitter variables
  586. ansible.builtin.fail:
  587. msg: |-
  588. The MX Puppet Twitter bridge was completely removed from the playbook in November 2025.
  589. Please remove all `matrix_mx_puppet_twitter_*` variables from your configuration file (vars.yml).
  590. You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-mx-puppet-twitter.md` for more information.
  591. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_mx_puppet_twitter_.+', wantlist=True) | join(', ') }}
  592. when: "lookup('ansible.builtin.varnames', '^matrix_mx_puppet_twitter_.+', wantlist=True) | length > 0"
  593. - name: (Deprecation) Catch and report the Dimension integration manager variables
  594. ansible.builtin.fail:
  595. msg: |-
  596. The Dimension integration manager was completely removed from the playbook in February 2026.
  597. Please remove all `matrix_dimension_*` variables from your configuration file (vars.yml).
  598. You may also wish to uninstall the component manually. See `docs/configuring-playbook-dimension.md` for more information.
  599. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_dimension_.+', wantlist=True) | join(', ') }}
  600. when: "lookup('ansible.builtin.varnames', '^matrix_dimension_.+', wantlist=True) | length > 0"
  601. - name: (Deprecation) Catch and report Email2Matrix variables
  602. ansible.builtin.fail:
  603. msg: |-
  604. 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.
  605. Please remove all `matrix_email2matrix_*` variables from your configuration file (vars.yml).
  606. You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-email2matrix.md` for more information.
  607. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_email2matrix_.+', wantlist=True) | join(', ') }}
  608. when: "lookup('ansible.builtin.varnames', '^matrix_email2matrix_.+', wantlist=True) | length > 0"
  609. - name: (Deprecation) Catch and report go-skype-bridge variables
  610. ansible.builtin.fail:
  611. msg: |-
  612. The go-skype-bridge was completely removed from the playbook in November 2025, as Skype has been discontinued since May 2025.
  613. Please remove all `matrix_go_skype_bridge_*` variables from your configuration file (vars.yml).
  614. You may also wish to uninstall the bridge manually. See `docs/configuring-playbook-bridge-go-skype-bridge.md` for more information.
  615. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_go_skype_bridge_.+', wantlist=True) | join(', ') }}
  616. when: "lookup('ansible.builtin.varnames', '^matrix_go_skype_bridge_.+', wantlist=True) | length > 0"
  617. - name: (Deprecation) Catch and report the Sliding Sync proxy variables
  618. ansible.builtin.fail:
  619. msg: |-
  620. The Sliding Sync proxy was completely removed from the playbook in November 2025.
  621. Please remove all `matrix_sliding_sync_*` variables from your configuration file (vars.yml).
  622. You may also wish to uninstall the proxy manually. See `docs/configuring-playbook-sliding-sync-proxy.md` for more information.
  623. The following variables in your configuration need to be removed: {{ lookup('ansible.builtin.varnames', '^matrix_sliding_sync_.+', wantlist=True) | join(', ') }}
  624. when: "lookup('ansible.builtin.varnames', '^matrix_sliding_sync_.+', wantlist=True) | length > 0"