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.
 
 

1913 lines
81 KiB

  1. ---
  2. # This variables file wires together the various components (roles) used by the playbook.
  3. #
  4. # Roles used by playbook are pretty minimal and kept independent of one another as much as possible.
  5. # To deliver a turnkey fully-featured Matrix server, this playbook needs
  6. # to connect them all together. It does so by overriding role variables.
  7. #
  8. # You can also override ANY variable (seen here or in any given role),
  9. # by re-defining it in your own configuration file (`inventory/host_vars/matrix.<your-domain>`).
  10. matrix_container_global_registry_prefix: "docker.io/"
  11. ######################################################################
  12. #
  13. # matrix-base
  14. #
  15. ######################################################################
  16. matrix_identity_server_url: "{{ ('https://' + matrix_server_fqn_matrix) if matrix_ma1sd_enabled else None }}"
  17. # If Synapse workers are enabled and matrix-nginx-proxy is disabled, certain APIs may not work over 'http://matrix-synapse:8008'.
  18. # This is because we explicitly disable them for the main Synapse process.
  19. matrix_homeserver_container_url: "{{ 'http://matrix-nginx-proxy:12080' if matrix_nginx_proxy_enabled else 'http://matrix-synapse:8008' }}"
  20. ######################################################################
  21. #
  22. # /matrix-base
  23. #
  24. ######################################################################
  25. ######################################################################
  26. #
  27. # matrix-awx
  28. #
  29. ######################################################################
  30. # We don't enable AWX support by default.
  31. matrix_awx_enabled: false
  32. matrix_nginx_proxy_data_path: "{{ '/chroot/website' if (matrix_awx_enabled and not matrix_nginx_proxy_base_domain_homepage_enabled) else (matrix_nginx_proxy_base_path + '/data') }}"
  33. matrix_nginx_proxy_data_path_in_container: "{{ '/nginx-data/matrix-domain' if (matrix_awx_enabled and not matrix_nginx_proxy_base_domain_homepage_enabled) else '/nginx-data' }}"
  34. ######################################################################
  35. #
  36. # /matrix-awx
  37. #
  38. ######################################################################
  39. ######################################################################
  40. #
  41. # matrix-bridge-appservice-discord
  42. #
  43. ######################################################################
  44. # We don't enable bridges by default.
  45. matrix_appservice_discord_enabled: false
  46. # Normally, matrix-nginx-proxy is enabled and nginx can reach matrix-appservice-discord over the container network.
  47. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it, you can expose
  48. # matrix-appservice-discord's client-server port to the local host.
  49. matrix_appservice_discord_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:9005' }}"
  50. # If the homeserver disables presence, it's likely better (less wasteful) to also disable presence on the bridge side.
  51. matrix_appservice_discord_bridge_disablePresence: "{{ not matrix_synapse_presence_enabled }}"
  52. matrix_appservice_discord_systemd_required_services_list: |
  53. {{
  54. ['docker.service']
  55. +
  56. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  57. +
  58. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  59. +
  60. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  61. }}
  62. matrix_appservice_discord_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'discord.as.token') | to_uuid }}"
  63. matrix_appservice_discord_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'discord.hs.token') | to_uuid }}"
  64. # We only make this use Postgres if our own Postgres server is enabled.
  65. # It's only then (for now) that we can automatically create the necessary database and user for this service.
  66. matrix_appservice_discord_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  67. matrix_appservice_discord_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'as.discord.db') | to_uuid }}"
  68. ######################################################################
  69. #
  70. # /matrix-bridge-appservice-discord
  71. #
  72. ######################################################################
  73. ######################################################################
  74. #
  75. # matrix-appservice-webhooks
  76. #
  77. ######################################################################
  78. # We don't enable bridges by default.
  79. matrix_appservice_webhooks_enabled: false
  80. # Normally, matrix-nginx-proxy is enabled and nginx can reach matrix-appservice-webhooks over the container network.
  81. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it, you can expose
  82. # matrix-appservice-webhooks' client-server port to the local host.
  83. matrix_appservice_webhooks_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else ('127.0.0.1:' ~ matrix_appservice_webhooks_matrix_port) }}"
  84. matrix_appservice_webhooks_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'webhook.as.token') | to_uuid }}"
  85. matrix_appservice_webhooks_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'webhook.hs.token') | to_uuid }}"
  86. matrix_appservice_webhooks_id_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'webhook.id.token') | to_uuid }}"
  87. matrix_appservice_webhooks_systemd_required_services_list: |
  88. {{
  89. ['docker.service']
  90. +
  91. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  92. +
  93. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  94. }}
  95. ######################################################################
  96. #
  97. # /matrix-appservice-webhooks
  98. #
  99. ######################################################################
  100. ######################################################################
  101. #
  102. # matrix-appservice-slack
  103. #
  104. ######################################################################
  105. # We don't enable bridges by default.
  106. matrix_appservice_slack_enabled: false
  107. matrix_appservice_slack_container_self_build: "{{ matrix_architecture != 'amd64' }}"
  108. # Normally, matrix-nginx-proxy is enabled and nginx can reach matrix-appservice-slack over the container network.
  109. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it, you can expose
  110. # matrix-appservice-slack's client-server port to the local host.
  111. matrix_appservice_slack_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else ('127.0.0.1:' ~ matrix_appservice_slack_slack_port) }}"
  112. matrix_appservice_slack_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'slack.as.token') | to_uuid }}"
  113. matrix_appservice_slack_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'slack.hs.token') | to_uuid }}"
  114. matrix_appservice_slack_id_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'slack.id.token') | to_uuid }}"
  115. matrix_appservice_slack_systemd_required_services_list: |
  116. {{
  117. ['docker.service']
  118. +
  119. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  120. +
  121. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  122. }}
  123. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  124. matrix_appservice_slack_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'nedb' }}"
  125. matrix_appservice_slack_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'as.slack.db') | to_uuid }}"
  126. ######################################################################
  127. #
  128. # /matrix-bridge-appservice-slack
  129. #
  130. ######################################################################
  131. ######################################################################
  132. #
  133. # matrix-bridge-appservice-irc
  134. #
  135. ######################################################################
  136. # We don't enable bridges by default.
  137. matrix_appservice_irc_enabled: false
  138. matrix_appservice_irc_container_self_build: "{{ matrix_architecture != 'amd64' }}"
  139. # Normally, matrix-nginx-proxy is enabled and nginx can reach matrix-appservice-irc over the container network.
  140. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it, you can expose
  141. # matrix-appservice-irc's client-server port to the local host.
  142. matrix_appservice_irc_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:9999' }}"
  143. # The IRC bridge docs say that if homeserver presence is disabled, it's better to also disable
  144. # IRC bridge presence, for performance reasons.
  145. matrix_appservice_irc_homeserver_enablePresence: "{{ matrix_synapse_presence_enabled }}"
  146. matrix_appservice_irc_systemd_required_services_list: |
  147. {{
  148. ['docker.service']
  149. +
  150. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  151. +
  152. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  153. }}
  154. matrix_appservice_irc_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'irc.as.token') | to_uuid }}"
  155. matrix_appservice_irc_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'irc.hs.token') | to_uuid }}"
  156. matrix_appservice_irc_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'nedb' }}"
  157. matrix_appservice_irc_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'as.irc.db') | to_uuid }}"
  158. ######################################################################
  159. #
  160. # /matrix-bridge-appservice-irc
  161. #
  162. ######################################################################
  163. ######################################################################
  164. #
  165. # matrix-bridge-mautrix-facebook
  166. #
  167. ######################################################################
  168. # We don't enable bridges by default.
  169. matrix_mautrix_facebook_enabled: false
  170. matrix_mautrix_facebook_container_image_self_build: "{{ matrix_architecture not in ['amd64', 'arm64'] }}"
  171. matrix_mautrix_facebook_systemd_required_services_list: |
  172. {{
  173. ['docker.service']
  174. +
  175. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  176. +
  177. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  178. +
  179. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  180. }}
  181. matrix_mautrix_facebook_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'fb.as.token') | to_uuid }}"
  182. matrix_mautrix_facebook_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'fb.hs.token') | to_uuid }}"
  183. matrix_mautrix_facebook_login_shared_secret: "{{ matrix_synapse_ext_password_provider_shared_secret_auth_shared_secret if matrix_synapse_ext_password_provider_shared_secret_auth_enabled else '' }}"
  184. matrix_mautrix_facebook_bridge_presence: "{{ matrix_synapse_presence_enabled if matrix_synapse_enabled else true }}"
  185. # We'd like to force-set people with external Postgres to SQLite, so the bridge role can complain
  186. # and point them to a migration path.
  187. matrix_mautrix_facebook_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  188. matrix_mautrix_facebook_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mau.fb.db') | to_uuid }}"
  189. ######################################################################
  190. #
  191. # /matrix-bridge-mautrix-facebook
  192. #
  193. ######################################################################
  194. ######################################################################
  195. #
  196. # matrix-bridge-mautrix-hangouts
  197. #
  198. ######################################################################
  199. # We don't enable bridges by default.
  200. matrix_mautrix_hangouts_enabled: false
  201. matrix_mautrix_hangouts_container_image_self_build: "{{ matrix_architecture not in ['amd64', 'arm64'] }}"
  202. matrix_mautrix_hangouts_systemd_required_services_list: |
  203. {{
  204. ['docker.service']
  205. +
  206. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  207. +
  208. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  209. +
  210. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  211. }}
  212. matrix_mautrix_hangouts_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'ho.as.token') | to_uuid }}"
  213. matrix_mautrix_hangouts_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'ho.hs.token') | to_uuid }}"
  214. matrix_mautrix_hangouts_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:9007' }}"
  215. matrix_mautrix_hangouts_login_shared_secret: "{{ matrix_synapse_ext_password_provider_shared_secret_auth_shared_secret if matrix_synapse_ext_password_provider_shared_secret_auth_enabled else '' }}"
  216. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  217. matrix_mautrix_hangouts_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  218. matrix_mautrix_hangouts_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mau.hangouts.db') | to_uuid }}"
  219. ######################################################################
  220. #
  221. # /matrix-bridge-mautrix-hangouts
  222. #
  223. ######################################################################
  224. ######################################################################
  225. #
  226. # matrix-bridge-mautrix-instagram
  227. #
  228. ######################################################################
  229. # We don't enable bridges by default.
  230. matrix_mautrix_instagram_enabled: false
  231. matrix_mautrix_instagram_container_image_self_build: "{{ matrix_architecture not in ['amd64', 'arm64'] }}"
  232. matrix_mautrix_instagram_systemd_required_services_list: |
  233. {{
  234. ['docker.service']
  235. +
  236. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  237. +
  238. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  239. +
  240. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  241. }}
  242. matrix_mautrix_instagram_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'ig.as.token') | to_uuid }}"
  243. matrix_mautrix_instagram_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'ig.hs.token') | to_uuid }}"
  244. matrix_mautrix_instagram_login_shared_secret: "{{ matrix_synapse_ext_password_provider_shared_secret_auth_shared_secret if matrix_synapse_ext_password_provider_shared_secret_auth_enabled else '' }}"
  245. matrix_mautrix_instagram_bridge_presence: "{{ matrix_synapse_presence_enabled if matrix_synapse_enabled else true }}"
  246. # We'd like to force-set people with external Postgres to SQLite, so the bridge role can complain
  247. # and point them to a migration path.
  248. matrix_mautrix_instagram_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  249. matrix_mautrix_instagram_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mau.ig.db') | to_uuid }}"
  250. ######################################################################
  251. #
  252. # /matrix-bridge-mautrix-instagram
  253. #
  254. ######################################################################
  255. ######################################################################
  256. #
  257. # matrix-bridge-mautrix-signal
  258. #
  259. ######################################################################
  260. # We don't enable bridges by default.
  261. matrix_mautrix_signal_enabled: false
  262. matrix_mautrix_signal_systemd_required_services_list: |
  263. {{
  264. ['docker.service']
  265. +
  266. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  267. +
  268. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  269. +
  270. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  271. +
  272. ['matrix-mautrix-signal-daemon.service']
  273. }}
  274. matrix_mautrix_signal_homeserver_domain: '{{ matrix_domain }}'
  275. matrix_mautrix_signal_homeserver_address: "{{ matrix_homeserver_container_url }}"
  276. matrix_mautrix_signal_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'si.hs.token') | to_uuid }}"
  277. matrix_mautrix_signal_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'si.as.token') | to_uuid }}"
  278. matrix_mautrix_signal_login_shared_secret: "{{ matrix_synapse_ext_password_provider_shared_secret_auth_shared_secret if matrix_synapse_ext_password_provider_shared_secret_auth_enabled else '' }}"
  279. matrix_mautrix_signal_database_engine: 'postgres'
  280. matrix_mautrix_signal_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mau.signal.db') | to_uuid }}"
  281. matrix_mautrix_signal_container_self_build: "{{ matrix_architecture not in ['amd64', 'arm64'] }}"
  282. matrix_mautrix_signal_daemon_container_self_build: "{{ matrix_architecture != 'amd64' }}"
  283. ######################################################################
  284. #
  285. # /matrix-bridge-mautrix-signal
  286. #
  287. ######################################################################
  288. ######################################################################
  289. #
  290. # matrix-bridge-mautrix-telegram
  291. #
  292. ######################################################################
  293. # We don't enable bridges by default.
  294. matrix_mautrix_telegram_enabled: false
  295. # Images are multi-arch (amd64 and arm64, but not arm32).
  296. matrix_mautrix_telegram_container_self_build: "{{ matrix_architecture not in ['arm64', 'amd64'] }}"
  297. matrix_telegram_lottieconverter_container_self_build: "{{ matrix_architecture not in ['arm64', 'amd64'] }}"
  298. matrix_telegram_lottieconverter_container_self_build_mask_arch: "{{ matrix_architecture != 'amd64' }}"
  299. matrix_mautrix_telegram_systemd_required_services_list: |
  300. {{
  301. ['docker.service']
  302. +
  303. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  304. +
  305. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  306. +
  307. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  308. }}
  309. matrix_mautrix_telegram_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'telegr.as.token') | to_uuid }}"
  310. matrix_mautrix_telegram_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'telegr.hs.token') | to_uuid }}"
  311. matrix_mautrix_telegram_public_endpoint: "/{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'telegram') | to_uuid }}"
  312. matrix_mautrix_telegram_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:9006' }}"
  313. matrix_mautrix_telegram_login_shared_secret: "{{ matrix_synapse_ext_password_provider_shared_secret_auth_shared_secret if matrix_synapse_ext_password_provider_shared_secret_auth_enabled else '' }}"
  314. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  315. matrix_mautrix_telegram_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  316. matrix_mautrix_telegram_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mau.telegram.db') | to_uuid }}"
  317. ######################################################################
  318. #
  319. # /matrix-bridge-mautrix-telegram
  320. #
  321. ######################################################################
  322. ######################################################################
  323. #
  324. # matrix-bridge-mautrix-whatsapp
  325. #
  326. ######################################################################
  327. # We don't enable bridges by default.
  328. matrix_mautrix_whatsapp_enabled: false
  329. matrix_mautrix_whatsapp_systemd_required_services_list: |
  330. {{
  331. ['docker.service']
  332. +
  333. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  334. +
  335. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  336. +
  337. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  338. }}
  339. matrix_mautrix_whatsapp_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'whats.as.token') | to_uuid }}"
  340. matrix_mautrix_whatsapp_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'whats.hs.token') | to_uuid }}"
  341. matrix_mautrix_whatsapp_login_shared_secret: "{{ matrix_synapse_ext_password_provider_shared_secret_auth_shared_secret if matrix_synapse_ext_password_provider_shared_secret_auth_enabled else '' }}"
  342. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  343. matrix_mautrix_whatsapp_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  344. matrix_mautrix_whatsapp_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mauwhatsapp.db') | to_uuid }}"
  345. ######################################################################
  346. #
  347. # /matrix-bridge-mautrix-whatsapp
  348. #
  349. ######################################################################
  350. ######################################################################
  351. #
  352. # matrix-sms-bridge
  353. #
  354. ######################################################################
  355. # We don't enable bridges by default.
  356. matrix_sms_bridge_enabled: false
  357. matrix_sms_bridge_systemd_required_services_list: |
  358. {{
  359. ['docker.service']
  360. +
  361. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  362. +
  363. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  364. }}
  365. matrix_sms_bridge_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'sms.as.token') | to_uuid }}"
  366. matrix_sms_bridge_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'sms.hs.token') | to_uuid }}"
  367. ######################################################################
  368. #
  369. # /matrix-sms-bridge
  370. #
  371. ######################################################################
  372. ######################################################################
  373. #
  374. # matrix-bridge-heisenbridge
  375. #
  376. ######################################################################
  377. # We don't enable bridges by default.
  378. matrix_heisenbridge_enabled: false
  379. matrix_heisenbridge_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'heisen.as.tok') | to_uuid }}"
  380. matrix_heisenbridge_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'heisen.hs.tok') | to_uuid }}"
  381. matrix_heisenbridge_systemd_wanted_services_list: |
  382. {{
  383. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  384. +
  385. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  386. }}
  387. ######################################################################
  388. #
  389. # /matrix-bridge-heisenbridge
  390. #
  391. ######################################################################
  392. ######################################################################
  393. #
  394. # matrix-bridge-mx-puppet-skype
  395. #
  396. ######################################################################
  397. # We don't enable bridges by default.
  398. matrix_mx_puppet_skype_enabled: false
  399. matrix_mx_puppet_skype_container_image_self_build: "{{ matrix_architecture != 'amd64'}}"
  400. matrix_mx_puppet_skype_systemd_required_services_list: |
  401. {{
  402. ['docker.service']
  403. +
  404. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  405. +
  406. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  407. +
  408. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  409. }}
  410. matrix_mx_puppet_skype_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'skype.as.tok') | to_uuid }}"
  411. matrix_mx_puppet_skype_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'skype.hs.tok') | to_uuid }}"
  412. matrix_mx_puppet_skype_login_shared_secret: "{{ matrix_synapse_ext_password_provider_shared_secret_auth_shared_secret if matrix_synapse_ext_password_provider_shared_secret_auth_enabled else '' }}"
  413. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  414. matrix_mx_puppet_skype_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  415. matrix_mx_puppet_skype_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxpup.skype.db') | to_uuid }}"
  416. ######################################################################
  417. #
  418. # /matrix-bridge-mx-puppet-skype
  419. #
  420. ######################################################################
  421. ######################################################################
  422. #
  423. # matrix-bridge-mx-puppet-slack
  424. #
  425. ######################################################################
  426. # We don't enable bridges by default.
  427. matrix_mx_puppet_slack_enabled: false
  428. matrix_mx_puppet_slack_container_image_self_build: "{{ matrix_architecture != 'amd64'}}"
  429. matrix_mx_puppet_slack_systemd_required_services_list: |
  430. {{
  431. ['docker.service']
  432. +
  433. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  434. +
  435. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  436. +
  437. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  438. }}
  439. matrix_mx_puppet_slack_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxslk.as.tok') | to_uuid }}"
  440. matrix_mx_puppet_slack_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxslk.hs.tok') | to_uuid }}"
  441. matrix_mx_puppet_slack_login_shared_secret: "{{ matrix_synapse_ext_password_provider_shared_secret_auth_shared_secret if matrix_synapse_ext_password_provider_shared_secret_auth_enabled else '' }}"
  442. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  443. matrix_mx_puppet_slack_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  444. matrix_mx_puppet_slack_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxpup.slack.db') | to_uuid }}"
  445. ######################################################################
  446. #
  447. # /matrix-bridge-mx-puppet-slack
  448. #
  449. ######################################################################
  450. ######################################################################
  451. #
  452. # matrix-bridge-mx-puppet-twitter
  453. #
  454. ######################################################################
  455. # We don't enable bridges by default.
  456. matrix_mx_puppet_twitter_enabled: false
  457. matrix_mx_puppet_twitter_container_image_self_build: "{{ matrix_architecture != 'amd64'}}"
  458. matrix_mx_puppet_twitter_systemd_required_services_list: |
  459. {{
  460. ['docker.service']
  461. +
  462. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  463. +
  464. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  465. +
  466. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  467. }}
  468. matrix_mx_puppet_twitter_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxtwt.as.tok') | to_uuid }}"
  469. matrix_mx_puppet_twitter_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxtwt.hs.tok') | to_uuid }}"
  470. matrix_mx_puppet_twitter_login_shared_secret: "{{ matrix_synapse_ext_password_provider_shared_secret_auth_shared_secret if matrix_synapse_ext_password_provider_shared_secret_auth_enabled else '' }}"
  471. matrix_mx_puppet_twitter_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else ('127.0.0.1:' ~ matrix_mx_puppet_twitter_appservice_port) }}"
  472. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  473. matrix_mx_puppet_twitter_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  474. matrix_mx_puppet_twitter_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxpup.twitter.db') | to_uuid }}"
  475. ######################################################################
  476. #
  477. # /matrix-bridge-mx-puppet-twitter
  478. #
  479. ######################################################################
  480. ######################################################################
  481. #
  482. # matrix-bridge-mx-puppet-instagram
  483. #
  484. ######################################################################
  485. # We don't enable bridges by default.
  486. matrix_mx_puppet_instagram_enabled: false
  487. matrix_mx_puppet_instagram_container_image_self_build: "{{ matrix_architecture != 'amd64'}}"
  488. matrix_mx_puppet_instagram_systemd_required_services_list: |
  489. {{
  490. ['docker.service']
  491. +
  492. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  493. +
  494. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  495. +
  496. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  497. }}
  498. matrix_mx_puppet_instagram_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxig.as.tok') | to_uuid }}"
  499. matrix_mx_puppet_instagram_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxig.hs.tok') | to_uuid }}"
  500. matrix_mx_puppet_instagram_login_shared_secret: "{{ matrix_synapse_ext_password_provider_shared_secret_auth_shared_secret if matrix_synapse_ext_password_provider_shared_secret_auth_enabled else '' }}"
  501. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  502. matrix_mx_puppet_instagram_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  503. matrix_mx_puppet_instagram_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxpup.ig.db') | to_uuid }}"
  504. ######################################################################
  505. #
  506. # /matrix-bridge-mx-puppet-instagram
  507. #
  508. ######################################################################
  509. ######################################################################
  510. #
  511. # matrix-bridge-mx-puppet-discord
  512. #
  513. ######################################################################
  514. # We don't enable bridges by default.
  515. matrix_mx_puppet_discord_enabled: false
  516. matrix_mx_puppet_discord_container_image_self_build: "{{ matrix_architecture != 'amd64'}}"
  517. matrix_mx_puppet_discord_systemd_required_services_list: |
  518. {{
  519. ['docker.service']
  520. +
  521. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  522. +
  523. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  524. +
  525. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  526. }}
  527. matrix_mx_puppet_discord_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxdsc.as.tok') | to_uuid }}"
  528. matrix_mx_puppet_discord_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxdsc.hs.tok') | to_uuid }}"
  529. matrix_mx_puppet_discord_login_shared_secret: "{{ matrix_synapse_ext_password_provider_shared_secret_auth_shared_secret if matrix_synapse_ext_password_provider_shared_secret_auth_enabled else '' }}"
  530. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  531. matrix_mx_puppet_discord_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  532. matrix_mx_puppet_discord_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxpup.dsc.db') | to_uuid }}"
  533. ######################################################################
  534. #
  535. # /matrix-bridge-mx-puppet-discord
  536. #
  537. ######################################################################
  538. ######################################################################
  539. #
  540. # matrix-bridge-mx-puppet-steam
  541. #
  542. ######################################################################
  543. # We don't enable bridges by default.
  544. matrix_mx_puppet_steam_enabled: false
  545. matrix_mx_puppet_steam_container_image_self_build: "{{ matrix_architecture != 'amd64'}}"
  546. matrix_mx_puppet_steam_systemd_required_services_list: |
  547. {{
  548. ['docker.service']
  549. +
  550. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  551. +
  552. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  553. +
  554. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  555. }}
  556. matrix_mx_puppet_steam_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxste.as.tok') | to_uuid }}"
  557. matrix_mx_puppet_steam_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxste.hs.tok') | to_uuid }}"
  558. matrix_mx_puppet_steam_login_shared_secret: "{{ matrix_synapse_ext_password_provider_shared_secret_auth_shared_secret if matrix_synapse_ext_password_provider_shared_secret_auth_enabled else '' }}"
  559. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  560. matrix_mx_puppet_steam_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  561. matrix_mx_puppet_steam_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxpup.steam.db') | to_uuid }}"
  562. ######################################################################
  563. #
  564. # /matrix-bridge-mx-puppet-steam
  565. #
  566. ######################################################################
  567. ######################################################################
  568. #
  569. # matrix-bridge-mx-puppet-groupme
  570. #
  571. ######################################################################
  572. # We don't enable bridges by default.
  573. matrix_mx_puppet_groupme_enabled: false
  574. matrix_mx_puppet_groupme_container_image_self_build: "{{ matrix_architecture != 'amd64'}}"
  575. matrix_mx_puppet_groupme_systemd_required_services_list: |
  576. {{
  577. ['docker.service']
  578. +
  579. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  580. +
  581. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  582. +
  583. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  584. }}
  585. matrix_mx_puppet_groupme_appservice_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxgro.as.tok') | to_uuid }}"
  586. matrix_mx_puppet_groupme_homeserver_token: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxgro.hs.tok') | to_uuid }}"
  587. matrix_mx_puppet_groupme_login_shared_secret: "{{ matrix_synapse_ext_password_provider_shared_secret_auth_shared_secret if matrix_synapse_ext_password_provider_shared_secret_auth_enabled else '' }}"
  588. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  589. matrix_mx_puppet_groupme_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  590. matrix_mx_puppet_groupme_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mxpup.groupme.db') | to_uuid }}"
  591. ######################################################################
  592. #
  593. # /matrix-bridge-mx-puppet-groupme
  594. #
  595. ######################################################################
  596. ######################################################################
  597. #
  598. # matrix-bot-matrix-reminder-bot
  599. #
  600. ######################################################################
  601. # We don't enable bots by default.
  602. matrix_bot_matrix_reminder_bot_enabled: false
  603. matrix_bot_matrix_reminder_bot_systemd_required_services_list: |
  604. {{
  605. ['docker.service']
  606. +
  607. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  608. +
  609. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  610. +
  611. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  612. }}
  613. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  614. matrix_bot_matrix_reminder_bot_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  615. matrix_bot_matrix_reminder_bot_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'reminder.bot.db') | to_uuid }}"
  616. matrix_bot_matrix_reminder_bot_container_self_build: "{{ matrix_architecture != 'amd64' }}"
  617. ######################################################################
  618. #
  619. # /matrix-bot-matrix-reminder-bot
  620. #
  621. ######################################################################
  622. ######################################################################
  623. #
  624. # matrix-bot-go-neb
  625. #
  626. ######################################################################
  627. # We don't enable bots by default.
  628. matrix_bot_go_neb_enabled: false
  629. matrix_bot_go_neb_systemd_required_services_list: |
  630. {{
  631. ['docker.service']
  632. +
  633. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  634. +
  635. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  636. }}
  637. matrix_bot_go_neb_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:4050' }}"
  638. ######################################################################
  639. #
  640. # /matrix-bot-go-neb
  641. #
  642. ######################################################################
  643. ######################################################################
  644. #
  645. # matrix-bot-mjolnir
  646. #
  647. ######################################################################
  648. # We don't enable bots by default.
  649. matrix_bot_mjolnir_enabled: false
  650. matrix_bot_mjolnir_container_image_self_build: "{{ matrix_architecture != 'amd64'}}"
  651. matrix_bot_mjolnir_systemd_required_services_list: |
  652. {{
  653. ['docker.service']
  654. +
  655. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  656. +
  657. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  658. +
  659. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  660. }}
  661. ######################################################################
  662. #
  663. # /matrix-bot-mjolnir
  664. #
  665. ######################################################################
  666. ######################################################################
  667. #
  668. # matrix-corporal
  669. #
  670. ######################################################################
  671. matrix_corporal_enabled: false
  672. matrix_corporal_container_image_self_build: "{{ matrix_architecture != 'amd64' }}"
  673. # Normally, matrix-nginx-proxy is enabled and nginx can reach matrix-corporal over the container network.
  674. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it, you can expose
  675. # matrix-corporal's web-server ports to the local host.
  676. matrix_corporal_container_http_gateway_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:41080' }}"
  677. matrix_corporal_container_http_api_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:41081' }}"
  678. matrix_corporal_systemd_required_services_list: |
  679. {{
  680. (['docker.service'])
  681. +
  682. (['matrix-synapse.service'])
  683. }}
  684. # This goes to Synapse's vhost
  685. matrix_corporal_matrix_homeserver_api_endpoint: "{{ matrix_homeserver_container_url }}"
  686. matrix_corporal_matrix_auth_shared_secret: "{{ matrix_synapse_ext_password_provider_shared_secret_auth_shared_secret }}"
  687. # This is only useful if there's REST auth provider to make use of it.
  688. matrix_corporal_http_gateway_internal_rest_auth_enabled: "{{ matrix_synapse_ext_password_provider_rest_auth_enabled }}"
  689. matrix_corporal_matrix_registration_shared_secret: "{{ matrix_synapse_registration_shared_secret }}"
  690. ######################################################################
  691. #
  692. # /matrix-corporal
  693. #
  694. ######################################################################
  695. ######################################################################
  696. #
  697. # matrix-coturn
  698. #
  699. ######################################################################
  700. matrix_coturn_enabled: true
  701. matrix_coturn_container_image_self_build: "{{ matrix_architecture != 'amd64'}}"
  702. matrix_coturn_turn_external_ip_address: "{{ ansible_host }}"
  703. matrix_coturn_tls_enabled: "{{ matrix_ssl_retrieval_method != 'none' }}"
  704. matrix_coturn_tls_cert_path: "{{ matrix_ssl_config_dir_path }}/live/{{ matrix_server_fqn_matrix }}/fullchain.pem"
  705. matrix_coturn_tls_key_path: "{{ matrix_ssl_config_dir_path }}/live/{{ matrix_server_fqn_matrix }}/privkey.pem"
  706. matrix_coturn_container_additional_volumes: |
  707. {{
  708. ([] if matrix_ssl_retrieval_method == 'none' else [
  709. {
  710. 'src': matrix_ssl_config_dir_path,
  711. 'dst': matrix_ssl_config_dir_path,
  712. 'options': 'ro',
  713. }
  714. ])
  715. }}
  716. ######################################################################
  717. #
  718. # /matrix-coturn
  719. #
  720. ######################################################################
  721. ######################################################################
  722. #
  723. # matrix-dimension
  724. #
  725. ######################################################################
  726. matrix_dimension_enabled: false
  727. # Normally, matrix-nginx-proxy is enabled and nginx can reach Dimension over the container network.
  728. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it, you can expose
  729. # the Dimension HTTP port to the local host.
  730. matrix_dimension_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:8184' }}"
  731. matrix_integration_manager_rest_url: "{{ matrix_dimension_integrations_rest_url if matrix_dimension_enabled else None }}"
  732. matrix_integration_manager_ui_url: "{{ matrix_dimension_integrations_ui_url if matrix_dimension_enabled else None }}"
  733. matrix_dimension_systemd_required_services_list: |
  734. {{
  735. ['docker.service']
  736. +
  737. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  738. +
  739. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  740. +
  741. (['matrix-nginx-proxy.service'] if matrix_nginx_proxy_enabled else [])
  742. }}
  743. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  744. matrix_dimension_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  745. matrix_dimension_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'dimension.db') | to_uuid }}"
  746. ######################################################################
  747. #
  748. # /matrix-dimension
  749. #
  750. ######################################################################
  751. ######################################################################
  752. #
  753. # matrix-etherpad
  754. #
  755. ######################################################################
  756. matrix_etherpad_enabled: false
  757. matrix_etherpad_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:9001' }}"
  758. matrix_etherpad_systemd_required_services_list: |
  759. {{
  760. ['docker.service']
  761. +
  762. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  763. }}
  764. matrix_etherpad_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'etherpad.db') | to_uuid }}"
  765. ######################################################################
  766. #
  767. # /matrix-etherpad
  768. #
  769. ######################################################################
  770. ######################################################################
  771. #
  772. # matrix-dynamic-dns
  773. #
  774. ######################################################################
  775. matrix_dynamic_dns_enabled: false
  776. ######################################################################
  777. #
  778. # /matrix-dynamic-dns
  779. #
  780. ######################################################################
  781. ######################################################################
  782. #
  783. # matrix-email2matrix
  784. #
  785. ######################################################################
  786. matrix_email2matrix_enabled: false
  787. matrix_email2matrix_container_image_self_build: "{{ matrix_architecture != 'amd64' }}"
  788. ######################################################################
  789. #
  790. # /matrix-email2matrix
  791. #
  792. ######################################################################
  793. ######################################################################
  794. #
  795. # matrix-jitsi
  796. #
  797. ######################################################################
  798. matrix_jitsi_enabled: false
  799. # Normally, matrix-nginx-proxy is enabled and nginx can reach jitsi/web over the container network.
  800. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it, you can expose
  801. # the Jitsi HTTP port to the local host.
  802. matrix_jitsi_web_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:13080' }}"
  803. matrix_jitsi_jvb_container_colibri_ws_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:13090' }}"
  804. matrix_jitsi_prosody_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:5280' }}"
  805. matrix_jitsi_jibri_xmpp_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'jibri') | to_uuid }}"
  806. matrix_jitsi_jicofo_auth_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'jicofo') | to_uuid }}"
  807. matrix_jitsi_jvb_auth_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'jvb') | to_uuid }}"
  808. matrix_jitsi_web_stun_servers: |
  809. {{
  810. [
  811. 'stun:' + matrix_server_fqn_matrix + ':5349',
  812. 'stun:' + matrix_server_fqn_matrix + ':3478',
  813. ]
  814. if matrix_coturn_enabled
  815. else [ 'stun:meet-jit-si-turnrelay.jitsi.net:443']
  816. }}
  817. # If the self-hosted Etherpad instance is available, it will also show up in Jitsi conferences,
  818. # unless explicitly disabled by setting `matrix_jitsi_etherpad_enabled` to false.
  819. # Falls back to the scalar.vector.im etherpad in case someone sets `matrix_jitsi_etherpad_enabled` to true,
  820. # while also setting `matrix_etherpad_enabled` to false.
  821. matrix_jitsi_etherpad_enabled: "{{ matrix_etherpad_enabled }}"
  822. matrix_jitsi_etherpad_base: "{{ matrix_etherpad_base_url if matrix_etherpad_enabled else 'https://scalar.vector.im/etherpad' }}"
  823. ######################################################################
  824. #
  825. # /matrix-jitsi
  826. #
  827. ######################################################################
  828. ######################################################################
  829. #
  830. # matrix-mailer
  831. #
  832. ######################################################################
  833. # By default, this playbook sets up an exim mailer server (running in a container).
  834. # This is so that Synapse can send email reminders for unread messages.
  835. # Other services (like ma1sd), also use the mailer.
  836. matrix_mailer_enabled: true
  837. matrix_mailer_container_image_self_build: "{{ matrix_architecture != 'amd64'}}"
  838. ######################################################################
  839. #
  840. # /matrix-mailer
  841. #
  842. ######################################################################
  843. ######################################################################
  844. #
  845. # matrix-ma1sd
  846. #
  847. ######################################################################
  848. # By default, this playbook installs the ma1sd identity server on the same domain as Synapse (`matrix_server_fqn_matrix`).
  849. # If you wish to use the public identity servers (matrix.org, vector.im) instead of your own you may wish to disable this.
  850. matrix_ma1sd_enabled: true
  851. matrix_ma1sd_container_image_self_build: "{{ matrix_architecture != 'amd64' }}"
  852. # Normally, matrix-nginx-proxy is enabled and nginx can reach ma1sd over the container network.
  853. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it, you can expose
  854. # ma1sd's web-server port.
  855. matrix_ma1sd_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:8090' }}"
  856. # We enable Synapse integration via its Postgres database by default.
  857. # When using another Identity store, you might wish to disable this and define
  858. # your own configuration in `matrix_ma1sd_configuration_extension_yaml`.
  859. matrix_ma1sd_synapsesql_enabled: true
  860. matrix_ma1sd_synapsesql_type: postgresql
  861. matrix_ma1sd_synapsesql_connection: //{{ matrix_synapse_database_host }}/{{ matrix_synapse_database_database }}?user={{ matrix_synapse_database_user | urlencode() }}&password={{ matrix_synapse_database_password | urlencode() }}
  862. matrix_ma1sd_dns_overwrite_enabled: true
  863. matrix_ma1sd_dns_overwrite_homeserver_client_name: "{{ matrix_server_fqn_matrix }}"
  864. # The `matrix_ma1sd_dns_overwrite_homeserver_client_value` value when matrix_nginx_proxy_enabled is false covers the general case,
  865. # but may be inaccurate if matrix-corporal is enabled.
  866. matrix_ma1sd_dns_overwrite_homeserver_client_value: "{{ ('http://' + matrix_nginx_proxy_proxy_matrix_client_api_addr_with_container) if matrix_nginx_proxy_enabled else matrix_homeserver_container_url }}"
  867. # By default, we send mail through the `matrix-mailer` service.
  868. matrix_ma1sd_threepid_medium_email_identity_from: "{{ matrix_mailer_sender_address }}"
  869. matrix_ma1sd_threepid_medium_email_connectors_smtp_host: "matrix-mailer"
  870. matrix_ma1sd_threepid_medium_email_connectors_smtp_port: 8025
  871. matrix_ma1sd_threepid_medium_email_connectors_smtp_tls: 0
  872. matrix_ma1sd_self_check_validate_certificates: "{{ false if matrix_ssl_retrieval_method == 'self-signed' else true }}"
  873. matrix_ma1sd_systemd_required_services_list: |
  874. {{
  875. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  876. }}
  877. matrix_ma1sd_systemd_wanted_services_list: |
  878. {{
  879. (['matrix-corporal.service'] if matrix_corporal_enabled else ['matrix-synapse.service'])
  880. +
  881. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  882. +
  883. (['matrix-mailer.service'] if matrix_mailer_enabled else [])
  884. }}
  885. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  886. matrix_ma1sd_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  887. matrix_ma1sd_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'ma1sd.db') | to_uuid }}"
  888. ######################################################################
  889. #
  890. # /matrix-ma1sd
  891. #
  892. ######################################################################
  893. ######################################################################
  894. #
  895. # matrix-nginx-proxy
  896. #
  897. ######################################################################
  898. # By default, this playbook sets up a reverse-proxy nginx proxy server on TCP ports 80, 443 and 8448.
  899. # This is fine if you're dedicating the whole server to Matrix.
  900. # If that's not the case, you may wish to disable this and take care of proxying yourself.
  901. matrix_nginx_proxy_enabled: true
  902. matrix_nginx_proxy_proxy_matrix_client_api_addr_with_container: "{{ 'matrix-corporal:41080' if matrix_corporal_enabled else 'matrix-nginx-proxy:12080' }}"
  903. matrix_nginx_proxy_proxy_matrix_client_api_addr_sans_container: "{{ '127.0.0.1:41080' if matrix_corporal_enabled else '127.0.0.1:12080' }}"
  904. matrix_nginx_proxy_proxy_matrix_client_api_client_max_body_size_mb: "{{ matrix_synapse_max_upload_size_mb }}"
  905. matrix_nginx_proxy_proxy_matrix_client_api_forwarded_location_synapse_admin_api_enabled: "{{ matrix_synapse_admin_enabled }}"
  906. matrix_nginx_proxy_proxy_matrix_client_redirect_root_uri_to_domain: "{{ matrix_server_fqn_element if matrix_client_element_enabled else '' }}"
  907. matrix_nginx_proxy_proxy_matrix_enabled: true
  908. matrix_nginx_proxy_proxy_element_enabled: "{{ matrix_client_element_enabled }}"
  909. matrix_nginx_proxy_proxy_hydrogen_enabled: "{{ matrix_client_hydrogen_enabled }}"
  910. matrix_nginx_proxy_proxy_dimension_enabled: "{{ matrix_dimension_enabled }}"
  911. matrix_nginx_proxy_proxy_bot_go_neb_enabled: "{{ matrix_bot_go_neb_enabled }}"
  912. matrix_nginx_proxy_proxy_jitsi_enabled: "{{ matrix_jitsi_enabled }}"
  913. matrix_nginx_proxy_proxy_grafana_enabled: "{{ matrix_grafana_enabled }}"
  914. matrix_nginx_proxy_proxy_sygnal_enabled: "{{ matrix_sygnal_enabled }}"
  915. matrix_nginx_proxy_proxy_matrix_corporal_api_enabled: "{{ matrix_corporal_enabled and matrix_corporal_http_api_enabled }}"
  916. matrix_nginx_proxy_proxy_matrix_corporal_api_addr_with_container: "matrix-corporal:41081"
  917. matrix_nginx_proxy_proxy_matrix_corporal_api_addr_sans_container: "127.0.0.1:41081"
  918. matrix_nginx_proxy_proxy_matrix_identity_api_enabled: "{{ matrix_ma1sd_enabled }}"
  919. matrix_nginx_proxy_proxy_matrix_identity_api_addr_with_container: "matrix-ma1sd:8090"
  920. matrix_nginx_proxy_proxy_matrix_identity_api_addr_sans_container: "127.0.0.1:8090"
  921. # By default, we do TLS termination for the Matrix Federation API (port 8448) at matrix-nginx-proxy.
  922. # Unless this is handled there OR Synapse's federation listener port is disabled, we'll reverse-proxy.
  923. matrix_nginx_proxy_proxy_matrix_federation_api_enabled: "{{ matrix_synapse_federation_port_enabled and not matrix_synapse_tls_federation_listener_enabled }}"
  924. matrix_nginx_proxy_proxy_matrix_federation_api_addr_with_container: "matrix-nginx-proxy:12088"
  925. matrix_nginx_proxy_proxy_matrix_federation_api_addr_sans_container: "127.0.0.1:12088"
  926. # Settings controlling matrix-synapse-proxy.conf
  927. matrix_nginx_proxy_proxy_synapse_enabled: "{{ matrix_synapse_enabled }}"
  928. # When matrix-nginx-proxy is disabled, the actual port number that the vhost uses may begin to matter.
  929. matrix_nginx_proxy_proxy_matrix_federation_port: "{{ matrix_federation_public_port }}"
  930. matrix_nginx_proxy_container_federation_host_bind_port: "{{ matrix_federation_public_port }}"
  931. # This used to be hooked to `matrix_synapse_metrics_enabled`, but we don't do it anymore.
  932. # The fact that someone wishes to enable Synapse metrics does not necessarily mean they want to make them public.
  933. # A local Prometheus can consume them over the container network.
  934. matrix_nginx_proxy_proxy_synapse_metrics: false
  935. matrix_nginx_proxy_proxy_synapse_metrics_addr_with_container: "matrix-synapse:{{ matrix_synapse_metrics_port }}"
  936. matrix_nginx_proxy_proxy_synapse_metrics_addr_sans_container: "127.0.0.1:{{ matrix_synapse_metrics_port }}"
  937. matrix_nginx_proxy_proxy_matrix_user_directory_search_enabled: "{{ matrix_ma1sd_enabled }}"
  938. matrix_nginx_proxy_proxy_matrix_user_directory_search_addr_with_container: "{{ matrix_nginx_proxy_proxy_matrix_identity_api_addr_with_container }}"
  939. matrix_nginx_proxy_proxy_matrix_user_directory_search_addr_sans_container: "{{ matrix_nginx_proxy_proxy_matrix_identity_api_addr_sans_container }}"
  940. matrix_nginx_proxy_self_check_validate_certificates: "{{ false if matrix_ssl_retrieval_method == 'self-signed' else true }}"
  941. # OCSP stapling does not make sense when self-signed certificates are used.
  942. # See https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/1073
  943. # and https://github.com/spantaleev/matrix-docker-ansible-deploy/pull/1074
  944. matrix_nginx_proxy_ocsp_stapling_enabled: "{{ matrix_ssl_retrieval_method != 'self-signed' }}"
  945. matrix_nginx_proxy_synapse_presence_disabled: "{{ not matrix_synapse_presence_enabled }}"
  946. matrix_nginx_proxy_synapse_workers_enabled: "{{ matrix_synapse_workers_enabled }}"
  947. matrix_nginx_proxy_synapse_workers_list: "{{ matrix_synapse_workers_enabled_list }}"
  948. matrix_nginx_proxy_synapse_generic_worker_client_server_locations: "{{ matrix_synapse_workers_generic_worker_client_server_endpoints }}"
  949. matrix_nginx_proxy_synapse_generic_worker_federation_locations: "{{ matrix_synapse_workers_generic_worker_federation_endpoints }}"
  950. matrix_nginx_proxy_synapse_media_repository_locations: "{{matrix_synapse_workers_media_repository_endpoints|default([]) }}"
  951. matrix_nginx_proxy_synapse_user_dir_locations: "{{ matrix_synapse_workers_user_dir_endpoints|default([]) }}"
  952. matrix_nginx_proxy_synapse_frontend_proxy_locations: "{{ matrix_synapse_workers_frontend_proxy_endpoints|default([]) }}"
  953. matrix_nginx_proxy_systemd_wanted_services_list: |
  954. {{
  955. (['matrix-synapse.service'] if matrix_synapse_enabled else [])
  956. +
  957. (['matrix-corporal.service'] if matrix_corporal_enabled else [])
  958. +
  959. (['matrix-ma1sd.service'] if matrix_ma1sd_enabled else [])
  960. +
  961. (['matrix-client-element.service'] if matrix_client_element_enabled else [])
  962. }}
  963. matrix_ssl_domains_to_obtain_certificates_for: |
  964. {{
  965. ([matrix_server_fqn_matrix])
  966. +
  967. ([matrix_server_fqn_element] if matrix_client_element_enabled else [])
  968. +
  969. ([matrix_nginx_proxy_proxy_riot_compat_redirect_hostname] if matrix_nginx_proxy_proxy_riot_compat_redirect_enabled else [])
  970. +
  971. ([matrix_server_fqn_hydrogen] if matrix_client_hydrogen_enabled else [])
  972. +
  973. ([matrix_server_fqn_dimension] if matrix_dimension_enabled else [])
  974. +
  975. ([matrix_server_fqn_bot_go_neb] if matrix_bot_go_neb_enabled else [])
  976. +
  977. ([matrix_server_fqn_jitsi] if matrix_jitsi_enabled else [])
  978. +
  979. ([matrix_server_fqn_grafana] if matrix_grafana_enabled else [])
  980. +
  981. ([matrix_server_fqn_sygnal] if matrix_sygnal_enabled else [])
  982. +
  983. ([matrix_domain] if matrix_nginx_proxy_base_domain_serving_enabled else [])
  984. +
  985. matrix_ssl_additional_domains_to_obtain_certificates_for
  986. }}
  987. matrix_ssl_architecture: "{{
  988. {
  989. 'amd64': 'amd64',
  990. 'arm32': 'arm32v6',
  991. 'arm64': 'arm64v8',
  992. }[matrix_architecture]
  993. }}"
  994. matrix_ssl_pre_obtaining_required_service_name: "{{ 'matrix-dynamic-dns' if matrix_dynamic_dns_enabled else '' }}"
  995. ######################################################################
  996. #
  997. # /matrix-nginx-proxy
  998. #
  999. ######################################################################
  1000. ######################################################################
  1001. #
  1002. # matrix-postgres
  1003. #
  1004. ######################################################################
  1005. matrix_postgres_enabled: true
  1006. matrix_postgres_architecture: "{{ matrix_architecture }}"
  1007. # We unset this if internal Postgres disabled, which will cascade to some other variables
  1008. # and tell users they need to set it (either here or in those variables).
  1009. matrix_postgres_connection_hostname: "{{ 'matrix-postgres' if matrix_postgres_enabled else '' }}"
  1010. matrix_postgres_pgloader_container_image_self_build: "{{ matrix_architecture != 'amd64' }}"
  1011. matrix_postgres_additional_databases: |
  1012. {{
  1013. ([{
  1014. 'name': matrix_synapse_database_database,
  1015. 'username': matrix_synapse_database_user,
  1016. 'password': matrix_synapse_database_password,
  1017. }] if (matrix_synapse_enabled and matrix_synapse_database_database != matrix_postgres_db_name and matrix_synapse_database_host == 'matrix-postgres') else [])
  1018. +
  1019. ([{
  1020. 'name': matrix_ma1sd_database_name,
  1021. 'username': matrix_ma1sd_database_username,
  1022. 'password': matrix_ma1sd_database_password,
  1023. }] if (matrix_ma1sd_enabled and matrix_ma1sd_database_engine == 'postgres' and matrix_ma1sd_database_hostname == 'matrix-postgres') else [])
  1024. +
  1025. ([{
  1026. 'name': matrix_bot_matrix_reminder_bot_database_name,
  1027. 'username': matrix_bot_matrix_reminder_bot_database_username,
  1028. 'password': matrix_bot_matrix_reminder_bot_database_password,
  1029. }] if (matrix_bot_matrix_reminder_bot_enabled and matrix_bot_matrix_reminder_bot_database_engine == 'postgres' and matrix_bot_matrix_reminder_bot_database_hostname == 'matrix-postgres') else [])
  1030. +
  1031. ([{
  1032. 'name': matrix_registration_database_name,
  1033. 'username': matrix_registration_database_username,
  1034. 'password': matrix_registration_database_password,
  1035. }] if (matrix_registration_enabled and matrix_registration_database_engine == 'postgres' and matrix_registration_database_hostname == 'matrix-postgres') else [])
  1036. +
  1037. ([{
  1038. 'name': matrix_appservice_discord_database_name,
  1039. 'username': matrix_appservice_discord_database_username,
  1040. 'password': matrix_appservice_discord_database_password,
  1041. }] if (matrix_appservice_discord_enabled and matrix_appservice_discord_database_engine == 'postgres' and matrix_appservice_discord_database_hostname == 'matrix-postgres') else [])
  1042. +
  1043. ([{
  1044. 'name': matrix_appservice_slack_database_name,
  1045. 'username': matrix_appservice_slack_database_username,
  1046. 'password': matrix_appservice_slack_database_password,
  1047. }] if (matrix_appservice_slack_enabled and matrix_appservice_slack_database_engine == 'postgres' and matrix_appservice_slack_database_hostname == 'matrix-postgres') else [])
  1048. +
  1049. ([{
  1050. 'name': matrix_appservice_irc_database_name,
  1051. 'username': matrix_appservice_irc_database_username,
  1052. 'password': matrix_appservice_irc_database_password,
  1053. }] if (matrix_appservice_irc_enabled and matrix_appservice_irc_database_engine == 'postgres' and matrix_appservice_irc_database_hostname == 'matrix-postgres') else [])
  1054. +
  1055. ([{
  1056. 'name': matrix_mautrix_facebook_database_name,
  1057. 'username': matrix_mautrix_facebook_database_username,
  1058. 'password': matrix_mautrix_facebook_database_password,
  1059. }] if (matrix_mautrix_facebook_enabled and matrix_mautrix_facebook_database_engine == 'postgres' and matrix_mautrix_facebook_database_hostname == 'matrix-postgres') else [])
  1060. +
  1061. ([{
  1062. 'name': matrix_mautrix_hangouts_database_name,
  1063. 'username': matrix_mautrix_hangouts_database_username,
  1064. 'password': matrix_mautrix_hangouts_database_password,
  1065. }] if (matrix_mautrix_hangouts_enabled and matrix_mautrix_hangouts_database_engine == 'postgres' and matrix_mautrix_hangouts_database_hostname == 'matrix-postgres') else [])
  1066. +
  1067. ([{
  1068. 'name': matrix_mautrix_instagram_database_name,
  1069. 'username': matrix_mautrix_instagram_database_username,
  1070. 'password': matrix_mautrix_instagram_database_password,
  1071. }] if (matrix_mautrix_instagram_enabled and matrix_mautrix_instagram_database_engine == 'postgres' and matrix_mautrix_instagram_database_hostname == 'matrix-postgres') else [])
  1072. +
  1073. ([{
  1074. 'name': matrix_mautrix_signal_database_name,
  1075. 'username': matrix_mautrix_signal_database_username,
  1076. 'password': matrix_mautrix_signal_database_password,
  1077. }] if (matrix_mautrix_signal_enabled and matrix_mautrix_signal_database_engine == 'postgres' and matrix_mautrix_signal_database_hostname == 'matrix-postgres') else [])
  1078. +
  1079. ([{
  1080. 'name': matrix_mautrix_telegram_database_name,
  1081. 'username': matrix_mautrix_telegram_database_username,
  1082. 'password': matrix_mautrix_telegram_database_password,
  1083. }] if (matrix_mautrix_telegram_enabled and matrix_mautrix_telegram_database_engine == 'postgres' and matrix_mautrix_telegram_database_hostname == 'matrix-postgres') else [])
  1084. +
  1085. ([{
  1086. 'name': matrix_mautrix_whatsapp_database_name,
  1087. 'username': matrix_mautrix_whatsapp_database_username,
  1088. 'password': matrix_mautrix_whatsapp_database_password,
  1089. }] if (matrix_mautrix_whatsapp_enabled and matrix_mautrix_whatsapp_database_engine == 'postgres' and matrix_mautrix_whatsapp_database_hostname == 'matrix-postgres') else [])
  1090. +
  1091. ([{
  1092. 'name': matrix_mx_puppet_skype_database_name,
  1093. 'username': matrix_mx_puppet_skype_database_username,
  1094. 'password': matrix_mx_puppet_skype_database_password,
  1095. }] if (matrix_mx_puppet_skype_enabled and matrix_mx_puppet_skype_database_engine == 'postgres' and matrix_mx_puppet_skype_database_hostname == 'matrix-postgres') else [])
  1096. +
  1097. ([{
  1098. 'name': matrix_mx_puppet_slack_database_name,
  1099. 'username': matrix_mx_puppet_slack_database_username,
  1100. 'password': matrix_mx_puppet_slack_database_password,
  1101. }] if (matrix_mx_puppet_slack_enabled and matrix_mx_puppet_slack_database_engine == 'postgres' and matrix_mx_puppet_slack_database_hostname == 'matrix-postgres') else [])
  1102. +
  1103. ([{
  1104. 'name': matrix_mx_puppet_twitter_database_name,
  1105. 'username': matrix_mx_puppet_twitter_database_username,
  1106. 'password': matrix_mx_puppet_twitter_database_password,
  1107. }] if (matrix_mx_puppet_twitter_enabled and matrix_mx_puppet_twitter_database_engine == 'postgres' and matrix_mx_puppet_twitter_database_hostname == 'matrix-postgres') else [])
  1108. +
  1109. ([{
  1110. 'name': matrix_mx_puppet_instagram_database_name,
  1111. 'username': matrix_mx_puppet_instagram_database_username,
  1112. 'password': matrix_mx_puppet_instagram_database_password,
  1113. }] if (matrix_mx_puppet_instagram_enabled and matrix_mx_puppet_instagram_database_engine == 'postgres' and matrix_mx_puppet_instagram_database_hostname == 'matrix-postgres') else [])
  1114. +
  1115. ([{
  1116. 'name': matrix_mx_puppet_discord_database_name,
  1117. 'username': matrix_mx_puppet_discord_database_username,
  1118. 'password': matrix_mx_puppet_discord_database_password,
  1119. }] if (matrix_mx_puppet_discord_enabled and matrix_mx_puppet_discord_database_engine == 'postgres' and matrix_mx_puppet_discord_database_hostname == 'matrix-postgres') else [])
  1120. +
  1121. ([{
  1122. 'name': matrix_mx_puppet_steam_database_name,
  1123. 'username': matrix_mx_puppet_steam_database_username,
  1124. 'password': matrix_mx_puppet_steam_database_password,
  1125. }] if (matrix_mx_puppet_steam_enabled and matrix_mx_puppet_steam_database_engine == 'postgres' and matrix_mx_puppet_steam_database_hostname == 'matrix-postgres') else [])
  1126. +
  1127. ([{
  1128. 'name': matrix_mx_puppet_groupme_database_name,
  1129. 'username': matrix_mx_puppet_groupme_database_username,
  1130. 'password': matrix_mx_puppet_groupme_database_password,
  1131. }] if (matrix_mx_puppet_groupme_enabled and matrix_mx_puppet_groupme_database_engine == 'postgres' and matrix_mx_puppet_groupme_database_hostname == 'matrix-postgres') else [])
  1132. +
  1133. ([{
  1134. 'name': matrix_dimension_database_name,
  1135. 'username': matrix_dimension_database_username,
  1136. 'password': matrix_dimension_database_password,
  1137. }] if (matrix_dimension_enabled and matrix_dimension_database_engine == 'postgres' and matrix_dimension_database_hostname == 'matrix-postgres') else [])
  1138. +
  1139. ([{
  1140. 'name': matrix_etherpad_database_name,
  1141. 'username': matrix_etherpad_database_username,
  1142. 'password': matrix_etherpad_database_password,
  1143. }] if (matrix_etherpad_enabled and matrix_etherpad_database_engine == 'postgres' and matrix_etherpad_database_hostname == 'matrix-postgres') else [])
  1144. +
  1145. ([{
  1146. 'name': matrix_sygnal_database_name,
  1147. 'username': matrix_sygnal_database_username,
  1148. 'password': matrix_sygnal_database_password,
  1149. }] if (matrix_sygnal_enabled and matrix_sygnal_database_engine == 'postgres' and matrix_sygnal_database_hostname == 'matrix-postgres') else [])
  1150. +
  1151. ([{
  1152. 'name': matrix_prometheus_postgres_exporter_database_name,
  1153. 'username': matrix_prometheus_postgres_exporter_database_username,
  1154. 'password': matrix_prometheus_postgres_exporter_database_password,
  1155. }] if (matrix_prometheus_postgres_exporter_enabled and matrix_prometheus_postgres_exporter_database_hostname == 'matrix-postgres') else [])
  1156. }}
  1157. matrix_postgres_import_roles_to_ignore: |
  1158. {{
  1159. [matrix_postgres_connection_username]
  1160. +
  1161. matrix_postgres_additional_databases|map(attribute='username')|list
  1162. }}
  1163. matrix_postgres_import_databases_to_ignore: |
  1164. {{
  1165. [matrix_postgres_db_name]
  1166. +
  1167. matrix_postgres_additional_databases|map(attribute='name')|list
  1168. }}
  1169. ######################################################################
  1170. #
  1171. # /matrix-postgres
  1172. #
  1173. ######################################################################
  1174. ######################################################################
  1175. #
  1176. # matrix-sygnal
  1177. #
  1178. ######################################################################
  1179. # Most people don't need their own push-server, because they also need their own app to utilize it from.
  1180. matrix_sygnal_enabled: false
  1181. # If someone instals Prometheus via the playbook, they most likely wish to monitor Sygnal.
  1182. matrix_sygnal_metrics_prometheus_enabled: "{{ matrix_prometheus_enabled }}"
  1183. matrix_sygnal_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:6000' }}"
  1184. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  1185. matrix_sygnal_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  1186. matrix_sygnal_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'sygnal') | to_uuid }}"
  1187. ######################################################################
  1188. #
  1189. # /matrix-sygnal
  1190. #
  1191. ######################################################################
  1192. ######################################################################
  1193. #
  1194. # matrix-redis
  1195. #
  1196. ######################################################################
  1197. matrix_redis_enabled: "{{ matrix_synapse_workers_enabled }}"
  1198. ######################################################################
  1199. #
  1200. # /matrix-redis
  1201. #
  1202. ######################################################################
  1203. ######################################################################
  1204. #
  1205. # matrix-client-element
  1206. #
  1207. ######################################################################
  1208. # By default, this playbook installs the Element web UI on the `matrix_server_fqn_element` domain.
  1209. # If you wish to connect to your Matrix server by other means, you may wish to disable this.
  1210. matrix_client_element_enabled: true
  1211. matrix_client_element_container_image_self_build: "{{ matrix_architecture != 'amd64' }}"
  1212. # Normally, matrix-nginx-proxy is enabled and nginx can reach Element over the container network.
  1213. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it, you can expose
  1214. # the Element HTTP port to the local host.
  1215. matrix_client_element_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:8765' }}"
  1216. matrix_client_element_default_hs_url: "{{ matrix_homeserver_url }}"
  1217. matrix_client_element_default_is_url: "{{ matrix_identity_server_url }}"
  1218. # Use Dimension if enabled, otherwise fall back to Scalar
  1219. matrix_client_element_integrations_ui_url: "{{ matrix_dimension_integrations_ui_url if matrix_dimension_enabled else 'https://scalar.vector.im/' }}"
  1220. matrix_client_element_integrations_rest_url: "{{ matrix_dimension_integrations_rest_url if matrix_dimension_enabled else 'https://scalar.vector.im/api' }}"
  1221. matrix_client_element_integrations_widgets_urls: "{{ matrix_dimension_integrations_widgets_urls if matrix_dimension_enabled else ['https://scalar.vector.im/api'] }}"
  1222. matrix_client_element_integrations_jitsi_widget_url: "{{ matrix_dimension_integrations_jitsi_widget_url if matrix_dimension_enabled else 'https://scalar.vector.im/api/widgets/jitsi.html' }}"
  1223. matrix_client_element_self_check_validate_certificates: "{{ false if matrix_ssl_retrieval_method == 'self-signed' else true }}"
  1224. matrix_client_element_registration_enabled: "{{ matrix_synapse_enable_registration }}"
  1225. matrix_client_element_enable_presence_by_hs_url: |
  1226. {{
  1227. none
  1228. if matrix_synapse_presence_enabled
  1229. else {matrix_client_element_default_hs_url: false}
  1230. }}
  1231. matrix_client_element_welcome_user_id: ~
  1232. matrix_client_element_jitsi_preferredDomain: "{{ matrix_server_fqn_jitsi if matrix_jitsi_enabled else '' }}"
  1233. ######################################################################
  1234. #
  1235. # /matrix-client-element
  1236. #
  1237. ######################################################################
  1238. ######################################################################
  1239. #
  1240. # matrix-client-hydrogen
  1241. #
  1242. ######################################################################
  1243. matrix_client_hydrogen_enabled: false
  1244. # Normally, matrix-nginx-proxy is enabled and nginx can reach Hydrogen over the container network.
  1245. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it, you can expose
  1246. # the HTTP port to the local host.
  1247. matrix_client_hydrogen_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:8768' }}"
  1248. matrix_client_hydrogen_default_hs_url: "{{ matrix_homeserver_url }}"
  1249. matrix_client_hydrogen_self_check_validate_certificates: "{{ false if matrix_ssl_retrieval_method == 'self-signed' else true }}"
  1250. ######################################################################
  1251. #
  1252. # /matrix-client-hydrogen
  1253. #
  1254. ######################################################################
  1255. ######################################################################
  1256. #
  1257. # matrix-synapse
  1258. #
  1259. ######################################################################
  1260. matrix_synapse_container_image_self_build: "{{ matrix_architecture not in ['arm64', 'amd64'] }}"
  1261. # When ma1sd is enabled, we can use it to validate email addresses and phone numbers.
  1262. # Synapse can validate email addresses by itself as well, but it's probably not what we want by default when we have an identity server.
  1263. matrix_synapse_account_threepid_delegates_email: "{{ 'http://matrix-ma1sd:8090' if matrix_ma1sd_enabled else '' }}"
  1264. matrix_synapse_account_threepid_delegates_msisdn: "{{ 'http://matrix-ma1sd:8090' if matrix_ma1sd_enabled else '' }}"
  1265. # Normally, matrix-nginx-proxy is enabled and nginx can reach Synapse over the container network.
  1266. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it,
  1267. # you can expose Synapse's ports to the host.
  1268. #
  1269. # For exposing the Matrix Client API's port (plain HTTP) to the local host.
  1270. matrix_synapse_container_client_api_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:8008' }}"
  1271. #
  1272. # For exposing the Matrix Federation API's plain port (plain HTTP) to the local host.
  1273. matrix_synapse_container_federation_api_plain_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:8048' }}"
  1274. #
  1275. # For exposing the Matrix Federation API's TLS port (HTTPS) to the internet on all network interfaces.
  1276. matrix_synapse_container_federation_api_tls_host_bind_port: "{{ matrix_federation_public_port if (matrix_synapse_federation_enabled and matrix_synapse_tls_federation_listener_enabled) else '' }}"
  1277. #
  1278. # For exposing the Synapse Metrics API's port (plain HTTP) to the local host.
  1279. matrix_synapse_container_metrics_api_host_bind_port: "{{ '127.0.0.1:9100' if (matrix_synapse_metrics_enabled and not matrix_nginx_proxy_enabled) else '' }}"
  1280. #
  1281. # For exposing the Synapse Manhole port (plain HTTP) to the local host.
  1282. matrix_synapse_container_manhole_api_host_bind_port: "{{ '127.0.0.1:9000' if matrix_synapse_manhole_enabled else '' }}"
  1283. #
  1284. # For exposing the Synapse worker (and metrics) ports to the local host.
  1285. matrix_synapse_workers_container_host_bind_address: "{{ '127.0.0.1' if (matrix_synapse_workers_enabled and not matrix_nginx_proxy_enabled) else '' }}"
  1286. matrix_synapse_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'synapse.db') | to_uuid }}"
  1287. # We do not enable TLS in Synapse by default.
  1288. # TLS is handled by the matrix-nginx-proxy, which proxies the requests to Synapse.
  1289. matrix_synapse_tls_federation_listener_enabled: false
  1290. matrix_synapse_tls_certificate_path: ~
  1291. matrix_synapse_tls_private_key_path: ~
  1292. matrix_synapse_federation_port_openid_resource_required: "{{ not matrix_synapse_federation_enabled and (matrix_dimension_enabled or matrix_ma1sd_enabled) }}"
  1293. # If someone instals Prometheus via the playbook, they most likely wish to monitor Synapse.
  1294. matrix_synapse_metrics_enabled: "{{ matrix_prometheus_enabled }}"
  1295. matrix_synapse_email_enabled: "{{ matrix_mailer_enabled }}"
  1296. matrix_synapse_email_smtp_host: "matrix-mailer"
  1297. matrix_synapse_email_smtp_port: 8025
  1298. matrix_synapse_email_smtp_require_transport_security: false
  1299. matrix_synapse_email_notif_from: "Matrix <{{ matrix_mailer_sender_address }}>"
  1300. # Even if TURN doesn't support TLS (it does by default),
  1301. # it doesn't hurt to try a secure connection anyway.
  1302. #
  1303. # When Let's Encrypt certificates are used (the default case),
  1304. # we don't enable `turns` endpoints, because WebRTC in Element can't talk to them.
  1305. # Learn more here: https://github.com/spantaleev/matrix-docker-ansible-deploy/pull/1145
  1306. matrix_synapse_turn_uris: |
  1307. {{
  1308. []
  1309. +
  1310. [
  1311. 'turns:' + matrix_server_fqn_matrix + '?transport=udp',
  1312. 'turns:' + matrix_server_fqn_matrix + '?transport=tcp',
  1313. ] if matrix_coturn_enabled and matrix_coturn_tls_enabled and matrix_ssl_retrieval_method != 'lets-encrypt' else []
  1314. +
  1315. [
  1316. 'turn:' + matrix_server_fqn_matrix + '?transport=udp',
  1317. 'turn:' + matrix_server_fqn_matrix + '?transport=tcp',
  1318. ] if matrix_coturn_enabled else []
  1319. }}
  1320. matrix_synapse_turn_shared_secret: "{{ matrix_coturn_turn_static_auth_secret if matrix_coturn_enabled else '' }}"
  1321. matrix_synapse_self_check_validate_certificates: "{{ false if matrix_ssl_retrieval_method == 'self-signed' else true }}"
  1322. matrix_synapse_systemd_required_services_list: |
  1323. {{
  1324. (['docker.service'])
  1325. +
  1326. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  1327. +
  1328. (['matrix-goofys'] if matrix_s3_media_store_enabled else [])
  1329. }}
  1330. matrix_synapse_systemd_wanted_services_list: |
  1331. {{
  1332. (['matrix-coturn.service'] if matrix_coturn_enabled else [])
  1333. +
  1334. (['matrix-mailer.service'] if matrix_mailer_enabled else [])
  1335. }}
  1336. # Synapse workers (used for parallel load-scaling) need Redis for IPC.
  1337. matrix_synapse_redis_enabled: "{{ matrix_redis_enabled }}"
  1338. matrix_synapse_redis_host: "{{ 'matrix-redis' if matrix_redis_enabled else '' }}"
  1339. matrix_synapse_redis_password: "{{ matrix_redis_connection_password if matrix_redis_enabled else '' }}"
  1340. ######################################################################
  1341. #
  1342. # /matrix-synapse
  1343. #
  1344. ######################################################################
  1345. ######################################################################
  1346. #
  1347. # matrix-synapse-admin
  1348. #
  1349. ######################################################################
  1350. matrix_synapse_admin_enabled: false
  1351. # Normally, matrix-nginx-proxy is enabled and nginx can reach Synapse Admin over the container network.
  1352. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it, you can expose
  1353. # Synapse Admin's HTTP port to the local host.
  1354. matrix_synapse_admin_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:8766' }}"
  1355. matrix_synapse_admin_container_self_build: "{{ matrix_architecture != 'amd64' }}"
  1356. ######################################################################
  1357. #
  1358. # /matrix-synapse-admin
  1359. #
  1360. ######################################################################
  1361. ######################################################################
  1362. #
  1363. # matrix-prometheus-node-exporter
  1364. #
  1365. ######################################################################
  1366. matrix_prometheus_node_exporter_enabled: false
  1367. ######################################################################
  1368. #
  1369. # /matrix-prometheus-node-exporter
  1370. #
  1371. ######################################################################
  1372. ######################################################################
  1373. #
  1374. # matrix-prometheus
  1375. #
  1376. ######################################################################
  1377. matrix_prometheus_enabled: false
  1378. # Normally, matrix-nginx-proxy is enabled and nginx can reach Prometheus over the container network.
  1379. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it, you can expose
  1380. # Prometheus' HTTP port to the local host.
  1381. matrix_prometheus_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:9090' }}"
  1382. matrix_prometheus_scraper_synapse_enabled: "{{ matrix_synapse_enabled and matrix_synapse_metrics_enabled }}"
  1383. matrix_prometheus_scraper_synapse_targets: ['matrix-synapse:{{ matrix_synapse_metrics_port }}']
  1384. matrix_prometheus_scraper_synapse_workers_enabled_list: "{{ matrix_synapse_workers_enabled_list }}"
  1385. matrix_prometheus_scraper_synapse_rules_synapse_tag: "{{ matrix_synapse_docker_image_tag }}"
  1386. matrix_prometheus_scraper_node_enabled: "{{ matrix_prometheus_node_exporter_enabled }}"
  1387. matrix_prometheus_scraper_node_targets: "{{ ['matrix-prometheus-node-exporter:9100'] if matrix_prometheus_node_exporter_enabled else [] }}"
  1388. matrix_prometheus_scraper_postgres_enabled: "{{ matrix_prometheus_postgres_exporter_enabled }}"
  1389. matrix_prometheus_scraper_postgres_targets: "{{ ['matrix-prometheus-postgres-exporter:'+ matrix_prometheus_postgres_exporter_port|string] if matrix_prometheus_scraper_postgres_enabled else [] }}"
  1390. ######################################################################
  1391. #
  1392. # /matrix-prometheus
  1393. #
  1394. ######################################################################
  1395. ######################################################################
  1396. #
  1397. # matrix-prometheus-postgres-exporter
  1398. #
  1399. ######################################################################
  1400. matrix_prometheus_postgres_exporter_enabled: false
  1401. matrix_prometheus_postgres_exporter_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'prometheus.pg.db') | to_uuid }}"
  1402. matrix_prometheus_postgres_exporter_systemd_required_services_list: |
  1403. {{
  1404. ['docker.service']
  1405. +
  1406. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  1407. }}
  1408. ######################################################################
  1409. #
  1410. # /matrix-prometheus-postgres-exporter
  1411. #
  1412. ######################################################################
  1413. ######################################################################
  1414. #
  1415. # matrix-grafana
  1416. #
  1417. ######################################################################
  1418. matrix_grafana_enabled: false
  1419. # Normally, matrix-nginx-proxy is enabled and nginx can reach Grafana over the container network.
  1420. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it, you can expose
  1421. # Grafana's HTTP port to the local host.
  1422. matrix_grafana_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:3000' }}"
  1423. matrix_grafana_dashboard_download_urls_all: |
  1424. {{
  1425. matrix_grafana_dashboard_download_urls
  1426. +
  1427. (matrix_prometheus_postgres_exporter_dashboard_urls if matrix_prometheus_postgres_exporter_enabled else [])
  1428. }}
  1429. ######################################################################
  1430. #
  1431. # /matrix-grafana
  1432. #
  1433. ######################################################################
  1434. ######################################################################
  1435. #
  1436. # matrix-registration
  1437. #
  1438. ######################################################################
  1439. matrix_registration_enabled: false
  1440. # Normally, matrix-nginx-proxy is enabled and nginx can reach matrix-registration over the container network.
  1441. # If matrix-nginx-proxy is not enabled, or you otherwise have a need for it, you can expose
  1442. # matrix-registration's HTTP port to the local host.
  1443. matrix_registration_container_http_host_bind_port: "{{ '' if matrix_nginx_proxy_enabled else '127.0.0.1:8767' }}"
  1444. matrix_registration_riot_instance: "{{ ('https://' + matrix_server_fqn_element) if matrix_client_element_enabled else 'https://riot.im/app/' }}"
  1445. matrix_registration_shared_secret: "{{ matrix_synapse_registration_shared_secret if matrix_synapse_enabled else '' }}"
  1446. matrix_registration_server_location: "{{ matrix_homeserver_container_url }}"
  1447. matrix_registration_api_validate_certs: "{{ false if matrix_ssl_retrieval_method == 'self-signed' else true }}"
  1448. matrix_registration_container_image_self_build: "{{ matrix_architecture != 'amd64' }}"
  1449. matrix_registration_systemd_required_services_list: |
  1450. {{
  1451. ['docker.service']
  1452. +
  1453. (['matrix-postgres.service'] if matrix_postgres_enabled else [])
  1454. }}
  1455. # Postgres is the default, except if not using `matrix_postgres` (internal postgres)
  1456. matrix_registration_database_engine: "{{ 'postgres' if matrix_postgres_enabled else 'sqlite' }}"
  1457. matrix_registration_database_password: "{{ matrix_synapse_macaroon_secret_key | password_hash('sha512', 'mx.registr.db') | to_uuid }}"
  1458. ######################################################################
  1459. #
  1460. # /matrix-registration
  1461. #
  1462. ######################################################################
  1463. ######################################################################
  1464. #
  1465. # matrix-postgres-backup
  1466. #
  1467. ######################################################################
  1468. matrix_postgres_backup_connection_hostname: "{{ matrix_postgres_connection_hostname }}"
  1469. matrix_postgres_backup_connection_port: "{{ matrix_postgres_connection_port }}"
  1470. matrix_postgres_backup_connection_username: "{{ matrix_postgres_connection_username }}"
  1471. matrix_postgres_backup_connection_password: "{{ matrix_postgres_connection_password }}"
  1472. matrix_postgres_backup_postgres_data_path: "{{ matrix_postgres_data_path if matrix_postgres_enabled else '' }}"
  1473. # the default matrix synapse databse is not always part of the matrix_postgres_additional_databases variable thus we have to add it if the default database is used
  1474. matrix_postgres_backup_databases: |
  1475. {{
  1476. (([{
  1477. 'name': matrix_synapse_database_database
  1478. }] if (matrix_synapse_enabled and matrix_synapse_database_database == matrix_postgres_db_name and matrix_synapse_database_host == 'matrix-postgres') else [])
  1479. +
  1480. matrix_postgres_additional_databases)|map(attribute='name')|list
  1481. }}
  1482. ######################################################################
  1483. #
  1484. # /matrix-postgres-backup
  1485. #
  1486. ######################################################################