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.
 
 
 

11137 lines
363 KiB

  1. # SOME DESCRIPTIVE TITLE.
  2. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community
  3. # members
  4. # This file is distributed under the same license as the
  5. # matrix-docker-ansible-deploy package.
  6. # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
  7. #
  8. #, fuzzy
  9. msgid ""
  10. msgstr ""
  11. "Project-Id-Version: matrix-docker-ansible-deploy \n"
  12. "Report-Msgid-Bugs-To: \n"
  13. "POT-Creation-Date: 2024-12-16 12:05+0900\n"
  14. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  15. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  16. "Language: jp\n"
  17. "Language-Team: jp <LL@li.org>\n"
  18. "MIME-Version: 1.0\n"
  19. "Content-Type: text/plain; charset=utf-8\n"
  20. "Content-Transfer-Encoding: 8bit\n"
  21. "Generated-By: Babel 2.16.0\n"
  22. #: ../../../CHANGELOG.md:1
  23. msgid "2024-11-26"
  24. msgstr ""
  25. #: ../../../CHANGELOG.md:3
  26. msgid ""
  27. "(Backward Compatibility Break) Synapse now defaults to enabling "
  28. "authenticated media"
  29. msgstr ""
  30. #: ../../../CHANGELOG.md:5
  31. msgid ""
  32. "**TLDR**: with this update, your Synapse homeserver will start requiring "
  33. "authentication for newly-uploaded media files. While the majority of the "
  34. "ecosystem (clients, bots, etc.) should support this, certain software may"
  35. " lack support for it (and you may wish to turn it off, if it's causing "
  36. "issues)."
  37. msgstr ""
  38. #: ../../../CHANGELOG.md:7
  39. msgid ""
  40. "The default configuration for the Synapse homeserver now [enforces "
  41. "Authenticated media by default](https://element-"
  42. "hq.github.io/synapse/v1.120/upgrade.html#authenticated-media-is-now-"
  43. "enforced-by-default)."
  44. msgstr ""
  45. #: ../../../CHANGELOG.md:9
  46. msgid ""
  47. "Servers like `matrix.org` have already [sunset unauthenticated "
  48. "media](https://matrix.org/blog/2024/06/26/sunsetting-unauthenticated-"
  49. "media/) months ago."
  50. msgstr ""
  51. #: ../../../CHANGELOG.md:11
  52. msgid ""
  53. "Now that **various clients, bots, bridges and extra services have caught "
  54. "up with authenticated media support**, Synapse developers seem confident "
  55. "that it's time to enable authenticated media by default."
  56. msgstr ""
  57. #: ../../../CHANGELOG.md:13
  58. msgid ""
  59. "We're changing the playbook configuration for authenticated media to keep"
  60. " up with upstream defaults changing."
  61. msgstr ""
  62. #: ../../../CHANGELOG.md:15
  63. msgid ""
  64. "Old and unmaintained bridges (like all mx-puppet bridges, etc.) do not "
  65. "support authenticated media. Other software may be similarly affected. If"
  66. " you experience issues with some Matrix-related software, you may wish to"
  67. " disable authenticated media and contact the software maintainers to let "
  68. "them know."
  69. msgstr ""
  70. #: ../../../CHANGELOG.md:17
  71. msgid ""
  72. "You can disable authenticated media at any time by setting "
  73. "`matrix_synapse_enable_authenticated_media: false` in your `vars.yml` "
  74. "configuration file and re-running the playbook."
  75. msgstr ""
  76. #: ../../../CHANGELOG.md:20
  77. msgid "2024-11-23"
  78. msgstr ""
  79. #: ../../../CHANGELOG.md:22
  80. msgid ""
  81. "(Backward Compatibility Break) The playbook now defaults to Valkey, "
  82. "instead of KeyDB"
  83. msgstr ""
  84. #: ../../../CHANGELOG.md:24
  85. msgid ""
  86. "**TLDR**: if the playbook installed KeyDB (or Redis) as a dependency for "
  87. "you before, it will now replace it with [Valkey](https://valkey.io/) (a "
  88. "drop-in alternative). We [previously switched from Redis to KeyDB"
  89. "](#backward-compatibility-break-the-playbook-now-defaults-to-keydb-"
  90. "instead-of-redis), but Valkey is a better alternative, so we're switching"
  91. " again."
  92. msgstr ""
  93. #: ../../../CHANGELOG.md:26
  94. msgid ""
  95. "The playbook used to install Redis or KeyDB if services have a need for a"
  96. " Redis-compatible implementation ([enabling worker support for "
  97. "Synapse](docs/configuring-playbook-synapse.md#load-balancing-with-"
  98. "workers), [enabling Hookshot encryption](docs/configuring-playbook-"
  99. "bridge-hookshot.md#end-to-bridge-encryption), etc.)."
  100. msgstr ""
  101. #: ../../../CHANGELOG.md:28
  102. msgid ""
  103. "Earlier this year, we switched from Redis to KeyDB - see [(Backward "
  104. "Compatibility Break) The playbook now defaults to KeyDB, instead of Redis"
  105. "](#backward-compatibility-break-the-playbook-now-defaults-to-keydb-"
  106. "instead-of-redis)."
  107. msgstr ""
  108. #: ../../../CHANGELOG.md:30
  109. msgid ""
  110. "Because Valkey seems to be a better successor to Redis (than KeyDB) and "
  111. "likely doesn't suffer from [issues like this "
  112. "one](https://github.com/spantaleev/matrix-docker-ansible-"
  113. "deploy/issues/3544), we now replace KeyDB with Valkey."
  114. msgstr ""
  115. #: ../../../CHANGELOG.md:32
  116. msgid ""
  117. "Valkey (like KeyDB and Redis in the past) is an implicitly enabled "
  118. "dependency - you don't need custom configuration in `vars.yml` to enable "
  119. "it."
  120. msgstr ""
  121. #: ../../../CHANGELOG.md:34
  122. msgid ""
  123. "Next time your run the playbook (via the `setup-all` tag), **KeyDB will "
  124. "be automatically uninstalled and replaced with Valkey**. Some Synapse "
  125. "downtime may occur while the switch happens."
  126. msgstr ""
  127. #: ../../../CHANGELOG.md:36
  128. msgid ""
  129. "Users on `arm32` should be aware that there's **neither a prebuilt "
  130. "`arm32` container image for Valkey**, nor the Valkey role supports self-"
  131. "building yet. Users on this architecture likely don't run Synapse with "
  132. "workers, etc., so they're likely in no need of Valkey (or Redis/KeyDB). "
  133. "If Redis is necessary in an `arm32` deployment, disabling Valkey and "
  134. "making the playbook fall back to Redis is possible (see below)."
  135. msgstr ""
  136. #: ../../../CHANGELOG.md:38 ../../../CHANGELOG.md:378
  137. msgid ""
  138. "**The playbook still supports Redis** and you can keep using Redis (for "
  139. "now) if you'd like, by adding this additional configuration to your "
  140. "`vars.yml` file:"
  141. msgstr ""
  142. #: ../../../CHANGELOG.md:49
  143. msgid ""
  144. "**The playbook still supports KeyDB** and you can keep using KeyDB (for "
  145. "now) if you'd like, by adding this additional configuration to your "
  146. "`vars.yml` file:"
  147. msgstr ""
  148. #: ../../../CHANGELOG.md:59
  149. msgid ""
  150. "At some point in time in the future, we'll remove both KeyDB and Redis "
  151. "from the playbook, so we recommend that you migrate to Valkey earlier "
  152. "anyway."
  153. msgstr ""
  154. #: ../../../CHANGELOG.md:62
  155. msgid "2024-11-14"
  156. msgstr ""
  157. #: ../../../CHANGELOG.md:64
  158. msgid "HTTP-compression support for Traefik-based setups"
  159. msgstr ""
  160. #: ../../../CHANGELOG.md:66
  161. msgid ""
  162. "The playbook now **automatically enables HTTP-compression support** for "
  163. "major services powered by the playbook, like [Cinny](./docs/configuring-"
  164. "playbook-client-cinny.md), [Element Web](./docs/configuring-playbook-"
  165. "client-element-web.md), [Hydrogen](./docs/configuring-playbook-client-"
  166. "hydrogen.md), as well as for Matrix Client-Server and Federation APIs "
  167. "(`matrix.example.com`)."
  168. msgstr ""
  169. #: ../../../CHANGELOG.md:68
  170. msgid ""
  171. "Other services installed by the playbook are currently not compression-"
  172. "enabled, but may become so over time. This change is rolled out on a per-"
  173. "service basis (as opposed to doing it globally, at the Traefik entrypoint"
  174. " level) to allow certain services or route endpoints which do not behave "
  175. "well when compressed (e.g. [issue 3749](https://github.com/spantaleev"
  176. "/matrix-docker-ansible-deploy/issues/3749)) to be excluded from "
  177. "compression."
  178. msgstr ""
  179. #: ../../../CHANGELOG.md:70
  180. msgid ""
  181. "A long time ago, various services were operating with `gzip`-compression "
  182. "enabled at the nginx level. Since the switch to Traefik (see [Goodbye, "
  183. "`matrix-nginx-proxy` 🪦](https://github.com/spantaleev/matrix-docker-"
  184. "ansible-deploy/blob/57c5271d9d6265a34a9d9cceb93365f685074f96/CHANGELOG.md"
  185. "#goodbye-matrix-nginx-proxy-)), all services (with the exception of "
  186. "Matrix APIs for Synapse worker-enabled setups which are powered by "
  187. "`nginx` via `synapse-reverse-proxy-companion`) have been operating "
  188. "without HTTP-compression support."
  189. msgstr ""
  190. #: ../../../CHANGELOG.md:72
  191. msgid ""
  192. "HTTP-compression is now done via Traefik's "
  193. "[compress](https://doc.traefik.io/traefik/middlewares/http/compress/) "
  194. "middleware. We use the default configuration for this middleware, which "
  195. "enables `zstd`, `br` and `gzip` support (in this order). This "
  196. "middleware's configuration can be configured via variables in the Traefik"
  197. " role (see "
  198. "`traefik_config_http_middlewares_compression_middleware_options`)."
  199. msgstr ""
  200. #: ../../../CHANGELOG.md:74
  201. msgid ""
  202. "If you're using your own Traefik reverse-proxy server ([Traefik managed "
  203. "by you](./docs/configuring-playbook-own-webserver.md#traefik-managed-by-"
  204. "you)) instead of the playbook's integrated Traefik service, you can "
  205. "benefit from the same by:"
  206. msgstr ""
  207. #: ../../../CHANGELOG.md:76
  208. msgid ""
  209. "defining a "
  210. "[compress](https://doc.traefik.io/traefik/middlewares/http/compress/) "
  211. "middleware (via the "
  212. "[file](https://doc.traefik.io/traefik/providers/file/) or "
  213. "[Docker](https://doc.traefik.io/traefik/providers/docker/) providers)"
  214. msgstr ""
  215. #: ../../../CHANGELOG.md:77
  216. msgid ""
  217. "setting "
  218. "`matrix_playbook_reverse_proxy_traefik_middleware_compression_enabled` to"
  219. " `true`"
  220. msgstr ""
  221. #: ../../../CHANGELOG.md:78
  222. msgid ""
  223. "specifying the middleware's name in "
  224. "`matrix_playbook_reverse_proxy_traefik_middleware_compression_name` (e.g."
  225. " `matrix_playbook_reverse_proxy_traefik_middleware_compression_name: my-"
  226. "compression-middleware@file`)"
  227. msgstr ""
  228. #: ../../../CHANGELOG.md:80
  229. msgid "Timeout adjustments for Traefik-based setups"
  230. msgstr ""
  231. #: ../../../CHANGELOG.md:82
  232. msgid ""
  233. "The playbook now supports configuring various "
  234. "[transport.respondingTimeouts](https://doc.traefik.io/traefik/routing/entrypoints/#respondingtimeouts)"
  235. " timeout values (`readTimeout`, `writeTimeout`, `idleTimeout`) for the "
  236. "`web`, `web-secure` and `matrix-federation` entrypoints."
  237. msgstr ""
  238. #: ../../../CHANGELOG.md:84
  239. msgid ""
  240. "If you're using your own Traefik reverse-proxy server ([Traefik managed "
  241. "by you](./docs/configuring-playbook-own-webserver.md#traefik-managed-by-"
  242. "you)) instead of the playbook's integrated Traefik service, you may wish "
  243. "to do similar configuration changes to your setup manually."
  244. msgstr ""
  245. #: ../../../CHANGELOG.md:86
  246. msgid ""
  247. "The most interesting of these is the `readTimeout` configuration value "
  248. "(the maximum duration for reading the entire request, including the "
  249. "body), which used to default to `60s`. For large and slowly progressing "
  250. "file uploads, `60s` would often not be enough for the transfer to finish "
  251. "and uploads would end up being interrupted. The playbook now raises the "
  252. "`readTimeout` value to 5 minutes (`300s`) to improve this use-case."
  253. msgstr ""
  254. #: ../../../CHANGELOG.md:88
  255. msgid ""
  256. "The `traefik_config_entrypoint_web_transport_respondingTimeouts_*` "
  257. "variables (for the `web` entrypoint) cascade to affecting the timeout "
  258. "values for the `web-secure` and `matrix-federation` entrypoints, so you "
  259. "can easily adjust all timeout values using them."
  260. msgstr ""
  261. #: ../../../CHANGELOG.md:90
  262. msgid "Example of the default timeout values used by the playbook:"
  263. msgstr ""
  264. #: ../../../CHANGELOG.md:101
  265. msgid ""
  266. "Alternatively, you may adjust the timeout values for specific entrypoints"
  267. " (like `web-secure` and `matrix-federation`) using dedicated variables "
  268. "(like "
  269. "`traefik_config_entrypoint_web_secure_transport_respondingTimeouts_readTimeout`"
  270. " and "
  271. "`matrix_playbook_public_matrix_federation_api_traefik_entrypoint_config_transport_respondingTimeouts_readTimeout`)."
  272. msgstr ""
  273. #: ../../../CHANGELOG.md:104
  274. msgid "2024-11-08"
  275. msgstr ""
  276. #: ../../../CHANGELOG.md:106
  277. msgid ""
  278. "Support for synapse-admin auto-configuration via /.well-"
  279. "known/matrix/client"
  280. msgstr ""
  281. #: ../../../CHANGELOG.md:108
  282. msgid ""
  283. "You can administrate your Synapse-powered homeserver using synapse-admin "
  284. "hosted externally (e.g. [admin.etke.cc](https://admin.etke.cc/)) and the "
  285. "synapse-admin instance would still auto-configure itself correctly for "
  286. "your server by [reading its `/.well-known/matrix/client` "
  287. "file](https://github.com/etkecc/synapse-admin/pull/126)."
  288. msgstr ""
  289. #: ../../../CHANGELOG.md:110
  290. msgid ""
  291. "The playbook now configures the `/.well-known/matrix/client` file for "
  292. "this by default, injecting into it a `cc.etke.synapse-admin` section that"
  293. " contains the full synapse-admin configuration. This is done even if you "
  294. "don't enable the synapse-admin service in your configuration. The reason "
  295. "for always doing it is to allow users to skip the (small) overhead of "
  296. "self-hosting the non-core synapse-admin service, yet still be able to use"
  297. " it from elsewhere when needed."
  298. msgstr ""
  299. #: ../../../CHANGELOG.md:112
  300. msgid ""
  301. "If you don't ever plan on using synapse-admin from other servers (besides"
  302. " your own due to [self-hosting synapse-admin](./docs/configuring-"
  303. "playbook-synapse-admin.md)), you **can disable this** `/.well-"
  304. "known/matrix/client` configuration via "
  305. "`matrix_static_files_file_matrix_client_property_cc_etke_synapse_admin_enabled:"
  306. " false`"
  307. msgstr ""
  308. #: ../../../CHANGELOG.md:115
  309. msgid "2024-10-28"
  310. msgstr ""
  311. #: ../../../CHANGELOG.md:117
  312. msgid "(BC Break) Postmoogle's variable names need adjustments"
  313. msgstr ""
  314. #: ../../../CHANGELOG.md:119
  315. msgid ""
  316. "Due to the recategorization of [Postmoogle](./docs/configuring-playbook-"
  317. "bridge-postmoogle.md) from the bot to the bridge, its variables were "
  318. "renamed (`matrix_bot_postmoogle_` -> `matrix_postmoogle_`). You need to "
  319. "adjust your `vars.yml` configuration accordingly."
  320. msgstr ""
  321. #: ../../../CHANGELOG.md:121
  322. msgid "2024-10-19"
  323. msgstr ""
  324. #: ../../../CHANGELOG.md:123
  325. msgid "Support for Matrix Authentication Service"
  326. msgstr ""
  327. #: ../../../CHANGELOG.md:125
  328. msgid ""
  329. "The playbook now supports installing and configuring [Matrix "
  330. "Authentication Service](./docs/configuring-playbook-matrix-"
  331. "authentication-service.md) (MAS)."
  332. msgstr ""
  333. #: ../../../CHANGELOG.md:127
  334. msgid ""
  335. "Huge thanks to [Quentin Gliech](https://github.com/sandhose) from the "
  336. "[Element](https://element.io/) / [Matrix Authentication "
  337. "Service](https://github.com/element-hq/matrix-authentication-service) "
  338. "team for answering our numerous questions about MAS."
  339. msgstr ""
  340. #: ../../../CHANGELOG.md:129
  341. msgid ""
  342. "This is an **experimental service** and there are **still certain issues "
  343. "with it** (see [Expectations](./docs/configuring-playbook-matrix-"
  344. "authentication-service.md#expectations)). Matrix server administrators "
  345. "should only consider switching if they identify with one or more [reasons"
  346. " to use Matrix Authentication Service](./docs/configuring-playbook-"
  347. "matrix-authentication-service.md#reasons-to-use-matrix-authentication-"
  348. "service). As MAS adoption improves and more services are adjusted to "
  349. "support it, we expect that using MAS will become the norm."
  350. msgstr ""
  351. #: ../../../CHANGELOG.md:131
  352. msgid ""
  353. "Our [Setting up Matrix Authentication Service](./docs/configuring-"
  354. "playbook-matrix-authentication-service.md) documentation page has more "
  355. "details about this new service, what you might expect from the switch and"
  356. " how you can migrate your existing (Synapse) homeserver setup to MAS."
  357. msgstr ""
  358. #: ../../../CHANGELOG.md:134
  359. msgid "2024-09-27"
  360. msgstr ""
  361. #: ../../../CHANGELOG.md:136
  362. msgid ""
  363. "(BC Break) Postgres & Traefik roles have been relocated and variable "
  364. "names need adjustments"
  365. msgstr ""
  366. #: ../../../CHANGELOG.md:138
  367. msgid ""
  368. "Various roles have been relocated from the "
  369. "[devture](https://github.com/devture) organization to the [mother-of-all-"
  370. "self-hosting](https://github.com/mother-of-all-self-hosting) "
  371. "organization."
  372. msgstr ""
  373. #: ../../../CHANGELOG.md:140
  374. msgid ""
  375. "Along with the relocation, the `devture_` prefix was dropped from their "
  376. "variable names, so you need to adjust your `vars.yml` configuration."
  377. msgstr ""
  378. #: ../../../CHANGELOG.md:142
  379. msgid "You need to do the following replacements:"
  380. msgstr ""
  381. #: ../../../CHANGELOG.md:144
  382. msgid "`devture_postgres_` -> `postgres_`"
  383. msgstr ""
  384. #: ../../../CHANGELOG.md:145
  385. msgid "`devture_traefik_` -> `traefik_`"
  386. msgstr ""
  387. #: ../../../CHANGELOG.md:147
  388. msgid ""
  389. "As always, the playbook would let you know about this and point out any "
  390. "variables you may have missed."
  391. msgstr ""
  392. #: ../../../CHANGELOG.md:150
  393. msgid "2024-09-12"
  394. msgstr ""
  395. #: ../../../CHANGELOG.md:152
  396. msgid "Support for baibot"
  397. msgstr ""
  398. #: ../../../CHANGELOG.md:154
  399. msgid ""
  400. "The playbook now supports installing [baibot](./docs/configuring-"
  401. "playbook-bot-baibot.md) (pronounced bye-bot) - a "
  402. "[Matrix](https://matrix.org/) bot developed by "
  403. "[etke.cc](https://etke.cc/) that exposes the power of "
  404. "[AI](https://en.wikipedia.org/wiki/Artificial_intelligence) / [Large "
  405. "Language Models](https://en.wikipedia.org/wiki/Large_language_model) to "
  406. "you. 🤖"
  407. msgstr ""
  408. #: ../../../CHANGELOG.md:156
  409. msgid ""
  410. "It supports [OpenAI](https://openai.com/)'s "
  411. "[ChatGPT](https://openai.com/blog/chatgpt/) models, as well as many other"
  412. " [☁️ "
  413. "providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md)."
  414. msgstr ""
  415. #: ../../../CHANGELOG.md:158
  416. msgid ""
  417. "It's designed as a more private and [✨ "
  418. "featureful](https://github.com/etkecc/baibot/?tab=readme-ov-"
  419. "file#-features) alternative to the now-unmaintained [matrix-chatgpt-"
  420. "bot](./docs/configuring-playbook-bot-chatgpt.md)."
  421. msgstr ""
  422. #: ../../../CHANGELOG.md:160
  423. msgid ""
  424. "To get started, see the [Setting up baibot](./docs/configuring-playbook-"
  425. "bot-baibot.md) documentation page."
  426. msgstr ""
  427. #: ../../../CHANGELOG.md:162
  428. msgid "Switching synapse-admin to etke.cc's fork"
  429. msgstr ""
  430. #: ../../../CHANGELOG.md:164
  431. msgid ""
  432. "The playbook now installs [etke.cc](https://etke.cc/)'s "
  433. "[fork](https://github.com/etkecc/synapse-admin) of [synapse-"
  434. "admin](https://github.com/Awesome-Technologies/synapse-admin) (originally"
  435. " developed by [Awesome-Technologies](https://github.com/Awesome-"
  436. "Technologies)). This fork is a drop-in replacement for the original "
  437. "software."
  438. msgstr ""
  439. #: ../../../CHANGELOG.md:166
  440. msgid ""
  441. "The creation of the fork has been provoked by users frequently "
  442. "encountering issues with the original synapse-admin software, such as "
  443. "unintentionally deleting their one-and-only admin user account (fixed "
  444. "[here](https://github.com/etkecc/synapse-admin/pull/1) and also "
  445. "contributed upstream [here](https://github.com/Awesome-Technologies"
  446. "/synapse-admin/pull/608) - to no avail for now). Since its inception, [a "
  447. "bunch of other quality-of-life improvements](https://github.com/etkecc"
  448. "/synapse-admin?tab=readme-ov-file#changes) have been made to the fork."
  449. msgstr ""
  450. #: ../../../CHANGELOG.md:168
  451. msgid ""
  452. "If upstream synapse-admin picks up the pace and improves, the etke.cc "
  453. "fork may disappear and the playbook may switch to the original software "
  454. "again. Until that time comes, we believe that etke.cc's fork is the "
  455. "better software to use right now."
  456. msgstr ""
  457. #: ../../../CHANGELOG.md:170
  458. msgid ""
  459. "If you'd like to switch back to the original synapse-admin software, you "
  460. "can do so by adding the following configuration to your `vars.yml` file:"
  461. msgstr ""
  462. #: ../../../CHANGELOG.md:183
  463. msgid "2024-08-17"
  464. msgstr ""
  465. #: ../../../CHANGELOG.md:185
  466. msgid "New appservice-double-puppet service for better double-puppeting"
  467. msgstr ""
  468. #: ../../../CHANGELOG.md:187
  469. msgid ""
  470. "Mautrix bridges are undergoing large changes as announced in the [August "
  471. "2024 releases & progress](https://mau.fi/blog/2024-08-mautrix-release/) "
  472. "blog post."
  473. msgstr ""
  474. #: ../../../CHANGELOG.md:189
  475. msgid ""
  476. "The playbook has already upgraded to the rewritten mautrix-slack "
  477. "([v0.1.0](https://github.com/mautrix/slack/releases/tag/v0.1.0)) and "
  478. "mautrix-signal "
  479. "([v0.7.0](https://github.com/mautrix/signal/releases/tag/v0.7.0)) "
  480. "bridges."
  481. msgstr ""
  482. #: ../../../CHANGELOG.md:191
  483. msgid ""
  484. "The newly rewritten bridges do not support double-puppeting via [Shared "
  485. "Secret Auth](./docs/configuring-playbook-shared-secret-auth.md) anymore, "
  486. "which has prompted us to switch to the new & better [appservice "
  487. "method](https://docs.mau.fi/bridges/general/double-puppeting.html"
  488. "#appservice-method-new) for double-puppeting. The playbook automates this"
  489. " double-puppeting setup for you if you enable the new [Appservice Double "
  490. "Puppet](./docs/configuring-playbook-appservice-double-puppet.md) service."
  491. msgstr ""
  492. #: ../../../CHANGELOG.md:193
  493. msgid ""
  494. "All non-deprecated mautrix bridges in the playbook have been reworked to "
  495. "support double-puppeting via an Appservice. Most bridges still support "
  496. "double-puppeting via [Shared Secret Auth](./docs/configuring-playbook-"
  497. "shared-secret-auth.md), so the playbook supports it too. If only Shared "
  498. "Secret Auth is enabled, double-puppeting will be configured using that "
  499. "method (for the bridges that support it). That said, **Shared Secret Auth"
  500. " double-puppeting is being phased out and we recommend replacing it with "
  501. "the new Appservice method**."
  502. msgstr ""
  503. #: ../../../CHANGELOG.md:195
  504. msgid ""
  505. "We recommend **enabling double-puppeting via the new Appservice method** "
  506. "by adding the following configuration to your `vars.yml` file:"
  507. msgstr ""
  508. #: ../../../CHANGELOG.md:201
  509. msgid ""
  510. "You can still **keep** [Shared Secret Auth](./docs/configuring-playbook-"
  511. "shared-secret-auth.md) enabled. Non-mautrix bridges and other services "
  512. "(e.g. [matrix-corporal](./docs/configuring-playbook-matrix-corporal.md)) "
  513. "may still require it."
  514. msgstr ""
  515. #: ../../../CHANGELOG.md:203
  516. msgid ""
  517. "When both double-puppeting methods are enabled, the playbook will "
  518. "automatically choose the new and better Appservice method for bridges "
  519. "that support it."
  520. msgstr ""
  521. #: ../../../CHANGELOG.md:206
  522. msgid "2024-08-15"
  523. msgstr ""
  524. #: ../../../CHANGELOG.md:208
  525. msgid "matrix-media-repo now configured for Authenticated Media"
  526. msgstr ""
  527. #: ../../../CHANGELOG.md:210
  528. msgid ""
  529. "Thanks to [Michael Hollister](https://github.com/Michael-Hollister) from "
  530. "[FUTO](https://www.futo.org/), our matrix-media-repo implementation now "
  531. "automatically [sets up signing keys](https://docs.t2bot.io/matrix-media-"
  532. "repo/v1.3.5/installation/signing-key/) for Authenticated Media (as per "
  533. "[MSC3916](https://github.com/matrix-org/matrix-spec-"
  534. "proposals/pull/3916))."
  535. msgstr ""
  536. #: ../../../CHANGELOG.md:212
  537. msgid ""
  538. "If you had never heard of Authenticated Media before, the [Sunsetting "
  539. "unauthenticated media](https://matrix.org/blog/2024/06/26/sunsetting-"
  540. "unauthenticated-media/) article on [matrix.org](https://matrix.org/) is a"
  541. " good introduction."
  542. msgstr ""
  543. #: ../../../CHANGELOG.md:214
  544. msgid ""
  545. "This feature is enabled for matrix-media-repo installations by default "
  546. "and will append an additional (matrix-media-repo-generated signing key) "
  547. "to your homeserver's (Synapse or Dendrite) signing key. See the [Signing "
  548. "keys](./docs/configuring-playbook-matrix-media-repo.md#signing-keys) and "
  549. "[Key backup and revoking](./docs/configuring-playbook-matrix-media-"
  550. "repo.md#key-backup-and-revoking) sections of the matrix-media-repo "
  551. "documentation for more details."
  552. msgstr ""
  553. #: ../../../CHANGELOG.md:216
  554. msgid ""
  555. "If you'd like to avoid this new feature, you can disable it by setting "
  556. "`matrix_media_repo_generate_signing_key: false` in your `vars.yml` "
  557. "configuration file."
  558. msgstr ""
  559. #: ../../../CHANGELOG.md:219
  560. msgid "2024-08-08"
  561. msgstr ""
  562. #: ../../../CHANGELOG.md:221
  563. msgid "(Backward Compatibility Break) matrix-corporal has been upgraded to v3"
  564. msgstr ""
  565. #: ../../../CHANGELOG.md:223
  566. msgid ""
  567. "The playbook now installs [matrix-corporal](https://github.com/devture"
  568. "/matrix-corporal) v3.0.0, which brings support for **power-level "
  569. "management** (thanks to [this PR](https://github.com/devture/matrix-"
  570. "corporal/pull/32))."
  571. msgstr ""
  572. #: ../../../CHANGELOG.md:225
  573. msgid ""
  574. "This upgrade necessitates configuration policy changes as described in "
  575. "[matrix-corporal's changelog entry](https://github.com/devture/matrix-"
  576. "corporal/blob/5287cb81c82cd3b951c2a099b4697c3e0b384559/CHANGELOG.md#version-300-2024-08-08)."
  577. msgstr ""
  578. #: ../../../CHANGELOG.md:227
  579. msgid ""
  580. "If you'd like to remain on the old (v2) version of matrix-corporal, you "
  581. "can do so by adding the following configuration to your `vars.yml` file:"
  582. msgstr ""
  583. #: ../../../CHANGELOG.md:233
  584. msgid "2024-07-25"
  585. msgstr ""
  586. #: ../../../CHANGELOG.md:235
  587. msgid "synapse-usage-exporter support"
  588. msgstr ""
  589. #: ../../../CHANGELOG.md:237
  590. msgid ""
  591. "Thanks to [Michael Hollister](https://github.com/Michael-Hollister) from "
  592. "[FUTO](https://www.futo.org/), the creators of the [Circles "
  593. "app](https://circu.li/), the playbook can now set up [synapse-usage-"
  594. "exporter](https://github.com/loelkes/synapse-usage-exporter) - a small "
  595. "[Flask](https://flask.palletsprojects.com)-based webservice which can "
  596. "capture usage statistics from Synapse (via HTTP `PUT`) and then make them"
  597. " available for Prometheus to scrape."
  598. msgstr ""
  599. #: ../../../CHANGELOG.md:239
  600. msgid ""
  601. "To learn more see our [Enabling synapse-usage-exporter for Synapse usage "
  602. "statistics](docs/configuring-playbook-synapse-usage-exporter.md) "
  603. "documentation page."
  604. msgstr ""
  605. #: ../../../CHANGELOG.md:242
  606. msgid "2024-07-06"
  607. msgstr ""
  608. #: ../../../CHANGELOG.md:244
  609. msgid "matrix-alertmanager-receiver support"
  610. msgstr ""
  611. #: ../../../CHANGELOG.md:246
  612. msgid ""
  613. "For those wishing to more easily integrate "
  614. "[Prometheus](https://prometheus.io/)' alerting service "
  615. "([Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/))"
  616. " with Matrix, the playbook can now set up [matrix-alertmanager-"
  617. "receiver](https://github.com/metio/matrix-alertmanager-receiver)."
  618. msgstr ""
  619. #: ../../../CHANGELOG.md:248
  620. msgid ""
  621. "See [Setting up Prometheus Alertmanager integration via matrix-"
  622. "alertmanager-receiver](./docs/configuring-playbook-alertmanager-"
  623. "receiver.md) for more details."
  624. msgstr ""
  625. #: ../../../CHANGELOG.md:250
  626. msgid "Traefik v3 and HTTP/3 are here now"
  627. msgstr ""
  628. #: ../../../CHANGELOG.md:252
  629. msgid ""
  630. "**TLDR**: Traefik was migrated from v2 to v3. Minor changes were done to "
  631. "the playbook. Mostly everything else worked out of the box. Most people "
  632. "will not have to do any tweaks to their configuration. In addition, "
  633. "[HTTP/3](https://en.wikipedia.org/wiki/HTTP/3) support is now auto-"
  634. "enabled for the `web-secure` (port 443) and `matrix-federation` (port "
  635. "`8448`) entrypoints. If you have a firewall in front of your server and "
  636. "you wish to benefit from `HTTP3`, you will need to open the `443` and "
  637. "`8448` UDP ports in it."
  638. msgstr ""
  639. #: ../../../CHANGELOG.md:254
  640. msgid "Traefik v3"
  641. msgstr ""
  642. #: ../../../CHANGELOG.md:256
  643. msgid ""
  644. "The reverse-proxy that the playbook uses by default (Traefik) has "
  645. "recently been upgraded to v3 (see [this blog "
  646. "post](https://traefik.io/blog/announcing-traefik-proxy-v3-rc/) to learn "
  647. "about its new features). Version 3 includes some small breaking "
  648. "configuration changes requiring a "
  649. "[migration](https://doc.traefik.io/traefik/migration/v2-to-v3/)."
  650. msgstr ""
  651. #: ../../../CHANGELOG.md:258
  652. msgid ""
  653. "We have **updated the playbook to Traefik v3** (make sure to run `just "
  654. "roles` / `make roles` to get it)."
  655. msgstr ""
  656. #: ../../../CHANGELOG.md:260
  657. msgid ""
  658. "There were **only minor playbook changes required** to adapt to Traefik "
  659. "v3, and only to the Ansible role for [matrix-media-repo](./docs"
  660. "/configuring-playbook-matrix-media-repo.md) where we changed a few "
  661. "[`PathPrefix` instances to "
  662. "`PathRegexp`](https://doc.traefik.io/traefik/routing/routers/#path-"
  663. "pathprefix-and-pathregexp), because these instances were using a regular "
  664. "expression instead of a fixed path. For fixed-path values, `PathPrefix` "
  665. "is still the preferred matcher function to use."
  666. msgstr ""
  667. #: ../../../CHANGELOG.md:262
  668. msgid "**Most people using the playbook should not have to do any changes**."
  669. msgstr ""
  670. #: ../../../CHANGELOG.md:264
  671. msgid ""
  672. "If you're using the playbook's Traefik instance to reverse-proxy to some "
  673. "other services of your own (not managed by the playbook), you may wish to"
  674. " review their Traefik labels and make sure they're in line with the "
  675. "[Traefik v2 to v3 migration "
  676. "guide](https://doc.traefik.io/traefik/migration/v2-to-v3/)."
  677. msgstr ""
  678. #: ../../../CHANGELOG.md:266
  679. msgid ""
  680. "If you've tweaked any of this playbook's `_path_prefix` variables and "
  681. "made them use a regular expression, you will now need to make additional "
  682. "adjustments. The playbook makes extensive use of `PathPrefix()` matchers "
  683. "in Traefik rules and `PathPrefix` does not support regular expressions "
  684. "anymore. To work around it, you may now need to override a whole "
  685. "`_traefik_rule` variable and switch it from [`PathPrefix` to "
  686. "`PathRegexp`](https://doc.traefik.io/traefik/routing/routers/#path-"
  687. "pathprefix-and-pathregexp)."
  688. msgstr ""
  689. #: ../../../CHANGELOG.md:268
  690. msgid ""
  691. "If you're not using [matrix-media-repo](./docs/configuring-playbook-"
  692. "matrix-media-repo.md) (the only role we had to tweak to adapt it to "
  693. "Traefik v3), you **may potentially downgrade to Traefik v2** (if "
  694. "necessary) by adding `traefik_verison: v2.11.4` to your configuration. "
  695. "People using `matrix-media-repo` cannot downgrade this way, because "
  696. "`matrix-media-repo` has been adjusted to use `PathRegexp` - a [routing "
  697. "matcher](https://doc.traefik.io/traefik/v2.11/routing/routers/#rule) that"
  698. " Traefik v2 does not understand."
  699. msgstr ""
  700. #: ../../../CHANGELOG.md:270
  701. msgid "HTTP/3 is enabled by default"
  702. msgstr ""
  703. #: ../../../CHANGELOG.md:272
  704. msgid ""
  705. "In Traefik v3, [HTTP/3](https://en.wikipedia.org/wiki/HTTP/3) support is "
  706. "no longer considered experimental now. Due to this, **the playbook auto-"
  707. "enables HTTP3** for the `web-secure` (port 443) and `matrix-federation` "
  708. "(port `8448`) entrypoints."
  709. msgstr ""
  710. #: ../../../CHANGELOG.md:274
  711. msgid ""
  712. "HTTP3 uses the UDP protocol and **the playbook (together with Docker) "
  713. "will make sure that the appropriate ports** (`443` over UDP & `8448` over"
  714. " UDP) **are exposed and whitelisted in your server's firewall**. However,"
  715. " **if you have another firewall in front of your server** (as is the case"
  716. " for many cloud providers), **you will need to manually open these UDP "
  717. "ports**."
  718. msgstr ""
  719. #: ../../../CHANGELOG.md:276
  720. msgid ""
  721. "If you do not open the UDP ports correctly or there is some other issue, "
  722. "clients (browsers, mostly) will fall-back to "
  723. "[HTTP/2](https://en.wikipedia.org/wiki/HTTP/2) or even "
  724. "[HTTP/1.1](https://en.wikipedia.org/wiki/HTTP)."
  725. msgstr ""
  726. #: ../../../CHANGELOG.md:278
  727. msgid ""
  728. "Still, if HTTP/3 cannot function correctly in your setup, it's best to "
  729. "disable advertising support for it (and misleading clients into trying to"
  730. " use HTTP/3)."
  731. msgstr ""
  732. #: ../../../CHANGELOG.md:280
  733. msgid "To **disable HTTP/3**, you can use the following configuration:"
  734. msgstr ""
  735. #: ../../../CHANGELOG.md:294
  736. msgid ""
  737. "If you are using [your own webserver](./docs/configuring-playbook-own-"
  738. "webserver.md) (in front of Traefik), port binding on UDP port `8448` by "
  739. "default due to HTTP/3 is either unnecessary or [may get in the "
  740. "way](https://github.com/spantaleev/matrix-docker-ansible-"
  741. "deploy/issues/3402). If it does, you can disable it:"
  742. msgstr ""
  743. #: ../../../CHANGELOG.md:307
  744. msgid "2024-07-01"
  745. msgstr ""
  746. #: ../../../CHANGELOG.md:309
  747. msgid "synapse-admin is now restricted to your homeserver's URL by default"
  748. msgstr ""
  749. #: ../../../CHANGELOG.md:311
  750. msgid ""
  751. "A new feature introduced in synapse-admin [v0.10.0](https://github.com"
  752. "/Awesome-Technologies/synapse-admin/releases/tag/0.10.0) (released and "
  753. "supported by the playbook since a a few months ago) provides the ability "
  754. "to [restrict its usage to a specific homeserver](https://github.com"
  755. "/Awesome-Technologies/synapse-"
  756. "admin/blob/e21e44362c879ac41f47c580b04210842b6ff3d7/README.md"
  757. "#restricting-available-homeserver) (or multiple homeservers)."
  758. msgstr ""
  759. #: ../../../CHANGELOG.md:313
  760. msgid ""
  761. "The playbook has just started making use of this feature. **From now on, "
  762. "your synapse-admin instance will be restricted to the homeserver you're "
  763. "managing via the playbook**. When configured like this, the *Homeserver "
  764. "URL* field in synapse-admin's web UI changes from a text field to a "
  765. "dropdown having a single value (the URL of your homeserver). This makes "
  766. "usage simpler for most people, as they won't need to manually enter a "
  767. "*Homeserver URL* anymore."
  768. msgstr ""
  769. #: ../../../CHANGELOG.md:315
  770. msgid ""
  771. "If you'd like **to go back to the old unrestricted behavior**, use the "
  772. "following configuration:"
  773. msgstr ""
  774. #: ../../../CHANGELOG.md:323
  775. msgid "2024-06-25"
  776. msgstr ""
  777. #: ../../../CHANGELOG.md:325
  778. msgid "The URL-prefix for Hookshot generic webhooks has changed"
  779. msgstr ""
  780. #: ../../../CHANGELOG.md:327
  781. msgid ""
  782. "Until now, generic Hookshot webhook URLs looked like this: "
  783. "`https://matrix.example.com/hookshot/webhooks/:hookId`."
  784. msgstr ""
  785. #: ../../../CHANGELOG.md:329
  786. msgid ""
  787. "The `/hookshot/webhooks` common prefix gets stripped by Traefik "
  788. "automatically, so Hookshot only sees the part that comes after "
  789. "(`/:hookId`)."
  790. msgstr ""
  791. #: ../../../CHANGELOG.md:331
  792. msgid ""
  793. "[A few years ago](https://github.com/spantaleev/matrix-docker-ansible-"
  794. "deploy/issues/1681), Hookshot started to prefer to handle webhooks at a "
  795. "`/webhook/:hookId` path (instead of directly at `/:hookId`)."
  796. msgstr ""
  797. #: ../../../CHANGELOG.md:333
  798. msgid ""
  799. "To avoid future problems, we've "
  800. "[reconfigured](https://github.com/spantaleev/matrix-docker-ansible-"
  801. "deploy/commit/4704a60718946fd469aeee7fc3ae8127c633bb6b) our Hookshot "
  802. "configuration to use webhook URLs that include `/webhook` in the URL "
  803. "suffix (e.g. `/hookshot/webhooks/webhook/:hookId`, instead of "
  804. "`/hookshot/webhooks/:hookId`). This means that when we strip the common "
  805. "prefi (`/hookshot/webhooks`), we'll end up sending `/webhook/:hookId` to "
  806. "Hookshot, just like recommended."
  807. msgstr ""
  808. #: ../../../CHANGELOG.md:335
  809. msgid ""
  810. "When generating new webhooks, you should start seeing the new URLs being "
  811. "used."
  812. msgstr ""
  813. #: ../../../CHANGELOG.md:337
  814. msgid ""
  815. "**For now**, **both** old URLs (`/hookshot/webhooks/:hookId`) and new "
  816. "URLs (`/hookshot/webhooks/webhook/:hookId`) **continue to work**, so your"
  817. " webhooks will not break just yet."
  818. msgstr ""
  819. #: ../../../CHANGELOG.md:339
  820. msgid ""
  821. "However, **we recommend that you update all your old webhook URLs** "
  822. "(configured in other systems) to include the new `/webhook` path "
  823. "component, so that future Hookshot changes (whenever they come) will not "
  824. "break your webhooks. You don't need to do anything on the Hookshot side -"
  825. " you merely need to reconfigure the remote systems that use your webhook "
  826. "URLs."
  827. msgstr ""
  828. #: ../../../CHANGELOG.md:342
  829. msgid "2024-06-22"
  830. msgstr ""
  831. #: ../../../CHANGELOG.md:344
  832. msgid "The maubot user is now managed by the playbook"
  833. msgstr ""
  834. #: ../../../CHANGELOG.md:346
  835. msgid ""
  836. "To make things easier and to be consistent with other roles, the "
  837. "[maubot](./docs/configuring-playbook-bot-maubot.md) user (`bot.maubot` by"
  838. " default) is [now](https://github.com/spantaleev/matrix-docker-ansible-"
  839. "deploy/pull/3376) automatically created be the playbook."
  840. msgstr ""
  841. #: ../../../CHANGELOG.md:348
  842. msgid ""
  843. "If you have an existing maubot installation, you will need to specify "
  844. "`matrix_bot_maubot_initial_password` in your `vars.yml` file to make the "
  845. "playbook not complain about it being undefined. Since the bot is already "
  846. "registered in your installation, there's nothing for the playbook to do "
  847. "anyway. In case you don't remember the password you've registered your "
  848. "maubot user account with, you can specify any value for this variable."
  849. msgstr ""
  850. #: ../../../CHANGELOG.md:350
  851. msgid ""
  852. "If you've registered another username for the bot (other than the "
  853. "recommended default of `bot.maubot`), consider adjusting the "
  854. "`matrix_bot_maubot_login` variable (e.g. `matrix_bot_maubot_login: "
  855. "my.maubot.username`)."
  856. msgstr ""
  857. #: ../../../CHANGELOG.md:353
  858. msgid "2024-06-03"
  859. msgstr ""
  860. #: ../../../CHANGELOG.md:355
  861. msgid "WeChat bridging support"
  862. msgstr ""
  863. #: ../../../CHANGELOG.md:357
  864. msgid ""
  865. "Thanks to [Tobias Diez](https://github.com/tobiasdiez)'s "
  866. "[efforts](https://github.com/spantaleev/matrix-docker-ansible-"
  867. "deploy/pull/3241), the playbook now supports bridging to "
  868. "[WeChat](https://www.wechat.com/) via the [matrix-"
  869. "wechat](https://github.com/duo/matrix-wechat) bridge."
  870. msgstr ""
  871. #: ../../../CHANGELOG.md:359
  872. msgid ""
  873. "See our [Setting up WeChat bridging](docs/configuring-playbook-bridge-"
  874. "wechat.md) documentation page for getting started."
  875. msgstr ""
  876. #: ../../../CHANGELOG.md:362
  877. msgid "2024-03-26"
  878. msgstr ""
  879. #: ../../../CHANGELOG.md:364
  880. msgid ""
  881. "(Backward Compatibility Break) The playbook now defaults to KeyDB, "
  882. "instead of Redis"
  883. msgstr ""
  884. #: ../../../CHANGELOG.md:366
  885. msgid ""
  886. "**TLDR**: if the playbook used installed Redis as a dependency for you "
  887. "before, it will now replace it with [KeyDB](https://docs.keydb.dev/) (a "
  888. "drop-in alternative) due to [Redis having changed its "
  889. "license](https://redis.com/blog/redis-adopts-dual-source-available-"
  890. "licensing/)."
  891. msgstr ""
  892. #: ../../../CHANGELOG.md:368
  893. msgid ""
  894. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  895. "[etke.cc](https://etke.cc/), the playbook now uses "
  896. "[KeyDB](https://docs.keydb.dev/) (a drop-in alternative for Redis), "
  897. "instead of [Redis](https://redis.io/)."
  898. msgstr ""
  899. #: ../../../CHANGELOG.md:370
  900. msgid ""
  901. "The playbook used to install Redis (and now installs KeyDB in its place) "
  902. "if services have a need for it ([enabling worker support for "
  903. "Synapse](docs/configuring-playbook-synapse.md#load-balancing-with-"
  904. "workers), [enabling Hookshot encryption](docs/configuring-playbook-"
  905. "bridge-hookshot.md#end-to-bridge-encryption), etc.) or if you explicitly "
  906. "enabled the service (`redis_enabled: true` or `keydb_enabled: true`)."
  907. msgstr ""
  908. #: ../../../CHANGELOG.md:372
  909. msgid ""
  910. "This change is provoked by the fact that [Redis is now \"source "
  911. "available\"](https://redis.com/blog/redis-adopts-dual-source-available-"
  912. "licensing/). According to the Limitations of [the new "
  913. "license](https://redis.com/legal/rsalv2-agreement/) (as best as we "
  914. "understand them, given that we're not lawyers), using Redis in the "
  915. "playbook (even in a commercial FOSS service like "
  916. "[etke.cc](https://etke.cc/)) does not violate the new Redis license. That"
  917. " said, we'd rather neither risk it, nor endorse shady licenses and "
  918. "products that pretend to be free-software. Another high-quality "
  919. "alternative to Redis seems to be "
  920. "[Dragonfly](https://www.dragonflydb.io/), but the [Dragonfly "
  921. "license](https://github.com/dragonflydb/dragonfly?tab=License-1-ov-"
  922. "file#readme) is no better than Redis's."
  923. msgstr ""
  924. #: ../../../CHANGELOG.md:374
  925. msgid ""
  926. "Next time your run the playbook (via the `setup-all` tag), **Redis will "
  927. "be automatically uninstalled and replaced with KeyDB**. Some Synapse "
  928. "downtime may occur while the switch happens."
  929. msgstr ""
  930. #: ../../../CHANGELOG.md:376
  931. msgid ""
  932. "Users on `arm32` should be aware that there's **neither a prebuilt "
  933. "`arm32` container image for KeyDB**, nor the KeyDB role supports self-"
  934. "building yet. Users on this architecture likely don't run Synapse with "
  935. "workers, etc., so they're likely in no need of KeyDB (or Redis). If Redis"
  936. " is necessary in an `arm32` deployment, disabling KeyDB and making the "
  937. "playbook fall back to Redis is possible (see below)."
  938. msgstr ""
  939. #: ../../../CHANGELOG.md:387
  940. msgid "2024-03-24"
  941. msgstr ""
  942. #: ../../../CHANGELOG.md:389
  943. msgid "Initial work on IPv6 support"
  944. msgstr ""
  945. #: ../../../CHANGELOG.md:391
  946. msgid ""
  947. "Thanks to [Tilo Spannagel](https://github.com/tilosp), the playbook can "
  948. "now enable IPv6 for container networks for various components (roles) via"
  949. " [the `devture_systemd_docker_base_ipv6_enabled` "
  950. "variable](https://github.com/devture/com.devture.ansible.role.systemd_docker_base/blob/c11a526bb8e318b42eb52055056377bb31154f13/defaults/main.yml#L14-L31)."
  951. msgstr ""
  952. #: ../../../CHANGELOG.md:393
  953. msgid "It should be noted that:"
  954. msgstr ""
  955. #: ../../../CHANGELOG.md:395
  956. msgid ""
  957. "Matrix roles (`roles/custom/matrix-*`) respect this variable, but "
  958. "external roles (those defined in `requirements.yml` and installed via "
  959. "`just roles`) do not respect it yet. Additional work is necessary"
  960. msgstr ""
  961. #: ../../../CHANGELOG.md:396
  962. msgid ""
  963. "changing the variable subsequently may not change existing container "
  964. "networks. Refer to [these "
  965. "instructions](https://github.com/devture/com.devture.ansible.role.systemd_docker_base/blob/c11a526bb8e318b42eb52055056377bb31154f13/defaults/main.yml#L26-L30)"
  966. msgstr ""
  967. #: ../../../CHANGELOG.md:397
  968. msgid "this is all very new and untested"
  969. msgstr ""
  970. #: ../../../CHANGELOG.md:399
  971. msgid "Pantalaimon support"
  972. msgstr ""
  973. #: ../../../CHANGELOG.md:401
  974. msgid ""
  975. "Thanks to [Julian Foad](https://matrix.to/#/@julian:foad.me.uk), the "
  976. "playbook can now install the [Pantalaimon](https://github.com/matrix-"
  977. "org/pantalaimon) E2EE aware proxy daemon for you. It's already possible "
  978. "to integrate it with [Draupnir](docs/configuring-playbook-bot-"
  979. "draupnir.md) to allow it to work in E2EE rooms - see our Draupnir docs "
  980. "for details."
  981. msgstr ""
  982. #: ../../../CHANGELOG.md:403
  983. msgid ""
  984. "See our [Setting up Pantalaimon](docs/configuring-playbook-"
  985. "pantalaimon.md) documentation to get started."
  986. msgstr ""
  987. #: ../../../CHANGELOG.md:406
  988. msgid "2024-03-05"
  989. msgstr ""
  990. #: ../../../CHANGELOG.md:408
  991. msgid "Support for Draupnir-for-all"
  992. msgstr ""
  993. #: ../../../CHANGELOG.md:410
  994. msgid ""
  995. "Thanks to [FSG-Cat](https://github.com/FSG-Cat), the playbook can now "
  996. "install [Draupnir for all](./docs/configuring-playbook-appservice-"
  997. "draupnir-for-all.md) (aka multi-instance Draupnir running in appservice "
  998. "mode)."
  999. msgstr ""
  1000. #: ../../../CHANGELOG.md:412
  1001. msgid ""
  1002. "This is an alternative to [running Draupnir in bot mode](./docs"
  1003. "/configuring-playbook-bot-draupnir.md), which is still supported by the "
  1004. "playbook."
  1005. msgstr ""
  1006. #: ../../../CHANGELOG.md:414
  1007. msgid ""
  1008. "The documentation page for [Draupnir for all](./docs/configuring-"
  1009. "playbook-appservice-draupnir-for-all.md) contains more information on how"
  1010. " to install it."
  1011. msgstr ""
  1012. #: ../../../CHANGELOG.md:417
  1013. msgid "2024-02-19"
  1014. msgstr ""
  1015. #: ../../../CHANGELOG.md:419
  1016. msgid "Support for bridging to Facebook/Messenger via the new mautrix-meta bridge"
  1017. msgstr ""
  1018. #: ../../../CHANGELOG.md:421
  1019. msgid ""
  1020. "The [mautrix-facebook](./docs/configuring-playbook-bridge-mautrix-"
  1021. "facebook.md) and [mautrix-instagram](./docs/configuring-playbook-bridge-"
  1022. "mautrix-instagram.md) bridges are being [superseded by a new "
  1023. "bridge](https://github.com/mautrix/facebook/issues/332) - the [mautrix-"
  1024. "meta](https://github.com/mautrix/meta) bridge."
  1025. msgstr ""
  1026. #: ../../../CHANGELOG.md:423
  1027. msgid ""
  1028. "The playbook now supports the new mautrix-meta bridge - a single bridge, "
  1029. "which can run in different modes and bridge to Messenger (via "
  1030. "[Facebook](https://facebook.com/), Facebook over "
  1031. "[Tor](https://www.torproject.org/) or via "
  1032. "[Messenger](https://messenger.com/)) and "
  1033. "[Instagram](https://instagram.com/). The playbook makes this bridge "
  1034. "available via 2 separate Ansible roles, allowing you to easily run 2 "
  1035. "instances of mautrix-meta, for bridging to both services at the same "
  1036. "time."
  1037. msgstr ""
  1038. #: ../../../CHANGELOG.md:425
  1039. msgid ""
  1040. "If you're using mautrix-facebook or mautrix-instagram right now, **you "
  1041. "can still continue using the old bridges, but may wish to change to the "
  1042. "new bridge implementations**. See:"
  1043. msgstr ""
  1044. #: ../../../CHANGELOG.md:427
  1045. msgid ""
  1046. "[Setting up Instagram bridging via Mautrix Meta](docs/configuring-"
  1047. "playbook-bridge-mautrix-meta-instagram.md)"
  1048. msgstr ""
  1049. #: ../../../CHANGELOG.md:429
  1050. msgid ""
  1051. "[Setting up Messenger bridging via Mautrix Meta](docs/configuring-"
  1052. "playbook-bridge-mautrix-meta-messenger.md)"
  1053. msgstr ""
  1054. #: ../../../CHANGELOG.md:431
  1055. msgid "The documentation pages contain more information on how to migrate."
  1056. msgstr ""
  1057. #: ../../../CHANGELOG.md:434
  1058. msgid "2024-02-14"
  1059. msgstr ""
  1060. #: ../../../CHANGELOG.md:436
  1061. msgid "Much larger Synapse caches and cache auto-tuning enabled by default"
  1062. msgstr ""
  1063. #: ../../../CHANGELOG.md:438
  1064. msgid ""
  1065. "Thanks to [FSG-Cat](https://github.com/FSG-Cat), the playbook now uses "
  1066. "much larger caches and enables Synapse's [cache auto-tuning "
  1067. "functionality](https://matrix-"
  1068. "org.github.io/synapse/latest/usage/configuration/config_documentation.html"
  1069. "#caches-and-associated-values). This work and the default values used by "
  1070. "the playbook are inspired by [Tom Foster](https://github.com/tcpipuk)'s "
  1071. "[Synapse homeserver "
  1072. "guide](https://tcpipuk.github.io/synapse/deployment/synapse.html)."
  1073. msgstr ""
  1074. #: ../../../CHANGELOG.md:440
  1075. msgid ""
  1076. "The playbook has always used a very conservative cache factor "
  1077. "(`matrix_synapse_caches_global_factor`) value of `0.5`, which may be OK "
  1078. "for small and underactive deployments, but is not ideal for larger "
  1079. "servers. Paradoxically, a small global cache factor value [does not "
  1080. "necessarily decrease RAM usage as a whole](https://github.com/matrix-"
  1081. "org/synapse/issues/3939)."
  1082. msgstr ""
  1083. #: ../../../CHANGELOG.md:442
  1084. msgid ""
  1085. "The playbook now uses **a 20x larger cache factor** (currently `10`), "
  1086. "adjusts a few other cache-related variables, and **enables cache auto-"
  1087. "tuning** via the following variables:"
  1088. msgstr ""
  1089. #: ../../../CHANGELOG.md:444
  1090. msgid ""
  1091. "`matrix_synapse_cache_autotuning_max_cache_memory_usage` - defaults to "
  1092. "1/8 of total RAM with a cap of 2GB; values are specified in bytes"
  1093. msgstr ""
  1094. #: ../../../CHANGELOG.md:445
  1095. msgid ""
  1096. "`matrix_synapse_cache_autotuning_target_cache_memory_usage` - defaults to"
  1097. " 1/16 of total RAM with a cap of 1GB; values are specified in bytes"
  1098. msgstr ""
  1099. #: ../../../CHANGELOG.md:446
  1100. msgid "`matrix_synapse_cache_autotuning_min_cache_ttl` - defaults to `30s`"
  1101. msgstr ""
  1102. #: ../../../CHANGELOG.md:448
  1103. msgid ""
  1104. "These values should be good defaults for most servers, but may change "
  1105. "over time as we experiment further."
  1106. msgstr ""
  1107. #: ../../../CHANGELOG.md:450
  1108. msgid ""
  1109. "Refer to our new [Tuning caches and cache autotuning](docs/maintenance-"
  1110. "synapse.md#tuning-caches-and-cache-autotuning) documentation section for "
  1111. "more details."
  1112. msgstr ""
  1113. #: ../../../CHANGELOG.md:453
  1114. msgid "2024-01-31"
  1115. msgstr ""
  1116. #: ../../../CHANGELOG.md:455
  1117. msgid ""
  1118. "(Backward-compatibility break) Minor changes necessary for some people "
  1119. "serving a static website at the base domain"
  1120. msgstr ""
  1121. #: ../../../CHANGELOG.md:457
  1122. msgid ""
  1123. "This only affects people who are [Serving a static website at the base "
  1124. "domain](./docs/configuring-playbook-base-domain-serving.md#serving-a"
  1125. "-static-website-at-the-base-domain), but not managing its `index.html` "
  1126. "through the playbook."
  1127. msgstr ""
  1128. #: ../../../CHANGELOG.md:459
  1129. msgid ""
  1130. "That is, for people who have "
  1131. "`matrix_static_files_file_index_html_enabled: false` in their `vars.yml` "
  1132. "configuration, the playbook has a new default behavior. Since the "
  1133. "playbook is not managing the `index.html` file, it will default to a more"
  1134. " sensible way of handling the base domain - redirecting "
  1135. "`https://example.com/` to `https://matrix.example.com/`, instead of "
  1136. "serving a 404 page."
  1137. msgstr ""
  1138. #: ../../../CHANGELOG.md:461
  1139. msgid ""
  1140. "If you are managing your static website by yourself (by dropping files "
  1141. "into `/matrix/static-files/public` somehow), then you probably don't wish"
  1142. " for such redirection to happen. You can disable it by adding "
  1143. "`matrix_static_files_container_labels_base_domain_root_path_redirection_enabled:"
  1144. " false` to your `vars.yml` configuration file."
  1145. msgstr ""
  1146. #: ../../../CHANGELOG.md:464
  1147. msgid "2024-01-20"
  1148. msgstr ""
  1149. #: ../../../CHANGELOG.md:466
  1150. msgid "Support for more efficient (specialized) Synapse workers"
  1151. msgstr ""
  1152. #: ../../../CHANGELOG.md:468
  1153. msgid ""
  1154. "Thanks to [Charles Wright](https://github.com/cvwright) from "
  1155. "[FUTO](https://www.futo.org/), the creators of the [Circles "
  1156. "app](https://circu.li/), the playbook has [received "
  1157. "support](https://github.com/spantaleev/matrix-docker-ansible-"
  1158. "deploy/pull/3100) for load-balancing the Synapse workload via "
  1159. "[specialized workers](./docs/configuring-playbook-synapse.md#specialized-"
  1160. "workers) which are supposed to work better than our old [generic "
  1161. "workers](./docs/configuring-playbook-synapse.md#generic-workers) "
  1162. "implementation."
  1163. msgstr ""
  1164. #: ../../../CHANGELOG.md:470
  1165. msgid ""
  1166. "For now, playbook defaults remain unchanged and the `one-of-each` "
  1167. "[workers preset](./docs/configuring-playbook-synapse.md#worker-presets) "
  1168. "continues being the default. However, the default may change in the "
  1169. "future. If you'd like to remain on this preset even if/when the defaults "
  1170. "change, consider explicitly adding `matrix_synapse_workers_preset: one-"
  1171. "of-each` to your `vars.yml` configuration."
  1172. msgstr ""
  1173. #: ../../../CHANGELOG.md:472
  1174. msgid ""
  1175. "Our specialized workers setup is based on recommendations found in [Tom "
  1176. "Foster](https://github.com/tcpipuk)'s [Synapse homeserver "
  1177. "guide](https://tcpipuk.github.io/synapse/index.html). What's special "
  1178. "about our new setup is that we try to parse information out of the "
  1179. "request (who the user is; which room is being operated on) and try to "
  1180. "forward similar requests to the same worker. As an example, this means "
  1181. "that once a worker caches some room information, subsequent requests for "
  1182. "the same room will be routed to the same worker (which supposedly still "
  1183. "has the room's state cached)."
  1184. msgstr ""
  1185. #: ../../../CHANGELOG.md:474
  1186. msgid ""
  1187. "To get started, refer to our [Specialized workers](./docs/configuring-"
  1188. "playbook-synapse.md#specialized-workers) documentation section."
  1189. msgstr ""
  1190. #: ../../../CHANGELOG.md:477
  1191. msgid "2024-01-17"
  1192. msgstr ""
  1193. #: ../../../CHANGELOG.md:479
  1194. msgid "Switching to Element's AGPLv3-licensed Synapse release"
  1195. msgstr ""
  1196. #: ../../../CHANGELOG.md:481
  1197. msgid ""
  1198. "A few months ago, the [Element](https://element.io/) company has "
  1199. "[announced](https://element.io/blog/element-to-adopt-agplv3/) that their "
  1200. "work on the Synapse homeserver would no longer be available under the "
  1201. "permissive [Apache-2.0 "
  1202. "license](https://www.apache.org/licenses/LICENSE-2.0), but only under:"
  1203. msgstr ""
  1204. #: ../../../CHANGELOG.md:483
  1205. msgid ""
  1206. "the [AGPLv3](https://www.gnu.org/licenses/agpl-3.0.en.html) free-software"
  1207. " license - the same license that this Ansible playbook has always used"
  1208. msgstr ""
  1209. #: ../../../CHANGELOG.md:484
  1210. msgid ""
  1211. "a proprietary license, for those wishing for Element to [sell them an "
  1212. "exception](https://gnu.org/philosophy/selling-exceptions.html) to the "
  1213. "AGPLv3 license"
  1214. msgstr ""
  1215. #: ../../../CHANGELOG.md:486
  1216. msgid ""
  1217. "You can also learn more in [this post](https://matrix.org/blog/2023/11/06"
  1218. "/future-of-synapse-dendrite/) by the Matrix Foundation."
  1219. msgstr ""
  1220. #: ../../../CHANGELOG.md:488
  1221. msgid ""
  1222. "The change has [already happened](https://element.io/blog/synapse-now-"
  1223. "lives-at-github-com-element-hq-synapse/) and the first Synapse release "
  1224. "under the new license is here: [v1.99.0](https://github.com/element-"
  1225. "hq/synapse/releases/tag/v1.99.0)."
  1226. msgstr ""
  1227. #: ../../../CHANGELOG.md:490
  1228. msgid ""
  1229. "There is no up-to-date alternative Synapse fork right now and this free-"
  1230. "software (AGPLv3-licensed) playbook is definitely not against free-"
  1231. "software licenses, so we are now switching to the Element-maintained "
  1232. "Synapse release."
  1233. msgstr ""
  1234. #: ../../../CHANGELOG.md:492
  1235. msgid "**What does this mean to you?**"
  1236. msgstr ""
  1237. #: ../../../CHANGELOG.md:494
  1238. msgid ""
  1239. "For most home users, it doesn't mean anything. Your installation will "
  1240. "continue working as it should and you don't need to do anything."
  1241. msgstr ""
  1242. #: ../../../CHANGELOG.md:496
  1243. msgid ""
  1244. "For people building commercial products on top of Synapse, they may have "
  1245. "to either buy a license exception from Element (from what we hear, the "
  1246. "fee depends on the number of monthly-active users on your instance) or "
  1247. "they may need to release all related code as free-software (which is what"
  1248. " we've been doing at [etke.cc](https://etke.cc/) "
  1249. "([here](https://gitlab.com/etke.cc)) all along)."
  1250. msgstr ""
  1251. #: ../../../CHANGELOG.md:498
  1252. msgid ""
  1253. "We're no lawyers and this changelog entry does not aim to give you the "
  1254. "best legal advice, so please research on your own!"
  1255. msgstr ""
  1256. #: ../../../CHANGELOG.md:500
  1257. msgid ""
  1258. "If you'd like to continue using the old Apache-2.0-licensed Synapse (for "
  1259. "a while longer anyway), the playbook makes it possible by intruducing a "
  1260. "new Ansible variable. You can do it like this:"
  1261. msgstr ""
  1262. #: ../../../CHANGELOG.md:512
  1263. msgid "Notes:"
  1264. msgstr ""
  1265. #: ../../../CHANGELOG.md:514
  1266. msgid ""
  1267. "if you had already upgraded Synapse to `v1.99.0` by running this "
  1268. "playbook, you will still be able to downgrade to `v1.98.0`, because both "
  1269. "releases use the same database schema version (`SCHEMA_COMPAT_VERSION = "
  1270. "83` - see [here for v1.98.0](https://github.com/element-"
  1271. "hq/synapse/blob/v1.98.0/synapse/storage/schema/__init__.py#L131-L134) and"
  1272. " [here for v1.99.0](https://github.com/element-"
  1273. "hq/synapse/blob/v1.99.0/synapse/storage/schema/__init__.py#L137-L140)). "
  1274. "More details on Synapse's database schema are available [here](https"
  1275. "://element-"
  1276. "hq.github.io/synapse/develop/development/database_schema.html). It "
  1277. "appears that there are no new database migrations introduced in "
  1278. "`v1.99.0`, so going back to the older release is possible. This is not "
  1279. "guaranteed to hold true for future Synapse releases, so if you're seeing "
  1280. "this early-enough, consider pinning the version and organization before "
  1281. "re-running the playbook and getting upgraded to the latest version"
  1282. msgstr ""
  1283. #: ../../../CHANGELOG.md:516
  1284. msgid ""
  1285. "running an outdated homeserver exposes you to security issues and "
  1286. "incompatibilities. Only consider doing this as a short-term solution."
  1287. msgstr ""
  1288. #: ../../../CHANGELOG.md:518
  1289. msgid "2024-01-16"
  1290. msgstr ""
  1291. #: ../../../CHANGELOG.md:520
  1292. msgid "`Draupnir` has been relicensed to AFL-3.0"
  1293. msgstr ""
  1294. #: ../../../CHANGELOG.md:522
  1295. msgid ""
  1296. "As of [#204](https://github.com/the-draupnir-project/Draupnir/pull/204) "
  1297. "Draupnir changed its licence to AFL-3.0 from the CSL licence. This change"
  1298. " affects playbook users who could not run Draupnir under the old license "
  1299. "restrictions. The new license is considerably less restrictive and is OSI"
  1300. " approved. Draupnir version v1.86.0 and later are covered by this license"
  1301. " change."
  1302. msgstr ""
  1303. #: ../../../CHANGELOG.md:524
  1304. msgid "2024-01-15"
  1305. msgstr ""
  1306. #: ../../../CHANGELOG.md:526
  1307. msgid "Goodbye, `matrix-nginx-proxy` 🪦"
  1308. msgstr ""
  1309. #: ../../../CHANGELOG.md:528
  1310. msgid ""
  1311. "**TLDR**: All traces of the `matrix-nginx-proxy` reverse-proxy component "
  1312. "are now gone. This brought about many other internal changes (and "
  1313. "security improvements), so setups may need minor adjustments or suffer "
  1314. "some (temporary) breakage. People who have been on the Traefik-native "
  1315. "setup may upgrade without much issues. Those running their own Traefik "
  1316. "instance may need minor changes. People who have been postponing the "
  1317. "migration away from `matrix-nginx-proxy` (for more than a year already!) "
  1318. "will now finally need to do something about it."
  1319. msgstr ""
  1320. #: ../../../CHANGELOG.md:530
  1321. msgid "Backstory on `matrix-nginx-proxy`"
  1322. msgstr ""
  1323. #: ../../../CHANGELOG.md:532
  1324. msgid ""
  1325. "We gather here today to celebrate the loss of a once-beloved component in"
  1326. " our stack - `matrix-nginx-proxy`. It's been our "
  1327. "[nginx](https://nginx.org/)-based reverse-proxy of choice since the "
  1328. "[first commit](https://github.com/spantaleev/matrix-docker-ansible-"
  1329. "deploy/tree/87f5883f2455fb115457b65f267f17de305c053c) of this playbook, 7"
  1330. " years ago."
  1331. msgstr ""
  1332. #: ../../../CHANGELOG.md:534
  1333. msgid ""
  1334. "For 6 years, `matrix-nginx-proxy` has been the front-most reverse-proxy "
  1335. "in our setup (doing SSL termination, etc.). After [transitioning to "
  1336. "Traefik last year](#traefik-is-the-default-reverse-proxy-now), `matrix-"
  1337. "nginx-proxy` took a step back. Nevertheless, since it was so ingrained "
  1338. "into the playbook, it still remained in use - even if only internally. "
  1339. "Despite our warnings of its imminent death, many of you have indubitably "
  1340. "continued to use it instead of Traefik. Its suffering continued for too "
  1341. "long, because it served many different purposes and massive effort was "
  1342. "required to transition them to others."
  1343. msgstr ""
  1344. #: ../../../CHANGELOG.md:536
  1345. msgid "To us, `matrix-nginx-proxy` was:"
  1346. msgstr ""
  1347. #: ../../../CHANGELOG.md:538
  1348. msgid "an [nginx](https://nginx.org/)-based reverse-proxy"
  1349. msgstr ""
  1350. #: ../../../CHANGELOG.md:539
  1351. msgid ""
  1352. "an Ansible role organizing the work of "
  1353. "[certbot](https://certbot.eff.org/) - retrieving free [Let's "
  1354. "Encrypt](https://letsencrypt.org/) SSL certificates for `matrix-nginx-"
  1355. "proxy` and for the [Coturn TURN server](./docs/configuring-playbook-"
  1356. "turn.md)"
  1357. msgstr ""
  1358. #: ../../../CHANGELOG.md:540
  1359. msgid ""
  1360. "a central component for reverse-proxying to the [long list of "
  1361. "services](./docs/configuring-playbook.md) supported by the playbook. As "
  1362. "such, it became a dependency that all these services had to inject "
  1363. "themselves into during runtime"
  1364. msgstr ""
  1365. #: ../../../CHANGELOG.md:541
  1366. msgid ""
  1367. "an intermediary through which addons (bridges, bots) communicated with "
  1368. "the homeserver. Going through an intermediary (instead of directly "
  1369. "talking to the homeserver) is useful when certain components (like "
  1370. "[matrix-media-repo](./docs/configuring-playbook-matrix-media-repo.md) or "
  1371. "[matrix-corporal](./docs/configuring-playbook-matrix-corporal.md)) are "
  1372. "enabled, because it lets these services \"steal routes\" from the "
  1373. "homeserver"
  1374. msgstr ""
  1375. #: ../../../CHANGELOG.md:542
  1376. msgid ""
  1377. "a webserver for serving the `/.well-known/matrix` static files (generated"
  1378. " by the `matrix-base` role until now)"
  1379. msgstr ""
  1380. #: ../../../CHANGELOG.md:543
  1381. msgid ""
  1382. "a webserver [serving your base domain](./docs/configuring-playbook-base-"
  1383. "domain-serving.md) (and also generating the `index.html` page for it)"
  1384. msgstr ""
  1385. #: ../../../CHANGELOG.md:544
  1386. msgid ""
  1387. "a central component providing global [HTTP Basic "
  1388. "Auth](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) "
  1389. "password-protection for all `/metrics` endpoints when metrics were "
  1390. "exposed publicly for consumption from a remote Prometheus server"
  1391. msgstr ""
  1392. #: ../../../CHANGELOG.md:546
  1393. msgid ""
  1394. "Talk about a jack of all trades! The [UNIX "
  1395. "philosophy](https://en.wikipedia.org/wiki/Unix_philosophy) (and Docker "
  1396. "container philosophy) of \"do one thing and do it well\" had been "
  1397. "severely violated for too long."
  1398. msgstr ""
  1399. #: ../../../CHANGELOG.md:548
  1400. msgid ""
  1401. "On a related note, we also had a large chain of reverse-proxies in the "
  1402. "mix. In the worst case, it was something like this: (Traefik -> `matrix-"
  1403. "nginx-proxy:8080` -> `matrix-nginx-proxy:12080` -> `matrix-synapse-"
  1404. "reverse-proxy-companion:8008` -> `matrix-synapse:8008`)."
  1405. msgstr ""
  1406. #: ../../../CHANGELOG.md:550
  1407. msgid ""
  1408. "Due to complexity and the playbook's flexibility (trying to accommodate a"
  1409. " mix of tens of components), many layers of indirection were necessary. "
  1410. "We do like reverse-proxies, but.. not quite enough to enjoy going through"
  1411. " a chain of ~4 of them before reaching the target service."
  1412. msgstr ""
  1413. #: ../../../CHANGELOG.md:552
  1414. msgid ""
  1415. "After **a ton of work** in the last weeks (200+ commits, which changed "
  1416. "467 files - 8684 insertions and 8913 deletions), **we're finally saying "
  1417. "goodbye** to `matrix-nginx-proxy`."
  1418. msgstr ""
  1419. #: ../../../CHANGELOG.md:554
  1420. msgid "Going Traefik-native and cutting out all middlemen"
  1421. msgstr ""
  1422. #: ../../../CHANGELOG.md:556
  1423. msgid "In our new setup, you'll see the bare minimum number of reverse-proxies."
  1424. msgstr ""
  1425. #: ../../../CHANGELOG.md:558
  1426. msgid ""
  1427. "In most cases, there's only Traefik and all services being registered "
  1428. "directly with it. When [Synapse workers](./docs/configuring-playbook-"
  1429. "synapse.md#load-balancing-with-workers) are enabled, `matrix-synapse-"
  1430. "reverse-proxy-companion` remains as an extra reverse-proxy that requests "
  1431. "go through (for load-balancing to the correct Synapse worker), but in all"
  1432. " other cases services are exposed directly."
  1433. msgstr ""
  1434. #: ../../../CHANGELOG.md:560
  1435. msgid ""
  1436. "This reduces \"network\" hops (improving performance) and also decreases "
  1437. "the number of components (containers). Each Ansible role in our setup is "
  1438. "now independent and doesn't need to interact with other roles during "
  1439. "runtime."
  1440. msgstr ""
  1441. #: ../../../CHANGELOG.md:562
  1442. msgid "Traefik now has an extra job"
  1443. msgstr ""
  1444. #: ../../../CHANGELOG.md:564
  1445. msgid ""
  1446. "Previously, **Traefik had a single purpose** - being the main reverse-"
  1447. "proxy. It was either front-most (terminating SSL, etc.) or you were "
  1448. "[fronting Traefik with your own other reverse-proxy](./docs/configuring-"
  1449. "playbook-own-webserver.md#fronting-the-integrated-reverse-proxy-"
  1450. "webserver-with-another-reverse-proxy). In any case - it had this central "
  1451. "(yet decentralized) job."
  1452. msgstr ""
  1453. #: ../../../CHANGELOG.md:566
  1454. msgid ""
  1455. "Now, **Traefik has one more role** - it serves as an intermediary which "
  1456. "allows addon services (bridges, bots, etc.) to communicate with the "
  1457. "homeserver. As mentioned above, such an intermediary service is not "
  1458. "strictly necessary in all kinds of setups, but more complex setups "
  1459. "(including [matrix-media-repo](./docs/configuring-playbook-matrix-media-"
  1460. "repo.md) or [matrix-corporal](./docs/configuring-playbook-matrix-"
  1461. "corporal.md)) benefit from it."
  1462. msgstr ""
  1463. #: ../../../CHANGELOG.md:568
  1464. msgid ""
  1465. "To perform this new role, Traefik now has a new internal "
  1466. "[entrypoint](https://doc.traefik.io/traefik/routing/entrypoints/) called "
  1467. "`matrix-internal-matrix-client-api`. All homeservers (Conduit, Dendrite, "
  1468. "Synapse and even `matrix-synapse-reverse-proxy-companion`) and "
  1469. "homeserver-related core services ([matrix-media-repo](./docs/configuring-"
  1470. "playbook-matrix-media-repo.md), [matrix-corporal](./docs/configuring-"
  1471. "playbook-matrix-corporal.md) and potentially others) register their "
  1472. "routes (using [container labels](https://docs.docker.com/config/labels-"
  1473. "custom-metadata/)) not only on the public entrypoints (`web-secure`, "
  1474. "`matrix-federation`), but also on this new internal entrypoint."
  1475. msgstr ""
  1476. #: ../../../CHANGELOG.md:570
  1477. msgid ""
  1478. "Doing so, services can contact Traefik on this entrypoint's dedicated "
  1479. "port (the URL defaults to `http://matrix-traefik:8008`) and reach the "
  1480. "homeserver Client-Server API as they expect. Internally, Traefik takes "
  1481. "care of the routing to the correct service."
  1482. msgstr ""
  1483. #: ../../../CHANGELOG.md:572
  1484. msgid ""
  1485. "We've also considered keeping it simple and having services talk to the "
  1486. "homeserver over the public internet (e.g. `https://matrix.example.com`) "
  1487. "thus reusing all existing Traefik routing labels. In this scenario, "
  1488. "performance was incredibly poor (e.g. 70 rps, instead of 1400 rps) due to"
  1489. " TLS and networking overhead. The need for fast internal communication "
  1490. "(via the new internal non-TLS-enabled Traefik entrypoint) is definitely "
  1491. "there. In our benchmarks, Traefik even proved more efficient than nginx "
  1492. "at doing this: ~1200 rps for Traefik compared to ~900 rps for nginx (out "
  1493. "of ~1400 rps when talking to the Synapse homeserver directly)."
  1494. msgstr ""
  1495. #: ../../../CHANGELOG.md:574
  1496. msgid "Traefik serving this second purpose has a few downsides:"
  1497. msgstr ""
  1498. #: ../../../CHANGELOG.md:576
  1499. msgid ""
  1500. "Traefik becomes a runtime dependency for all homeserver-dependant "
  1501. "container services"
  1502. msgstr ""
  1503. #: ../../../CHANGELOG.md:577
  1504. msgid ""
  1505. "all homeserver-dependant services now need to be connected to the "
  1506. "`traefik` container network, even if they don't need public internet "
  1507. "exposure"
  1508. msgstr ""
  1509. #: ../../../CHANGELOG.md:579
  1510. msgid ""
  1511. "Despite these downsides (which the playbook manages automatically), we "
  1512. "believe it's still a good compromise given the amount of complexity it "
  1513. "eliminates and the performance benefits it yields. One alternative we've "
  1514. "[considered](https://github.com/spantaleev/matrix-docker-ansible-"
  1515. "deploy/pull/3045#issuecomment-1867327001) was adding a new intermediary "
  1516. "service (e.g. `matrix-homeserver-proxy` powered by nginx), but this both "
  1517. "had much higher complexity (one more component in the mix; duplication of"
  1518. " effort to produce nginx-compatible route definitions for it) and "
  1519. "slightly worse performance (see above)."
  1520. msgstr ""
  1521. #: ../../../CHANGELOG.md:581
  1522. msgid ""
  1523. "People running the default Traefik setup do not need to do anything to "
  1524. "make Traefik take on this extra job. Your Traefik configuration will be "
  1525. "updated automatically."
  1526. msgstr ""
  1527. #: ../../../CHANGELOG.md:583
  1528. msgid ""
  1529. "**People runnning their own Traefik reverse-proxy need to do [minor "
  1530. "adjustments](#people-managing-their-own-traefik-instance-need-to-do-"
  1531. "minor-changes)**, as described in the section below."
  1532. msgstr ""
  1533. #: ../../../CHANGELOG.md:585
  1534. msgid ""
  1535. "You may disable Traefik acting as an intermediary by explicitly setting "
  1536. "`matrix_playbook_public_matrix_federation_api_traefik_entrypoint_enabled`"
  1537. " to `false`. Services would then be configured to talk to the homeserver "
  1538. "directly, giving you a slight performance boost and a \"simpler\" Traefik"
  1539. " setup. However, such a configuration is less tested and will cause "
  1540. "troubles, especially if you enable more services (like `matrix-media-"
  1541. "repo`, etc.) in the future. As such, it's not recommended."
  1542. msgstr ""
  1543. #: ../../../CHANGELOG.md:587
  1544. msgid "People managing their own Traefik instance need to do minor changes"
  1545. msgstr ""
  1546. #: ../../../CHANGELOG.md:589
  1547. msgid ""
  1548. "This section is for people [managing their own Traefik instance on the "
  1549. "Matrix server](./docs/configuring-playbook-own-webserver.md#traefik-"
  1550. "managed-by-you). Those [using Traefik managed by the playbook](./docs"
  1551. "/configuring-playbook-own-webserver.md#traefik-managed-by-the-playbook) "
  1552. "don't need to do any changes."
  1553. msgstr ""
  1554. #: ../../../CHANGELOG.md:591
  1555. msgid ""
  1556. "Because [Traefik has an extra job now](#traefik-now-has-an-extra-job), "
  1557. "you need to adapt your configuration to add the additional `matrix-"
  1558. "internal-matrix-client-api` entrypoint and potentially configure the "
  1559. "`matrix_playbook_reverse_proxy_container_network` variable. See the "
  1560. "[Traefik managed by you](./docs/configuring-playbook-own-webserver.md"
  1561. "#traefik-managed-by-you) documentation section for more details."
  1562. msgstr ""
  1563. #: ../../../CHANGELOG.md:593
  1564. msgid ""
  1565. "People fronting Traefik with another reverse proxy need to do minor "
  1566. "changes"
  1567. msgstr ""
  1568. #: ../../../CHANGELOG.md:595
  1569. msgid ""
  1570. "We've already previously mentioned that you need to do some minor "
  1571. "[configuration changes related to `traefik_additional_entrypoints_auto"
  1572. "`](#backward-compatibility-configuration-changes-required-for-people-"
  1573. "fronting-the-integrated-reverse-proxy-webserver-with-another-reverse-"
  1574. "proxy)."
  1575. msgstr ""
  1576. #: ../../../CHANGELOG.md:597
  1577. msgid ""
  1578. "If you don't do these changes (switching from "
  1579. "`traefik_additional_entrypoints_auto` to multiple other variables), your "
  1580. "Traefik setup will not automatically receive the new `matrix-internal-"
  1581. "matrix-client-api` Traefik entrypoint and Traefik would not be able to "
  1582. "perform [its new duty of connecting addons with the homeserver](#traefik-"
  1583. "now-has-an-extra-job)."
  1584. msgstr ""
  1585. #: ../../../CHANGELOG.md:599
  1586. msgid "Supported reverse proxy types are now fewer"
  1587. msgstr ""
  1588. #: ../../../CHANGELOG.md:601
  1589. msgid ""
  1590. "This section is for people using a more custom reverse-proxy setup - "
  1591. "those having `matrix_playbook_reverse_proxy_type` set to a value "
  1592. "different than the default (`playbook-managed-traefik`)."
  1593. msgstr ""
  1594. #: ../../../CHANGELOG.md:603
  1595. msgid ""
  1596. "Previously, we allowed you to set `matrix_playbook_reverse_proxy_type` to"
  1597. " 7 different values to accommodate various reverse-proxy setups."
  1598. msgstr ""
  1599. #: ../../../CHANGELOG.md:605
  1600. msgid "The complexity of this is too high, so we only support 3 values right now:"
  1601. msgstr ""
  1602. #: ../../../CHANGELOG.md:607
  1603. msgid ""
  1604. "(the default) `playbook-managed-traefik`, when you're [using Traefik "
  1605. "managed by the playbook](./docs/configuring-playbook-own-webserver.md"
  1606. "#traefik-managed-by-the-playbook)"
  1607. msgstr ""
  1608. #: ../../../CHANGELOG.md:608
  1609. msgid ""
  1610. "`other-traefik-container`, when you're [managing your own Traefik "
  1611. "instance on the Matrix server](./docs/configuring-playbook-own-"
  1612. "webserver.md#traefik-managed-by-you)"
  1613. msgstr ""
  1614. #: ../../../CHANGELOG.md:609
  1615. msgid ""
  1616. "`none`, when you wish for [no reverse-proxy integration to be done at "
  1617. "all](./docs/configuring-playbook-own-webserver.md#using-no-reverse-proxy-"
  1618. "on-the-matrix-side-at-all)"
  1619. msgstr ""
  1620. #: ../../../CHANGELOG.md:611
  1621. msgid ""
  1622. "The `none` value is not recommended and may not work adequately, due to "
  1623. "lack of testing and [Traefik's new responsibilities](#traefik-now-has-an-"
  1624. "extra-job) in our setup."
  1625. msgstr ""
  1626. #: ../../../CHANGELOG.md:613
  1627. msgid ""
  1628. "**Previous values that are now gone** (and the playbook would report them"
  1629. " as such) are: `playbook-managed-nginx`, `other-nginx-non-container`, "
  1630. "`other-on-same-host` and `other-on-another-host`."
  1631. msgstr ""
  1632. #: ../../../CHANGELOG.md:615
  1633. msgid ""
  1634. "If you were using these values as a way to stay away from Traefik, you "
  1635. "now have 2 options:"
  1636. msgstr ""
  1637. #: ../../../CHANGELOG.md:617
  1638. msgid ""
  1639. "(recommended) [Fronting Traefik with another reverse-proxy](./docs"
  1640. "/configuring-playbook-own-webserver.md#fronting-the-integrated-reverse-"
  1641. "proxy-webserver-with-another-reverse-proxy)"
  1642. msgstr ""
  1643. #: ../../../CHANGELOG.md:618
  1644. msgid ""
  1645. "(not recommended) [Using no reverse-proxy on the Matrix side at "
  1646. "all](./docs/configuring-playbook-own-webserver.md#using-no-reverse-proxy-"
  1647. "on-the-matrix-side-at-all) and reverse-proxying to each and every service"
  1648. " manually"
  1649. msgstr ""
  1650. #: ../../../CHANGELOG.md:620
  1651. msgid "Container networking changes"
  1652. msgstr ""
  1653. #: ../../../CHANGELOG.md:622
  1654. msgid ""
  1655. "Now that `matrix-nginx-proxy` is not in the mix, it became easier to "
  1656. "clear out some other long-overdue technical debt."
  1657. msgstr ""
  1658. #: ../../../CHANGELOG.md:624
  1659. msgid ""
  1660. "Since the very beginning of this playbook, all playbook services were "
  1661. "connected to a single (shared) `matrix` container network. Later on, some"
  1662. " additional container networks appeared, but most services (database, "
  1663. "etc.) still remained in the `matrix` container network. This meant that "
  1664. "any random container in this network could try to talk (or attack) the "
  1665. "Postgres database operating in the same `matrix` network."
  1666. msgstr ""
  1667. #: ../../../CHANGELOG.md:626
  1668. msgid ""
  1669. "Moving components (especially the database) into other container networks"
  1670. " was difficult - it required changes to many other components to ensure "
  1671. "correct connectivity."
  1672. msgstr ""
  1673. #: ../../../CHANGELOG.md:628
  1674. msgid ""
  1675. "All the hard work has been done now. We've added much more isolation "
  1676. "between services by splitting them up into separate networks (`matrix-"
  1677. "homeserver`, `matrix-addons`, `matrix-monitoring`, `matrix-exim-relay`, "
  1678. "etc). Components are only joined to the networks they need and should "
  1679. "(for the most part) not be able to access unrelated things."
  1680. msgstr ""
  1681. #: ../../../CHANGELOG.md:630
  1682. msgid ""
  1683. "Carrying out these container networking changes necessitated modifying "
  1684. "many components, so **we're hoping not too many bugs were introduced in "
  1685. "the process**."
  1686. msgstr ""
  1687. #: ../../../CHANGELOG.md:632
  1688. msgid ""
  1689. "We've refrained from creating too many container networks (e.g. one for "
  1690. "each component), to avoid exhausting Docker's default network pool and "
  1691. "contaminating the container networks list too much."
  1692. msgstr ""
  1693. #: ../../../CHANGELOG.md:634
  1694. msgid "Metrics exposure changes"
  1695. msgstr ""
  1696. #: ../../../CHANGELOG.md:636
  1697. msgid ""
  1698. "This section is for people who are exposing monitoring metrics publicly, "
  1699. "to be consumed by an external Prometheus server."
  1700. msgstr ""
  1701. #: ../../../CHANGELOG.md:638
  1702. msgid ""
  1703. "Previously, `matrix-nginx-proxy` was potentially password-protecting all "
  1704. "`/metrics/*` endpoints with the same username and password (specified as "
  1705. "plain-text in your `vars.yml` configuration file)."
  1706. msgstr ""
  1707. #: ../../../CHANGELOG.md:640
  1708. msgid ""
  1709. "From now on, there are new variables for doing roughly the same - "
  1710. "`matrix_metrics_exposure_enabled`, "
  1711. "`matrix_metrics_exposure_http_basic_auth_enabled` and "
  1712. "`matrix_metrics_exposure_http_basic_auth_users`. See the [Prometheus & "
  1713. "Grafana](./docs/configuring-playbook-prometheus-grafana.md) docs page for"
  1714. " details."
  1715. msgstr ""
  1716. #: ../../../CHANGELOG.md:642
  1717. msgid ""
  1718. "`matrix-nginx-proxy` is not acting as a \"global guardian\" anymore. Now,"
  1719. " each role provides its own metrics exposure and protection by "
  1720. "registering with Traefik. Nevertheless, all roles are wired (via playbook"
  1721. " configuration in `group_vars/matrix_servers`) to obey these new "
  1722. "`matrix_metrics_exposure_*` variables. We've eliminated the "
  1723. "centralization, but have kept the ease of use. Now, you can also do per-"
  1724. "service password-protection (with different credentials), should you need"
  1725. " to do that for some reason."
  1726. msgstr ""
  1727. #: ../../../CHANGELOG.md:644
  1728. msgid ""
  1729. "The playbook will tell you about all variables that you need to migrate "
  1730. "during runtime, so rest assured - you shouldn't be able to miss anything!"
  1731. msgstr ""
  1732. #: ../../../CHANGELOG.md:646
  1733. msgid "Matrix static files"
  1734. msgstr ""
  1735. #: ../../../CHANGELOG.md:648
  1736. msgid ""
  1737. "As mentioned above, static files like `/.well-known/matrix/*` or your "
  1738. "base domain's `index.html` file (when [serving the base domain via the "
  1739. "Matrix server](./docs/configuring-playbook-base-domain-serving.md) was "
  1740. "enabled) were generated by the `matrix-base` or `matrix-nginx-proxy` "
  1741. "roles and put into a `/matrix/static-files` directory on the server. Then"
  1742. " `matrix-nginx-proxy` was serving all these static files."
  1743. msgstr ""
  1744. #: ../../../CHANGELOG.md:650
  1745. msgid ""
  1746. "All of this has been extracted into a new `matrix-static-files` Ansible "
  1747. "role that's part of the playbook. The static files generated by this new "
  1748. "role still live at roughly the same place (`/matrix/static-files/public` "
  1749. "directory, instead of `/matrix/static-files`)."
  1750. msgstr ""
  1751. #: ../../../CHANGELOG.md:652
  1752. msgid ""
  1753. "The playbook will migrate and update the `/.well-known/matrix/*` files "
  1754. "automatically but not your own files in `nginx-proxy/data/matrix-domain/`"
  1755. " you will need to back these up yourself otherwise they will be lost. It "
  1756. "will also warn you about usage of old variable names, so you can adapt to"
  1757. " the new names."
  1758. msgstr ""
  1759. #: ../../../CHANGELOG.md:654
  1760. msgid "A note on performance"
  1761. msgstr ""
  1762. #: ../../../CHANGELOG.md:656
  1763. msgid ""
  1764. "Some of you have been voicing their concerns (for a long time) about "
  1765. "Traefik being too slow and nginx being better."
  1766. msgstr ""
  1767. #: ../../../CHANGELOG.md:658
  1768. msgid ""
  1769. "Some online benchmarks support this by demonstrating slightly higher SSL-"
  1770. "termination performance in favor of nginx. The upcoming Traefik v3 "
  1771. "release is [said to](https://medium.com/beyn-technology/is-nginx-dead-is-"
  1772. "traefik-v3-20-faster-than-traefik-v2-f28ffb7eed3e) improve Traefik's SSL "
  1773. "performance by some 20%, but that still ends up being somewhat slower "
  1774. "than nginx."
  1775. msgstr ""
  1776. #: ../../../CHANGELOG.md:660
  1777. msgid ""
  1778. "We believe that using Traefik provides way too many benefits to worry "
  1779. "about this minor performance impairment."
  1780. msgstr ""
  1781. #: ../../../CHANGELOG.md:662
  1782. msgid ""
  1783. "The heaviest part of running a Matrix homeserver is all the slow and "
  1784. "potentially inefficient things the homeserver (e.g. Synapse) is doing. "
  1785. "These things affect performance much more than whatever reverse-proxy is "
  1786. "in front. Your server will die the same way by joining the famously large"
  1787. " **Matrix HQ** room, no matter which reverse-proxy you put in front."
  1788. msgstr ""
  1789. #: ../../../CHANGELOG.md:664
  1790. msgid ""
  1791. "Even our previously mentioned benchmarks (yielding ~1300 rps) are "
  1792. "synthetic - hitting a useless `/_matrix/client/versions` endpoint. Real-"
  1793. "use does much more than this."
  1794. msgstr ""
  1795. #: ../../../CHANGELOG.md:666
  1796. msgid ""
  1797. "If this is still not convincing enough for you and you want the best "
  1798. "possible performance, consider [Fronting Traefik with another reverse-"
  1799. "proxy](./docs/configuring-playbook-own-webserver.md#fronting-the-"
  1800. "integrated-reverse-proxy-webserver-with-another-reverse-proxy) (thus "
  1801. "having the slowest part - SSL termination - happen elsewhere) or [Using "
  1802. "no reverse-proxy on the Matrix side at all](./docs/configuring-playbook-"
  1803. "own-webserver.md#using-no-reverse-proxy-on-the-matrix-side-at-all). The "
  1804. "playbook will not get in your way of doing that, but these options may "
  1805. "make your life much harder. Performance comes at a cost, after all."
  1806. msgstr ""
  1807. #: ../../../CHANGELOG.md:668
  1808. msgid "Migration procedure"
  1809. msgstr ""
  1810. #: ../../../CHANGELOG.md:670
  1811. msgid ""
  1812. "The updated playbook will automatically perform some migration tasks for "
  1813. "you:"
  1814. msgstr ""
  1815. #: ../../../CHANGELOG.md:672
  1816. msgid ""
  1817. "It will stop and remove the `matrix-nginx-proxy` systemd service and "
  1818. "container for you. This behavior cannot be disabled. It's essential that "
  1819. "this service gets stopped, because it remaining running (and having "
  1820. "container labels) may confuse Traefik as to where to route HTTP requests."
  1821. msgstr ""
  1822. #: ../../../CHANGELOG.md:674
  1823. msgid ""
  1824. "It will delete the `/matrix/nginx-proxy` directory and all files within "
  1825. "it. You can disable this behavior by adding "
  1826. "`matrix_playbook_migration_matrix_nginx_proxy_uninstallation_enabled: "
  1827. "false` to your `vars.yml` configuration file. Doing so will leave its "
  1828. "data around."
  1829. msgstr ""
  1830. #: ../../../CHANGELOG.md:676
  1831. msgid ""
  1832. "It will delete the `/matrix/ssl` directory and all files within it. You "
  1833. "can disable this behavior by adding "
  1834. "`matrix_playbook_migration_matrix_ssl_uninstallation_enabled: false` to "
  1835. "your `vars.yml` configuration file. If you have some important "
  1836. "certificates there for some reason, take them out or temporarily disable "
  1837. "removal of these files until you do."
  1838. msgstr ""
  1839. #: ../../../CHANGELOG.md:678
  1840. msgid ""
  1841. "It will tell you about all variables (`matrix_nginx_proxy_*` and many "
  1842. "others - even from other roles) that have changed during this large "
  1843. "nginx-elimination upgrade. You can disable this behavior by adding "
  1844. "`matrix_playbook_migration_matrix_nginx_proxy_elimination_variable_transition_checks_enabled:"
  1845. " false` to your `vars.yml` configuration file."
  1846. msgstr ""
  1847. #: ../../../CHANGELOG.md:680
  1848. msgid ""
  1849. "It will tell you about any leftover `matrix_nginx_proxy_*` variables in "
  1850. "your `vars.yml` file. You can disable this behavior by adding "
  1851. "`matrix_playbook_migration_matrix_nginx_proxy_leftover_variable_validation_checks_enabled:"
  1852. " false` to your `vars.yml` configuration file."
  1853. msgstr ""
  1854. #: ../../../CHANGELOG.md:682
  1855. msgid ""
  1856. "It will tell you about any leftover `matrix_ssl_*` variables in your "
  1857. "`vars.yml` file. You can disable this behavior by adding "
  1858. "`matrix_playbook_migration_matrix_ssl_leftover_variable_checks_enabled: "
  1859. "false` to your `vars.yml` configuration file."
  1860. msgstr ""
  1861. #: ../../../CHANGELOG.md:684
  1862. msgid ""
  1863. "We don't recommend changing these variables and suppressing warnings, "
  1864. "unless you know what you're doing."
  1865. msgstr ""
  1866. #: ../../../CHANGELOG.md:686
  1867. msgid ""
  1868. "**Most people should just upgrade as per-normal**, bearing in mind that a"
  1869. " lot has changed and some issues may arise. The playbook would guide you "
  1870. "through renamed variables automatically."
  1871. msgstr ""
  1872. #: ../../../CHANGELOG.md:688
  1873. msgid "Conclusion"
  1874. msgstr ""
  1875. #: ../../../CHANGELOG.md:690
  1876. msgid ""
  1877. "Thousands of lines of code were changed across hundreds of files. All "
  1878. "addons (bridges, bots) were rewired in terms of container networking and "
  1879. "in terms of how they reach the homeserver."
  1880. msgstr ""
  1881. #: ../../../CHANGELOG.md:692
  1882. msgid ""
  1883. "I don't actively use all the ~100 components offered by the playbook (no "
  1884. "one does), nor do I operate servers exercising all edge-cases. As such, "
  1885. "issues may arise. Please have patience and report (or try to fix) these "
  1886. "issues!"
  1887. msgstr ""
  1888. #: ../../../CHANGELOG.md:695
  1889. msgid "2024-01-14"
  1890. msgstr ""
  1891. #: ../../../CHANGELOG.md:697
  1892. msgid ""
  1893. "(Backward Compatibility) Configuration changes required for people "
  1894. "fronting the integrated reverse-proxy webserver with another reverse-"
  1895. "proxy"
  1896. msgstr ""
  1897. #: ../../../CHANGELOG.md:699
  1898. msgid ""
  1899. "If you're on the default setup (using the Traefik reverse-proxy as "
  1900. "installed by the playbook), you don't need to do anything."
  1901. msgstr ""
  1902. #: ../../../CHANGELOG.md:701
  1903. msgid ""
  1904. "People who are [Fronting the integrated Traefik reverse-proxy webserver "
  1905. "with another reverse-proxy](./docs/configuring-playbook-own-webserver.md"
  1906. "#fronting-the-integrated-reverse-proxy-webserver-with-another-reverse-"
  1907. "proxy), as per our previous instructions are redefining "
  1908. "`traefik_additional_entrypoints_auto` in their `vars.yml` configuration."
  1909. msgstr ""
  1910. #: ../../../CHANGELOG.md:703
  1911. msgid ""
  1912. "Such a full variable redefinion is intrustive, because it prevents the "
  1913. "playbook from injecting additional entrypoints into the Traefik "
  1914. "webserver. In the future, the playbook may have a need to do so."
  1915. msgstr ""
  1916. #: ../../../CHANGELOG.md:705
  1917. msgid ""
  1918. "For this reason, we no longer recommend completely redefining "
  1919. "`traefik_additional_entrypoints_auto`. The playbook now defines [various "
  1920. "`matrix_playbook_public_matrix_federation_api_traefik_entrypoint_*` "
  1921. "variables in the `defaults/main.yml` file](https://github.com/spantaleev"
  1922. "/matrix-docker-ansible-deploy/blob/master/roles/custom/matrix-"
  1923. "base/defaults/main.yml) of the `matrix-base` role which can be used as a "
  1924. "safer alternative to `traefik_additional_entrypoints_auto`."
  1925. msgstr ""
  1926. #: ../../../CHANGELOG.md:707
  1927. msgid "Adapt your configuration as seen below:"
  1928. msgstr ""
  1929. #: ../../../CHANGELOG.md:740
  1930. msgid ""
  1931. "Also, feel free to read the [Fronting the integrated Traefik reverse-"
  1932. "proxy webserver with another reverse-proxy](./docs/configuring-playbook-"
  1933. "own-webserver.md#fronting-the-integrated-reverse-proxy-webserver-with-"
  1934. "another-reverse-proxy) documentation section again for additional "
  1935. "details."
  1936. msgstr ""
  1937. #: ../../../CHANGELOG.md:743
  1938. msgid "2024-01-13"
  1939. msgstr ""
  1940. #: ../../../CHANGELOG.md:745
  1941. msgid ""
  1942. "matrix-reminder-bot update with more secure (backward-incompatible) "
  1943. "default settings"
  1944. msgstr ""
  1945. #: ../../../CHANGELOG.md:747
  1946. msgid ""
  1947. "**TLDR**: your updated (to [v0.3.0](https://github.com/anoadragon453"
  1948. "/matrix-reminder-bot/releases/tag/v0.3.0)) [matrix-reminder-bot](./docs"
  1949. "/configuring-playbook-bot-matrix-reminder-bot.md) is now more secure. By "
  1950. "default, like other bridges/bots managed by the playbook, it will only "
  1951. "provide its services to users of your own server (not to anyone, even "
  1952. "across the Matrix Federation). If that's fine, there's nothing you need "
  1953. "to do."
  1954. msgstr ""
  1955. #: ../../../CHANGELOG.md:749
  1956. msgid ""
  1957. "Maintenance of [matrix-reminder-bot](./docs/configuring-playbook-bot-"
  1958. "matrix-reminder-bot.md) has been picked up by [Kim "
  1959. "Brose](https://github.com/HarHarLinks) and "
  1960. "[@svierne](https://github.com/svierne)."
  1961. msgstr ""
  1962. #: ../../../CHANGELOG.md:751
  1963. msgid ""
  1964. "Thanks to them, a new [v0.3.0](https://github.com/anoadragon453/matrix-"
  1965. "reminder-bot/releases/tag/v0.3.0) release is out. The new version is now "
  1966. "available for the ARM64 architecture, so playbook users on this "
  1967. "architecture will no longer need to wait for [self-building](./docs/self-"
  1968. "building.md) to happen."
  1969. msgstr ""
  1970. #: ../../../CHANGELOG.md:753
  1971. msgid ""
  1972. "The new version also comes with new `allowlist` and `blocklist` settings,"
  1973. " which make it possible to restrict who can use the bot. Previously "
  1974. "anyone, even across the Matrix Federation could talk to it and schedule "
  1975. "reminders."
  1976. msgstr ""
  1977. #: ../../../CHANGELOG.md:755
  1978. msgid ""
  1979. "The playbook defaults all bridges and bots (where possible) to only be "
  1980. "exposed to users of the current homeserver, not users across federation. "
  1981. "Thanks to the new version of this bot making such a restriction possible,"
  1982. " we're now making use of it. The playbook (via its "
  1983. "`group_vars/matrix_servers` file) automatically enables the `allowlist` "
  1984. "(`matrix_bot_matrix_reminder_bot_allowlist_enabled: true`) and configures"
  1985. " it in such a way "
  1986. "(`matrix_bot_matrix_reminder_bot_allowlist_regexes_auto`) so as to "
  1987. "restrict the bot to your homeserver's users."
  1988. msgstr ""
  1989. #: ../../../CHANGELOG.md:757
  1990. msgid ""
  1991. "If you need **to undo or tweak these security improvements**, you can "
  1992. "change your `vars.yml` file to:"
  1993. msgstr ""
  1994. #: ../../../CHANGELOG.md:759
  1995. msgid ""
  1996. "disable the allowlist (`matrix_bot_matrix_reminder_bot_allowlist_enabled:"
  1997. " false`), making the bot allow usage by anyone, anywhere"
  1998. msgstr ""
  1999. #: ../../../CHANGELOG.md:761
  2000. msgid ""
  2001. "inject additional allowed servers or users by adding **additional** (on "
  2002. "top of the default allowlist in "
  2003. "`matrix_bot_matrix_reminder_bot_allowlist_regexes_auto`) custom regexes "
  2004. "in the `matrix_bot_matrix_reminder_bot_allowlist_regexes_custom` list "
  2005. "variable (see the [syntax reference](https://github.com/anoadragon453"
  2006. "/matrix-reminder-"
  2007. "bot/blob/1e910c0aa3469d280d93ee7e6c6d577227a3460c/sample.config.yaml#L43-L49))"
  2008. msgstr ""
  2009. #: ../../../CHANGELOG.md:763
  2010. msgid ""
  2011. "override the default allowlist (in the `group_vars/matrix_servers` file) "
  2012. "by redefining `matrix_bot_matrix_reminder_bot_allowlist_regexes_auto`"
  2013. msgstr ""
  2014. #: ../../../CHANGELOG.md:766
  2015. msgid "2024-01-05"
  2016. msgstr ""
  2017. #: ../../../CHANGELOG.md:768
  2018. msgid "matrix-mailer has been replaced by the exim-relay external role"
  2019. msgstr ""
  2020. #: ../../../CHANGELOG.md:770 ../../../CHANGELOG.md:1410
  2021. msgid ""
  2022. "We're continuing our effort to make [the playbook use external roles for "
  2023. "some things](#the-playbook-now-uses-external-roles-for-some-things), so "
  2024. "as to avoid doing everything ourselves and to facilitate code re-use."
  2025. msgstr ""
  2026. #: ../../../CHANGELOG.md:772
  2027. msgid ""
  2028. "The `matrix-mailer` role has been moved to its own repository ([ansible-"
  2029. "role-exim-relay](https://github.com/mother-of-all-self-hosting/ansible-"
  2030. "role-exim-relay)) that this playbook now includes."
  2031. msgstr ""
  2032. #: ../../../CHANGELOG.md:774
  2033. msgid "To migrate:"
  2034. msgstr ""
  2035. #: ../../../CHANGELOG.md:776
  2036. msgid "pull the playbook changes, as usual"
  2037. msgstr ""
  2038. #: ../../../CHANGELOG.md:777
  2039. msgid "update your roles (run `just roles` or `make roles`)"
  2040. msgstr ""
  2041. #: ../../../CHANGELOG.md:778
  2042. msgid ""
  2043. "update your `vars.yml`, renaming `matrix_mailer`-prefixed variables to "
  2044. "`exim_relay`-prefixed ones (e.g. `matrix_mailer_sender_address` -> "
  2045. "`exim_relay_sender_address`). If you find none, it means you're using the"
  2046. " default configuration and your migraiton job is even simpler."
  2047. msgstr ""
  2048. #: ../../../CHANGELOG.md:779
  2049. msgid "re-run the playbook (`install-all` or `setup-all`)"
  2050. msgstr ""
  2051. #: ../../../CHANGELOG.md:781
  2052. msgid ""
  2053. "The playbook will take care of stopping the old `matrix-mailer` systemd "
  2054. "service, relocating its directory and restarting it under the new name "
  2055. "(`matrix-exim-relay.service`)."
  2056. msgstr ""
  2057. #: ../../../CHANGELOG.md:784
  2058. msgid "2024-01-02"
  2059. msgstr ""
  2060. #: ../../../CHANGELOG.md:786
  2061. msgid "mautrix-signal now powered by the new Go-based bridge"
  2062. msgstr ""
  2063. #: ../../../CHANGELOG.md:788
  2064. msgid ""
  2065. "The old Python-based [mautrix-signal](https://github.com/mautrix/signal) "
  2066. "bridge is no longer maintained upstream. It's also known to have issues "
  2067. "linking new devices."
  2068. msgstr ""
  2069. #: ../../../CHANGELOG.md:790
  2070. msgid ""
  2071. "It seems like the path forward is to switch to the new mautrix-signal "
  2072. "bridge written in Golang, which we did thanks to [PR "
  2073. "#3031](https://github.com/spantaleev/matrix-docker-ansible-"
  2074. "deploy/pull/3041) by [Pierre 'McFly' Marty](https://github.com/pm-McFly)."
  2075. msgstr ""
  2076. #: ../../../CHANGELOG.md:792
  2077. msgid ""
  2078. "The playbook should **automatically migrate your mautrix-signal "
  2079. "installation to the new bridge code**. You will **need to relink all your"
  2080. " devices** to continue your bridged conversations."
  2081. msgstr ""
  2082. #: ../../../CHANGELOG.md:795
  2083. msgid "2023-10-23"
  2084. msgstr ""
  2085. #: ../../../CHANGELOG.md:797
  2086. msgid "Enabling `allow_public_rooms_over_federation` by default for Synapse"
  2087. msgstr ""
  2088. #: ../../../CHANGELOG.md:799
  2089. msgid ""
  2090. "**TDLR**: if your Matrix server is federating (which it mostly likely is,"
  2091. " unless you've [disabled federation](docs/configuring-playbook-"
  2092. "federation.md#disabling-federation)), your public rooms will not only be "
  2093. "joinable across federation (as they've always been), but from now on will"
  2094. " be discoverable (made available as a list across federation). We're "
  2095. "changing this by flipping the value for Synapse's "
  2096. "`allow_public_rooms_over_federation` setting to `true`, going against the"
  2097. " upstream default. Servers that disable federation are not affected. "
  2098. "Servers that have public rooms which are not published to the room "
  2099. "directory are also not affected."
  2100. msgstr ""
  2101. #: ../../../CHANGELOG.md:801
  2102. msgid ""
  2103. "We generally try to stick to the default configuration for Synapse (and "
  2104. "all other components), unless these defaults seem wrong or harmful. One "
  2105. "such previous case from a few months ago was us [Enabling "
  2106. "`forget_rooms_on_leave` by default for Synapse](#enabling-"
  2107. "forget_rooms_on_leave-by-default-for-synapse) - the default value was "
  2108. "making Synapse more wasteful of resources by default."
  2109. msgstr ""
  2110. #: ../../../CHANGELOG.md:803
  2111. msgid ""
  2112. "Today, we're going against upstream defaults again and flipping the "
  2113. "`allow_public_rooms_over_federation` configuration option to `true`. This"
  2114. " way, public rooms on your server will be made discoverable by others via"
  2115. " federation, using the [`GET /_matrix/federation/v1/publicRooms` of the "
  2116. "Server-Server API](https://spec.matrix.org/v1.8/server-server-"
  2117. "api/#get_matrixfederationv1publicrooms)."
  2118. msgstr ""
  2119. #: ../../../CHANGELOG.md:805
  2120. msgid ""
  2121. "The upstream Synapse default is `false` (disabled), so that public rooms "
  2122. "are not exposed for other servers to discover (learn about their "
  2123. "existence). Nevertheless, even if these rooms are not exposed (listed) "
  2124. "for discovery, they are **still joinable** by anyone who knows their "
  2125. "address or is invited to the room by an existing member."
  2126. msgstr ""
  2127. #: ../../../CHANGELOG.md:807
  2128. msgid ""
  2129. "**We go against the upstream default** in an effort to make Matrix "
  2130. "federation more useful - a public room should be globally public - not "
  2131. "only joinable, but also discoverable across federation."
  2132. msgstr ""
  2133. #: ../../../CHANGELOG.md:809
  2134. msgid "The **historical reasoning** behind this change is as follows:"
  2135. msgstr ""
  2136. #: ../../../CHANGELOG.md:811
  2137. msgid ""
  2138. "`allow_public_rooms_over_federation` seems to have been enabled by "
  2139. "default for Synapse until v1.7.0 (~2019), just like we believe it should "
  2140. "be for a globally-federating network - rooms should be joinable and "
  2141. "discoverable across federation."
  2142. msgstr ""
  2143. #: ../../../CHANGELOG.md:813
  2144. msgid ""
  2145. "In Synapse v1.7.0 (~2019), `allow_public_rooms_over_federation` [got "
  2146. "disabled](https://github.com/element-"
  2147. "hq/synapse/blob/e9069c9f919685606506f04527332e83fbfa44d9/docs/upgrade.md?plain=1#L1877-L1891)"
  2148. " by default in a [security-by-"
  2149. "obscurity](https://en.wikipedia.org/wiki/Security_through_obscurity) "
  2150. "workaround for misconfigured servers. See the [Avoiding unwelcome "
  2151. "visitors on private Matrix servers](https://matrix.org/blog/2019/11/09"
  2152. "/avoiding-unwelcome-visitors-on-private-matrix-servers/) `matrix.org` "
  2153. "blog article. We believe that people wishing for a truly private server, "
  2154. "should [disable federation](docs/configuring-playbook-federation.md"
  2155. "#disabling-federation), instead of having a fully-federating server and "
  2156. "trying to hide its public rooms. We also provide other workarounds below."
  2157. " We (and the Synapse team, obviously) believe that Matrix should federate"
  2158. " by default, so federating the public room list seems to make sense."
  2159. msgstr ""
  2160. #: ../../../CHANGELOG.md:815
  2161. #, python-format
  2162. msgid ""
  2163. "[etke.cc](https://etke.cc/) has been developing the free-software [Matrix"
  2164. " Rooms Search](https://github.com/etkecc/mrs) project for a while now. "
  2165. "One public (demo) instance of it is hosted at "
  2166. "[matrixrooms.info](https://matrixrooms.info/). This search engine tries "
  2167. "to go through the Matrix federation and discover & index public rooms to "
  2168. "allow people to find them. We believe it's vital for Matrix (and any chat"
  2169. " or social network for that matter) to be more discoverable, so that "
  2170. "people can find communities and others to talk to. Today (on 23rd of "
  2171. "October 2023), `matrixrooms.info` is indexing `23066` Matrix servers. Of "
  2172. "these, only `1567` servers (7%) are making their public rooms "
  2173. "discoverable. Who knows what wonderful communities and rooms are "
  2174. "available on these 93% other Matrix servers that are supposedly "
  2175. "federating, but are still gate-keeping their public room list. "
  2176. "Indubitably, many of these servers are hosted via matrix-docker-ansible-"
  2177. "deploy, so we feel partially responsible for making Matrix federation "
  2178. "less useful."
  2179. msgstr ""
  2180. #: ../../../CHANGELOG.md:817
  2181. msgid "Here are **actions you may wish to take** as a result of this change:"
  2182. msgstr ""
  2183. #: ../../../CHANGELOG.md:819
  2184. msgid ""
  2185. "(recommended) embrace the new default. If your Matrix server is "
  2186. "federating, your public rooms have always been joinable across federation"
  2187. " anyway. Exposing the list of public rooms does no harm and more-so does "
  2188. "good by contributing to the usefulness of the Matrix network by "
  2189. "facilitating room discovery."
  2190. msgstr ""
  2191. #: ../../../CHANGELOG.md:821
  2192. msgid ""
  2193. "(switch to a better way of doings things on your semi-private server) The"
  2194. " problem that the Synapse team appears to have solved by flipping the "
  2195. "`allow_public_rooms_over_federation` default in Synapse v1.7.0 seems to "
  2196. "for \"mostly private\" servers, which federate and have a bunch of rooms "
  2197. "made public (and published in their room directory) in an effort to allow"
  2198. " people on the same homeserver to easily find and join them (self-"
  2199. "onboarding). With the introduction of Matrix Spaces, you can reorganize "
  2200. "your flow around spaces - you can auto-join your users to a Matrix Space "
  2201. "(via Synapse's `auto_join_rooms` setting - controlled by our "
  2202. "`matrix_synapse_auto_join_rooms` variable), then add a bunch of rooms to "
  2203. "the space and make them joinable by people belonging to the space. That "
  2204. "is to say, do not make rooms public and do not publish them to the room "
  2205. "directory unless they are really public. Instead, use other mechanisms "
  2206. "for semi-public rooms or private rooms. One alternative is to stick to "
  2207. "what you're doing (public rooms published to your rooms directory) but "
  2208. "having a `m.federate: true` flag set during creation (clients like "
  2209. "Element Web have a nice UI checkbox for this) to explicitly disable "
  2210. "federation for them."
  2211. msgstr ""
  2212. #: ../../../CHANGELOG.md:823
  2213. msgid ""
  2214. "(keeping the old behavior) if you wish to keep doing what you're doing "
  2215. "(keeping your Matrix server federating, but hiding its public rooms "
  2216. "list), add `matrix_synapse_allow_public_rooms_over_federation: false` to "
  2217. "your `vars.yml` configuration. This restores the old behavior. You may "
  2218. "also consider [disabling federation](docs/configuring-playbook-"
  2219. "federation.md#disabling-federation) completely instead of relying on "
  2220. "security-by-obscurity measures."
  2221. msgstr ""
  2222. #: ../../../CHANGELOG.md:826
  2223. msgid "2023-10-18"
  2224. msgstr ""
  2225. #: ../../../CHANGELOG.md:828
  2226. msgid "Postgres parameters are automatically tuned now"
  2227. msgstr ""
  2228. #: ../../../CHANGELOG.md:830
  2229. msgid ""
  2230. "The playbook has provided some hints about [Tuning PostgreSQL](docs"
  2231. "/maintenance-postgres.md#tuning-postgresql) for quite a while now."
  2232. msgstr ""
  2233. #: ../../../CHANGELOG.md:832
  2234. msgid ""
  2235. "From now on, the [Postgres Ansible role](https://github.com/mother-of-"
  2236. "all-self-hosting/ansible-role-postgres) automatically tunes your Postgres"
  2237. " configuration with the same [calculation "
  2238. "logic](https://github.com/le0pard/pgtune/blob/master/src/features/configuration/configurationSlice.js)"
  2239. " that powers https://pgtune.leopard.in.ua/."
  2240. msgstr ""
  2241. #: ../../../CHANGELOG.md:834
  2242. msgid ""
  2243. "Our [Tuning PostgreSQL](docs/maintenance-postgres.md#tuning-postgresql) "
  2244. "documentation page has details about how you can turn auto-tuning off or "
  2245. "adjust the automatically-determined Postgres configuration parameters "
  2246. "manually."
  2247. msgstr ""
  2248. #: ../../../CHANGELOG.md:836
  2249. msgid ""
  2250. "People who [enable load-balancing with Synapse workers](docs/configuring-"
  2251. "playbook-synapse.md#load-balancing-with-workers) no longer need to "
  2252. "increase the maximum number of Postgres connections manually (previously "
  2253. "done via `postgres_process_extra_arguments`). There's a new variable "
  2254. "(`postgres_max_connections`) for controlling this number and the playbook"
  2255. " automatically raises its value from `200` to `500` for setups which "
  2256. "enable workers."
  2257. msgstr ""
  2258. #: ../../../CHANGELOG.md:839
  2259. msgid "2023-08-31"
  2260. msgstr ""
  2261. #: ../../../CHANGELOG.md:841
  2262. msgid "SchildiChat Web support"
  2263. msgstr ""
  2264. #: ../../../CHANGELOG.md:843
  2265. msgid ""
  2266. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  2267. "[etke.cc](https://etke.cc/), the playbook can now set up the [SchildiChat"
  2268. " Web](https://github.com/SchildiChat/schildichat-desktop) client."
  2269. msgstr ""
  2270. #: ../../../CHANGELOG.md:845
  2271. msgid ""
  2272. "See our [Configuring SchildiChat Web](docs/configuring-playbook-client-"
  2273. "schildichat-web.md) documentation to get started."
  2274. msgstr ""
  2275. #: ../../../CHANGELOG.md:848
  2276. msgid "2023-08-23"
  2277. msgstr ""
  2278. #: ../../../CHANGELOG.md:850
  2279. msgid "mautrix-wsproxy support"
  2280. msgstr ""
  2281. #: ../../../CHANGELOG.md:852
  2282. msgid ""
  2283. "Thanks to [Johan Swetzén](https://github.com/jswetzen)'s efforts (who "
  2284. "finished what was started by [James Reilly](https://github.com/hanthor) "
  2285. "and [Shreyas Ajjarapu](https://github.com/shreyasajj)), the playbook now "
  2286. "supports bridging to Android SMS and Apple iMessage via the [mautrix-"
  2287. "wsproxy](https://github.com/mautrix/wsproxy) service (in combination with"
  2288. " a [mautrix-imessage](https://github.com/mautrix/imessage) bridge running"
  2289. " on your Mac or Android phone)."
  2290. msgstr ""
  2291. #: ../../../CHANGELOG.md:854
  2292. msgid ""
  2293. "See our [Setting up Mautrix wsproxy for bridging Android SMS or Apple "
  2294. "iMessage](docs/configuring-playbook-bridge-mautrix-wsproxy.md) "
  2295. "documentation page for getting started."
  2296. msgstr ""
  2297. #: ../../../CHANGELOG.md:857
  2298. msgid "2023-07-24"
  2299. msgstr ""
  2300. #: ../../../CHANGELOG.md:859
  2301. msgid "matrix-registration-bot usage changed"
  2302. msgstr ""
  2303. #: ../../../CHANGELOG.md:861
  2304. msgid ""
  2305. "[matrix-registration-bot](docs/configuring-playbook-bot-matrix-"
  2306. "registration-bot.md) got some updates and now supports password-only-"
  2307. "based login. Therefore the bot now doesn't need any manual configuration "
  2308. "except setting a password in your `vars.yml`. The bot will be registered "
  2309. "as admin and access tokens will be obtained automatically by the bot."
  2310. msgstr ""
  2311. #: ../../../CHANGELOG.md:863
  2312. msgid ""
  2313. "**For existing users** You need to set "
  2314. "`matrix_bot_matrix_registration_bot_bot_password` if you previously only "
  2315. "used `matrix_bot_matrix_registration_bot_bot_access_token`. Please also "
  2316. "remove the following deprecated settings"
  2317. msgstr ""
  2318. #: ../../../CHANGELOG.md:865
  2319. msgid "`matrix_bot_matrix_registration_bot_bot_access_token`"
  2320. msgstr ""
  2321. #: ../../../CHANGELOG.md:866
  2322. msgid "`matrix_bot_matrix_registration_bot_api_token`"
  2323. msgstr ""
  2324. #: ../../../CHANGELOG.md:869
  2325. msgid "2023-07-21"
  2326. msgstr ""
  2327. #: ../../../CHANGELOG.md:871
  2328. msgid "mautrix-gmessages support"
  2329. msgstr ""
  2330. #: ../../../CHANGELOG.md:873
  2331. msgid ""
  2332. "Thanks to [Shreyas Ajjarapu](https://github.com/shreyasajj)'s efforts, "
  2333. "the playbook now supports bridging to [Google "
  2334. "Messages](https://messages.google.com/) via the [mautrix-"
  2335. "gmessages](https://github.com/mautrix/gmessages) bridge. See our [Setting"
  2336. " up Mautrix Google Messages bridging](docs/configuring-playbook-bridge-"
  2337. "mautrix-gmessages.md) documentation page for getting started."
  2338. msgstr ""
  2339. #: ../../../CHANGELOG.md:876
  2340. msgid "2023-07-17"
  2341. msgstr ""
  2342. #: ../../../CHANGELOG.md:878
  2343. msgid "matrix-media-repo support"
  2344. msgstr ""
  2345. #: ../../../CHANGELOG.md:880
  2346. msgid ""
  2347. "Thanks to [Michael Hollister](https://github.com/Michael-Hollister) from "
  2348. "[FUTO](https://www.futo.org/), the creators of the [Circles "
  2349. "app](https://circu.li/), the playbook can now set up [matrix-media-"
  2350. "repo](https://github.com/turt2live/matrix-media-repo) - an alternative "
  2351. "way to store homeserver media files, powered by a homeserver-independent "
  2352. "implementation which supports S3 storage, IPFS, deduplication and other "
  2353. "advanced features."
  2354. msgstr ""
  2355. #: ../../../CHANGELOG.md:882
  2356. msgid ""
  2357. "To learn more see our [Storing Matrix media files using matrix-media-"
  2358. "repo](docs/configuring-playbook-matrix-media-repo.md) documentation page."
  2359. msgstr ""
  2360. #: ../../../CHANGELOG.md:885
  2361. msgid "2023-05-25"
  2362. msgstr ""
  2363. #: ../../../CHANGELOG.md:887
  2364. msgid "Enabling `forget_rooms_on_leave` by default for Synapse"
  2365. msgstr ""
  2366. #: ../../../CHANGELOG.md:889
  2367. msgid ""
  2368. "With the [Synapse v1.84.0 update](https://github.com/spantaleev/matrix-"
  2369. "docker-ansible-deploy/pull/2698), we've also **changed the default "
  2370. "value** of the `forget_rooms_on_leave` setting of Synapse to a value of "
  2371. "`true`. This way, **when you leave a room, Synapse will now forget it "
  2372. "automatically**."
  2373. msgstr ""
  2374. #: ../../../CHANGELOG.md:891
  2375. msgid ""
  2376. "The upstream Synapse default is `false` (disabled), so that you must "
  2377. "forget rooms manually after leaving."
  2378. msgstr ""
  2379. #: ../../../CHANGELOG.md:893
  2380. msgid ""
  2381. "**We go against the upstream default** ([somewhat "
  2382. "controversially](https://github.com/spantaleev/matrix-docker-ansible-"
  2383. "deploy/pull/2700)) in an effort to make Synapse leaner and potentially do"
  2384. " what we believe most users would expect their homeserver to be doing."
  2385. msgstr ""
  2386. #: ../../../CHANGELOG.md:895
  2387. msgid ""
  2388. "If you'd like to go back to the old behavior, add the following to your "
  2389. "configuration: `matrix_synapse_forget_rooms_on_leave: false`"
  2390. msgstr ""
  2391. #: ../../../CHANGELOG.md:898
  2392. msgid "2023-04-03"
  2393. msgstr ""
  2394. #: ../../../CHANGELOG.md:900
  2395. msgid "The matrix-jitsi role lives independently now"
  2396. msgstr ""
  2397. #: ../../../CHANGELOG.md:902
  2398. msgid ""
  2399. "**TLDR**: the `matrix-jitsi` role is now included from the [ansible-role-"
  2400. "jitsi](https://github.com/mother-of-all-self-hosting/ansible-role-jitsi) "
  2401. "repository, part of the [MASH playbook](https://github.com/mother-of-all-"
  2402. "self-hosting/mash-playbook). Some variables have been renamed. All "
  2403. "functionality remains intact."
  2404. msgstr ""
  2405. #: ../../../CHANGELOG.md:904
  2406. msgid ""
  2407. "The `matrix-jitsi` role has been relocated in its own repository, part of"
  2408. " the [MASH playbook](https://github.com/mother-of-all-self-hosting/mash-"
  2409. "playbook) project - an Ansible playbook for self-hosting [a growing list "
  2410. "of FOSS software](https://github.com/mother-of-all-self-hosting/mash-"
  2411. "playbook/blob/main/docs/supported-services.md). If hosting a Jitsi stack "
  2412. "on the Matrix server itself did not stand right with you or you always "
  2413. "wanted to host most stuff, you can now use this new playbook to do so."
  2414. msgstr ""
  2415. #: ../../../CHANGELOG.md:906
  2416. msgid ""
  2417. "As part of the extraction process of this role out of the Matrix "
  2418. "playbook, a few other things improved:"
  2419. msgstr ""
  2420. #: ../../../CHANGELOG.md:908
  2421. msgid "**native Traefik support** has been added"
  2422. msgstr ""
  2423. #: ../../../CHANGELOG.md:909
  2424. msgid ""
  2425. "**support for hosting under a subpath** has been added, although it "
  2426. "suffers from a few minor issues listed [here](https://github.com/mother-"
  2427. "of-all-self-hosting/mash-playbook/blob/main/docs/services/jitsi.md#url)"
  2428. msgstr ""
  2429. #: ../../../CHANGELOG.md:911
  2430. msgid ""
  2431. "You need to **update your roles** (`just roles` or `make roles`) "
  2432. "regardless of whether you're using Jitsi or not."
  2433. msgstr ""
  2434. #: ../../../CHANGELOG.md:913
  2435. msgid ""
  2436. "If you're making use of Jitsi via this playbook, you will need to update "
  2437. "variable references in your `vars.yml` file:"
  2438. msgstr ""
  2439. #: ../../../CHANGELOG.md:915
  2440. msgid "`matrix_jitsi_*_docker_image_` -> `matrix_jitsi_*_container_image_`"
  2441. msgstr ""
  2442. #: ../../../CHANGELOG.md:916
  2443. msgid "`matrix_jitsi_` -> `jitsi_`"
  2444. msgstr ""
  2445. #: ../../../CHANGELOG.md:917 ../../../CHANGELOG.md:944
  2446. msgid ""
  2447. "some other internal variables have changed, but the playbook will tell "
  2448. "you about them"
  2449. msgstr ""
  2450. #: ../../../CHANGELOG.md:919
  2451. msgid "2023-03-22"
  2452. msgstr ""
  2453. #: ../../../CHANGELOG.md:921
  2454. msgid "ntfy Web App is disabled by default"
  2455. msgstr ""
  2456. #: ../../../CHANGELOG.md:923
  2457. msgid ""
  2458. "ntfy provides a web app, which is now disabled by default, because it may"
  2459. " be unknown to and unused by most users of this playbook. You can enable "
  2460. "it by setting `ntfy_web_root: \"app\"` (see [ntfy documentation](docs"
  2461. "/configuring-playbook-ntfy.md))."
  2462. msgstr ""
  2463. #: ../../../CHANGELOG.md:925
  2464. msgid ""
  2465. "This change was already applied a while before this entry, but as some "
  2466. "users were reporting the missing web app, this entry was added (see "
  2467. "[#2529](https://github.com/spantaleev/matrix-docker-ansible-"
  2468. "deploy/issues/2529))."
  2469. msgstr ""
  2470. #: ../../../CHANGELOG.md:928
  2471. msgid "2023-03-21"
  2472. msgstr ""
  2473. #: ../../../CHANGELOG.md:930
  2474. msgid "The matrix-prometheus role lives independently now"
  2475. msgstr ""
  2476. #: ../../../CHANGELOG.md:932
  2477. msgid ""
  2478. "**TLDR**: the `matrix-prometheus` role is now included from the [ansible-"
  2479. "role-prometheus](https://github.com/mother-of-all-self-hosting/ansible-"
  2480. "role-prometheus) repository, part of the [MASH "
  2481. "playbook](https://github.com/mother-of-all-self-hosting/mash-playbook). "
  2482. "Some variables have been renamed. All functionality remains intact."
  2483. msgstr ""
  2484. #: ../../../CHANGELOG.md:934
  2485. msgid ""
  2486. "The `matrix-prometheus` role has been relocated in its own repository, "
  2487. "part of the [MASH playbook](https://github.com/mother-of-all-self-hosting"
  2488. "/mash-playbook) project - an Ansible playbook for self-hosting [a growing"
  2489. " list of FOSS software](https://github.com/mother-of-all-self-hosting"
  2490. "/mash-playbook/blob/main/docs/supported-services.md). If hosting a "
  2491. "Prometheus stack on the Matrix server itself did not stand right with you"
  2492. " or you always wanted to host most stuff, you can now use this new "
  2493. "playbook to do so."
  2494. msgstr ""
  2495. #: ../../../CHANGELOG.md:936
  2496. msgid ""
  2497. "Extracting the Prometheus role out of this Matrix playbook required huge "
  2498. "internal refactoring to the way the Prometheus configuration (scraping "
  2499. "jobs) is generated. If you notice any breakage after upgrading, let us "
  2500. "know."
  2501. msgstr ""
  2502. #: ../../../CHANGELOG.md:938
  2503. msgid ""
  2504. "You need to **update your roles** (`just roles` or `make roles`) "
  2505. "regardless of whether you're using Prometheus or not."
  2506. msgstr ""
  2507. #: ../../../CHANGELOG.md:940
  2508. msgid ""
  2509. "If you're making use of Prometheus via this playbook, you will need to "
  2510. "update variable references in your `vars.yml` file:"
  2511. msgstr ""
  2512. #: ../../../CHANGELOG.md:942
  2513. msgid "`matrix_prometheus_docker_image_` -> `matrix_prometheus_container_image_`"
  2514. msgstr ""
  2515. #: ../../../CHANGELOG.md:943
  2516. msgid "`matrix_prometheus_` -> `prometheus_`"
  2517. msgstr ""
  2518. #: ../../../CHANGELOG.md:947
  2519. msgid "2023-03-12"
  2520. msgstr ""
  2521. #: ../../../CHANGELOG.md:949
  2522. msgid "synapse-auto-compressor support"
  2523. msgstr ""
  2524. #: ../../../CHANGELOG.md:951
  2525. msgid ""
  2526. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  2527. "[etke.cc](https://etke.cc/), the playbook can now set up [rust-synapse-"
  2528. "compress-state](https://github.com/matrix-org/rust-synapse-compress-"
  2529. "state)'s `synapse_auto_compressor` tool to run periodically."
  2530. msgstr ""
  2531. #: ../../../CHANGELOG.md:953
  2532. msgid ""
  2533. "If enabled, `synapse_auto_compressor` runs on a schedule and compresses "
  2534. "your Synapse database's `state_groups` table. It was possible to run "
  2535. "`rust-synapse-compress-state` manually via the playbook even before - see"
  2536. " [Compressing state with rust-synapse-compress-state](docs/maintenance-"
  2537. "synapse.md#compressing-state-with-rust-synapse-compress-state). However, "
  2538. "using `synapse_auto_compressor` is better, because:"
  2539. msgstr ""
  2540. #: ../../../CHANGELOG.md:955
  2541. msgid "it runs on a more up-to-date version of `rust-synapse-compress-state`"
  2542. msgstr ""
  2543. #: ../../../CHANGELOG.md:956
  2544. msgid ""
  2545. "it's a set-it-and-forget-it tool that you can enable and never have to "
  2546. "deal with manual compression anymore"
  2547. msgstr ""
  2548. #: ../../../CHANGELOG.md:958
  2549. msgid ""
  2550. "This tool needs to be enabled manually, for now. In the future, we're "
  2551. "considering enabling it by default for all Synapse installations."
  2552. msgstr ""
  2553. #: ../../../CHANGELOG.md:960
  2554. msgid ""
  2555. "See our [Setting up synapse-auto-compressor](docs/configuring-playbook-"
  2556. "synapse-auto-compressor.md) documentation to get started."
  2557. msgstr ""
  2558. #: ../../../CHANGELOG.md:963
  2559. msgid "2023-03-07"
  2560. msgstr ""
  2561. #: ../../../CHANGELOG.md:965
  2562. msgid "Sliding Sync proxy (Element X) support"
  2563. msgstr ""
  2564. #: ../../../CHANGELOG.md:967
  2565. msgid ""
  2566. "Thanks to [Benjamin Kampmann](https://github.com/gnunicorn) for [getting "
  2567. "it started](https://github.com/spantaleev/matrix-docker-ansible-"
  2568. "deploy/pull/2515), [FSG-Cat](https://github.com/FSG-Cat) for fixing it up"
  2569. " and me ([Slavi](https://github.com/spantaleev)) for polishing it up, the"
  2570. " playbook can now install and configure the [sliding-sync "
  2571. "proxy](https://github.com/matrix-org/sliding-sync)."
  2572. msgstr ""
  2573. #: ../../../CHANGELOG.md:969
  2574. msgid ""
  2575. "The upcoming Element X clients ([Element X iOS](https://github.com"
  2576. "/vector-im/element-x-ios) and [Element X Android](https://github.com"
  2577. "/vector-im/element-x-android)) require the `sliding-sync` proxy to do "
  2578. "their job. **These clients are still in beta** (especially Element X "
  2579. "Android, which requires manual compilation to get it working with a "
  2580. "non-`matrix.org` homeseserver). Playbook users can now easily give these "
  2581. "clients a try and help test them thanks to us having `sliding-sync` "
  2582. "support."
  2583. msgstr ""
  2584. #: ../../../CHANGELOG.md:971
  2585. msgid ""
  2586. "To get started, see our [Setting up the Sliding Sync proxy](docs"
  2587. "/configuring-playbook-sliding-sync-proxy.md) documentation page."
  2588. msgstr ""
  2589. #: ../../../CHANGELOG.md:974
  2590. msgid "2023-03-02"
  2591. msgstr ""
  2592. #: ../../../CHANGELOG.md:976
  2593. msgid "The matrix-etherpad role lives independently now"
  2594. msgstr ""
  2595. #: ../../../CHANGELOG.md:978
  2596. msgid ""
  2597. "**TLDR**: the `matrix-etherpad` role is now included from [another "
  2598. "repository](https://github.com/mother-of-all-self-hosting/ansible-role-"
  2599. "etherpad). Some variables have been renamed. All functionality remains "
  2600. "intact."
  2601. msgstr ""
  2602. #: ../../../CHANGELOG.md:980
  2603. msgid ""
  2604. "You need to **update your roles** (`just roles` or `make roles`) "
  2605. "regardless of whether you're using Etherpad or not."
  2606. msgstr ""
  2607. #: ../../../CHANGELOG.md:982
  2608. msgid ""
  2609. "If you're making use of Etherpad via this playbook, you will need to "
  2610. "update variable references in your `vars.yml` file:"
  2611. msgstr ""
  2612. #: ../../../CHANGELOG.md:984
  2613. msgid "Rename `matrix_etherpad_public_endpoint` to `etherpad_path_prefix`"
  2614. msgstr ""
  2615. #: ../../../CHANGELOG.md:986
  2616. msgid "Replace `matrix_etherpad_mode: dimension` with:"
  2617. msgstr ""
  2618. #: ../../../CHANGELOG.md:987
  2619. msgid "for `matrix-nginx-proxy` users:"
  2620. msgstr ""
  2621. #: ../../../CHANGELOG.md:988
  2622. msgid "`etherpad_nginx_proxy_dimension_integration_enabled: true`"
  2623. msgstr ""
  2624. #: ../../../CHANGELOG.md:989
  2625. msgid "`etherpad_hostname: \"{{ matrix_server_fqn_dimension }}\"`"
  2626. msgstr ""
  2627. #: ../../../CHANGELOG.md:990
  2628. msgid "for Traefik users:"
  2629. msgstr ""
  2630. #: ../../../CHANGELOG.md:991
  2631. msgid ""
  2632. "define your own `etherpad_hostname` and `etherpad_path_prefix` as you see"
  2633. " fit"
  2634. msgstr ""
  2635. #: ../../../CHANGELOG.md:993
  2636. msgid "Rename all other variables:"
  2637. msgstr ""
  2638. #: ../../../CHANGELOG.md:994
  2639. msgid "`matrix_etherpad_docker_image_` -> `matrix_etherpad_container_image_`"
  2640. msgstr ""
  2641. #: ../../../CHANGELOG.md:995
  2642. msgid "`matrix_etherpad_` -> `etherpad_`"
  2643. msgstr ""
  2644. #: ../../../CHANGELOG.md:997
  2645. msgid "Along with this relocation, the new role also:"
  2646. msgstr ""
  2647. #: ../../../CHANGELOG.md:999
  2648. msgid ""
  2649. "supports [self-building](docs/self-building.md), so it should work on "
  2650. "`arm32` and `arm64` architectures"
  2651. msgstr ""
  2652. #: ../../../CHANGELOG.md:1000
  2653. msgid ""
  2654. "has native Traefik reverse-proxy support (Etherpad requests no longer go "
  2655. "through `matrix-nginx-proxy` when using Traefik)"
  2656. msgstr ""
  2657. #: ../../../CHANGELOG.md:1003
  2658. msgid "2023-02-26"
  2659. msgstr ""
  2660. #: ../../../CHANGELOG.md:1005
  2661. msgid "Traefik is the default reverse-proxy now"
  2662. msgstr ""
  2663. #: ../../../CHANGELOG.md:1007
  2664. msgid ""
  2665. "**TLDR**: new installations will now default to Traefik as their reverse-"
  2666. "proxy. Existing users need to explicitly choose their reverse-proxy type."
  2667. " [Switching to Traefik](#how-do-i-switch-my-existing-setup-to-traefik) is"
  2668. " strongly encouraged. `matrix-nginx-proxy` may break over time and will "
  2669. "ultimately be removed."
  2670. msgstr ""
  2671. #: ../../../CHANGELOG.md:1009
  2672. msgid ""
  2673. "As mentioned 2 weeks ago in [(Backward Compatibility) Reverse-proxy "
  2674. "configuration changes and initial Traefik support](#backward-"
  2675. "compatibility-reverse-proxy-configuration-changes-and-initial-traefik-"
  2676. "support), the playbook is moving to Traefik as its default SSL-"
  2677. "terminating reverse-proxy."
  2678. msgstr ""
  2679. #: ../../../CHANGELOG.md:1011
  2680. msgid ""
  2681. "Until now, we've been doing the migration gradually and keeping full "
  2682. "backward compatibility. New installations were defaulting to `matrix-"
  2683. "nginx-proxy` (just like before), while existing installations were "
  2684. "allowed to remain on `matrix-nginx-proxy` as well. This makes things very"
  2685. " difficult for us, because we need to maintain and think about lots of "
  2686. "different setups:"
  2687. msgstr ""
  2688. #: ../../../CHANGELOG.md:1013
  2689. msgid "Traefik managed by the playbook"
  2690. msgstr ""
  2691. #: ../../../CHANGELOG.md:1014
  2692. msgid "Traefik managed by the user in another way"
  2693. msgstr ""
  2694. #: ../../../CHANGELOG.md:1015
  2695. msgid "another reverse-proxy on the same host (`127.0.0.1` port exposure)"
  2696. msgstr ""
  2697. #: ../../../CHANGELOG.md:1016
  2698. msgid "another reverse-proxy on another host (`0.0.0.0` port exposure)"
  2699. msgstr ""
  2700. #: ../../../CHANGELOG.md:1017
  2701. msgid "`matrix-nginx-proxy` - an `nginx` container managed by the playbook"
  2702. msgstr ""
  2703. #: ../../../CHANGELOG.md:1018
  2704. msgid ""
  2705. "`nginx` webserver operated by the user, running without a container on "
  2706. "the same server"
  2707. msgstr ""
  2708. #: ../../../CHANGELOG.md:1020
  2709. msgid ""
  2710. "Each change we do and each new feature that comes in needs to support all"
  2711. " these different ways of reverse-proxying. Because `matrix-nginx-proxy` "
  2712. "was the default and pretty much everyone was (and still is) using it, "
  2713. "means that new PRs also come with `matrix-nginx-proxy` as their main "
  2714. "focus and Traefik as an afterthought, which means we need to spend hours "
  2715. "fixing up Traefik support."
  2716. msgstr ""
  2717. #: ../../../CHANGELOG.md:1022
  2718. msgid ""
  2719. "We can't spend all this time maintaining so many different configurations"
  2720. " anymore. Traefik support has been an option for 2 weeks and lots of "
  2721. "people have already migrated their server and have tested things out. "
  2722. "Traefik is what we use and preferentially test for."
  2723. msgstr ""
  2724. #: ../../../CHANGELOG.md:1024
  2725. msgid ""
  2726. "It's time for the **next step in our migration process** to Traefik and "
  2727. "elimination of `matrix-nginx-proxy`:"
  2728. msgstr ""
  2729. #: ../../../CHANGELOG.md:1026
  2730. msgid "Traefik is now the default reverse-proxy for new installations"
  2731. msgstr ""
  2732. #: ../../../CHANGELOG.md:1027
  2733. msgid ""
  2734. "All existing users need to explicitly choose their reverse-proxy type by "
  2735. "defining the `matrix_playbook_reverse_proxy_type` variable in their "
  2736. "`vars.yml` configuration file. We strongly encourage existing users to "
  2737. "[switch the Traefik](#how-to-switch-an-existing-setup-to-traefik), as the"
  2738. " nginx setup is bound to become more and more broken over time until it's"
  2739. " ultimately removed"
  2740. msgstr ""
  2741. #: ../../../CHANGELOG.md:1029
  2742. msgid "How do I switch my existing setup to Traefik?"
  2743. msgstr ""
  2744. #: ../../../CHANGELOG.md:1031
  2745. msgid ""
  2746. "**For users who are on `matrix-nginx-proxy`** (the default reverse-proxy "
  2747. "provided by the playbook), switching to Traefik can happen with a simple "
  2748. "configuration change. Follow this section from 2 weeks ago: [How do I "
  2749. "explicitly switch to Traefik right now?](#how-do-i-explicitly-switch-to-"
  2750. "traefik-right-now)."
  2751. msgstr ""
  2752. #: ../../../CHANGELOG.md:1033
  2753. msgid "If you experience trouble:"
  2754. msgstr ""
  2755. #: ../../../CHANGELOG.md:1035
  2756. msgid ""
  2757. "Follow [How do I remain on matrix-nginx-proxy?](#how-do-i-remain-on-"
  2758. "matrix-nginx-proxy) to bring your server back online using the old "
  2759. "reverse-proxy"
  2760. msgstr ""
  2761. #: ../../../CHANGELOG.md:1036
  2762. msgid "Ask for help in our [support channels](README.md#support)"
  2763. msgstr ""
  2764. #: ../../../CHANGELOG.md:1037
  2765. msgid "Try switching to Traefik again later"
  2766. msgstr ""
  2767. #: ../../../CHANGELOG.md:1039
  2768. msgid ""
  2769. "**For users with a more special reverse-proxying setup** (another nginx "
  2770. "server, Apache, Caddy, etc.), the migration may not be so smooth. Follow "
  2771. "the [Using your own webserver](docs/configuring-playbook-own-"
  2772. "webserver.md) guide. Ideally, your custom reverse-proxy will be "
  2773. "configured in such a way that it **fronts the Traefik reverse-proxy** "
  2774. "provided by the playbook. Other means of reverse-proxying are more "
  2775. "fragile and may be deprecated in the future."
  2776. msgstr ""
  2777. #: ../../../CHANGELOG.md:1041
  2778. msgid "I already use my own Traefik server. How do I plug that in?"
  2779. msgstr ""
  2780. #: ../../../CHANGELOG.md:1043
  2781. msgid ""
  2782. "See the [Traefik managed by the playbook](docs/configuring-playbook-own-"
  2783. "webserver.md#traefik-managed-by-the-playbook) section."
  2784. msgstr ""
  2785. #: ../../../CHANGELOG.md:1045
  2786. msgid "Why is matrix-nginx-proxy used even after switching to Traefik?"
  2787. msgstr ""
  2788. #: ../../../CHANGELOG.md:1047
  2789. msgid ""
  2790. "This playbook manages many different services. All these services were "
  2791. "initially integrated with `matrix-nginx-proxy`."
  2792. msgstr ""
  2793. #: ../../../CHANGELOG.md:1049
  2794. msgid ""
  2795. "While we migrate all these components to have native Traefik support, "
  2796. "some still go through nginx internally (Traefik -> local `matrix-nginx-"
  2797. "proxy` -> component). As time goes on, internal reliance on `matrix-"
  2798. "nginx-proxy` will gradually decrease until it's completely removed."
  2799. msgstr ""
  2800. #: ../../../CHANGELOG.md:1051
  2801. msgid "How do I remain on matrix-nginx-proxy?"
  2802. msgstr ""
  2803. #: ../../../CHANGELOG.md:1053
  2804. msgid ""
  2805. "Most new work and testing targets Traefik, so remaining on nginx is "
  2806. "**not** \"the good old stable\" option, but rather the \"still available,"
  2807. " but largely untested and likely to be broken very soon\" option."
  2808. msgstr ""
  2809. #: ../../../CHANGELOG.md:1055
  2810. msgid ""
  2811. "To proceed regardless of this warning, add "
  2812. "`matrix_playbook_reverse_proxy_type: playbook-managed-nginx` to your "
  2813. "configuration."
  2814. msgstr ""
  2815. #: ../../../CHANGELOG.md:1057
  2816. msgid ""
  2817. "At some point in the **near** future (days, or even weeks at most), we "
  2818. "hope to completely get rid of `matrix-nginx-proxy` (or break it enough to"
  2819. " make it unusable), so you **will soon be forced to migrate** anyway. "
  2820. "Plan your migration accordingly."
  2821. msgstr ""
  2822. #: ../../../CHANGELOG.md:1059
  2823. msgid "How do I keep using my own other reverse-proxy?"
  2824. msgstr ""
  2825. #: ../../../CHANGELOG.md:1061
  2826. msgid ""
  2827. "We recommend that you follow the guide for [Fronting the integrated "
  2828. "reverse-proxy webserver with another reverse-proxy](docs/configuring-"
  2829. "playbook-own-webserver.md#fronting-the-integrated-reverse-proxy-"
  2830. "webserver-with-another-reverse-proxy)."
  2831. msgstr ""
  2832. #: ../../../CHANGELOG.md:1064
  2833. msgid "2023-02-25"
  2834. msgstr ""
  2835. #: ../../../CHANGELOG.md:1066
  2836. msgid "rageshake support"
  2837. msgstr ""
  2838. #: ../../../CHANGELOG.md:1068
  2839. msgid ""
  2840. "Thanks to [Benjamin Kampmann](https://github.com/gnunicorn), the playbook"
  2841. " can now install and configure the [rageshake](https://github.com/matrix-"
  2842. "org/rageshake) bug report server."
  2843. msgstr ""
  2844. #: ../../../CHANGELOG.md:1070
  2845. msgid ""
  2846. "Additional details are available in [Setting up rageshake](docs"
  2847. "/configuring-playbook-rageshake.md)."
  2848. msgstr ""
  2849. #: ../../../CHANGELOG.md:1073
  2850. msgid "2023-02-17"
  2851. msgstr ""
  2852. #: ../../../CHANGELOG.md:1075
  2853. msgid "Synapse templates customization support"
  2854. msgstr ""
  2855. #: ../../../CHANGELOG.md:1077
  2856. msgid "The playbook can now help you customize Synapse's templates."
  2857. msgstr ""
  2858. #: ../../../CHANGELOG.md:1079
  2859. msgid ""
  2860. "Additional details are available in the [Customizing templates](docs"
  2861. "/configuring-playbook-synapse.md#customizing-templates) section of our "
  2862. "Synapse documentation."
  2863. msgstr ""
  2864. #: ../../../CHANGELOG.md:1081
  2865. msgid "The matrix-redis role lives independently now"
  2866. msgstr ""
  2867. #: ../../../CHANGELOG.md:1083
  2868. msgid ""
  2869. "**TLDR**: the `matrix-redis` role is now included from another "
  2870. "repository. Some variables have been renamed. All functionality remains "
  2871. "intact."
  2872. msgstr ""
  2873. #: ../../../CHANGELOG.md:1085
  2874. msgid ""
  2875. "The `matrix-redis` role (which configures [Redis](https://redis.io/)) has"
  2876. " been extracted from the playbook and now lives in its [own "
  2877. "repository](https://github.com/mother-of-all-self-hosting/ansible-role-"
  2878. "redis). This makes it possible to easily use it in other Ansible "
  2879. "playbooks."
  2880. msgstr ""
  2881. #: ../../../CHANGELOG.md:1087
  2882. msgid ""
  2883. "You need to **update your roles** (`just roles` or `make roles`) "
  2884. "regardless of whether you're enabling Ntfy or not. If you're making use "
  2885. "of Ntfy via this playbook, you will need to update variable references in"
  2886. " your `vars.yml` file (`matrix_redis_` -> `redis_`)."
  2887. msgstr ""
  2888. #: ../../../CHANGELOG.md:1089
  2889. msgid "The matrix-ntfy role lives independently now"
  2890. msgstr ""
  2891. #: ../../../CHANGELOG.md:1091
  2892. msgid ""
  2893. "**TLDR**: the `matrix-ntfy` role is now included from another repository."
  2894. " Some variables have been renamed. All functionality remains intact."
  2895. msgstr ""
  2896. #: ../../../CHANGELOG.md:1093
  2897. msgid ""
  2898. "The `matrix-ntfy` role (which configures [Ntfy](https://ntfy.sh/)) has "
  2899. "been extracted from the playbook and now lives in its [own "
  2900. "repository](https://github.com/mother-of-all-self-hosting/ansible-role-"
  2901. "ntfy). This makes it possible to easily use it in other Ansible "
  2902. "playbooks."
  2903. msgstr ""
  2904. #: ../../../CHANGELOG.md:1095
  2905. msgid ""
  2906. "You need to **update your roles** (`just roles` or `make roles`) "
  2907. "regardless of whether you're enabling Ntfy or not. If you're making use "
  2908. "of Ntfy via this playbook, you will need to update variable references in"
  2909. " your `vars.yml` file (`matrix_ntfy_` -> `ntfy_`)."
  2910. msgstr ""
  2911. #: ../../../CHANGELOG.md:1098
  2912. msgid "2023-02-15"
  2913. msgstr ""
  2914. #: ../../../CHANGELOG.md:1100
  2915. msgid "The matrix-grafana role lives independently now"
  2916. msgstr ""
  2917. #: ../../../CHANGELOG.md:1102
  2918. msgid ""
  2919. "**TLDR**: the `matrix-grafana` role is now included from another "
  2920. "repository. Some variables have been renamed. All functionality remains "
  2921. "intact."
  2922. msgstr ""
  2923. #: ../../../CHANGELOG.md:1104
  2924. msgid ""
  2925. "The `matrix-grafana` role (which configures [Grafana](docs/configuring-"
  2926. "playbook-prometheus-grafana.md)) has been extracted from the playbook and"
  2927. " now lives in its [own repository](https://github.com/mother-of-all-self-"
  2928. "hosting/ansible-role-grafana). This makes it possible to easily use it in"
  2929. " other Ansible playbooks."
  2930. msgstr ""
  2931. #: ../../../CHANGELOG.md:1106
  2932. msgid ""
  2933. "You need to **update your roles** (`just roles` or `make roles`) "
  2934. "regardless of whether you're enabling Grafana or not. If you're making "
  2935. "use of Grafana via this playbook, you will need to update variable "
  2936. "references in your `vars.yml` file (`matrix_grafana_` -> `grafana_`)."
  2937. msgstr ""
  2938. #: ../../../CHANGELOG.md:1109
  2939. msgid "2023-02-13"
  2940. msgstr ""
  2941. #: ../../../CHANGELOG.md:1111
  2942. msgid "The matrix-backup-borg role lives independently now"
  2943. msgstr ""
  2944. #: ../../../CHANGELOG.md:1113
  2945. msgid ""
  2946. "**TLDR**: the `matrix-backup-borg` role is now included from another "
  2947. "repository. Some variables have been renamed. All functionality remains "
  2948. "intact."
  2949. msgstr ""
  2950. #: ../../../CHANGELOG.md:1115
  2951. msgid ""
  2952. "Thanks to [moan0s](https://github.com/moan0s), the `matrix-backup-borg` "
  2953. "role (which configures [BorgBackup](docs/configuring-playbook-backup-"
  2954. "borg.md)) has been extracted from the playbook and now lives in its [own "
  2955. "repository](https://github.com/mother-of-all-self-hosting/ansible-role-"
  2956. "backup_borg). This makes it possible to easily use it in other Ansible "
  2957. "playbooks and will become part of [nextcloud-docker-ansible-"
  2958. "deploy](https://github.com/spantaleev/nextcloud-docker-ansible-deploy) "
  2959. "soon."
  2960. msgstr ""
  2961. #: ../../../CHANGELOG.md:1117
  2962. msgid ""
  2963. "You need to **update your roles** (`just roles` or `make roles`) "
  2964. "regardless of whether you're enabling Borg's backup functionality or not."
  2965. " If you're making use of BorgBackup via this playbook, you will need to "
  2966. "update variable references in your `vars.yml` file (`matrix_backup_borg_`"
  2967. " -> `backup_borg_`)."
  2968. msgstr ""
  2969. #: ../../../CHANGELOG.md:1120
  2970. msgid "2023-02-12"
  2971. msgstr ""
  2972. #: ../../../CHANGELOG.md:1122
  2973. msgid ""
  2974. "(Backward Compatibility) Reverse-proxy configuration changes and initial "
  2975. "Traefik support"
  2976. msgstr ""
  2977. #: ../../../CHANGELOG.md:1124
  2978. msgid "**TLDR**:"
  2979. msgstr ""
  2980. #: ../../../CHANGELOG.md:1126
  2981. msgid ""
  2982. "there's a new `matrix_playbook_reverse_proxy_type` variable (see "
  2983. "[roles/custom/matrix-base/defaults/main.yml](roles/custom/matrix-"
  2984. "base/defaults/main.yml)), which lets you tell the playbook what reverse-"
  2985. "proxy setup you'd like to have. This makes it easier for people who want "
  2986. "to do reverse-proxying in other ways."
  2987. msgstr ""
  2988. #: ../../../CHANGELOG.md:1127
  2989. msgid ""
  2990. "the default reverse-proxy (`matrix_playbook_reverse_proxy_type`) is still"
  2991. " `playbook-managed-nginx` (via `matrix-nginx-proxy`), for now. **Existing"
  2992. " `matrix-nginx-proxy` users should not observe any changes** and can stay"
  2993. " on this for now."
  2994. msgstr ""
  2995. #: ../../../CHANGELOG.md:1128
  2996. msgid ""
  2997. "**Users who use their [own other webserver](docs/configuring-playbook-"
  2998. "own-webserver.md) (e.g. Apache, etc.) need to change** "
  2999. "`matrix_playbook_reverse_proxy_type` to something like `other-on-same-"
  3000. "host`, `other-on-another-host` or `other-nginx-non-container`"
  3001. msgstr ""
  3002. #: ../../../CHANGELOG.md:1129
  3003. msgid ""
  3004. "we now have **optional [Traefik](https://traefik.io/) support**, so you "
  3005. "could easily host Matrix and other Traefik-native services in containers "
  3006. "on the same server. Traefik support is still experimental (albeit, good "
  3007. "enough) and will improve over time. It does work, but certain esoteric "
  3008. "features may not be there yet."
  3009. msgstr ""
  3010. #: ../../../CHANGELOG.md:1130
  3011. msgid ""
  3012. "**Traefik will become the default reverse-proxy in the near future**. "
  3013. "`matrix-nginx-proxy` will either remain as an option, or be completely "
  3014. "removed to simplify the playbook"
  3015. msgstr ""
  3016. #: ../../../CHANGELOG.md:1132
  3017. msgid "Motivation for redoing our reverse-proxy setup"
  3018. msgstr ""
  3019. #: ../../../CHANGELOG.md:1134
  3020. msgid ""
  3021. "The playbook has supported various reverse-proxy setups for a long time. "
  3022. "We have various configuration variables (`matrix_nginx_proxy_enabled`, "
  3023. "various `_host_bind_port` variables, etc.) which allow the playbook to "
  3024. "adapt to these different setups. The whole situation was messy though - "
  3025. "hard to figure out and with lots of variables to toggle to make things "
  3026. "work as you'd expect - huge **operational complexity**."
  3027. msgstr ""
  3028. #: ../../../CHANGELOG.md:1136
  3029. msgid ""
  3030. "We love containers, proven by the fact that **everything** that this "
  3031. "playbook manages runs in a container. Yet, we weren't allowing people to "
  3032. "easily host other web-exposed containers alongside Matrix services on the"
  3033. " same server. We were using `matrix-nginx-proxy` (our integrated "
  3034. "[nginx](https://nginx.org/) server), which was handling web-exposure and "
  3035. "SSL termination for our own services, but we **weren't helping you with "
  3036. "all your other containers**."
  3037. msgstr ""
  3038. #: ../../../CHANGELOG.md:1138
  3039. msgid ""
  3040. "People who were **using `matrix-nginx-proxy`** were on the happy path on "
  3041. "which everything worked well by default (Matrix-wise), **but** could not "
  3042. "easily run other web-exposed services on their Matrix server because "
  3043. "`matrix-nginx-proxy` was occupying ports `80` and `443`. Other services "
  3044. "which wanted to get web exposure either had to be plugged into `matrix-"
  3045. "nginx-proxy` (somewhat difficult) or people had to forgo using `matrix-"
  3046. "nginx-proxy` in favor of something else."
  3047. msgstr ""
  3048. #: ../../../CHANGELOG.md:1140
  3049. msgid ""
  3050. "Of those that decided to forgo `matrix-nginx-proxy`, many were **using "
  3051. "nginx** on the same server without a container. This was likely some "
  3052. "ancient nginx version, depending on your choice of distro. The Matrix "
  3053. "playbook was trying to be helpful and even with "
  3054. "`matrix_nginx_proxy_enabled: false` was still generating nginx "
  3055. "configuration in `/matrix/nginx-proxy/conf.d`. Those configuration files "
  3056. "were adapted for inclusion into an nginx server running locally. "
  3057. "Disabling the `matrix-nginx-proxy` role like this, yet still having it "
  3058. "produce files is a bit disgusting, but it's what we've had since the "
  3059. "early beginnings of this playbook."
  3060. msgstr ""
  3061. #: ../../../CHANGELOG.md:1142
  3062. msgid ""
  3063. "Others still, wanted to run Matrix locally (no SSL certificates), "
  3064. "regardless of which web server technology this relied on, and then "
  3065. "**reverse-proxy from another machine on the network** which was doing SSL"
  3066. " termination. These people were:"
  3067. msgstr ""
  3068. #: ../../../CHANGELOG.md:1144
  3069. msgid ""
  3070. "*either* relying on `matrix_nginx_proxy_enabled: false` as well, combined"
  3071. " with exposing services manually (setting `_bind_port` variables)"
  3072. msgstr ""
  3073. #: ../../../CHANGELOG.md:1145
  3074. msgid ""
  3075. "*or* better yet, they were keeping `matrix-nginx-proxy` enabled, but in "
  3076. "`http`-only mode (no SSL certificate retrieval)."
  3077. msgstr ""
  3078. #: ../../../CHANGELOG.md:1147
  3079. msgid ""
  3080. "Despite this operational complexity, things worked and were reasonably "
  3081. "flexible to adapt to all these situations."
  3082. msgstr ""
  3083. #: ../../../CHANGELOG.md:1149
  3084. msgid ""
  3085. "When using `matrix-nginx-proxy` as is, we still had another problem - one"
  3086. " of **internal playbook complexity**. Too many services need to be web-"
  3087. "exposed (port 80/443, SSL certificates). Because of this, they all had to"
  3088. " integrate with the `matrix-nginx-proxy` role. Tens of different roles "
  3089. "explicitly integrating with `matrix-nginx-proxy` is not what we call "
  3090. "clean. The `matrix-nginx-proxy` role contains variables for many of these"
  3091. " roles (yikes). Other roles were more decoupled from it and were "
  3092. "injecting configuration into `matrix-nginx-proxy` at runtime - see all "
  3093. "the `inject_into_nginx_proxy.yml` task files in this playbook (more "
  3094. "decoupled, but still.. yikes)."
  3095. msgstr ""
  3096. #: ../../../CHANGELOG.md:1151
  3097. msgid ""
  3098. "The next problem is one of **efficiency, interoperability and cost-"
  3099. "saving**. We're working on other playbooks:"
  3100. msgstr ""
  3101. #: ../../../CHANGELOG.md:1153
  3102. msgid ""
  3103. "[vaultwarden-docker-ansible-deploy](https://github.com/spantaleev"
  3104. "/vaultwarden-docker-ansible-deploy) for hosting the "
  3105. "[Vaultwarden](https://github.com/dani-garcia/vaultwarden) server - an "
  3106. "alternative implementation of the [Bitwarden](https://bitwarden.com/) "
  3107. "password manager"
  3108. msgstr ""
  3109. #: ../../../CHANGELOG.md:1154
  3110. msgid ""
  3111. "[gitea-docker-ansible-deploy](https://github.com/spantaleev/gitea-docker-"
  3112. "ansible-deploy) - for hosting the [Gitea](https://gitea.io/) git source "
  3113. "code hosting service"
  3114. msgstr ""
  3115. #: ../../../CHANGELOG.md:1155
  3116. msgid ""
  3117. "[nextcloud-docker-ansible-deploy](https://github.com/spantaleev"
  3118. "/nextcloud-docker-ansible-deploy) - for hosting the "
  3119. "[Nextcloud](https://nextcloud.com/) groupware platform"
  3120. msgstr ""
  3121. #: ../../../CHANGELOG.md:1157
  3122. msgid ""
  3123. "We'd love for users to be able to **seamlessly use all these playbooks "
  3124. "(and others, even) against a single server**. We don't want `matrix-"
  3125. "nginx-proxy` to have a monopoly on port `80`/`443` and make it hard for "
  3126. "other services to join in on the party. Such a thing forces people into "
  3127. "running multiple servers (one for each service), which does provide nice "
  3128. "security benefits, but is costly and ineffiecient. We'd like to make "
  3129. "self-hosting these services cheap and easy."
  3130. msgstr ""
  3131. #: ../../../CHANGELOG.md:1159
  3132. msgid ""
  3133. "These other playbooks have been using [Traefik](https://traefik.io/) as "
  3134. "their default reverse-proxy for a long time. They can all coexist nicely "
  3135. "together (as an example, see the "
  3136. "[Interoperability](https://github.com/spantaleev/nextcloud-docker-"
  3137. "ansible-deploy/blob/master/docs/configuring-playbook-interoperability.md)"
  3138. " documentation for the [Nextcloud playbook](https://github.com/spantaleev"
  3139. "/nextcloud-docker-ansible-deploy)). Now that this playbook is gaining "
  3140. "Traefik support, it will be able to interoperate with them. If you're "
  3141. "going this way, make sure to have the Matrix playbook install Traefik and"
  3142. " have the others use `*_reverse_proxy_type: other-traefik-container`."
  3143. msgstr ""
  3144. #: ../../../CHANGELOG.md:1161
  3145. msgid ""
  3146. "Finally, at [etke.cc - a managed Matrix server hosting "
  3147. "service](https://etke.cc) (built on top of this playbook, and "
  3148. "coincidentally [turning 2 years old today](https://etke.cc/news"
  3149. "/upsyw4ykbtgmwhz8k7ukldx0zbbfq-fh0iqi3llixi0/) 🎉), we're allowing people "
  3150. "to host some additional services besides Matrix components. Exposing "
  3151. "these services to the web requires ugly hacks and configuration files "
  3152. "being dropped into `/matrix/nginx-proxy/conf.d`. We believe that "
  3153. "everything should run in independent containers and be exposed to the web"
  3154. " via a Traefik server, without a huge Ansible role like `matrix-nginx-"
  3155. "proxy` that everything else needs to integrate with."
  3156. msgstr ""
  3157. #: ../../../CHANGELOG.md:1163
  3158. msgid "How do these changes fix all these problems?"
  3159. msgstr ""
  3160. #: ../../../CHANGELOG.md:1165
  3161. msgid ""
  3162. "The new `matrix_playbook_reverse_proxy_type` lets you easily specify your"
  3163. " preferred reverse-proxy type, including `other-on-same-host`, `other-on-"
  3164. "another-host` and `none`, so people who'd like to reverse-proxy with "
  3165. "their own web server have more options now."
  3166. msgstr ""
  3167. #: ../../../CHANGELOG.md:1167
  3168. msgid ""
  3169. "Using Traefik greatly simplifies things, so going forward we'll have a "
  3170. "simpler and easier to maintain playbook, which is also interoperable with"
  3171. " other services."
  3172. msgstr ""
  3173. #: ../../../CHANGELOG.md:1169
  3174. msgid ""
  3175. "Traefik is a web server, which has been specifically **designed for "
  3176. "reverse-proxying to services running in containers**. It's ideal for "
  3177. "usage in an Ansible playbook which runs everything in containers."
  3178. msgstr ""
  3179. #: ../../../CHANGELOG.md:1171
  3180. msgid ""
  3181. "**Traefik obtains SSL certificates automatically**, so there's no need "
  3182. "for plugging additional tools like [Certbot](https://certbot.eff.org/) "
  3183. "into your web server (like we were doing in the `matrix-nginx-proxy` "
  3184. "role). No more certificate renewal timers, web server reloading timers, "
  3185. "etc. It's just simpler."
  3186. msgstr ""
  3187. #: ../../../CHANGELOG.md:1173
  3188. msgid ""
  3189. "Traefik is a **modern web server**. "
  3190. "[HTTP/3](https://doc.traefik.io/traefik/routing/entrypoints/#http3) is "
  3191. "supported already (experimentally) and will move to stable soon, in the "
  3192. "upcoming Traefik v3 release."
  3193. msgstr ""
  3194. #: ../../../CHANGELOG.md:1175
  3195. msgid ""
  3196. "Traefik does not lock important functionality we'd like to use into [plus"
  3197. " packages like nginx does](https://www.nginx.com/products/nginx/), "
  3198. "leading us to resolve to configuration workarounds. The default Traefik "
  3199. "package is good enough as it is."
  3200. msgstr ""
  3201. #: ../../../CHANGELOG.md:1177
  3202. msgid "Where we're at right now?"
  3203. msgstr ""
  3204. #: ../../../CHANGELOG.md:1179
  3205. msgid ""
  3206. "`matrix_playbook_reverse_proxy_type` still defaults to a value of "
  3207. "`playbook-managed-nginx`."
  3208. msgstr ""
  3209. #: ../../../CHANGELOG.md:1181
  3210. msgid ""
  3211. "Unless we have some regression, **existing `matrix-nginx-proxy` users "
  3212. "should be able to update their Matrix server and not observe any "
  3213. "changes**. Their setup should still remain on nginx and everything should"
  3214. " still work as expected."
  3215. msgstr ""
  3216. #: ../../../CHANGELOG.md:1183
  3217. msgid ""
  3218. "**Users using [their own webservers](docs/configuring-playbook-own-"
  3219. "webserver.md) will need to change `matrix_playbook_reverse_proxy_type`** "
  3220. "to something like `other-on-same-host`, `other-on-another-host` or "
  3221. "`other-nginx-non-container`. Previously, they could toggle "
  3222. "`matrix_nginx_proxy_enabled` to `false`, and that made the playbook "
  3223. "automatically expose services locally. Currently, we only do this if you "
  3224. "change the reverse-proxy type to `other-on-same-host`, `other-on-another-"
  3225. "host` or `other-nginx-non-container`."
  3226. msgstr ""
  3227. #: ../../../CHANGELOG.md:1185
  3228. msgid "How do I explicitly switch to Traefik right now?"
  3229. msgstr ""
  3230. #: ../../../CHANGELOG.md:1187
  3231. msgid ""
  3232. "**Users who wish to migrate to Traefik** today, can do so by **adding** "
  3233. "this to their configuration:"
  3234. msgstr ""
  3235. #: ../../../CHANGELOG.md:1195
  3236. msgid ""
  3237. "You may still need to keep certain old `matrix_nginx_proxy_*` variables "
  3238. "(like `matrix_nginx_proxy_base_domain_serving_enabled`), even when using "
  3239. "Traefik. For now, we recommend keeping all `matrix_nginx_proxy_*` "
  3240. "variables just in case. In the future, reliance on `matrix-nginx-proxy` "
  3241. "will be removed."
  3242. msgstr ""
  3243. #: ../../../CHANGELOG.md:1197
  3244. msgid ""
  3245. "Switching to Traefik will obtain new SSL certificates from Let's Encrypt "
  3246. "(stored in `/matrix/traefik/ssl/acme.json`). **The switch is "
  3247. "reversible**. You can always go back to `playbook-managed-nginx` if "
  3248. "Traefik is causing you trouble."
  3249. msgstr ""
  3250. #: ../../../CHANGELOG.md:1199
  3251. msgid ""
  3252. "**Note**: toggling `matrix_playbook_reverse_proxy_type` between Traefik "
  3253. "and nginx will uninstall the Traefik role and all of its data (under "
  3254. "`/matrix/traefik`), so you may run into a Let's Encrypt rate limit if you"
  3255. " do it often."
  3256. msgstr ""
  3257. #: ../../../CHANGELOG.md:1201
  3258. msgid ""
  3259. "Treafik directly reverse-proxies to **some** services right now, but for "
  3260. "most other services it goes through `matrix-nginx-proxy` (e.g. Traefik ->"
  3261. " `matrix-nginx-proxy` -> [Ntfy](docs/configuring-playbook-ntfy.md)). So, "
  3262. "even if you opt into Traefik, you'll still see `matrix-nginx-proxy` being"
  3263. " installed in local-only mode. This will improve with time."
  3264. msgstr ""
  3265. #: ../../../CHANGELOG.md:1203
  3266. msgid ""
  3267. "Some services (like [Coturn](docs/configuring-playbook-turn.md) and "
  3268. "[Postmoogle](docs/configuring-playbook-bridge-postmoogle.md)) cannot be "
  3269. "reverse-proxied to directly from Traefik, so they require direct access "
  3270. "to SSL certificate files extracted out of Traefik. The playbook does this"
  3271. " automatically thanks to a new "
  3272. "[com.devture.ansible.role.traefik_certs_dumper](https://github.com/devture/com.devture.ansible.role.traefik_certs_dumper)"
  3273. " role utilizing the [traefik-certs-dumper](https://github.com/ldez"
  3274. "/traefik-certs-dumper) tool."
  3275. msgstr ""
  3276. #: ../../../CHANGELOG.md:1205
  3277. msgid ""
  3278. "Our Traefik setup mostly works, but certain esoteric features may not "
  3279. "work. If you have a default setup, we expect you to have a good "
  3280. "experience."
  3281. msgstr ""
  3282. #: ../../../CHANGELOG.md:1207
  3283. msgid "Where we're going in the near future?"
  3284. msgstr ""
  3285. #: ../../../CHANGELOG.md:1209
  3286. msgid ""
  3287. "The `matrix-nginx-proxy` role is quite messy. It manages both nginx and "
  3288. "Certbot and its certificate renewal scripts and timers. It generates "
  3289. "configuration even when the role is disabled (weird). Although it doesn't"
  3290. " directly reach into variables from other roles, it has explicit "
  3291. "awareness of various other services that it reverse-proxies to "
  3292. "(`roles/custom/matrix-nginx-proxy/templates/nginx/conf.d/matrix-"
  3293. "ntfy.conf.j2`, etc.). We'd like to clean this up. The only way is "
  3294. "probably to just get rid of the whole thing at some point."
  3295. msgstr ""
  3296. #: ../../../CHANGELOG.md:1211
  3297. msgid "For now, `matrix-nginx-proxy` will stay around."
  3298. msgstr ""
  3299. #: ../../../CHANGELOG.md:1213
  3300. msgid ""
  3301. "As mentioned above, Traefik still reverse-proxies to some (most) services"
  3302. " by going through a local-only `matrix-nginx-proxy` server. This has "
  3303. "allowed us to add Traefik support to the playbook early on (without "
  3304. "having to rework all services), but is not the final goal. We'll **work "
  3305. "on making each service support Traefik natively**, so that traffic will "
  3306. "not need to go through `matrix-nginx-proxy` anymore. In the end, choosing"
  3307. " Traefik should only give you a pure Traefik installation with no "
  3308. "`matrix-nginx-proxy` in sight."
  3309. msgstr ""
  3310. #: ../../../CHANGELOG.md:1215
  3311. msgid ""
  3312. "As Traefik support becomes complete and proves to be stable for a while, "
  3313. "especially as a playbook default, we will **most likely remove `matrix-"
  3314. "nginx-proxy` completely**. It will likely be some months before this "
  3315. "happens though. Keeping support for both Traefik and nginx in the "
  3316. "playbook will be a burden, especially with most of us running Traefik in "
  3317. "the future. The Traefik role should do everything nginx does in a better "
  3318. "and cleaner way. Users who use their own `nginx` server on the Matrix "
  3319. "server will be inconvenienced, as nothing will generate ready-to-include "
  3320. "nginx configuration for them. Still, we hope it won't be too hard to "
  3321. "migrate their setup to another way of doing things, like:"
  3322. msgstr ""
  3323. #: ../../../CHANGELOG.md:1217
  3324. msgid ""
  3325. "not using nginx anymore. A common reason for using nginx until now was "
  3326. "that you were running other containers and you need your own nginx to "
  3327. "reverse-proxy to all of them. Just switch them to Traefik as well."
  3328. msgstr ""
  3329. #: ../../../CHANGELOG.md:1218
  3330. msgid ""
  3331. "running Traefik in local-only mode "
  3332. "(`traefik_config_entrypoint_web_secure_enabled: false`) and using some "
  3333. "nginx configuration which reverse-proxies to Traefik (we should introduce"
  3334. " examples for this in `examples/nginx`)."
  3335. msgstr ""
  3336. #: ../../../CHANGELOG.md:1220
  3337. msgid "How do I help?"
  3338. msgstr ""
  3339. #: ../../../CHANGELOG.md:1222
  3340. msgid "You can help by:"
  3341. msgstr ""
  3342. #: ../../../CHANGELOG.md:1224
  3343. msgid ""
  3344. "**explicitly switching your server to Traefik** right now (see example "
  3345. "configuration in [How do I explicitly switch to Traefik right now?](#how-"
  3346. "do-i-explicitly-switch-to-traefik-right-now) above), testing, reporting "
  3347. "troubles"
  3348. msgstr ""
  3349. #: ../../../CHANGELOG.md:1226
  3350. msgid ""
  3351. "**adding native Traefik support to a role** (requires adding Traefik "
  3352. "labels, etc.) - for inspiration, see these roles "
  3353. "([prometheus_node_exporter](https://github.com/mother-of-all-self-hosting"
  3354. "/ansible-role-prometheus-node-exporter), "
  3355. "[prometheus_postgres_exporter](https://github.com/mother-of-all-self-"
  3356. "hosting/ansible-role-prometheus-postgres-exporter)) and how they're "
  3357. "hooked into the playbook via "
  3358. "[group_vars/matrix_servers](group_vars/matrix_servers)."
  3359. msgstr ""
  3360. #: ../../../CHANGELOG.md:1228
  3361. msgid ""
  3362. "**adding reverse-proxying examples for nginx users** in `examples/nginx`."
  3363. " People who insist on using their own `nginx` server on the same Matrix "
  3364. "host, can run Traefik in local-only mode "
  3365. "(`traefik_config_entrypoint_web_secure_enabled: false`) and reverse-proxy"
  3366. " to the Traefik server"
  3367. msgstr ""
  3368. #: ../../../CHANGELOG.md:1231
  3369. msgid "2023-02-10"
  3370. msgstr ""
  3371. #: ../../../CHANGELOG.md:1233
  3372. msgid "Matrix Authentication Support for Jitsi"
  3373. msgstr ""
  3374. #: ../../../CHANGELOG.md:1235
  3375. msgid ""
  3376. "Thanks to [Jakob S.](https://github.com/jakicoll) ([zakk "
  3377. "gGmbH](https://github.com/zakk-it)), Jitsi can now use Matrix for "
  3378. "authentication (via [Matrix User Verification Service](https://github.com"
  3379. "/matrix-org/matrix-user-verification-service))."
  3380. msgstr ""
  3381. #: ../../../CHANGELOG.md:1237
  3382. msgid ""
  3383. "Additional details are available in the [Authenticate using Matrix OpenID"
  3384. " (Auth-Type 'matrix')](docs/configuring-playbook-jitsi.md#authenticate-"
  3385. "using-matrix-openid-auth-type-matrix)."
  3386. msgstr ""
  3387. #: ../../../CHANGELOG.md:1239
  3388. msgid "Draupnir moderation tool (bot) support"
  3389. msgstr ""
  3390. #: ../../../CHANGELOG.md:1241
  3391. msgid ""
  3392. "Thanks to [FSG-Cat](https://github.com/FSG-Cat), the playbook can now "
  3393. "install and configure the [Draupnir](https://github.com/the-draupnir-"
  3394. "project/Draupnir) moderation tool (bot). Draupnir is a fork of "
  3395. "[Mjolnir](docs/configuring-playbook-bot-mjolnir.md) (which the playbook "
  3396. "has supported for a long time) maintained by Mjolnir's former lead "
  3397. "developer."
  3398. msgstr ""
  3399. #: ../../../CHANGELOG.md:1243
  3400. msgid ""
  3401. "Additional details are available in [Setting up Draupnir](docs"
  3402. "/configuring-playbook-bot-draupnir.md)."
  3403. msgstr ""
  3404. #: ../../../CHANGELOG.md:1246
  3405. msgid "2023-02-05"
  3406. msgstr ""
  3407. #: ../../../CHANGELOG.md:1248
  3408. msgid "The matrix-prometheus-postgres-exporter role lives independently now"
  3409. msgstr ""
  3410. #: ../../../CHANGELOG.md:1250
  3411. msgid ""
  3412. "**TLDR**: the `matrix-prometheus-postgres-exporter` role is now included "
  3413. "from another repository. Some variables have been renamed. All "
  3414. "functionality remains intact."
  3415. msgstr ""
  3416. #: ../../../CHANGELOG.md:1252
  3417. msgid ""
  3418. "The `matrix-prometheus-postgres-exporter` role (which configures "
  3419. "[Prometheus Postgres Exporter](https://github.com/prometheus-"
  3420. "community/postgres_exporter)) has been extracted from the playbook and "
  3421. "now lives in its own repository at https://github.com/mother-of-all-self-"
  3422. "hosting/ansible-role-prometheus-postgres-exporter"
  3423. msgstr ""
  3424. #: ../../../CHANGELOG.md:1254
  3425. msgid ""
  3426. "It's still part of the playbook, but is now installed via `ansible-"
  3427. "galaxy` (by running `just roles` / `make roles`). Some variables have "
  3428. "been renamed (`matrix_prometheus_postgres_exporter_` -> "
  3429. "`prometheus_postgres_exporter_`, etc.). The playbook will report all "
  3430. "variables that you need to rename to get upgraded. All functionality "
  3431. "remains intact."
  3432. msgstr ""
  3433. #: ../../../CHANGELOG.md:1256
  3434. msgid ""
  3435. "The `matrix-prometheus-services-proxy-connect` role has bee adjusted to "
  3436. "help integrate the new `prometheus_postgres_exporter` role with our own "
  3437. "services (`matrix-nginx-proxy`)"
  3438. msgstr ""
  3439. #: ../../../CHANGELOG.md:1258 ../../../CHANGELOG.md:1300
  3440. msgid ""
  3441. "Other roles which aren't strictly related to Matrix are likely to follow "
  3442. "this fate of moving to their own repositories. Extracting them out allows"
  3443. " other Ansible playbooks to make use of these roles easily."
  3444. msgstr ""
  3445. #: ../../../CHANGELOG.md:1261
  3446. msgid "2023-01-26"
  3447. msgstr ""
  3448. #: ../../../CHANGELOG.md:1263
  3449. msgid "Coturn can now use host-networking"
  3450. msgstr ""
  3451. #: ../../../CHANGELOG.md:1265
  3452. msgid ""
  3453. "Large Coturn deployments (with a huge range of ports specified via "
  3454. "`matrix_coturn_turn_udp_min_port` and `matrix_coturn_turn_udp_max_port`) "
  3455. "experience a huge slowdown with how Docker publishes all these ports "
  3456. "(setting up firewall forwarding rules), which leads to a very slow Coturn"
  3457. " service startup and shutdown."
  3458. msgstr ""
  3459. #: ../../../CHANGELOG.md:1267
  3460. msgid ""
  3461. "Such deployments don't need to run Coturn within a private container "
  3462. "network anymore. Coturn can now run with host-networking by using "
  3463. "configuration like this:"
  3464. msgstr ""
  3465. #: ../../../CHANGELOG.md:1273
  3466. msgid ""
  3467. "With such a configuration, **Docker no longer needs to configure "
  3468. "thousands of firewall forwarding rules** each time Coturn starts and "
  3469. "stops. This, however, means that **you will need to ensure these ports "
  3470. "are open** in your firewall yourself."
  3471. msgstr ""
  3472. #: ../../../CHANGELOG.md:1275
  3473. msgid ""
  3474. "Thanks to us [tightening Coturn security](#backward-compatibility-"
  3475. "tightening-coturn-security-can-lead-to-connectivity-issues), running "
  3476. "Coturn with host-networking should be safe and not expose neither other "
  3477. "services running on the host, nor other services running on the local "
  3478. "network."
  3479. msgstr ""
  3480. #: ../../../CHANGELOG.md:1277
  3481. msgid ""
  3482. "(Backward Compatibility) Tightening Coturn security can lead to "
  3483. "connectivity issues"
  3484. msgstr ""
  3485. #: ../../../CHANGELOG.md:1279
  3486. msgid ""
  3487. "**TLDR**: users who run and access their Matrix server on a private "
  3488. "network (likely a small minority of users) may experience connectivity "
  3489. "issues with our new default Coturn blocklists. They may need to override "
  3490. "`matrix_coturn_denied_peer_ips` and remove some IP ranges from it."
  3491. msgstr ""
  3492. #: ../../../CHANGELOG.md:1281
  3493. msgid ""
  3494. "Inspired by [this security "
  3495. "article](https://www.rtcsec.com/article/cve-2020-26262-bypass-of-coturns-"
  3496. "access-control-protection/), we've decided to make use of Coturn's "
  3497. "`denied-peer-ip` functionality to prevent relaying network traffic to "
  3498. "certain private IP subnets. This ensures that your Coturn server won't "
  3499. "accidentally try to forward traffic to certain services running on your "
  3500. "local networks. We run Coturn in a container and in a private container "
  3501. "network by default, which should prevent such access anyway, but having "
  3502. "additional block layers in place is better."
  3503. msgstr ""
  3504. #: ../../../CHANGELOG.md:1283
  3505. msgid ""
  3506. "If you access your Matrix server from a local network and need Coturn to "
  3507. "relay to private IP addresses, you may observe that relaying is now "
  3508. "blocked due to our new default `denied-peer-ip` lists (specified in "
  3509. "`matrix_coturn_denied_peer_ips`). If you experience such connectivity "
  3510. "problems, consider overriding this setting in your `vars.yml` file and "
  3511. "removing certain networks from it."
  3512. msgstr ""
  3513. #: ../../../CHANGELOG.md:1285
  3514. msgid ""
  3515. "We've also added `no-multicast-peers` to the default Coturn "
  3516. "configuration, but we don't expect this to cause trouble for most people."
  3517. msgstr ""
  3518. #: ../../../CHANGELOG.md:1288
  3519. msgid "2023-01-21"
  3520. msgstr ""
  3521. #: ../../../CHANGELOG.md:1290
  3522. msgid "The matrix-prometheus-node-exporter role lives independently now"
  3523. msgstr ""
  3524. #: ../../../CHANGELOG.md:1292
  3525. msgid ""
  3526. "**TLDR**: the `matrix-prometheus-node-exporter` role is now included from"
  3527. " another repository. Some variables have been renamed. All functionality "
  3528. "remains intact."
  3529. msgstr ""
  3530. #: ../../../CHANGELOG.md:1294
  3531. msgid ""
  3532. "The `matrix-prometheus-node-exporter` role (which configures [Prometheus "
  3533. "node exporter](https://github.com/prometheus/node_exporter)) has been "
  3534. "extracted from the playbook and now lives in its own repository at "
  3535. "https://github.com/mother-of-all-self-hosting/ansible-role-prometheus-"
  3536. "node-exporter"
  3537. msgstr ""
  3538. #: ../../../CHANGELOG.md:1296
  3539. msgid ""
  3540. "It's still part of the playbook, but is now installed via `ansible-"
  3541. "galaxy` (by running `just roles` / `make roles`). Some variables have "
  3542. "been renamed (`matrix_prometheus_node_exporter_` -> "
  3543. "`prometheus_node_exporter_`, etc.). The playbook will report all "
  3544. "variables that you need to rename to get upgraded. All functionality "
  3545. "remains intact."
  3546. msgstr ""
  3547. #: ../../../CHANGELOG.md:1298
  3548. msgid ""
  3549. "A new `matrix-prometheus-services-proxy-connect` role was added to the "
  3550. "playbook to help integrate the new `prometheus_node_exporter` role with "
  3551. "our own services (`matrix-nginx-proxy`)"
  3552. msgstr ""
  3553. #: ../../../CHANGELOG.md:1303
  3554. msgid "2023-01-13"
  3555. msgstr ""
  3556. #: ../../../CHANGELOG.md:1305
  3557. msgid "Support for running commands via just"
  3558. msgstr ""
  3559. #: ../../../CHANGELOG.md:1307
  3560. msgid ""
  3561. "We've previously used [make](https://www.gnu.org/software/make/) for "
  3562. "easily running some playbook commands (e.g. `make roles` which triggers "
  3563. "`ansible-galaxy`, see [Makefile](Makefile)). Our `Makefile` is still "
  3564. "around and you can still run these commands."
  3565. msgstr ""
  3566. #: ../../../CHANGELOG.md:1309
  3567. msgid ""
  3568. "In addition, we've added support for running commands via "
  3569. "[just](https://github.com/casey/just) - a more modern command-runner "
  3570. "alternative to `make`. Instead of `make roles`, you can now run `just "
  3571. "roles` to accomplish the same."
  3572. msgstr ""
  3573. #: ../../../CHANGELOG.md:1311
  3574. msgid ""
  3575. "Our [justfile](justfile) already defines some additional helpful "
  3576. "**shortcut** commands that weren't part of our `Makefile`. Here are some "
  3577. "examples:"
  3578. msgstr ""
  3579. #: ../../../CHANGELOG.md:1313
  3580. msgid ""
  3581. "`just install-all` to trigger the much longer `ansible-playbook -i "
  3582. "inventory/hosts setup.yml --tags=install-all,ensure-matrix-users-"
  3583. "created,start` command"
  3584. msgstr ""
  3585. #: ../../../CHANGELOG.md:1314
  3586. msgid ""
  3587. "`just install-all --ask-vault-pass` - commands also support additional "
  3588. "arguments (`--ask-vault-pass` will be appended to the above installation "
  3589. "command)"
  3590. msgstr ""
  3591. #: ../../../CHANGELOG.md:1315
  3592. msgid ""
  3593. "`just run-tags install-mautrix-slack,start` - to run specific playbook "
  3594. "tags"
  3595. msgstr ""
  3596. #: ../../../CHANGELOG.md:1316
  3597. msgid "`just start-all` - (re-)starts all services"
  3598. msgstr ""
  3599. #: ../../../CHANGELOG.md:1317
  3600. msgid "`just stop-group postgres` - to stop only the Postgres service"
  3601. msgstr ""
  3602. #: ../../../CHANGELOG.md:1318
  3603. msgid ""
  3604. "`just register-user alice secret-password yes` - registers an `alice` "
  3605. "user with the `secret-password` password and admin access (admin = `yes`)"
  3606. msgstr ""
  3607. #: ../../../CHANGELOG.md:1320
  3608. msgid "Additional helpful commands and shortcuts may be defined in the future."
  3609. msgstr ""
  3610. #: ../../../CHANGELOG.md:1322
  3611. msgid ""
  3612. "This is all completely optional. If you find it difficult to [install "
  3613. "`just`](https://github.com/casey/just#installation) or don't find any of "
  3614. "this convenient, feel free to run all commands manually."
  3615. msgstr ""
  3616. #: ../../../CHANGELOG.md:1325
  3617. msgid "2023-01-11"
  3618. msgstr ""
  3619. #: ../../../CHANGELOG.md:1327
  3620. msgid "mautrix-slack support"
  3621. msgstr ""
  3622. #: ../../../CHANGELOG.md:1329
  3623. msgid ""
  3624. "Thanks to [Cody Neiman](https://github.com/xangelix)'s efforts, the "
  3625. "playbook now supports bridging to [Slack](https://slack.com/) via the "
  3626. "[mautrix-slack](https://mau.dev/mautrix/slack) bridge. See our [Setting "
  3627. "up Mautrix Slack bridging](docs/configuring-playbook-bridge-mautrix-"
  3628. "slack.md) documentation page for getting started."
  3629. msgstr ""
  3630. #: ../../../CHANGELOG.md:1331
  3631. msgid ""
  3632. "**Note**: this is a new Slack bridge. The playbook still retains Slack "
  3633. "bridging via [matrix-appservice-slack](docs/configuring-playbook-bridge-"
  3634. "appservice-slack.md) and [mx-puppet-slack](docs/configuring-playbook-"
  3635. "bridge-mx-puppet-slack.md). You're free to use the bridge that serves you"
  3636. " better, or even all three of them (for different users and use-cases)."
  3637. msgstr ""
  3638. #: ../../../CHANGELOG.md:1334
  3639. msgid "2023-01-10"
  3640. msgstr ""
  3641. #: ../../../CHANGELOG.md:1336
  3642. msgid "ChatGPT support"
  3643. msgstr ""
  3644. #: ../../../CHANGELOG.md:1338
  3645. msgid ""
  3646. "Thanks to [@bertybuttface](https://github.com/bertybuttface), the "
  3647. "playbook can now help you set up [matrix-chatgpt-"
  3648. "bot](https://github.com/matrixgpt/matrix-chatgpt-bot) - a bot through "
  3649. "which you can talk to the [ChatGPT](https://openai.com/blog/chatgpt/) "
  3650. "model."
  3651. msgstr ""
  3652. #: ../../../CHANGELOG.md:1340
  3653. msgid ""
  3654. "See our [Setting up matrix-bot-chatgpt](docs/configuring-playbook-bot-"
  3655. "chatgpt.md) documentation to get started."
  3656. msgstr ""
  3657. #: ../../../CHANGELOG.md:1343
  3658. msgid "2022-11-30"
  3659. msgstr ""
  3660. #: ../../../CHANGELOG.md:1345
  3661. msgid ""
  3662. "matrix-postgres-backup has been replaced by the ansible-role-postgres-"
  3663. "backup external role"
  3664. msgstr ""
  3665. #: ../../../CHANGELOG.md:1347
  3666. msgid ""
  3667. "Just like we've [replaced Postgres with an external role](#matrix-"
  3668. "postgres-has-been-replaced-by-the-comdevtureansiblerolepostgres-external-"
  3669. "role) on 2022-11-28, we're now replacing `matrix-postgres-backup` with an"
  3670. " external role - "
  3671. "[com.devture.ansible.role.postgres_backup](https://github.com/mother-of-"
  3672. "all-self-hosting/ansible-role-postgres_backup)."
  3673. msgstr ""
  3674. #: ../../../CHANGELOG.md:1349
  3675. msgid ""
  3676. "You'll need to rename your `matrix_postgres_backup`-prefixed variables "
  3677. "such that they use a `postgres_backup` prefix."
  3678. msgstr ""
  3679. #: ../../../CHANGELOG.md:1352
  3680. msgid "2022-11-28"
  3681. msgstr ""
  3682. #: ../../../CHANGELOG.md:1354
  3683. msgid ""
  3684. "matrix-postgres has been replaced by the ansible-role-postgres external "
  3685. "role"
  3686. msgstr ""
  3687. #: ../../../CHANGELOG.md:1356
  3688. msgid ""
  3689. "**TLDR**: the tasks that install the integrated Postgres server now live "
  3690. "in an external role - [ansible-role-postgres](https://github.com/mother-"
  3691. "of-all-self-hosting/ansible-role-postgres). You'll need to run `make "
  3692. "roles` to install it, and to also rename your `matrix_postgres`-prefixed "
  3693. "variables to use a `devture_postgres` prefix (e.g. "
  3694. "`matrix_postgres_connection_password` -> `postgres_connection_password`)."
  3695. " All your data will still be there! Some scripts have moved "
  3696. "(`/usr/local/bin/matrix-postgres-cli` -> `/matrix/postgres/bin/cli`)."
  3697. msgstr ""
  3698. #: ../../../CHANGELOG.md:1358
  3699. msgid ""
  3700. "The `matrix-postgres` role that has been part of the playbook for a long "
  3701. "time has been replaced with the [ansible-role-"
  3702. "postgres](https://github.com/mother-of-all-self-hosting/ansible-role-"
  3703. "postgres) role. This was done as part of our work to [use external roles "
  3704. "for some things](#the-playbook-now-uses-external-roles-for-some-things) "
  3705. "for better code re-use and maintainability."
  3706. msgstr ""
  3707. #: ../../../CHANGELOG.md:1360
  3708. msgid ""
  3709. "The new role is an upgraded version of the old `matrix-postgres` role "
  3710. "with these notable differences:"
  3711. msgstr ""
  3712. #: ../../../CHANGELOG.md:1362
  3713. msgid ""
  3714. "it uses different names for its variables (`matrix_postgres` -> "
  3715. "`devture_postgres`)"
  3716. msgstr ""
  3717. #: ../../../CHANGELOG.md:1363
  3718. msgid ""
  3719. "when [Vacuuming PostgreSQL](docs/maintenance-postgres.md#vacuuming-"
  3720. "postgresql), it will vacuum all your databases, not just the Synapse one"
  3721. msgstr ""
  3722. #: ../../../CHANGELOG.md:1365
  3723. msgid ""
  3724. "You'll need to run `make roles` to install the new role. You would also "
  3725. "need to rename your `matrix_postgres`-prefixed variables to use a "
  3726. "`devture_postgres` prefix."
  3727. msgstr ""
  3728. #: ../../../CHANGELOG.md:1367
  3729. msgid ""
  3730. "Note: the systemd service still remains the same - `matrix-"
  3731. "postgres.service`. Your data will still be in `/matrix/postgres`, etc. "
  3732. "Postgres-related scripts will be moved to `/matrix/postgres/bin` "
  3733. "(`/usr/local/bin/matrix-postgres-cli` -> `/matrix/postgres/bin/cli`, "
  3734. "etc). Also see [The playbook no longer installs scripts in /usr/local/bin"
  3735. "](#the-playbook-no-longer-installs-scripts-in-usrlocalbin)."
  3736. msgstr ""
  3737. #: ../../../CHANGELOG.md:1369
  3738. msgid "The playbook no longer installs scripts to /usr/local/bin"
  3739. msgstr ""
  3740. #: ../../../CHANGELOG.md:1371
  3741. msgid "The locations of various scripts installed by the playbook have changed."
  3742. msgstr ""
  3743. #: ../../../CHANGELOG.md:1373
  3744. msgid ""
  3745. "The playbook no longer contaminates your `/usr/local/bin` directory. All "
  3746. "scripts installed by the playbook now live in `bin/` directories under "
  3747. "`/matrix`. Some examples are below:"
  3748. msgstr ""
  3749. #: ../../../CHANGELOG.md:1375
  3750. msgid "`/usr/local/bin/matrix-remove-all` -> `/matrix/bin/remove-all`"
  3751. msgstr ""
  3752. #: ../../../CHANGELOG.md:1376
  3753. msgid "`/usr/local/bin/matrix-postgres-cli` -> `/matrix/postgres/bin/cli`"
  3754. msgstr ""
  3755. #: ../../../CHANGELOG.md:1377
  3756. msgid ""
  3757. "`/usr/local/bin/matrix-ssl-lets-encrypt-certificates-renew` -> "
  3758. "`/matrix/ssl/bin/lets-encrypt-certificates-renew`"
  3759. msgstr ""
  3760. #: ../../../CHANGELOG.md:1378
  3761. msgid ""
  3762. "`/usr/local/bin/matrix-synapse-register-user` -> `/matrix/synapse/bin"
  3763. "/register-user`"
  3764. msgstr ""
  3765. #: ../../../CHANGELOG.md:1381
  3766. msgid "2022-11-25"
  3767. msgstr ""
  3768. #: ../../../CHANGELOG.md:1383
  3769. msgid "2x-5x performance improvements in playbook runtime"
  3770. msgstr ""
  3771. #: ../../../CHANGELOG.md:1385
  3772. msgid ""
  3773. "**TLDR**: the playbook is 2x faster for running `--tags=setup-all` (and "
  3774. "various other tags). It also has new `--tags=install-*` tags (like "
  3775. "`--tags=install-all`), which skip uninstallation tasks and bring an "
  3776. "additional 2.5x speedup. In total, the playbook can maintain your server "
  3777. "5 times faster."
  3778. msgstr ""
  3779. #: ../../../CHANGELOG.md:1387
  3780. msgid ""
  3781. "Our [etke.cc managed Matrix hosting service](https://etke.cc) runs "
  3782. "maintenance against hundreds of servers, so the playbook being fast means"
  3783. " a lot. The [etke.cc Ansible playbook](https://github.com/etkecc/ansible)"
  3784. " (which is an extension of this one) is growing to support more and more "
  3785. "services (besides just Matrix), so the Matrix playbook being leaner "
  3786. "prevents runtimes from becoming too slow and improves the customer "
  3787. "experience."
  3788. msgstr ""
  3789. #: ../../../CHANGELOG.md:1389
  3790. msgid ""
  3791. "Even when running `ansible-playbook` manually (as most of us here do), "
  3792. "it's beneficial not to waste time and CPU resources."
  3793. msgstr ""
  3794. #: ../../../CHANGELOG.md:1391
  3795. msgid ""
  3796. "Recently, a few large optimizations have been done to this playbook and "
  3797. "its external roles (see [The playbook now uses external roles for some "
  3798. "things](#the-playbook-now-uses-external-roles-for-some-things) and don't "
  3799. "forget to run `make roles`):"
  3800. msgstr ""
  3801. #: ../../../CHANGELOG.md:1393
  3802. msgid ""
  3803. "Replacing Ansible `import_tasks` calls with `include_tasks`, which "
  3804. "decreased runtime in half. Using `import_tasks` is slower and causes "
  3805. "Ansible to go through and skip way too many tasks (tasks which could have"
  3806. " been skipped altogether by not having Ansible include them in the first "
  3807. "place). On an experimental VM, **deployment time was decreased from ~530 "
  3808. "seconds to ~250 seconds**."
  3809. msgstr ""
  3810. #: ../../../CHANGELOG.md:1395
  3811. msgid ""
  3812. "Introducing new `install-*` tags (`install-all` and `install-COMPONENT`, "
  3813. "e.g. `install-synapse`, `install-bot-mjolnir`), which only run Ansible "
  3814. "tasks pertaining to installation, while skipping uninstallation tasks. In"
  3815. " most cases, people are maintaining the same setup or they're *adding* "
  3816. "new components. Removing components is rare. Running thousands of "
  3817. "uninstallation tasks each time is wasteful. On an experimental VM, "
  3818. "**deployment time was decreased from ~250 seconds (`--tags=setup-all`) to"
  3819. " ~100 seconds (`--tags=install-all`)**."
  3820. msgstr ""
  3821. #: ../../../CHANGELOG.md:1397
  3822. msgid ""
  3823. "You can still use `--tags=setup-all`. In fact, that's the best way to "
  3824. "ensure your server is reconciled with the `vars.yml` configuration."
  3825. msgstr ""
  3826. #: ../../../CHANGELOG.md:1399
  3827. msgid ""
  3828. "If you know you haven't uninstalled any services since the last time you "
  3829. "ran the playbook, you could run `--tags=install-all` instead and benefit "
  3830. "from quicker runtimes. It should be noted that a service may become "
  3831. "\"eligible for uninstallation\" even if your `vars.yml` file remains the "
  3832. "same. In rare cases, we toggle services from being auto-installed to "
  3833. "being optional, like we did on the 17th of March 2022 when we made [ma1sd"
  3834. " not get installed by default](https://github.com/spantaleev/matrix-"
  3835. "docker-ansible-deploy/blob/master/CHANGELOG.md#compatibility-break-ma1sd-"
  3836. "identity-server-no-longer-installed-by-default). In such rare cases, "
  3837. "you'd also need to run `--tags=setup-all`."
  3838. msgstr ""
  3839. #: ../../../CHANGELOG.md:1402
  3840. msgid "2022-11-22"
  3841. msgstr ""
  3842. #: ../../../CHANGELOG.md:1404
  3843. msgid "Automatic `matrix_architecture` determination"
  3844. msgstr ""
  3845. #: ../../../CHANGELOG.md:1406
  3846. msgid ""
  3847. "From now on, the playbook automatically determines your server's "
  3848. "architecture and sets the `matrix_architecture` variable accordingly. You"
  3849. " no longer need to set this variable manually in your `vars.yml` file."
  3850. msgstr ""
  3851. #: ../../../CHANGELOG.md:1408
  3852. msgid "Docker and the Docker SDK for Python are now installed via external roles"
  3853. msgstr ""
  3854. #: ../../../CHANGELOG.md:1412
  3855. msgid ""
  3856. "Docker will now be installed on the server via the "
  3857. "[geerlingguy.docker](https://github.com/geerlingguy/ansible-role-docker) "
  3858. "Ansible role. If you'd like to manage the Docker installation yourself, "
  3859. "you can disable the playbook's installation of Docker by setting "
  3860. "`matrix_playbook_docker_installation_enabled: false`."
  3861. msgstr ""
  3862. #: ../../../CHANGELOG.md:1414
  3863. msgid ""
  3864. "The Docker SDK for Python (named `docker-python`, `python-docker`, etc. "
  3865. "on the different platforms) is now also installed by another role "
  3866. "([com.devture.ansible.role.docker_sdk_for_python](https://github.com/devture/com.devture.ansible.role.docker_sdk_for_python))."
  3867. " To disable this role and install the necessary tools yourself, use "
  3868. "`devture_docker_sdk_for_python_installation_enabled: false`."
  3869. msgstr ""
  3870. #: ../../../CHANGELOG.md:1416
  3871. msgid ""
  3872. "If you're hitting issues with Docker installation or Docker SDK for "
  3873. "Python installation, consider reporting bugs or contributing to these "
  3874. "other projects."
  3875. msgstr ""
  3876. #: ../../../CHANGELOG.md:1418
  3877. msgid ""
  3878. "These additional roles are downloaded into the playbook directory (to "
  3879. "`roles/galaxy`) via an `ansible-galaxy ..` command. `make roles` is an "
  3880. "easy shortcut for invoking the `ansible-galaxy` command to download these"
  3881. " roles."
  3882. msgstr ""
  3883. #: ../../../CHANGELOG.md:1421
  3884. msgid "2022-11-20"
  3885. msgstr ""
  3886. #: ../../../CHANGELOG.md:1423
  3887. msgid ""
  3888. "(Backward Compatibility Break) Changing how reverse-proxying to Synapse "
  3889. "works - now via a `matrix-synapse-reverse-proxy-companion` service"
  3890. msgstr ""
  3891. #: ../../../CHANGELOG.md:1425
  3892. msgid ""
  3893. "**TLDR**: There's now a `matrix-synapse-reverse-proxy-companion` nginx "
  3894. "service, which helps with reverse-proxying to Synapse and its various "
  3895. "worker processes (if workers are enabled), so that `matrix-nginx-proxy` "
  3896. "can be relieved of this role. `matrix-nginx-proxy` still remains as the "
  3897. "public SSL-terminating reverse-proxy in the playbook. `matrix-synapse-"
  3898. "reverse-proxy-companion` is just one more reverse-proxy thrown into the "
  3899. "mix for convenience. People with a more custom reverse-proxying "
  3900. "configuration may be affected - see [Webserver configuration](#webserver-"
  3901. "configuration) below."
  3902. msgstr ""
  3903. #: ../../../CHANGELOG.md:1427
  3904. msgid "Background"
  3905. msgstr ""
  3906. #: ../../../CHANGELOG.md:1429
  3907. msgid ""
  3908. "Previously, `matrix-nginx-proxy` forwarded requests to Synapse directly. "
  3909. "When Synapse is running in worker mode, the reverse-proxying "
  3910. "configuration is more complicated (different requests need to go to "
  3911. "different Synapse worker processes). `matrix-nginx-proxy` had "
  3912. "configuration for sending each URL endpoint to the correct Synapse worker"
  3913. " responsible for handling it. However, sometimes people like to disable "
  3914. "`matrix-nginx-proxy` (for whatever reason) as detailed in [Using your own"
  3915. " webserver, instead of this playbook's nginx proxy](docs/configuring-"
  3916. "playbook-own-webserver.md)."
  3917. msgstr ""
  3918. #: ../../../CHANGELOG.md:1431
  3919. msgid ""
  3920. "Because `matrix-nginx-proxy` was so central to request forwarding, when "
  3921. "it was disabled and Synapse was running with workers enabled, there was "
  3922. "nothing which could forward requests to the correct place anymore.. which"
  3923. " caused [problems such as this one affecting "
  3924. "Dimension](https://github.com/spantaleev/matrix-docker-ansible-"
  3925. "deploy/issues/2090)."
  3926. msgstr ""
  3927. #: ../../../CHANGELOG.md:1433
  3928. msgid "Solution"
  3929. msgstr ""
  3930. #: ../../../CHANGELOG.md:1435
  3931. msgid ""
  3932. "From now on, `matrix-nginx-proxy` is relieved of its function of reverse-"
  3933. "proxying to Synapse and its various worker processes. This role is now "
  3934. "handled by the new `matrix-synapse-reverse-proxy-companion` nginx service"
  3935. " and works even if `matrix-nginx-proxy` is disabled. The purpose of the "
  3936. "new `matrix-synapse-reverse-proxy-companion` service is to:"
  3937. msgstr ""
  3938. #: ../../../CHANGELOG.md:1437
  3939. msgid ""
  3940. "serve as a companion to Synapse and know how to reverse-proxy to Synapse "
  3941. "correctly (no matter if workers are enabled or not)"
  3942. msgstr ""
  3943. #: ../../../CHANGELOG.md:1439
  3944. msgid ""
  3945. "provide a unified container address for reaching Synapse (no matter if "
  3946. "workers are enabled or not)"
  3947. msgstr ""
  3948. #: ../../../CHANGELOG.md:1440
  3949. msgid ""
  3950. "`matrix-synapse-reverse-proxy-companion:8008` for Synapse Client-Server "
  3951. "API traffic"
  3952. msgstr ""
  3953. #: ../../../CHANGELOG.md:1441
  3954. msgid ""
  3955. "`matrix-synapse-reverse-proxy-companion:8048` for Synapse Server-Server "
  3956. "(Federation) API traffic"
  3957. msgstr ""
  3958. #: ../../../CHANGELOG.md:1443
  3959. msgid ""
  3960. "simplify `matrix-nginx-proxy` configuration - it now only needs to send "
  3961. "requests to `matrix-synapse-reverse-proxy-companion` or `matrix-"
  3962. "dendrite`, etc., without having to worry about workers"
  3963. msgstr ""
  3964. #: ../../../CHANGELOG.md:1445
  3965. msgid ""
  3966. "allow reverse-proxying to Synapse, even if `matrix-nginx-proxy` is "
  3967. "disabled"
  3968. msgstr ""
  3969. #: ../../../CHANGELOG.md:1447
  3970. msgid ""
  3971. "`matrix-nginx-proxy` still remains as the public SSL-terminating reverse-"
  3972. "proxy in the playbook. All traffic goes through it before reaching any of"
  3973. " the services. It's just that now the Synapse traffic is routed through "
  3974. "`matrix-synapse-reverse-proxy-companion` like this:"
  3975. msgstr ""
  3976. #: ../../../CHANGELOG.md:1449
  3977. msgid ""
  3978. "(`matrix-nginx-proxy` -> `matrix-synapse-reverse-proxy-companion` -> "
  3979. "(`matrix-synapse` or some Synapse worker))."
  3980. msgstr ""
  3981. #: ../../../CHANGELOG.md:1451
  3982. msgid ""
  3983. "Various services (like Dimension, etc.) still talk to Synapse via "
  3984. "`matrix-nginx-proxy` (e.g. `http://matrix-nginx-proxy:12080`) "
  3985. "preferentially. They only talk to Synapse via the reverse-proxy companion"
  3986. " (e.g. `http://matrix-synapse-reverse-proxy-companion:8008`) if `matrix-"
  3987. "nginx-proxy` is disabled. Services should not be talking to Synapse (e.g."
  3988. " `https://matrix-synapse:8008` directly anymore), because when workers "
  3989. "are enabled, that's the Synapse `master` process and may not be serving "
  3990. "all URL endpoints needed by the service."
  3991. msgstr ""
  3992. #: ../../../CHANGELOG.md:1453
  3993. msgid "Webserver configuration"
  3994. msgstr ""
  3995. #: ../../../CHANGELOG.md:1455
  3996. msgid ""
  3997. "if you're using `matrix-nginx-proxy` (`matrix_nginx_proxy_enabled: true`,"
  3998. " which is the default for the playbook), you don't need to do anything"
  3999. msgstr ""
  4000. #: ../../../CHANGELOG.md:1457
  4001. msgid ""
  4002. "if you're using your own `nginx` webserver running on the server, you "
  4003. "shouldn't be affected. The `/matrix/nginx/conf.d` configuration and "
  4004. "exposed ports that you're relying on will automatically be updated in a "
  4005. "way that should work"
  4006. msgstr ""
  4007. #: ../../../CHANGELOG.md:1459
  4008. msgid ""
  4009. "if you're using another local webserver (e.g. Apache, etc.) and haven't "
  4010. "changed any ports (`matrix_*_host_bind_port` definitions), you shouldn't "
  4011. "be affected. You're likely sending Matrix traffic to `127.0.0.1:8008` and"
  4012. " `127.0.0.1:8048`. These ports (`8008` and `8048`) will still be exposed "
  4013. "on `127.0.0.1` by default - just not by the `matrix-synapse` container "
  4014. "from now on, but by the `matrix-synapse-reverse-proxy-companion` "
  4015. "container instead"
  4016. msgstr ""
  4017. #: ../../../CHANGELOG.md:1461
  4018. msgid ""
  4019. "if you've been exposing `matrix-synapse` ports "
  4020. "(`matrix_synapse_container_client_api_host_bind_port`, etc.) manually, "
  4021. "you should consider exposing `matrix-synapse-reverse-proxy-companion` "
  4022. "ports instead"
  4023. msgstr ""
  4024. #: ../../../CHANGELOG.md:1463
  4025. msgid ""
  4026. "if you're running Traefik and reverse-proxying directly to the `matrix-"
  4027. "synapse` container, you should start reverse-proxying to the `matrix-"
  4028. "synapse-reverse-proxy-companion` container instead. See [our updated "
  4029. "Traefik example configuration](docs/configuring-playbook-own-webserver.md"
  4030. "#sample-configuration-for-running-behind-traefik-20). Note: we now "
  4031. "recommend calling the federation entry point `federation` (instead of "
  4032. "`synapse`) and reverse-proxying the federation traffic via `matrix-nginx-"
  4033. "proxy`, instead of sending it directly to Synapse (or `matrix-synapse-"
  4034. "reverse-proxy-companion`). This makes the configuration simpler."
  4035. msgstr ""
  4036. #: ../../../CHANGELOG.md:1466
  4037. msgid "2022-11-05"
  4038. msgstr ""
  4039. #: ../../../CHANGELOG.md:1468
  4040. msgid "(Backward Compatibility Break) A new default standalone mode for Etherpad"
  4041. msgstr ""
  4042. #: ../../../CHANGELOG.md:1470
  4043. msgid ""
  4044. "Until now, [Etherpad](https://etherpad.org/) (which [the playbook could "
  4045. "install for you](docs/configuring-playbook-etherpad.md)) required the "
  4046. "[Dimension integration manager](docs/configuring-playbook-dimension.md) "
  4047. "to also be installed, because Etherpad was hosted on the Dimension domain"
  4048. " (at `dimension.example.com/etherpad`)."
  4049. msgstr ""
  4050. #: ../../../CHANGELOG.md:1472
  4051. msgid ""
  4052. "From now on, Etherpad can be installed in `standalone` mode on "
  4053. "`etherpad.example.com` and used even without Dimension. This is much more"
  4054. " versatile, so the playbook now defaults to this new mode "
  4055. "(`etherpad_mode: standalone`)."
  4056. msgstr ""
  4057. #: ../../../CHANGELOG.md:1474
  4058. msgid "If you've already got both Etherpad and Dimension in use you could:"
  4059. msgstr ""
  4060. #: ../../../CHANGELOG.md:1476
  4061. msgid ""
  4062. "**either** keep hosting Etherpad under the Dimension domain by adding "
  4063. "`etherpad_mode: dimension` to your `vars.yml` file. All your existing "
  4064. "room widgets will continue working at the same URLs and no other changes "
  4065. "will be necessary."
  4066. msgstr ""
  4067. #: ../../../CHANGELOG.md:1478
  4068. msgid ""
  4069. "**or**, you could change to hosting Etherpad separately on "
  4070. "`etherpad.example.com`. You will need to [configure a DNS record](docs"
  4071. "/configuring-dns.md) for this new domain. You will also need to "
  4072. "reconfigure Dimension to use the new pad URLs "
  4073. "(`https://etherpad.example.com/…`) going forward (refer to our "
  4074. "[configuring Etherpad documentation](docs/configuring-playbook-"
  4075. "etherpad.md)). All your existing room widgets (which still use "
  4076. "`https://dimension.example.com/etherpad/…`) will break as Etherpad is not"
  4077. " hosted there anymore. You will need to re-add them or to consider not "
  4078. "using `standalone` mode"
  4079. msgstr ""
  4080. #: ../../../CHANGELOG.md:1481
  4081. msgid "2022-11-04"
  4082. msgstr ""
  4083. #: ../../../CHANGELOG.md:1483
  4084. msgid "The playbook now uses external roles for some things"
  4085. msgstr ""
  4086. #: ../../../CHANGELOG.md:1485
  4087. msgid ""
  4088. "**TLDR**: when updating the playbook and before running it, you'll need "
  4089. "to run `make roles` to make [ansible-"
  4090. "galaxy](https://docs.ansible.com/ansible/latest/cli/ansible-galaxy.html) "
  4091. "download dependency roles (see the [`requirements.yml` "
  4092. "file](requirements.yml)) to the `roles/galaxy` directory. Without this, "
  4093. "the playbook won't work."
  4094. msgstr ""
  4095. #: ../../../CHANGELOG.md:1487
  4096. msgid ""
  4097. "We're in the process of trimming the playbook and making it reuse Ansible"
  4098. " roles."
  4099. msgstr ""
  4100. #: ../../../CHANGELOG.md:1489
  4101. msgid "Starting now, the playbook is composed of 2 types of Ansible roles:"
  4102. msgstr ""
  4103. #: ../../../CHANGELOG.md:1491
  4104. msgid "those that live within the playbook itself (`roles/custom/*`)"
  4105. msgstr ""
  4106. #: ../../../CHANGELOG.md:1493
  4107. msgid ""
  4108. "those downloaded from other sources (using [ansible-"
  4109. "galaxy](https://docs.ansible.com/ansible/latest/cli/ansible-galaxy.html) "
  4110. "to `roles/galaxy`, based on the [`requirements.yml` "
  4111. "file](requirements.yml)). These roles are maintained by us or by other "
  4112. "people from the Ansible community."
  4113. msgstr ""
  4114. #: ../../../CHANGELOG.md:1495
  4115. msgid ""
  4116. "We're doing this for greater code-reuse (across Ansible playbooks, "
  4117. "including our own related playbooks [gitea-docker-ansible-"
  4118. "deploy](https://github.com/spantaleev/gitea-docker-ansible-deploy) and "
  4119. "[nextcloud-docker-ansible-deploy](https://github.com/spantaleev"
  4120. "/nextcloud-docker-ansible-deploy)) and decreased maintenance burden. "
  4121. "Until now, certain features were copy-pasted across playbooks or were "
  4122. "maintained separately in each one, with improvements often falling "
  4123. "behind. We've also tended to do too much by ourselves - installing Docker"
  4124. " on the server from our `matrix-base` role, etc. - something that we'd "
  4125. "rather not do anymore by switching to the "
  4126. "[geerlingguy.docker](https://galaxy.ansible.com/geerlingguy/docker) role."
  4127. msgstr ""
  4128. #: ../../../CHANGELOG.md:1497
  4129. msgid ""
  4130. "Some variable names will change during the transition to having more and "
  4131. "more external (galaxy) roles. There's a new "
  4132. "`custom/matrix_playbook_migration` role added to the playbook which will "
  4133. "tell you about these changes each time you run the playbook."
  4134. msgstr ""
  4135. #: ../../../CHANGELOG.md:1499
  4136. msgid ""
  4137. "**From now on**, every time you update the playbook (well, every time the"
  4138. " `requirements.yml` file changes), it's best to run `make roles` to "
  4139. "update the roles downloaded from other sources. `make roles` is a "
  4140. "shortcut (a `roles` target defined in [`Makefile`](Makefile) and executed"
  4141. " by the [`make`](https://www.gnu.org/software/make/) utility) which "
  4142. "ultimately runs [ansible-"
  4143. "galaxy](https://docs.ansible.com/ansible/latest/cli/ansible-galaxy.html) "
  4144. "to download Ansible roles. If you don't have `make`, you can also "
  4145. "manually run the commands seen in the `Makefile`."
  4146. msgstr ""
  4147. #: ../../../CHANGELOG.md:1502
  4148. msgid "2022-10-14"
  4149. msgstr ""
  4150. #: ../../../CHANGELOG.md:1504
  4151. msgid "synapse-s3-storage-provider support"
  4152. msgstr ""
  4153. #: ../../../CHANGELOG.md:1506
  4154. msgid ""
  4155. "**`synapse-s3-storage-provider` support is very new and still relatively "
  4156. "untested. Using it may cause data loss.**"
  4157. msgstr ""
  4158. #: ../../../CHANGELOG.md:1508
  4159. msgid ""
  4160. "You can now store your Synapse media repository files on Amazon S3 (or "
  4161. "another S3-compatible object store) using [synapse-s3-storage-"
  4162. "provider](https://github.com/matrix-org/synapse-s3-storage-provider) - a "
  4163. "media provider for Synapse (Python module), which should work faster and "
  4164. "more reliably than our previous [Goofys](docs/configuring-"
  4165. "playbook-s3-goofys.md) implementation (Goofys will continue to work)."
  4166. msgstr ""
  4167. #: ../../../CHANGELOG.md:1510
  4168. msgid ""
  4169. "This is not just for initial installations. Users with existing files "
  4170. "(stored in the local filesystem) can also migrate their files to "
  4171. "`synapse-s3-storage-provider`."
  4172. msgstr ""
  4173. #: ../../../CHANGELOG.md:1512
  4174. msgid ""
  4175. "To get started, see our [Storing Synapse media files on Amazon S3 with "
  4176. "synapse-s3-storage-provider](docs/configuring-playbook-synapse-s3"
  4177. "-storage-provider.md) documentation."
  4178. msgstr ""
  4179. #: ../../../CHANGELOG.md:1514
  4180. msgid "Synapse container image customization support"
  4181. msgstr ""
  4182. #: ../../../CHANGELOG.md:1516
  4183. msgid ""
  4184. "We now support customizing the Synapse container image by adding "
  4185. "additional build steps to its "
  4186. "[`Dockerfile`](https://docs.docker.com/engine/reference/builder/)."
  4187. msgstr ""
  4188. #: ../../../CHANGELOG.md:1518
  4189. msgid ""
  4190. "Our [synapse-s3-storage-provider support](#synapse-s3-storage-provider-"
  4191. "support) is actually built on this. When `s3-storage-provider` is "
  4192. "enabled, we automatically add additional build steps to install its "
  4193. "Python module into the Synapse image."
  4194. msgstr ""
  4195. #: ../../../CHANGELOG.md:1520
  4196. msgid ""
  4197. "Besides this kind of auto-added build steps (for components supported by "
  4198. "the playbook), we also let you inject your own custom build steps using "
  4199. "configuration like this:"
  4200. msgstr ""
  4201. #: ../../../CHANGELOG.md:1531
  4202. msgid ""
  4203. "People who have needed to customize Synapse previously had to fork the "
  4204. "git repository, make their changes to the `Dockerfile` there, point the "
  4205. "playbook to the new repository "
  4206. "(`matrix_synapse_container_image_self_build_repo`) and enable self-"
  4207. "building from scratch (`matrix_synapse_container_image_self_build: "
  4208. "true`). This is harder and slower."
  4209. msgstr ""
  4210. #: ../../../CHANGELOG.md:1533
  4211. msgid ""
  4212. "With the new Synapse-customization feature in the playbook, we use the "
  4213. "original upstream (pre-built, if available) Synapse image and only build "
  4214. "on top of it, right on the Matrix server. This is much faster than "
  4215. "building all of Synapse from scratch."
  4216. msgstr ""
  4217. #: ../../../CHANGELOG.md:1536
  4218. msgid "2022-10-02"
  4219. msgstr ""
  4220. #: ../../../CHANGELOG.md:1538
  4221. msgid "matrix-ldap-registration-proxy support"
  4222. msgstr ""
  4223. #: ../../../CHANGELOG.md:1540
  4224. msgid ""
  4225. "Thanks to [@TheOneWithTheBraid](https://github.com/TheOneWithTheBraid), "
  4226. "we now support installing [matrix-ldap-registration-"
  4227. "proxy](https://gitlab.com/activism.international/matrix_ldap_registration_proxy)"
  4228. " - a proxy which handles Matrix registration requests and forwards them "
  4229. "to LDAP."
  4230. msgstr ""
  4231. #: ../../../CHANGELOG.md:1542
  4232. msgid ""
  4233. "See our [Setting up matrix-ldap-registration-proxy](docs/configuring-"
  4234. "playbook-matrix-ldap-registration-proxy.md) documentation to get started."
  4235. msgstr ""
  4236. #: ../../../CHANGELOG.md:1545
  4237. msgid "2022-09-15"
  4238. msgstr ""
  4239. #: ../../../CHANGELOG.md:1547
  4240. msgid ""
  4241. "(Potential Backward Compatibility Break) Major improvements to Synapse "
  4242. "workers"
  4243. msgstr ""
  4244. #: ../../../CHANGELOG.md:1549
  4245. msgid ""
  4246. "People who are interested in running a Synapse worker setup should know "
  4247. "that **our Synapse worker implementation is much more powerful now**:"
  4248. msgstr ""
  4249. #: ../../../CHANGELOG.md:1551
  4250. msgid "we've added support for [Stream writers](#stream-writers-support)"
  4251. msgstr ""
  4252. #: ../../../CHANGELOG.md:1552
  4253. msgid ""
  4254. "we've added support for [multiple federation sender workers](#multiple-"
  4255. "federation-sender-workers-support)"
  4256. msgstr ""
  4257. #: ../../../CHANGELOG.md:1553
  4258. msgid ""
  4259. "we've added support for [multiple pusher workers](#multiple-pusher-"
  4260. "workers-support)"
  4261. msgstr ""
  4262. #: ../../../CHANGELOG.md:1554
  4263. msgid ""
  4264. "we've added support for [running background tasks on a worker"
  4265. "](#background-tasks-can-run-on-a-worker)"
  4266. msgstr ""
  4267. #: ../../../CHANGELOG.md:1555
  4268. msgid ""
  4269. "we've restored support for [`appservice` workers](#appservice-worker-"
  4270. "support-is-back)"
  4271. msgstr ""
  4272. #: ../../../CHANGELOG.md:1556
  4273. msgid ""
  4274. "we've restored support for [`user_dir` workers](#user-directory-worker-"
  4275. "support-is-back)"
  4276. msgstr ""
  4277. #: ../../../CHANGELOG.md:1557
  4278. msgid ""
  4279. "we've made it possible to [reliably use more than 1 `media_repository` "
  4280. "worker](#using-more-than-1-media-repository-worker-is-now-more-reliable)"
  4281. msgstr ""
  4282. #: ../../../CHANGELOG.md:1558
  4283. msgid ""
  4284. "see the [Potential Backward Incompatibilities after these Synapse worker "
  4285. "changes](#potential-backward-incompatibilities-after-these-synapse-"
  4286. "worker-changes)"
  4287. msgstr ""
  4288. #: ../../../CHANGELOG.md:1560
  4289. msgid "Stream writers support"
  4290. msgstr ""
  4291. #: ../../../CHANGELOG.md:1562
  4292. msgid ""
  4293. "From now on, the playbook lets you easily set up various [stream writer "
  4294. "workers](https://matrix-org.github.io/synapse/latest/workers.html#stream-"
  4295. "writers) which can handle different streams (`events` stream; `typing` "
  4296. "URL endpoints, `to_device` URL endpoints, `account_data` URL endpoints, "
  4297. "`receipts` URL endpoints, `presence` URL endpoints). All of this work was"
  4298. " previously handled by the main Synapse process, but can now be offloaded"
  4299. " to stream writer worker processes."
  4300. msgstr ""
  4301. #: ../../../CHANGELOG.md:1564
  4302. msgid ""
  4303. "If you're using `matrix_synapse_workers_preset: one-of-each`, you'll "
  4304. "automatically get 6 additional workers (one for each of the above stream "
  4305. "types). Our `little-federation-helper` preset (meant to be quite minimal "
  4306. "and focusing in improved federation performance) does not include stream "
  4307. "writer workers."
  4308. msgstr ""
  4309. #: ../../../CHANGELOG.md:1566
  4310. msgid ""
  4311. "If you'd like to customize the number of workers we also make that "
  4312. "possible using these variables:"
  4313. msgstr ""
  4314. #: ../../../CHANGELOG.md:1579
  4315. msgid "Multiple federation sender workers support"
  4316. msgstr ""
  4317. #: ../../../CHANGELOG.md:1581
  4318. msgid ""
  4319. "Until now, we only supported a single `federation_sender` worker "
  4320. "(`matrix_synapse_workers_federation_sender_workers_count` could either be"
  4321. " `0` or `1`). From now on, you can have as many as you want to help with "
  4322. "your federation traffic."
  4323. msgstr ""
  4324. #: ../../../CHANGELOG.md:1583
  4325. msgid "Multiple pusher workers support"
  4326. msgstr ""
  4327. #: ../../../CHANGELOG.md:1585
  4328. msgid ""
  4329. "Until now, we only supported a single `pusher` worker "
  4330. "(`matrix_synapse_workers_pusher_workers_count` could either be `0` or "
  4331. "`1`). From now on, you can have as many as you want to help with pushing "
  4332. "notifications out."
  4333. msgstr ""
  4334. #: ../../../CHANGELOG.md:1587
  4335. msgid "Background tasks can run on a worker"
  4336. msgstr ""
  4337. #: ../../../CHANGELOG.md:1589
  4338. msgid ""
  4339. "From now on, you can put [background task processing on a worker](https"
  4340. "://matrix-org.github.io/synapse/latest/workers.html#background-tasks)."
  4341. msgstr ""
  4342. #: ../../../CHANGELOG.md:1591
  4343. msgid ""
  4344. "With `matrix_synapse_workers_preset: one-of-each`, you'll get one "
  4345. "`background` worker automatically. You can also control the `background` "
  4346. "workers count with `matrix_synapse_workers_background_workers_count`. "
  4347. "Only `0` or `1` workers of this type are supported by Synapse."
  4348. msgstr ""
  4349. #: ../../../CHANGELOG.md:1593
  4350. msgid "Appservice worker support is back"
  4351. msgstr ""
  4352. #: ../../../CHANGELOG.md:1595
  4353. msgid ""
  4354. "We previously had an `appservice` worker type, which [Synapse deprecated "
  4355. "in v1.59.0](https://github.com/element-"
  4356. "hq/synapse/blob/v1.59.0/docs/upgrade.md#deprecation-of-the-"
  4357. "synapseappappservice-and-synapseappuser_dir-worker-application-types). So"
  4358. " did we, at the time."
  4359. msgstr ""
  4360. #: ../../../CHANGELOG.md:1597
  4361. msgid ""
  4362. "The new way to implement such workers is by using a `generic_worker` and "
  4363. "dedicating it to the task of talking to Application Services. From now "
  4364. "on, we have support for this."
  4365. msgstr ""
  4366. #: ../../../CHANGELOG.md:1599
  4367. msgid ""
  4368. "With `matrix_synapse_workers_preset: one-of-each`, you'll get one "
  4369. "`appservice` worker automatically. You can also control the `appservice` "
  4370. "workers count with `matrix_synapse_workers_appservice_workers_count`. "
  4371. "Only `0` or `1` workers of this type are supported by Synapse."
  4372. msgstr ""
  4373. #: ../../../CHANGELOG.md:1601
  4374. msgid "User Directory worker support is back"
  4375. msgstr ""
  4376. #: ../../../CHANGELOG.md:1603
  4377. msgid ""
  4378. "We previously had a `user_dir` worker type, which [Synapse deprecated in "
  4379. "v1.59.0](https://github.com/element-"
  4380. "hq/synapse/blob/v1.59.0/docs/upgrade.md#deprecation-of-the-"
  4381. "synapseappappservice-and-synapseappuser_dir-worker-application-types). So"
  4382. " did we, at the time."
  4383. msgstr ""
  4384. #: ../../../CHANGELOG.md:1605
  4385. msgid ""
  4386. "The new way to implement such workers is by using a `generic_worker` and "
  4387. "dedicating it to the task of serving the user directory. From now on, we "
  4388. "have support for this."
  4389. msgstr ""
  4390. #: ../../../CHANGELOG.md:1607
  4391. msgid ""
  4392. "With `matrix_synapse_workers_preset: one-of-each`, you'll get one "
  4393. "`user_dir` worker automatically. You can also control the `user_dir` "
  4394. "workers count with `matrix_synapse_workers_user_dir_workers_count`. Only"
  4395. " `0` or `1` workers of this type are supported by Synapse."
  4396. msgstr ""
  4397. #: ../../../CHANGELOG.md:1609
  4398. msgid "Using more than 1 media repository worker is now more reliable"
  4399. msgstr ""
  4400. #: ../../../CHANGELOG.md:1611
  4401. msgid ""
  4402. "With `matrix_synapse_workers_preset: one-of-each`, we only launch one "
  4403. "`media_repository` worker."
  4404. msgstr ""
  4405. #: ../../../CHANGELOG.md:1613
  4406. msgid ""
  4407. "If you've been configuring "
  4408. "`matrix_synapse_workers_media_repository_workers_count` manually, you may"
  4409. " have increased that to more workers. When multiple media repository "
  4410. "workers are in use, background tasks related to the media repository must"
  4411. " always be configured to run on a single `media_repository` worker via "
  4412. "`media_instance_running_background_jobs`. Until now, we weren't doing "
  4413. "this correctly, but we now are."
  4414. msgstr ""
  4415. #: ../../../CHANGELOG.md:1615
  4416. msgid "Potential Backward Incompatibilities after these Synapse worker changes"
  4417. msgstr ""
  4418. #: ../../../CHANGELOG.md:1617
  4419. msgid "Below we'll discuss **potential backward incompatibilities**."
  4420. msgstr ""
  4421. #: ../../../CHANGELOG.md:1619
  4422. msgid ""
  4423. "**Worker names** (container names, systemd services, worker configuration"
  4424. " files) **have changed**. Workers are now labeled sequentially (e.g. "
  4425. "`matrix-synapse-worker_generic_worker-18111` -> `matrix-synapse-worker-"
  4426. "generic-0`). The playbook will handle these changes automatically."
  4427. msgstr ""
  4428. #: ../../../CHANGELOG.md:1621
  4429. msgid ""
  4430. "Due to increased worker types support above, people who use "
  4431. "`matrix_synapse_workers_preset: one-of-each` should be aware that with "
  4432. "these changes, **the playbook will deploy 9 additional workers** (6 "
  4433. "stream writers, 1 `appservice` worker, 1 `user_dir` worker, 1 background "
  4434. "task worker). This **may increase RAM/CPU usage**, etc. If you find your "
  4435. "server struggling, consider disabling some workers with the appropriate "
  4436. "`matrix_synapse_workers_*_workers_count` variables."
  4437. msgstr ""
  4438. #: ../../../CHANGELOG.md:1623
  4439. msgid ""
  4440. "**Metric endpoints have also changed** "
  4441. "(`/metrics/synapse/worker/generic_worker-18111` -> "
  4442. "`/metrics/synapse/worker/generic-worker-0`). If you're [collecting "
  4443. "metrics to an external Prometheus server](docs/configuring-playbook-"
  4444. "prometheus-grafana.md#collecting-metrics-to-an-external-prometheus-"
  4445. "server), consider revisiting our [Collecting Synapse worker metrics to an"
  4446. " external Prometheus server](docs/configuring-playbook-prometheus-"
  4447. "grafana.md#collecting-synapse-worker-metrics-to-an-external-prometheus-"
  4448. "server) docs and updating your Prometheus configuration. **If you're "
  4449. "collecting metrics to the integrated Prometheus server** (not enabled by "
  4450. "default), **your Prometheus configuration will be updated "
  4451. "automatically**. Old data (from before this change) may stick around "
  4452. "though."
  4453. msgstr ""
  4454. #: ../../../CHANGELOG.md:1625
  4455. msgid ""
  4456. "**the format of `matrix_synapse_workers_enabled_list` has changed**. You "
  4457. "were never advised to use this variable for directly creating workers (we"
  4458. " advise people to control workers using `matrix_synapse_workers_preset` "
  4459. "or by tweaking `matrix_synapse_workers_*_workers_count` variables only), "
  4460. "but some people may have started using the "
  4461. "`matrix_synapse_workers_enabled_list` variable to gain more control over "
  4462. "workers. If you're one of them, you'll need to adjust its value. See "
  4463. "`roles/custom/matrix-synapse/defaults/main.yml` for more information on "
  4464. "the new format. The playbook will also do basic validation and complain "
  4465. "if you got something wrong."
  4466. msgstr ""
  4467. #: ../../../CHANGELOG.md:1628
  4468. msgid "2022-09-09"
  4469. msgstr ""
  4470. #: ../../../CHANGELOG.md:1630
  4471. msgid "Cactus Comments support"
  4472. msgstr ""
  4473. #: ../../../CHANGELOG.md:1632
  4474. msgid ""
  4475. "Thanks to [Julian-Samuel Gebühr (@moan0s)](https://github.com/moan0s), "
  4476. "the playbook can now set up [Cactus Comments](https://cactus.chat) - "
  4477. "federated comment system for the web based on Matrix."
  4478. msgstr ""
  4479. #: ../../../CHANGELOG.md:1634
  4480. msgid ""
  4481. "See our [Setting up Cactus Comments](docs/configuring-playbook-cactus-"
  4482. "comments.md) documentation to get started."
  4483. msgstr ""
  4484. #: ../../../CHANGELOG.md:1637
  4485. msgid "2022-08-23"
  4486. msgstr ""
  4487. #: ../../../CHANGELOG.md:1639
  4488. msgid "Postmoogle email bridge support"
  4489. msgstr ""
  4490. #: ../../../CHANGELOG.md:1641
  4491. msgid ""
  4492. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  4493. "[etke.cc](https://etke.cc/), the playbook can now set up the new "
  4494. "[Postmoogle](https://github.com/etkecc/postmoogle) email bridge. "
  4495. "Postmoogle is like the [email2matrix "
  4496. "bridge](https://github.com/devture/email2matrix) (also [already supported"
  4497. " by the playbook](docs/configuring-playbook-email2matrix.md)), but more "
  4498. "capable and with the intention to soon support *sending* emails, not just"
  4499. " receiving."
  4500. msgstr ""
  4501. #: ../../../CHANGELOG.md:1643
  4502. msgid ""
  4503. "See our [Setting up Postmoogle email bridging](docs/configuring-playbook-"
  4504. "bridge-postmoogle.md) documentation to get started."
  4505. msgstr ""
  4506. #: ../../../CHANGELOG.md:1646
  4507. msgid "2022-08-10"
  4508. msgstr ""
  4509. #: ../../../CHANGELOG.md:1648
  4510. msgid "mautrix-whatsapp default configuration changes"
  4511. msgstr ""
  4512. #: ../../../CHANGELOG.md:1650
  4513. msgid ""
  4514. "In [Pull Request #2012](https://github.com/spantaleev/matrix-docker-"
  4515. "ansible-deploy/pull/2012), we've made some changes to the default "
  4516. "configuration used by the `mautrix-whatsapp` bridge."
  4517. msgstr ""
  4518. #: ../../../CHANGELOG.md:1652
  4519. msgid ""
  4520. "If you're using this bridge, you should look into this PR and see if the "
  4521. "new configuration suits you. If not, you can always change individual "
  4522. "preferences in your `vars.yml` file."
  4523. msgstr ""
  4524. #: ../../../CHANGELOG.md:1654
  4525. msgid ""
  4526. "Most notably, spaces support has been enabled by default. The bridge will"
  4527. " now group rooms into a Matrix space. **If you've already bridged to "
  4528. "Whatsapp** prior to this update, you will need to send `!wa sync space` "
  4529. "to the bridge bot to make it create the space and put your existing rooms"
  4530. " into it."
  4531. msgstr ""
  4532. #: ../../../CHANGELOG.md:1657
  4533. msgid "2022-08-09"
  4534. msgstr ""
  4535. #: ../../../CHANGELOG.md:1659
  4536. msgid "Conduit support"
  4537. msgstr ""
  4538. #: ../../../CHANGELOG.md:1661
  4539. msgid ""
  4540. "Thanks to [Charles Wright](https://github.com/cvwright), we now have "
  4541. "optional experimental [Conduit](https://conduit.rs) homeserver support "
  4542. "for new installations. This comes as a follow-up to the playbook getting "
  4543. "[Dendrite support](#dendrite-support) earlier this year."
  4544. msgstr ""
  4545. #: ../../../CHANGELOG.md:1663
  4546. msgid ""
  4547. "Existing Synapse or Dendrite installations do **not** need to be updated."
  4548. " **Synapse is still the default homeserver implementation** installed by "
  4549. "the playbook."
  4550. msgstr ""
  4551. #: ../../../CHANGELOG.md:1665
  4552. msgid ""
  4553. "To try out Conduit, we recommend that you **use a new server** and the "
  4554. "following `vars.yml` configuration:"
  4555. msgstr ""
  4556. #: ../../../CHANGELOG.md:1671
  4557. msgid ""
  4558. "**The homeserver implementation of an existing server cannot be changed**"
  4559. " (e.g. from Synapse or Dendrite to Conduit) without data loss."
  4560. msgstr ""
  4561. #: ../../../CHANGELOG.md:1674
  4562. msgid "2022-07-29"
  4563. msgstr ""
  4564. #: ../../../CHANGELOG.md:1676
  4565. msgid "mautrix-discord support"
  4566. msgstr ""
  4567. #: ../../../CHANGELOG.md:1678
  4568. msgid ""
  4569. "Thanks to [MdotAmaan](https://github.com/MdotAmaan)'s efforts, the "
  4570. "playbook now supports bridging to [Discord](https://discordapp.com/) via "
  4571. "the [mautrix-discord](https://mau.dev/mautrix/discord) bridge. See our "
  4572. "[Setting up Mautrix Discord bridging](docs/configuring-playbook-bridge-"
  4573. "mautrix-discord.md) documentation page for getting started."
  4574. msgstr ""
  4575. #: ../../../CHANGELOG.md:1680
  4576. msgid ""
  4577. "**Note**: this is a new Discord bridge. The playbook still retains "
  4578. "Discord bridging via [matrix-appservice-discord](docs/configuring-"
  4579. "playbook-bridge-appservice-discord.md) and [mx-puppet-discord](docs"
  4580. "/configuring-playbook-bridge-mx-puppet-discord.md). You're free to use "
  4581. "the bridge that serves you better, or even all three of them (for "
  4582. "different users and use-cases)."
  4583. msgstr ""
  4584. #: ../../../CHANGELOG.md:1683
  4585. msgid "2022-07-27"
  4586. msgstr ""
  4587. #: ../../../CHANGELOG.md:1685
  4588. msgid "matrix-appservice-kakaotalk support"
  4589. msgstr ""
  4590. #: ../../../CHANGELOG.md:1687
  4591. msgid ""
  4592. "The playbook now supports bridging to "
  4593. "[Kakaotalk](https://www.kakaocorp.com/page/service/service/KakaoTalk?lang=ENG)"
  4594. " via [matrix-appservice-kakaotalk](https://src.miscworks.net/fair/matrix-"
  4595. "appservice-kakaotalk) - a bridge based on [node-"
  4596. "kakao](https://github.com/storycraft/node-kakao) (now unmaintained) and "
  4597. "some [mautrix-facebook](https://github.com/mautrix/facebook) code. Thanks"
  4598. " to [hnarjis](https://github.com/hnarjis) for helping us add support for "
  4599. "this!"
  4600. msgstr ""
  4601. #: ../../../CHANGELOG.md:1689
  4602. msgid ""
  4603. "See our [Setting up Appservice Kakaotalk bridging](docs/configuring-"
  4604. "playbook-bridge-appservice-kakaotalk.md) documentation to get started."
  4605. msgstr ""
  4606. #: ../../../CHANGELOG.md:1692
  4607. msgid "2022-07-20"
  4608. msgstr ""
  4609. #: ../../../CHANGELOG.md:1694
  4610. msgid "maubot support"
  4611. msgstr ""
  4612. #: ../../../CHANGELOG.md:1696
  4613. msgid ""
  4614. "Thanks to [Stuart Mumford (@Cadair)](https://github.com/cadair) for "
  4615. "starting ([PR #373](https://github.com/spantaleev/matrix-docker-ansible-"
  4616. "deploy/pull/373) and [PR #622](https://github.com/spantaleev/matrix-"
  4617. "docker-ansible-deploy/pull/622)) and to [Julian-Samuel Gebühr "
  4618. "(@moan0s)](https://github.com/moan0s) for finishing up (in [PR "
  4619. "#1894](https://github.com/spantaleev/matrix-docker-ansible-"
  4620. "deploy/pull/1894)), the playbook can now help you set up "
  4621. "[maubot](https://github.com/maubot/maubot) - a plugin-based Matrix bot "
  4622. "system."
  4623. msgstr ""
  4624. #: ../../../CHANGELOG.md:1698
  4625. msgid ""
  4626. "See our [Setting up maubot](docs/configuring-playbook-bot-maubot.md) "
  4627. "documentation to get started."
  4628. msgstr ""
  4629. #: ../../../CHANGELOG.md:1701
  4630. msgid "2022-07-14"
  4631. msgstr ""
  4632. #: ../../../CHANGELOG.md:1703
  4633. msgid "mx-puppet-skype removal"
  4634. msgstr ""
  4635. #: ../../../CHANGELOG.md:1705
  4636. msgid ""
  4637. "The playbook no longer includes the [mx-puppet-"
  4638. "skype](https://github.com/Sorunome/mx-puppet-skype) bridge, because it "
  4639. "has been broken and unmaintained for a long time. Users that have "
  4640. "`matrix_mx_puppet_skype_enabled` in their configuration files will "
  4641. "encounter an error when running the playbook until they remove references"
  4642. " to this bridge from their configuration."
  4643. msgstr ""
  4644. #: ../../../CHANGELOG.md:1707
  4645. msgid ""
  4646. "To completely clean up your server from `mx-puppet-skype`'s presence on "
  4647. "it:"
  4648. msgstr ""
  4649. #: ../../../CHANGELOG.md:1709
  4650. msgid ""
  4651. "ensure your Ansible configuration (`vars.yml` file) no longer contains "
  4652. "`matrix_mx_puppet_skype_*` references"
  4653. msgstr ""
  4654. #: ../../../CHANGELOG.md:1710
  4655. msgid ""
  4656. "stop and disable the systemd service (run `systemctl disable --now "
  4657. "matrix-mx-puppet-skype` on the server)"
  4658. msgstr ""
  4659. #: ../../../CHANGELOG.md:1711
  4660. msgid ""
  4661. "delete the systemd service (run `rm /etc/systemd/system/matrix-mx-puppet-"
  4662. "skype.service` on the server)"
  4663. msgstr ""
  4664. #: ../../../CHANGELOG.md:1712
  4665. msgid ""
  4666. "delete `/matrix/mx-puppet-skype` (run `rm -rf /matrix/mx-puppet-skype` on"
  4667. " the server)"
  4668. msgstr ""
  4669. #: ../../../CHANGELOG.md:1713
  4670. msgid ""
  4671. "drop the `matrix_mx_puppet_skype` database (run `/usr/local/bin/matrix-"
  4672. "postgres-cli` on the server, and execute the `DROP DATABASE "
  4673. "matrix_mx_puppet_skype;` query there)"
  4674. msgstr ""
  4675. #: ../../../CHANGELOG.md:1715
  4676. msgid ""
  4677. "If you still need bridging to [Skype](https://www.skype.com/), consider "
  4678. "switching to [go-skype-bridge](https://github.com/kelaresg/go-skype-"
  4679. "bridge) instead. See [Setting up Go Skype Bridge bridging](docs"
  4680. "/configuring-playbook-bridge-go-skype-bridge.md)."
  4681. msgstr ""
  4682. #: ../../../CHANGELOG.md:1717
  4683. msgid ""
  4684. "If you think this is a mistake and `mx-puppet-skype` works for you (or "
  4685. "you get it to work somehow), let us know and we may reconsider this "
  4686. "removal."
  4687. msgstr ""
  4688. #: ../../../CHANGELOG.md:1719
  4689. msgid "signald (0.19.0+) upgrade requires data migration"
  4690. msgstr ""
  4691. #: ../../../CHANGELOG.md:1721
  4692. msgid ""
  4693. "In [Pull Request #1921](https://github.com/spantaleev/matrix-docker-"
  4694. "ansible-deploy/pull/1921) we upgraded [signald](https://signald.org/) "
  4695. "(used by the mautrix-signal bridge) from `v0.18.5` to `v0.20.0`."
  4696. msgstr ""
  4697. #: ../../../CHANGELOG.md:1723
  4698. msgid ""
  4699. "Back in the [`v0.19.0` released of "
  4700. "signald](https://gitlab.com/signald/signald/-/blob/main/releases/0.19.0.md)"
  4701. " (which we skipped and migrated straight to `v0.20.0`), a new `--migrate-"
  4702. "data` command had been added that migrates avatars, group images, "
  4703. "attachments, etc., into the database (those were previously stored in the"
  4704. " filesystem)."
  4705. msgstr ""
  4706. #: ../../../CHANGELOG.md:1725
  4707. msgid ""
  4708. "If you've been using the mautrix-signal bridge for a while, you may have "
  4709. "files stored in the local filesystem, which will need to be upgraded."
  4710. msgstr ""
  4711. #: ../../../CHANGELOG.md:1727
  4712. msgid ""
  4713. "We attempt to do this data migration automatically every time Signald "
  4714. "starts (`matrix-mautrix-signal-daemon.service`) using a `ExecStartPre` "
  4715. "systemd unit definition."
  4716. msgstr ""
  4717. #: ../../../CHANGELOG.md:1729
  4718. msgid ""
  4719. "Keep an eye on your Signal bridge and let us know (in our [support "
  4720. "room](README.md#support) or in [Pull Request "
  4721. "#1921](https://github.com/spantaleev/matrix-docker-ansible-"
  4722. "deploy/pull/1921)) if you experience any trouble!"
  4723. msgstr ""
  4724. #: ../../../CHANGELOG.md:1732
  4725. msgid "2022-07-05"
  4726. msgstr ""
  4727. #: ../../../CHANGELOG.md:1734
  4728. msgid "Ntfy push notifications support"
  4729. msgstr ""
  4730. #: ../../../CHANGELOG.md:1736
  4731. msgid ""
  4732. "Thanks to [Julian Foad](https://matrix.to/#/@julian:foad.me.uk), the "
  4733. "playbook can now install a [ntfy](https://ntfy.sh/) push notifications "
  4734. "server for you."
  4735. msgstr ""
  4736. #: ../../../CHANGELOG.md:1738
  4737. msgid ""
  4738. "See our [Setting up the ntfy push notifications server](docs/configuring-"
  4739. "playbook-ntfy.md) documentation to get started."
  4740. msgstr ""
  4741. #: ../../../CHANGELOG.md:1741
  4742. msgid "2022-06-23"
  4743. msgstr ""
  4744. #: ../../../CHANGELOG.md:1743
  4745. msgid "(Potential Backward Compatibility Break) Changes around metrics collection"
  4746. msgstr ""
  4747. #: ../../../CHANGELOG.md:1745
  4748. msgid ""
  4749. "**TLDR**: we've made extensive **changes to metrics exposure/collection, "
  4750. "which concern people using an external Prometheus server**. If you don't "
  4751. "know what that is, you don't need to read below."
  4752. msgstr ""
  4753. #: ../../../CHANGELOG.md:1747
  4754. msgid ""
  4755. "**Why do major changes to metrics**? Because various services were "
  4756. "exposing metrics in different, hacky, ways. Synapse was exposing metrics "
  4757. "at `/_synapse/metrics` and `/_synapse-worker-…/metrics` on the "
  4758. "`matrix.example.com`. The Hookshot role was **repurposing** the Granana "
  4759. "web UI domain (`stats.example.com`) for exposing its metrics on "
  4760. "`stats.example.com/hookshot/metrics`, while protecting these routes using"
  4761. " Basic Authentication **normally used for Synapse** "
  4762. "(`/_synapse/metrics`). Node-exporter and Postgres-exporter roles were "
  4763. "advising for more `stats.example.com` usage in manual ways. Each role was"
  4764. " doing things differently and mixing variables from other roles. Each "
  4765. "metrics endpoint was ending up in a different place, protected by who "
  4766. "knows what Basic Authentication credentials (if protected at all)."
  4767. msgstr ""
  4768. #: ../../../CHANGELOG.md:1749
  4769. msgid ""
  4770. "**The solution**: a completely revamped way to expose metrics to an "
  4771. "external Prometheus server. We are **introducing new "
  4772. "`https://matrix.example.com/metrics/*` endpoints**, where various "
  4773. "services *can* expose their metrics, for collection by external "
  4774. "Prometheus servers. To enable the `/metrics/*` endpoints, use "
  4775. "`matrix_nginx_proxy_proxy_matrix_metrics_enabled: true`. There's also a "
  4776. "way to protect access using [Basic "
  4777. "Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication)."
  4778. " See the `matrix-nginx-proxy` role or our [Collecting metrics to an "
  4779. "external Prometheus server](docs/configuring-playbook-prometheus-"
  4780. "grafana.md#collecting-metrics-to-an-external-prometheus-server) "
  4781. "documentation for additional variables around "
  4782. "`matrix_nginx_proxy_proxy_matrix_metrics_enabled`."
  4783. msgstr ""
  4784. #: ../../../CHANGELOG.md:1751
  4785. msgid ""
  4786. "**If you are using the [Hookshot bridge](docs/configuring-playbook-"
  4787. "bridge-hookshot.md)**, you may find that:"
  4788. msgstr ""
  4789. #: ../../../CHANGELOG.md:1752
  4790. msgid "**Metrics may not be enabled by default anymore**:"
  4791. msgstr ""
  4792. #: ../../../CHANGELOG.md:1753
  4793. msgid ""
  4794. "If Prometheus is enabled (`prometheus_enabled: true`), then Hookshot "
  4795. "metrics will be enabled automatically (`matrix_hookshot_metrics_enabled: "
  4796. "true`). These metrics will be collected from the local (in-container) "
  4797. "Prometheus over the container network."
  4798. msgstr ""
  4799. #: ../../../CHANGELOG.md:1754
  4800. msgid ""
  4801. "**If Prometheus is not enabled** (you are either not using Prometheus or "
  4802. "are using an external one), **Hookshot metrics will not be enabled by "
  4803. "default anymore**. Feel free to enable them by setting "
  4804. "`matrix_hookshot_metrics_enabled: true`. Also, see below."
  4805. msgstr ""
  4806. #: ../../../CHANGELOG.md:1755
  4807. msgid ""
  4808. "When metrics are meant to be **consumed by an external Prometheus "
  4809. "server**, `matrix_hookshot_metrics_proxying_enabled` needs to be set to "
  4810. "`true`, so that metrics would be exposed (proxied) \"publicly\" on "
  4811. "`https://matrix.example.com/metrics/hookshot`. To make use of this, "
  4812. "you'll also need to enable the new `https://matrix.example.com/metrics/*`"
  4813. " endpoints mentioned above, using "
  4814. "`matrix_nginx_proxy_proxy_matrix_metrics_enabled`. Learn more in our "
  4815. "[Collecting metrics to an external Prometheus server](docs/configuring-"
  4816. "playbook-prometheus-grafana.md#collecting-metrics-to-an-external-"
  4817. "prometheus-server) documentation."
  4818. msgstr ""
  4819. #: ../../../CHANGELOG.md:1756
  4820. msgid ""
  4821. "**We've changed the URL we're exposing Hookshot metrics at** for external"
  4822. " Prometheus servers. Until now, you were advised to consume Hookshot "
  4823. "metrics from `https://stats.example.com/hookshot/metrics` (working in "
  4824. "conjunction with `matrix_nginx_proxy_proxy_synapse_metrics`). From now "
  4825. "on, **this no longer works**. As described above, you need to start "
  4826. "consuming metrics from `https://matrix.example.com/metrics/hookshot`."
  4827. msgstr ""
  4828. #: ../../../CHANGELOG.md:1758
  4829. msgid ""
  4830. "**If you're using node-exporter** "
  4831. "(`matrix_prometheus_node_exporter_enabled: true`) and would like to "
  4832. "collect its metrics from an external Prometheus server, see "
  4833. "`matrix_prometheus_node_exporter_metrics_proxying_enabled` described in "
  4834. "our [Collecting metrics to an external Prometheus server](docs"
  4835. "/configuring-playbook-prometheus-grafana.md#collecting-metrics-to-an-"
  4836. "external-prometheus-server) documentation. You will be able to collect "
  4837. "its metrics from `https://matrix.example.com/metrics/node-exporter`."
  4838. msgstr ""
  4839. #: ../../../CHANGELOG.md:1760
  4840. msgid ""
  4841. "**If you're using [postgres-exporter](docs/configuring-playbook-"
  4842. "prometheus-postgres.md)** (`prometheus_postgres_exporter_enabled: true`) "
  4843. "and would like to collect its metrics from an external Prometheus server,"
  4844. " see "
  4845. "`matrix_prometheus_services_proxy_connect_prometheus_postgres_exporter_metrics_proxying_enabled`"
  4846. " described in our [Collecting metrics to an external Prometheus "
  4847. "server](docs/configuring-playbook-prometheus-grafana.md#collecting-"
  4848. "metrics-to-an-external-prometheus-server) documentation. You will be able"
  4849. " to collect its metrics from `https://matrix.example.com/metrics"
  4850. "/postgres-exporter`."
  4851. msgstr ""
  4852. #: ../../../CHANGELOG.md:1762
  4853. msgid ""
  4854. "**If you're using Synapse** and would like to collect its metrics from an"
  4855. " external Prometheus server, you may find that:"
  4856. msgstr ""
  4857. #: ../../../CHANGELOG.md:1764
  4858. msgid ""
  4859. "Exposing metrics is now done using "
  4860. "`matrix_synapse_metrics_proxying_enabled`, not "
  4861. "`matrix_nginx_proxy_proxy_synapse_metrics: true`. You may still need to "
  4862. "enable metrics using `matrix_synapse_metrics_enabled: true` before "
  4863. "exposing them."
  4864. msgstr ""
  4865. #: ../../../CHANGELOG.md:1765
  4866. msgid ""
  4867. "Protecting metrics endpoints using [Basic "
  4868. "Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication)"
  4869. " is now done in another way. See our [Collecting metrics to an external "
  4870. "Prometheus server](docs/configuring-playbook-prometheus-grafana.md"
  4871. "#collecting-metrics-to-an-external-prometheus-server) documentation"
  4872. msgstr ""
  4873. #: ../../../CHANGELOG.md:1766
  4874. msgid ""
  4875. "If Synapse metrics are exposed, they will be made available at "
  4876. "`https://matrix.example.com/metrics/synapse/main-process` or "
  4877. "`https://matrix.example.com/metrics/synapse/worker/TYPE-ID` (when workers"
  4878. " are enabled), not at `https://matrix.example.com/_synapse/metrics` and "
  4879. "`https://matrix.example.com/_synapse-worker-…/metrics`"
  4880. msgstr ""
  4881. #: ../../../CHANGELOG.md:1767
  4882. msgid ""
  4883. "The playbook still generates an `external_prometheus.yml.example` sample "
  4884. "file for scraping Synapse from Prometheus as described in [Collecting "
  4885. "Synapse worker metrics to an external Prometheus server](docs"
  4886. "/configuring-playbook-prometheus-grafana.md#collecting-synapse-worker-"
  4887. "metrics-to-an-external-prometheus-server), but it's now saved under "
  4888. "`/matrix/synapse` (not `/matrix`)."
  4889. msgstr ""
  4890. #: ../../../CHANGELOG.md:1769
  4891. msgid ""
  4892. "**If you where already using a external Prometheus server** before this "
  4893. "change, and you gave a hashed version of the password as a variable, the "
  4894. "playbook will now take care of hashing the password for you. Thus, you "
  4895. "need to provide the non-hashed version now."
  4896. msgstr ""
  4897. #: ../../../CHANGELOG.md:1771
  4898. msgid "2022-06-13"
  4899. msgstr ""
  4900. #: ../../../CHANGELOG.md:1773
  4901. msgid "go-skype-bridge bridging support"
  4902. msgstr ""
  4903. #: ../../../CHANGELOG.md:1775
  4904. msgid ""
  4905. "Thanks to [CyberShadow](https://github.com/CyberShadow), the playbook can"
  4906. " now install the [go-skype-bridge](https://github.com/kelaresg/go-skype-"
  4907. "bridge) bridge for bridging Matrix to [Skype](https://www.skype.com/)."
  4908. msgstr ""
  4909. #: ../../../CHANGELOG.md:1777
  4910. msgid ""
  4911. "See our [Setting up Go Skype Bridge bridging](docs/configuring-playbook-"
  4912. "bridge-go-skype-bridge.md) documentation to get started."
  4913. msgstr ""
  4914. #: ../../../CHANGELOG.md:1779
  4915. msgid ""
  4916. "The playbook has supported [mx-puppet-skype](https://github.com/Sorunome"
  4917. "/mx-puppet-skype) bridging (see [Setting up MX Puppet Skype "
  4918. "bridging](docs/configuring-playbook-bridge-mx-puppet-skype.md)) since "
  4919. "[2020-04-09](#2020-04-09), but `mx-puppet-skype` is reportedly broken."
  4920. msgstr ""
  4921. #: ../../../CHANGELOG.md:1782
  4922. msgid "2022-06-09"
  4923. msgstr ""
  4924. #: ../../../CHANGELOG.md:1784
  4925. msgid "Running Ansible in a container can now happen on the Matrix server itself"
  4926. msgstr ""
  4927. #: ../../../CHANGELOG.md:1786
  4928. msgid ""
  4929. "If you're tired of being on an old and problematic Ansible version, you "
  4930. "can now run [run Ansible in a container on the Matrix server "
  4931. "itself](docs/ansible.md#running-ansible-in-a-container-on-the-matrix-"
  4932. "server-itself)."
  4933. msgstr ""
  4934. #: ../../../CHANGELOG.md:1789
  4935. msgid "2022-05-31"
  4936. msgstr ""
  4937. #: ../../../CHANGELOG.md:1791
  4938. msgid "Synapse v1.60 upgrade may cause trouble and require manual intervention"
  4939. msgstr ""
  4940. #: ../../../CHANGELOG.md:1793
  4941. msgid ""
  4942. "Synapse v1.60 will try to add a new unique index to `state_group_edges` "
  4943. "upon startup and could fail if your database is corrupted."
  4944. msgstr ""
  4945. #: ../../../CHANGELOG.md:1795
  4946. msgid ""
  4947. "We haven't observed this problem yet, but [the Synapse v1.60.0 upgrade "
  4948. "notes](https://github.com/element-"
  4949. "hq/synapse/blob/v1.60.0/docs/upgrade.md#adding-a-new-unique-index-to-"
  4950. "state_group_edges-could-fail-if-your-database-is-corrupted) mention it, "
  4951. "so we're giving you a heads up here in case you're unlucky."
  4952. msgstr ""
  4953. #: ../../../CHANGELOG.md:1797
  4954. msgid ""
  4955. "**If Synapse fails to start** after your next playbook run, you'll need "
  4956. "to:"
  4957. msgstr ""
  4958. #: ../../../CHANGELOG.md:1799
  4959. msgid "SSH into the Matrix server"
  4960. msgstr ""
  4961. #: ../../../CHANGELOG.md:1800
  4962. msgid "launch `/usr/local/bin/matrix-postgres-cli`"
  4963. msgstr ""
  4964. #: ../../../CHANGELOG.md:1801
  4965. msgid "switch to the `synapse` database: `\\c synapse`"
  4966. msgstr ""
  4967. #: ../../../CHANGELOG.md:1802
  4968. msgid "run the following SQL query:"
  4969. msgstr ""
  4970. #: ../../../CHANGELOG.md:1821
  4971. msgid ""
  4972. "You could then restart services: `ansible-playbook -i inventory/hosts "
  4973. "setup.yml --tags=start`"
  4974. msgstr ""
  4975. #: ../../../CHANGELOG.md:1824
  4976. msgid "2022-04-25"
  4977. msgstr ""
  4978. #: ../../../CHANGELOG.md:1826
  4979. msgid "Buscarron bot support"
  4980. msgstr ""
  4981. #: ../../../CHANGELOG.md:1828
  4982. msgid ""
  4983. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  4984. "[etke.cc](https://etke.cc/), the playbook can now set up [the Buscarron "
  4985. "bot](https://github.com/etkecc/buscarron). It's a bot you can use to send"
  4986. " any form (HTTP POST, HTML) to a (encrypted) Matrix room"
  4987. msgstr ""
  4988. #: ../../../CHANGELOG.md:1830
  4989. msgid ""
  4990. "See our [Setting up Buscarron](docs/configuring-playbook-bot-"
  4991. "buscarron.md) documentation to get started."
  4992. msgstr ""
  4993. #: ../../../CHANGELOG.md:1833
  4994. msgid "2022-04-21"
  4995. msgstr ""
  4996. #: ../../../CHANGELOG.md:1835
  4997. msgid "matrix-registration-bot support"
  4998. msgstr ""
  4999. #: ../../../CHANGELOG.md:1837
  5000. msgid ""
  5001. "Thanks to [Julian-Samuel Gebühr (@moan0s)](https://github.com/moan0s), "
  5002. "the playbook can now help you set up [matrix-registration-"
  5003. "bot](https://github.com/moan0s/matrix-registration-bot) - a bot that is "
  5004. "used to create and manage registration tokens for a Matrix server."
  5005. msgstr ""
  5006. #: ../../../CHANGELOG.md:1839
  5007. msgid ""
  5008. "See our [Setting up matrix-registration-bot](docs/configuring-playbook-"
  5009. "bot-matrix-registration-bot.md) documentation to get started."
  5010. msgstr ""
  5011. #: ../../../CHANGELOG.md:1842
  5012. msgid "2022-04-19"
  5013. msgstr ""
  5014. #: ../../../CHANGELOG.md:1844
  5015. msgid "BorgBackup support"
  5016. msgstr ""
  5017. #: ../../../CHANGELOG.md:1846
  5018. msgid ""
  5019. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  5020. "[etke.cc](https://etke.cc/), the playbook can now set up "
  5021. "[Borg](https://www.borgbackup.org/) backups with "
  5022. "[borgmatic](https://torsion.org/borgmatic/) of your Matrix server."
  5023. msgstr ""
  5024. #: ../../../CHANGELOG.md:1848
  5025. msgid ""
  5026. "See our [Setting up BorgBackup](docs/configuring-playbook-backup-borg.md)"
  5027. " documentation to get started."
  5028. msgstr ""
  5029. #: ../../../CHANGELOG.md:1850
  5030. msgid ""
  5031. "(Compatibility Break) Upgrading to Synapse v1.57 on setups using workers "
  5032. "may require manual action"
  5033. msgstr ""
  5034. #: ../../../CHANGELOG.md:1852
  5035. msgid ""
  5036. "If you're running a worker setup for Synapse "
  5037. "(`matrix_synapse_workers_enabled: true`), the [Synapse v1.57 upgrade "
  5038. "notes](https://github.com/element-"
  5039. "hq/synapse/blob/v1.57.0rc1/docs/upgrade.md#changes-to-database-schema-"
  5040. "for-application-services) say that you may need to take special care when"
  5041. " upgrading:"
  5042. msgstr ""
  5043. #: ../../../CHANGELOG.md:1854
  5044. msgid ""
  5045. "Synapse v1.57.0 includes a change to the way transaction IDs are managed "
  5046. "for application services. If your deployment uses a dedicated worker for "
  5047. "application service traffic, **it must be stopped** when the database is "
  5048. "upgraded (which normally happens when the main process is upgraded), to "
  5049. "ensure the change is made safely without any risk of reusing transaction "
  5050. "IDs."
  5051. msgstr ""
  5052. #: ../../../CHANGELOG.md:1856
  5053. msgid ""
  5054. "If you're not running an `appservice` worker "
  5055. "(`matrix_synapse_workers_preset: little-federation-helper` or "
  5056. "`matrix_synapse_workers_appservice_workers_count: 0`), you are probably "
  5057. "safe to upgrade as per normal, without taking any special care."
  5058. msgstr ""
  5059. #: ../../../CHANGELOG.md:1858
  5060. msgid ""
  5061. "If you are running a setup with an `appservice` worker, or otherwise want"
  5062. " to be on the safe side, we recommend the following upgrade path:"
  5063. msgstr ""
  5064. #: ../../../CHANGELOG.md:1860
  5065. msgid "Pull the latest playbook changes"
  5066. msgstr ""
  5067. #: ../../../CHANGELOG.md:1861
  5068. msgid ""
  5069. "Stop all services (`ansible-playbook -i inventory/hosts setup.yml "
  5070. "--tags=stop`)"
  5071. msgstr ""
  5072. #: ../../../CHANGELOG.md:1862
  5073. msgid ""
  5074. "Re-run the playbook (`ansible-playbook -i inventory/hosts setup.yml "
  5075. "--tags=setup-all`)"
  5076. msgstr ""
  5077. #: ../../../CHANGELOG.md:1863
  5078. msgid "Start Postgres (`systemctl start matrix-postgres` on the server)"
  5079. msgstr ""
  5080. #: ../../../CHANGELOG.md:1864
  5081. msgid ""
  5082. "Start the main Synapse process (`systemctl start matrix-synapse` on the "
  5083. "server)"
  5084. msgstr ""
  5085. #: ../../../CHANGELOG.md:1865
  5086. msgid ""
  5087. "Wait a while so that Synapse can start and complete the database "
  5088. "migrations. You can use `journalctl -fu matrix-synapse` on the server to "
  5089. "get a clue. Waiting a few minutes should also be enough."
  5090. msgstr ""
  5091. #: ../../../CHANGELOG.md:1866
  5092. msgid ""
  5093. "It should now be safe to start all other services. `ansible-playbook -i "
  5094. "inventory/hosts setup.yml --tags=start` will do it for you"
  5095. msgstr ""
  5096. #: ../../../CHANGELOG.md:1869
  5097. msgid "2022-04-14"
  5098. msgstr ""
  5099. #: ../../../CHANGELOG.md:1871
  5100. msgid ""
  5101. "(Compatibility Break) Changes to `docker-src` permissions necessitating "
  5102. "manual action"
  5103. msgstr ""
  5104. #: ../../../CHANGELOG.md:1873
  5105. msgid ""
  5106. "Users who build container images from source will need to manually "
  5107. "correct file permissions of some directories on the server."
  5108. msgstr ""
  5109. #: ../../../CHANGELOG.md:1875
  5110. msgid ""
  5111. "When self-building, the playbook used to `git clone` repositories (into "
  5112. "`/matrix/SERVICE/docker-src`) using the `root` user, but now uses "
  5113. "`matrix` instead to work around [the following issue with git "
  5114. "2.35.2](https://github.com/spantaleev/matrix-docker-ansible-"
  5115. "deploy/issues/1749)."
  5116. msgstr ""
  5117. #: ../../../CHANGELOG.md:1877
  5118. msgid ""
  5119. "If you're on a non-`amd64` architecture (that is, you're overriding "
  5120. "`matrix_architecture` in your `vars.yml` file) or you have enabled self-"
  5121. "building for some service (e.g. `matrix_*_self_build: true`), you're "
  5122. "certainly building some container images from source and have `docker-"
  5123. "src` directories with mixed permissions lying around in various "
  5124. "`/matrix/SERVICE` directories."
  5125. msgstr ""
  5126. #: ../../../CHANGELOG.md:1879
  5127. msgid ""
  5128. "The playbook *could* correct these permissions automatically, but that "
  5129. "requires additional Ansible tasks in some ~45 different places - "
  5130. "something that takes considerable effort. So we ask users observing "
  5131. "errors related to `docker-src` directories to correct the problem "
  5132. "manually by **running this command on the Matrix server** (which deletes "
  5133. "all `/matrix/*/docker-src` directories): `find /matrix -maxdepth 2 -name "
  5134. "'docker-src' | xargs rm -rf`"
  5135. msgstr ""
  5136. #: ../../../CHANGELOG.md:1882
  5137. msgid "2022-03-17"
  5138. msgstr ""
  5139. #: ../../../CHANGELOG.md:1884
  5140. msgid "(Compatibility Break) ma1sd identity server no longer installed by default"
  5141. msgstr ""
  5142. #: ../../../CHANGELOG.md:1886
  5143. msgid ""
  5144. "The playbook no longer installs the "
  5145. "[ma1sd](https://github.com/ma1uta/ma1sd) identity server by default. The "
  5146. "next time you run the playbook, ma1sd will be uninstalled from your "
  5147. "server, unless you explicitly enable the ma1sd service (see how below)."
  5148. msgstr ""
  5149. #: ../../../CHANGELOG.md:1888
  5150. msgid ""
  5151. "The main reason we used to install ma1sd by default in the past was to "
  5152. "prevent Element clients from talking to the `matrix.org` / `vector.im` "
  5153. "identity servers, by forcing it to talk to our own self-hosted (but "
  5154. "otherwise useless) identity server instead, thus preventing contact list "
  5155. "leaks."
  5156. msgstr ""
  5157. #: ../../../CHANGELOG.md:1890
  5158. msgid ""
  5159. "Since Element clients no longer default to using a public identity server"
  5160. " if another one is not provided, we can stop installing ma1sd."
  5161. msgstr ""
  5162. #: ../../../CHANGELOG.md:1892
  5163. msgid ""
  5164. "If you need to install the ma1sd identity server for some reason, you can"
  5165. " explicitly enable it by adding this to your `vars.yml` file:"
  5166. msgstr ""
  5167. #: ../../../CHANGELOG.md:1899
  5168. msgid "2022-02-12"
  5169. msgstr ""
  5170. #: ../../../CHANGELOG.md:1901
  5171. msgid "matrix_encryption_disabler support"
  5172. msgstr ""
  5173. #: ../../../CHANGELOG.md:1903
  5174. msgid ""
  5175. "We now support installing the "
  5176. "[matrix_encryption_disabler](https://github.com/digitalentity/matrix_encryption_disabler)"
  5177. " Synapse module, which lets you prevent End-to-End-Encryption from being "
  5178. "enabled by users on your homeserver. The popular opinion is that this is "
  5179. "dangerous and shouldn't be done, but there are valid use cases for "
  5180. "disabling encryption discussed [here](https://github.com/matrix-"
  5181. "org/synapse/issues/4401)."
  5182. msgstr ""
  5183. #: ../../../CHANGELOG.md:1905
  5184. msgid ""
  5185. "To enable this module (and prevent encryption from being used on your "
  5186. "homserver), add `matrix_synapse_ext_encryption_disabler_enabled: true` to"
  5187. " your configuration. This module provides further customization. Check "
  5188. "its other configuration settings (and defaults) in `roles/custom/matrix-"
  5189. "synapse/defaults/main.yml`."
  5190. msgstr ""
  5191. #: ../../../CHANGELOG.md:1908
  5192. msgid "2022-02-01"
  5193. msgstr ""
  5194. #: ../../../CHANGELOG.md:1910
  5195. msgid "matrix-hookshot bridging support"
  5196. msgstr ""
  5197. #: ../../../CHANGELOG.md:1912
  5198. msgid ""
  5199. "Thanks to [HarHarLinks](https://github.com/HarHarLinks), the playbook can"
  5200. " now install the [matrix-hookshot](https://github.com/matrix-org/matrix-"
  5201. "hookshot) bridge for bridging Matrix to multiple project management "
  5202. "services, such as GitHub, GitLab and JIRA. See our [Setting up matrix-"
  5203. "hookshot](docs/configuring-playbook-bridge-hookshot.md) documentation to "
  5204. "get started."
  5205. msgstr ""
  5206. #: ../../../CHANGELOG.md:1915
  5207. msgid "2022-01-31"
  5208. msgstr ""
  5209. #: ../../../CHANGELOG.md:1917
  5210. msgid "ARM support for matrix-corporal"
  5211. msgstr ""
  5212. #: ../../../CHANGELOG.md:1919
  5213. msgid ""
  5214. "[matrix-corporal](https://github.com/devture/matrix-corporal) (as of "
  5215. "version `2.2.3`) is now published to Docker Hub (see [devture/matrix-"
  5216. "corporal](https://hub.docker.com/r/devture/matrix-corporal)) as a multi-"
  5217. "arch container image with support for all these platforms: `linux/amd64`,"
  5218. " `linux/arm64/v8` and `linux/arm/v7`. The playbook no longer resorts to "
  5219. "self-building matrix-corporal on these ARM architectures."
  5220. msgstr ""
  5221. #: ../../../CHANGELOG.md:1922
  5222. msgid "2022-01-07"
  5223. msgstr ""
  5224. #: ../../../CHANGELOG.md:1924
  5225. msgid "Dendrite support"
  5226. msgstr ""
  5227. #: ../../../CHANGELOG.md:1926
  5228. msgid ""
  5229. "**TLDR**: We now have optional experimental [Dendrite](https://github.com"
  5230. "/matrix-org/dendrite) homeserver support for new installations. "
  5231. "**Existing (Synapse) installations need to be updated**, because some "
  5232. "internals changed. See [Adapting the configuration for existing Synapse "
  5233. "installations](#adapting-the-configuration-for-existing-synapse-"
  5234. "installations)."
  5235. msgstr ""
  5236. #: ../../../CHANGELOG.md:1928
  5237. msgid ""
  5238. "[Jip J. Dekker](https://github.com/Dekker1) did the [initial "
  5239. "work](https://github.com/spantaleev/matrix-docker-ansible-"
  5240. "deploy/pull/818) of adding [Dendrite](https://github.com/matrix-"
  5241. "org/dendrite) support to the playbook back in January 2021. Lots of work "
  5242. "(and time) later, Dendrite support is finally ready for testing."
  5243. msgstr ""
  5244. #: ../../../CHANGELOG.md:1930
  5245. msgid "We believe that 2022 will be the year of the non-Synapse Matrix server!"
  5246. msgstr ""
  5247. #: ../../../CHANGELOG.md:1932
  5248. msgid ""
  5249. "The playbook was previously quite [Synapse](https://github.com/element-"
  5250. "hq/synapse)-centric, but can now accommodate multiple homeserver "
  5251. "implementations. Only one homeserver implementation can be active "
  5252. "(installed) at a given time."
  5253. msgstr ""
  5254. #: ../../../CHANGELOG.md:1934
  5255. msgid ""
  5256. "**Synapse is still the default homeserver implementation** installed by "
  5257. "the playbook. A new variable (`matrix_homeserver_implementation`) "
  5258. "controls which server implementation is enabled (`synapse` or `dendrite` "
  5259. "at the given moment)."
  5260. msgstr ""
  5261. #: ../../../CHANGELOG.md:1936
  5262. msgid "Adapting the configuration for existing Synapse installations"
  5263. msgstr ""
  5264. #: ../../../CHANGELOG.md:1938
  5265. msgid ""
  5266. "Because the playbook is not so Synapse-centric anymore, a small "
  5267. "configuration change is necessary for existing installations to bring "
  5268. "them up to date."
  5269. msgstr ""
  5270. #: ../../../CHANGELOG.md:1940
  5271. msgid ""
  5272. "The `vars.yml` file for **existing installations will need to be "
  5273. "updated** by adding this **additional configuration**:"
  5274. msgstr ""
  5275. #: ../../../CHANGELOG.md:1952
  5276. msgid "Trying out Dendrite"
  5277. msgstr ""
  5278. #: ../../../CHANGELOG.md:1954
  5279. msgid ""
  5280. "Finally, **to try out Dendrite**, we recommend that you **use a new "
  5281. "server** and the following addition to your `vars.yml` configuration:"
  5282. msgstr ""
  5283. #: ../../../CHANGELOG.md:1960
  5284. msgid ""
  5285. "**The homeserver implementation of an existing server cannot be changed**"
  5286. " (e.g. from Synapse to Dendrite) without data loss."
  5287. msgstr ""
  5288. #: ../../../CHANGELOG.md:1962
  5289. msgid ""
  5290. "We're excited to gain support for other homeserver implementations, like "
  5291. "[Conduit](https://conduit.rs/), etc!"
  5292. msgstr ""
  5293. #: ../../../CHANGELOG.md:1964
  5294. msgid "Honoroit bot support"
  5295. msgstr ""
  5296. #: ../../../CHANGELOG.md:1966
  5297. msgid ""
  5298. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  5299. "[etke.cc](https://etke.cc/), the playbook can now help you set up "
  5300. "[Honoroit](https://github.com/etkecc/honoroit) - a helpdesk bot."
  5301. msgstr ""
  5302. #: ../../../CHANGELOG.md:1968
  5303. msgid ""
  5304. "See our [Setting up Honoroit](docs/configuring-playbook-bot-honoroit.md) "
  5305. "documentation to get started."
  5306. msgstr ""
  5307. #: ../../../CHANGELOG.md:1971
  5308. msgid "2022-01-06"
  5309. msgstr ""
  5310. #: ../../../CHANGELOG.md:1973
  5311. msgid "Cinny support"
  5312. msgstr ""
  5313. #: ../../../CHANGELOG.md:1975
  5314. msgid ""
  5315. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  5316. "[etke.cc](https://etke.cc/), the playbook now supports "
  5317. "[Cinny](https://cinny.in/) - a new simple, elegant and secure Matrix "
  5318. "client."
  5319. msgstr ""
  5320. #: ../../../CHANGELOG.md:1977
  5321. msgid ""
  5322. "By default, we still install Element Web. Still, people who'd like to try"
  5323. " Cinny out can now install it via the playbook."
  5324. msgstr ""
  5325. #: ../../../CHANGELOG.md:1979
  5326. msgid ""
  5327. "Additional details are available in [Setting up Cinny](docs/configuring-"
  5328. "playbook-client-cinny.md)."
  5329. msgstr ""
  5330. #: ../../../CHANGELOG.md:1982
  5331. msgid "2021-12-22"
  5332. msgstr ""
  5333. #: ../../../CHANGELOG.md:1984
  5334. msgid "Twitter bridging support via mautrix-twitter"
  5335. msgstr ""
  5336. #: ../../../CHANGELOG.md:1986
  5337. msgid ""
  5338. "Thanks to [Matthew Cengia](https://github.com/mattcen) and [Shreyas "
  5339. "Ajjarapu](https://github.com/shreyasajj), besides [mx-puppet-"
  5340. "twitter](docs/configuring-playbook-bridge-mx-puppet-twitter.md), bridging"
  5341. " to [Twitter](https://twitter.com/) can now also happen with [mautrix-"
  5342. "twitter](docs/configuring-playbook-bridge-mautrix-twitter.md)."
  5343. msgstr ""
  5344. #: ../../../CHANGELOG.md:1989
  5345. msgid "2021-12-14"
  5346. msgstr ""
  5347. #: ../../../CHANGELOG.md:1991
  5348. msgid ""
  5349. "(Security) Users of the Signal bridge may wish to upgrade it to work "
  5350. "around log4j vulnerability"
  5351. msgstr ""
  5352. #: ../../../CHANGELOG.md:1993
  5353. msgid ""
  5354. "Recently, a security vulnerability affecting the Java logging package "
  5355. "`log4j` [has been discovered](https://www.huntress.com/blog/rapid-"
  5356. "response-critical-rce-vulnerability-is-affecting-java). Software that "
  5357. "uses this Java package is potentially vulnerable."
  5358. msgstr ""
  5359. #: ../../../CHANGELOG.md:1995
  5360. msgid ""
  5361. "One such piece of software that is part of the playbook is the [mautrix-"
  5362. "signal bridge](./docs/configuring-playbook-bridge-mautrix-signal.md), "
  5363. "which [has been patched already](https://github.com/spantaleev/matrix-"
  5364. "docker-ansible-deploy/pull/1452). If you're running this bridge, you may "
  5365. "wish to [upgrade](./docs/maintenance-upgrading-services.md)."
  5366. msgstr ""
  5367. #: ../../../CHANGELOG.md:1998
  5368. msgid "2021-11-11"
  5369. msgstr ""
  5370. #: ../../../CHANGELOG.md:2000
  5371. msgid "Dropped support for Postgres v9.6"
  5372. msgstr ""
  5373. #: ../../../CHANGELOG.md:2002
  5374. msgid ""
  5375. "Postgres v9.6 reached its end of life today, so the playbook will refuse "
  5376. "to run for you if you're still on that version."
  5377. msgstr ""
  5378. #: ../../../CHANGELOG.md:2004
  5379. msgid ""
  5380. "Synapse still supports v9.6 (for now), but we're retiring support for it "
  5381. "early, to avoid having to maintain support for so many Postgres versions."
  5382. " Users that are still on Postgres v9.6 can easily [upgrade Postgres](docs"
  5383. "/maintenance-postgres.md#upgrading-postgresql) via the playbook."
  5384. msgstr ""
  5385. #: ../../../CHANGELOG.md:2007
  5386. msgid "2021-10-23"
  5387. msgstr ""
  5388. #: ../../../CHANGELOG.md:2009
  5389. msgid "Hangouts bridge no longer updated, superseded by a Googlechat bridge"
  5390. msgstr ""
  5391. #: ../../../CHANGELOG.md:2011
  5392. msgid ""
  5393. "The mautrix-hangouts bridge is no longer receiving updates upstream and "
  5394. "is likely to stop working in the future. We still retain support for this"
  5395. " bridge in the playbook, but you're encouraged to switch away from it."
  5396. msgstr ""
  5397. #: ../../../CHANGELOG.md:2013
  5398. msgid ""
  5399. "There's a new [mautrix-googlechat](https://github.com/mautrix/googlechat)"
  5400. " bridge that you can [install using the playbook](docs/configuring-"
  5401. "playbook-bridge-mautrix-googlechat.md). Your **Hangouts bridge data will "
  5402. "not be migrated**, however. You need to start fresh with the new bridge."
  5403. msgstr ""
  5404. #: ../../../CHANGELOG.md:2016
  5405. msgid "2021-08-23"
  5406. msgstr ""
  5407. #: ../../../CHANGELOG.md:2018
  5408. msgid "LinkedIn bridging support via beeper-linkedin"
  5409. msgstr ""
  5410. #: ../../../CHANGELOG.md:2020
  5411. msgid ""
  5412. "Thanks to [Alexandar Mechev](https://github.com/apmechev), the playbook "
  5413. "can now install the [beeper-linkedin](https://gitlab.com/beeper/linkedin)"
  5414. " bridge for bridging to [LinkedIn](https://www.linkedin.com/) Messaging."
  5415. msgstr ""
  5416. #: ../../../CHANGELOG.md:2022
  5417. msgid ""
  5418. "This brings the total number of bridges supported by the playbook up to "
  5419. "20. See all supported bridges [here](docs/configuring-playbook.md"
  5420. "#bridging-other-networks)."
  5421. msgstr ""
  5422. #: ../../../CHANGELOG.md:2024
  5423. msgid ""
  5424. "To get started with bridging to LinkedIn, see [Setting up Beeper LinkedIn"
  5425. " bridging](docs/configuring-playbook-bridge-beeper-linkedin.md)."
  5426. msgstr ""
  5427. #: ../../../CHANGELOG.md:2027
  5428. msgid "2021-08-20"
  5429. msgstr ""
  5430. #: ../../../CHANGELOG.md:2029
  5431. msgid "Sygnal upgraded - ARM support and no longer requires a database"
  5432. msgstr ""
  5433. #: ../../../CHANGELOG.md:2031
  5434. msgid ""
  5435. "The [Sygnal](docs/configuring-playbook-sygnal.md) push gateway has been "
  5436. "upgraded from `v0.9.0` to `v0.10.1`."
  5437. msgstr ""
  5438. #: ../../../CHANGELOG.md:2033
  5439. msgid ""
  5440. "This is an optional component for the playbook, so most of our users "
  5441. "wouldn't care about this announcement."
  5442. msgstr ""
  5443. #: ../../../CHANGELOG.md:2035
  5444. msgid ""
  5445. "Since this feels like a relatively big (and untested, as of yet) Sygnal "
  5446. "change, we're putting up this changelog entry."
  5447. msgstr ""
  5448. #: ../../../CHANGELOG.md:2037
  5449. msgid ""
  5450. "The new version is also available for the ARM architecture. It also no "
  5451. "longer requires a database anymore. If you need to downgrade to the "
  5452. "previous version, changing `matrix_sygnal_version` or "
  5453. "`matrix_sygnal_docker_image` will not be enough, as we've removed the "
  5454. "`database` configuration completely. You'd need to switch to an earlier "
  5455. "playbook commit."
  5456. msgstr ""
  5457. #: ../../../CHANGELOG.md:2040
  5458. msgid "2021-05-21"
  5459. msgstr ""
  5460. #: ../../../CHANGELOG.md:2042
  5461. msgid "Hydrogen support"
  5462. msgstr ""
  5463. #: ../../../CHANGELOG.md:2044
  5464. msgid ""
  5465. "Thanks to [Aaron Raimist](https://github.com/aaronraimist), the playbook "
  5466. "now supports [Hydrogen](https://github.com/vector-im/hydrogen-web) - a "
  5467. "new lightweight Matrix client with legacy and mobile browser support."
  5468. msgstr ""
  5469. #: ../../../CHANGELOG.md:2046
  5470. msgid ""
  5471. "By default, we still install Element Web, as Hydrogen is still not fully-"
  5472. "featured. Still, people who'd like to try Hydrogen out can now install it"
  5473. " via the playbook."
  5474. msgstr ""
  5475. #: ../../../CHANGELOG.md:2048
  5476. msgid ""
  5477. "Additional details are available in [Setting up Hydrogen](docs"
  5478. "/configuring-playbook-client-hydrogen.md)."
  5479. msgstr ""
  5480. #: ../../../CHANGELOG.md:2051
  5481. msgid "2021-05-19"
  5482. msgstr ""
  5483. #: ../../../CHANGELOG.md:2053
  5484. msgid "Heisenbridge support"
  5485. msgstr ""
  5486. #: ../../../CHANGELOG.md:2055
  5487. msgid ""
  5488. "Thanks to [Toni Spets (hifi)](https://github.com/hifi), the playbook now "
  5489. "supports bridging to "
  5490. "[IRC](https://en.wikipedia.org/wiki/Internet_Relay_Chat) using yet "
  5491. "another bridge (besides matrix-appservice-irc), called "
  5492. "[Heisenbridge](https://github.com/hifi/heisenbridge)."
  5493. msgstr ""
  5494. #: ../../../CHANGELOG.md:2057
  5495. msgid ""
  5496. "Additional details are available in [Setting up Heisenbridge bouncer-"
  5497. "style IRC bridging](docs/configuring-playbook-bridge-heisenbridge.md)."
  5498. msgstr ""
  5499. #: ../../../CHANGELOG.md:2060
  5500. msgid "2021-04-16"
  5501. msgstr ""
  5502. #: ../../../CHANGELOG.md:2062
  5503. msgid "Disabling TLSv1 and TLSv1.1 for Coturn"
  5504. msgstr ""
  5505. #: ../../../CHANGELOG.md:2064
  5506. msgid ""
  5507. "To improve security, we've [removed TLSv1 and TLSv1.1 "
  5508. "support](https://github.com/spantaleev/matrix-docker-ansible-"
  5509. "deploy/pull/999) from our default "
  5510. "[Coturn](https://github.com/coturn/coturn) configuration."
  5511. msgstr ""
  5512. #: ../../../CHANGELOG.md:2066
  5513. msgid ""
  5514. "If you need to support old clients, you can re-enable both (or whichever "
  5515. "one you need) with the following configuration:"
  5516. msgstr ""
  5517. #: ../../../CHANGELOG.md:2074
  5518. msgid "2021-04-05"
  5519. msgstr ""
  5520. #: ../../../CHANGELOG.md:2076
  5521. msgid "Automated local Postgres backup support"
  5522. msgstr ""
  5523. #: ../../../CHANGELOG.md:2078
  5524. msgid ""
  5525. "Thanks to [foxcris](https://github.com/foxcris), the playbook can now "
  5526. "make automated local Postgres backups on a fixed schedule using [docker-"
  5527. "postgres-backup-local](https://github.com/prodrigestivill/docker-"
  5528. "postgres-backup-local)."
  5529. msgstr ""
  5530. #: ../../../CHANGELOG.md:2080
  5531. msgid ""
  5532. "Additional details are available in [Setting up postgres backup](docs"
  5533. "/configuring-playbook-postgres-backup.md)."
  5534. msgstr ""
  5535. #: ../../../CHANGELOG.md:2083
  5536. msgid "2021-04-03"
  5537. msgstr ""
  5538. #: ../../../CHANGELOG.md:2085
  5539. msgid "Mjolnir moderation tool (bot) support"
  5540. msgstr ""
  5541. #: ../../../CHANGELOG.md:2087
  5542. msgid ""
  5543. "Thanks to [Aaron Raimist](https://github.com/aaronraimist), the playbook "
  5544. "can now install and configure the [Mjolnir](https://github.com/matrix-"
  5545. "org/mjolnir) moderation tool (bot)."
  5546. msgstr ""
  5547. #: ../../../CHANGELOG.md:2089
  5548. msgid ""
  5549. "Additional details are available in [Setting up Mjolnir](docs"
  5550. "/configuring-playbook-bot-mjolnir.md)."
  5551. msgstr ""
  5552. #: ../../../CHANGELOG.md:2092
  5553. msgid "2021-03-20"
  5554. msgstr ""
  5555. #: ../../../CHANGELOG.md:2094
  5556. msgid "Sygnal push gateway support"
  5557. msgstr ""
  5558. #: ../../../CHANGELOG.md:2096
  5559. msgid ""
  5560. "The playbook can now install the [Sygnal](https://github.com/matrix-"
  5561. "org/sygnal) push gateway for you."
  5562. msgstr ""
  5563. #: ../../../CHANGELOG.md:2098
  5564. msgid ""
  5565. "This is only useful to people who develop/build their own Matrix client "
  5566. "applications."
  5567. msgstr ""
  5568. #: ../../../CHANGELOG.md:2100
  5569. msgid ""
  5570. "Additional details are available in our [Setting up the Sygnal push "
  5571. "gateway](docs/configuring-playbook-sygnal.md) docs."
  5572. msgstr ""
  5573. #: ../../../CHANGELOG.md:2103
  5574. msgid "2021-03-16"
  5575. msgstr ""
  5576. #: ../../../CHANGELOG.md:2105
  5577. msgid "Go-NEB support"
  5578. msgstr ""
  5579. #: ../../../CHANGELOG.md:2107
  5580. msgid ""
  5581. "Thanks to [Zir0h](https://github.com/Zir0h), the playbook can now install"
  5582. " and configure the [Go-NEB](https://github.com/matrix-org/go-neb) bot."
  5583. msgstr ""
  5584. #: ../../../CHANGELOG.md:2109
  5585. msgid ""
  5586. "Additional details are available in [Setting up Go-NEB](docs/configuring-"
  5587. "playbook-bot-go-neb.md)."
  5588. msgstr ""
  5589. #: ../../../CHANGELOG.md:2112
  5590. msgid "2021-02-19"
  5591. msgstr ""
  5592. #: ../../../CHANGELOG.md:2114
  5593. msgid "GroupMe bridging support via mx-puppet-groupme"
  5594. msgstr ""
  5595. #: ../../../CHANGELOG.md:2116
  5596. msgid ""
  5597. "Thanks to [Cody Neiman](https://github.com/xangelix), the playbook can "
  5598. "now install the [mx-puppet-groupme](https://gitlab.com/robintown/mx-"
  5599. "puppet-groupme) bridge for bridging to [GroupMe](https://groupme.com)."
  5600. msgstr ""
  5601. #: ../../../CHANGELOG.md:2118
  5602. msgid ""
  5603. "This brings the total number of bridges supported by the playbook up to "
  5604. "18. See all supported bridges [here](docs/configuring-playbook.md"
  5605. "#bridging-other-networks)."
  5606. msgstr ""
  5607. #: ../../../CHANGELOG.md:2120
  5608. msgid ""
  5609. "To get started, follow our [Setting up MX Puppet GroupMe](docs"
  5610. "/configuring-playbook-bridge-mx-puppet-groupme.md) docs."
  5611. msgstr ""
  5612. #: ../../../CHANGELOG.md:2122
  5613. msgid "Mautrix Instagram bridging support"
  5614. msgstr ""
  5615. #: ../../../CHANGELOG.md:2124
  5616. msgid ""
  5617. "The playbook now supports bridging with "
  5618. "[Instagram](https://www.instagram.com/) by installing the [mautrix-"
  5619. "instagram](https://github.com/tulir/mautrix-instagram) bridge. This "
  5620. "playbook functionality is available thanks to "
  5621. "[@MarcProe](https://github.com/MarcProe)."
  5622. msgstr ""
  5623. #: ../../../CHANGELOG.md:2126
  5624. msgid ""
  5625. "Additional details are available in [Setting up Mautrix Instagram "
  5626. "bridging](docs/configuring-playbook-bridge-mautrix-instagram.md)."
  5627. msgstr ""
  5628. #: ../../../CHANGELOG.md:2128
  5629. msgid "Synapse workers support"
  5630. msgstr ""
  5631. #: ../../../CHANGELOG.md:2130
  5632. msgid ""
  5633. "After [lots and lots of work](https://github.com/spantaleev/matrix-"
  5634. "docker-ansible-deploy/pull/456) (done over many months by [Marcel "
  5635. "Partap](https://github.com/eMPee584), [Max "
  5636. "Klenk](https://github.com/maxklenk), a few others from the [Technical "
  5637. "University of Dresden, Germany](https://tu-dresden.de/) and various other"
  5638. " contributors), support for Synapse workers has finally landed."
  5639. msgstr ""
  5640. #: ../../../CHANGELOG.md:2132
  5641. msgid ""
  5642. "Having support for workers makes the playbook suitable for larger "
  5643. "homeserver deployments."
  5644. msgstr ""
  5645. #: ../../../CHANGELOG.md:2134
  5646. msgid ""
  5647. "Our setup is not yet perfect (we don't support all types of workers; "
  5648. "scaling some of them (like `pusher`, `federation_sender`) beyond a single"
  5649. " instance is not yet supported). Still, it's a great start and can "
  5650. "already power homeservers with thousands of users, like the [Matrix "
  5651. "deployment at TU Dresden](https://doc.matrix.tu-dresden.de/en/) discussed"
  5652. " in [Matrix Live S06E09 - TU Dresden on their Matrix "
  5653. "deployment](https://www.youtube.com/watch?v=UHJX2pmT2gk)."
  5654. msgstr ""
  5655. #: ../../../CHANGELOG.md:2136
  5656. msgid ""
  5657. "By default, workers are disabled and Synapse runs as a single process "
  5658. "(homeservers don't necessarily need the complexity and increased memory "
  5659. "requirements of running a worker-based setup)."
  5660. msgstr ""
  5661. #: ../../../CHANGELOG.md:2138
  5662. msgid ""
  5663. "To enable Synapse workers, follow our [Load balancing with workers](docs"
  5664. "/configuring-playbook-synapse.md#load-balancing-with-workers) "
  5665. "documentation."
  5666. msgstr ""
  5667. #: ../../../CHANGELOG.md:2141
  5668. msgid "2021-02-12"
  5669. msgstr ""
  5670. #: ../../../CHANGELOG.md:2143
  5671. msgid ""
  5672. "(Potential Breaking Change) Monitoring/metrics support using Prometheus "
  5673. "and Grafana"
  5674. msgstr ""
  5675. #: ../../../CHANGELOG.md:2145
  5676. msgid ""
  5677. "Thanks to [@Peetz0r](https://github.com/Peetz0r), the playbook can now "
  5678. "install a bunch of tools for monitoring your Matrix server: the "
  5679. "[Prometheus](https://prometheus.io) time-series database server, the "
  5680. "Prometheus [node-exporter](https://prometheus.io/docs/guides/node-"
  5681. "exporter/) host metrics exporter, and the [Grafana](https://grafana.com/)"
  5682. " web UI."
  5683. msgstr ""
  5684. #: ../../../CHANGELOG.md:2147
  5685. msgid ""
  5686. "To get get these installed, follow our [Enabling metrics and graphs "
  5687. "(Prometheus, Grafana) for your Matrix server](docs/configuring-playbook-"
  5688. "prometheus-grafana.md) docs page."
  5689. msgstr ""
  5690. #: ../../../CHANGELOG.md:2149
  5691. msgid ""
  5692. "This update comes with a **potential breaking change** for people who "
  5693. "were already exposing Synapse metrics (for consumption via another "
  5694. "Prometheus installation). From now on, `matrix_synapse_metrics_enabled: "
  5695. "true` no longer exposes metrics publicly via matrix-nginx-proxy (at "
  5696. "`https://matrix.example.com/_synapse/metrics`). To do so, you'd need to "
  5697. "explicitly set `matrix_nginx_proxy_proxy_synapse_metrics: true`."
  5698. msgstr ""
  5699. #: ../../../CHANGELOG.md:2152
  5700. msgid "2021-01-31"
  5701. msgstr ""
  5702. #: ../../../CHANGELOG.md:2154
  5703. msgid "Etherpad support"
  5704. msgstr ""
  5705. #: ../../../CHANGELOG.md:2156
  5706. msgid ""
  5707. "Thanks to [@pushytoxin](https://github.com/pushytoxin), the playbook can "
  5708. "now install the [Etherpad](https://etherpad.org) realtime collaborative "
  5709. "text editor. It can be used in a [Jitsi](https://jitsi.org/) audio/video "
  5710. "call or integrated as a widget into Matrix chat rooms via the "
  5711. "[Dimension](https://dimension.t2bot.io) integration manager."
  5712. msgstr ""
  5713. #: ../../../CHANGELOG.md:2158
  5714. msgid ""
  5715. "To get it installed, follow [our Etherpad docs page](docs/configuring-"
  5716. "playbook-etherpad.md)."
  5717. msgstr ""
  5718. #: ../../../CHANGELOG.md:2161
  5719. msgid "2021-01-22"
  5720. msgstr ""
  5721. #: ../../../CHANGELOG.md:2163
  5722. msgid "(Breaking Change) Postgres changes that require manual intervention"
  5723. msgstr ""
  5724. #: ../../../CHANGELOG.md:2165
  5725. msgid ""
  5726. "We've made a lot of changes to our Postgres setup and some manual action "
  5727. "is required (described below). Sorry about the hassle."
  5728. msgstr ""
  5729. #: ../../../CHANGELOG.md:2167
  5730. msgid ""
  5731. "**TLDR**: people running an [external Postgres server](docs/configuring-"
  5732. "playbook-external-postgres.md) don't need to change anything for now. "
  5733. "Everyone else (the common/default case) is affected and manual "
  5734. "intervention is required."
  5735. msgstr ""
  5736. #: ../../../CHANGELOG.md:2169
  5737. msgid "Why?"
  5738. msgstr ""
  5739. #: ../../../CHANGELOG.md:2171
  5740. msgid ""
  5741. "we had a default Postgres password (`matrix_postgres_connection_password:"
  5742. " synapse-password`), which we think is **not ideal for security "
  5743. "anymore**. We now ask you to generate/provide a strong password yourself."
  5744. " Postgres is normally not exposed outside the container network, making "
  5745. "it relatively secure, but still:"
  5746. msgstr ""
  5747. #: ../../../CHANGELOG.md:2172
  5748. msgid ""
  5749. "by tweaking the configuration, you may end up intentionally or "
  5750. "unintentionally exposing your Postgres server to the local network (or "
  5751. "even publicly), while still using the default default credentials "
  5752. "(`synapse` + `synapse-password`)"
  5753. msgstr ""
  5754. #: ../../../CHANGELOG.md:2173
  5755. msgid ""
  5756. "we can't be sure we trust all these services (bridges, etc). Some of them"
  5757. " may try to talk to or attack `matrix-postgres` using the default "
  5758. "credentials (`synapse` + `synapse-password`)"
  5759. msgstr ""
  5760. #: ../../../CHANGELOG.md:2174
  5761. msgid ""
  5762. "you may have other containers running on the same Docker network, which "
  5763. "may try to talk to or attack `matrix-postgres` using the default "
  5764. "credentials (`synapse` + `synapse-password`)"
  5765. msgstr ""
  5766. #: ../../../CHANGELOG.md:2175
  5767. msgid ""
  5768. "our Postgres usage **was overly-focused on Synapse** (default username of"
  5769. " `synapse` and default/main database of `homeserver`). Additional "
  5770. "homeserver options are likely coming in the future "
  5771. "([Dendrite](https://matrix.org/docs/projects/server/dendrite), "
  5772. "[Conduit](https://matrix.org/docs/projects/server/conduit), [The "
  5773. "Construct](https://matrix.org/docs/projects/server/construct)), so being "
  5774. "too focused on `matrix-synapse` is not great. From now on, Synapse is "
  5775. "just another component of this playbook, which happens to have an "
  5776. "*additional database* (called `synapse`) on the Postgres server."
  5777. msgstr ""
  5778. #: ../../../CHANGELOG.md:2176
  5779. msgid ""
  5780. "we try to reorganize things a bit, to make the playbook even friendlier "
  5781. "to people running an [external Postgres server](docs/configuring-"
  5782. "playbook-external-postgres.md). Work on this will proceed in the future."
  5783. msgstr ""
  5784. #: ../../../CHANGELOG.md:2178
  5785. msgid ""
  5786. "So, this is some **effort to improve security** and to **prepare for a "
  5787. "brighter future of having more homeserver options** than just Synapse."
  5788. msgstr ""
  5789. #: ../../../CHANGELOG.md:2180
  5790. msgid "What has really changed?"
  5791. msgstr ""
  5792. #: ../../../CHANGELOG.md:2182
  5793. msgid ""
  5794. "the default superuser Postgres username is now `matrix` (used to be "
  5795. "`synapse`)"
  5796. msgstr ""
  5797. #: ../../../CHANGELOG.md:2183
  5798. msgid "the default Postgres database is now `matrix` (used to be `homeserver`)"
  5799. msgstr ""
  5800. #: ../../../CHANGELOG.md:2184
  5801. msgid ""
  5802. "Synapse's database is now `synapse` (used to be `homeserver`). This is "
  5803. "now just another \"additional database\" that the playbook manages for "
  5804. "you"
  5805. msgstr ""
  5806. #: ../../../CHANGELOG.md:2185
  5807. msgid ""
  5808. "Synapse's user called `synapse` is just a regular user that can only use "
  5809. "the `synapse` database (not a superuser anymore)"
  5810. msgstr ""
  5811. #: ../../../CHANGELOG.md:2187
  5812. msgid "What do I do if I'm using the integrated Postgres server (default)?"
  5813. msgstr ""
  5814. #: ../../../CHANGELOG.md:2189
  5815. msgid ""
  5816. "By default, the playbook runs an integrated Postgres server for you in a "
  5817. "container (`matrix-postgres`). Unless you've explicitly configured an "
  5818. "[external Postgres server](docs/configuring-playbook-external-"
  5819. "postgres.md), these steps are meant for you."
  5820. msgstr ""
  5821. #: ../../../CHANGELOG.md:2191
  5822. msgid ""
  5823. "To migrate to the new setup, expect a few minutes of downtime, while you "
  5824. "follow these steps:"
  5825. msgstr ""
  5826. #: ../../../CHANGELOG.md:2193
  5827. msgid ""
  5828. "We believe the steps below are safe and you won't encounter any data "
  5829. "loss, but consider [making a Postgres backup](docs/maintenance-"
  5830. "postgres.md#backing-up-postgresql) anyway. If you've never backed up "
  5831. "Postgres, now would be a good time to try it."
  5832. msgstr ""
  5833. #: ../../../CHANGELOG.md:2195
  5834. msgid ""
  5835. "Generate a strong password to be used for your superuser Postgres user "
  5836. "(called `matrix`). You can use `pwgen -s 64 1` to generate it, or some "
  5837. "other tool. The **maximum length** for a Postgres password is 100 bytes "
  5838. "(characters). Don't go crazy!"
  5839. msgstr ""
  5840. #: ../../../CHANGELOG.md:2197
  5841. msgid ""
  5842. "Update your playbook's `inventory/host_vars/matrix.example.com/vars.yml` "
  5843. "file, adding a line like this:"
  5844. msgstr ""
  5845. #: ../../../CHANGELOG.md:2202 ../../../CHANGELOG.md:2214
  5846. msgid ""
  5847. ".. where `YOUR_POSTGRES_PASSWORD_HERE` is to be replaced with the "
  5848. "password you generated during step #2."
  5849. msgstr ""
  5850. #: ../../../CHANGELOG.md:2204
  5851. msgid ""
  5852. "Stop all services: `ansible-playbook -i inventory/hosts setup.yml "
  5853. "--tags=stop`"
  5854. msgstr ""
  5855. #: ../../../CHANGELOG.md:2205
  5856. msgid "Log in to the server via SSH. The next commands will be performed there."
  5857. msgstr ""
  5858. #: ../../../CHANGELOG.md:2206
  5859. msgid "Start the Postgres database server: `systemctl start matrix-postgres`"
  5860. msgstr ""
  5861. #: ../../../CHANGELOG.md:2207
  5862. msgid "Open a Postgres shell: `/usr/local/bin/matrix-postgres-cli`"
  5863. msgstr ""
  5864. #: ../../../CHANGELOG.md:2208
  5865. msgid ""
  5866. "Execute the following query, while making sure to **change the password "
  5867. "inside** (**don't forget the ending `;`**):"
  5868. msgstr ""
  5869. #: ../../../CHANGELOG.md:2216
  5870. msgid ""
  5871. "Execute the following queries as you see them (no modifications "
  5872. "necessary, so you can just **paste them all at once**):"
  5873. msgstr ""
  5874. #: ../../../CHANGELOG.md:2234
  5875. msgid "You may need to press *Enter* after pasting the lines above."
  5876. msgstr ""
  5877. #: ../../../CHANGELOG.md:2236
  5878. msgid ""
  5879. "Re-run the playbook normally: `ansible-playbook -i inventory/hosts "
  5880. "setup.yml --tags=setup-all,start`"
  5881. msgstr ""
  5882. #: ../../../CHANGELOG.md:2238
  5883. msgid "What do I do if I'm using an external Postgres server?"
  5884. msgstr ""
  5885. #: ../../../CHANGELOG.md:2240
  5886. msgid ""
  5887. "If you've explicitly configured an [external Postgres server](docs"
  5888. "/configuring-playbook-external-postgres.md), there are **no changes** "
  5889. "that you need to do at this time."
  5890. msgstr ""
  5891. #: ../../../CHANGELOG.md:2242
  5892. msgid ""
  5893. "The fact that we've renamed Synapse's database from `homeserver` to "
  5894. "`synapse` (in our defaults) should not affect you, as you're already "
  5895. "explicitly defining `matrix_synapse_database_database` (if you've "
  5896. "followed our guide, that is). If you're not explicitly defining this "
  5897. "variable, you may wish to do so (`matrix_synapse_database_database: "
  5898. "homeserver`), to avoid the new `synapse` default and keep things as they "
  5899. "were."
  5900. msgstr ""
  5901. #: ../../../CHANGELOG.md:2245
  5902. msgid "2021-01-20"
  5903. msgstr ""
  5904. #: ../../../CHANGELOG.md:2247
  5905. msgid ""
  5906. "(Breaking Change) The mautrix-facebook bridge now requires a Postgres "
  5907. "database"
  5908. msgstr ""
  5909. #: ../../../CHANGELOG.md:2249
  5910. msgid ""
  5911. "**Update from 2021-11-15**: SQLite support has been re-added to the "
  5912. "mautrix-facebook bridge in "
  5913. "[v0.3.2](https://github.com/mautrix/facebook/releases/tag/v0.3.2). You "
  5914. "can ignore this changelog entry."
  5915. msgstr ""
  5916. #: ../../../CHANGELOG.md:2251
  5917. msgid ""
  5918. "A new version of the [mautrix-facebook](https://github.com/tulir/mautrix-"
  5919. "facebook) bridge has been released. It's a full rewrite of its backend "
  5920. "and the bridge now requires Postgres. New versions of the bridge can no "
  5921. "longer run on SQLite."
  5922. msgstr ""
  5923. #: ../../../CHANGELOG.md:2253
  5924. msgid ""
  5925. "**TLDR**: if you're NOT using an [external Postgres server](docs"
  5926. "/configuring-playbook-external-postgres.md) and have NOT forcefully kept "
  5927. "the bridge on SQLite during [The big move to all-on-Postgres (potentially"
  5928. " dangerous)](#the-big-move-to-all-on-postgres-potentially-dangerous), you"
  5929. " will be automatically upgraded without manual intervention. All you need"
  5930. " to do is send a `login` message to the Facebook bridge bot again."
  5931. msgstr ""
  5932. #: ../../../CHANGELOG.md:2255
  5933. msgid "Whether this change requires your intervention depends mostly on:"
  5934. msgstr ""
  5935. #: ../../../CHANGELOG.md:2256
  5936. msgid ""
  5937. "whether you're using an [external Postgres server](docs/configuring-"
  5938. "playbook-external-postgres.md). If yes, then [you need to do something"
  5939. "](#upgrade-path-for-people-running-an-external-postgres-server)."
  5940. msgstr ""
  5941. #: ../../../CHANGELOG.md:2257
  5942. msgid ""
  5943. "or whether you've force-changed the bridge's database engine to SQLite "
  5944. "(`matrix_mautrix_facebook_database_engine: 'sqlite'` in your `vars.yml`) "
  5945. "some time in the past (likely during [The big move to all-on-Postgres "
  5946. "(potentially dangerous)](#the-big-move-to-all-on-postgres-potentially-"
  5947. "dangerous))."
  5948. msgstr ""
  5949. #: ../../../CHANGELOG.md:2259
  5950. msgid ""
  5951. "As already mentioned above, you most likely don't need to do anything. If"
  5952. " you rerun the playbook and don't get an error, you've been automatically"
  5953. " upgraded. Just send a `login` message to the Facebook bridge bot again. "
  5954. "Otherwise, read below for a solution."
  5955. msgstr ""
  5956. #: ../../../CHANGELOG.md:2261
  5957. msgid ""
  5958. "Upgrade path for people NOT running an external Postgres server (default "
  5959. "for the playbook)"
  5960. msgstr ""
  5961. #: ../../../CHANGELOG.md:2263
  5962. msgid ""
  5963. "If you're **not running an external Postgres server**, then this bridge "
  5964. "either already works on Postgres for you, or you've intentionally kept it"
  5965. " back on SQLite with custom configuration "
  5966. "(`matrix_mautrix_facebook_database_engine: 'sqlite'` in your `vars.yml`) "
  5967. "."
  5968. msgstr ""
  5969. #: ../../../CHANGELOG.md:2265
  5970. msgid ""
  5971. "Simply remove that custom configuration from your `vars.yml` file (if "
  5972. "it's there) and re-run the playbook. It should upgrade you automatically."
  5973. " You'll need to send a `login` message to the Facebook bridge bot again."
  5974. msgstr ""
  5975. #: ../../../CHANGELOG.md:2267
  5976. msgid ""
  5977. "Alternatively, [you can stay on SQLite for a little longer](#staying-on-"
  5978. "sqlite-for-a-little-longer-temporary-solution)."
  5979. msgstr ""
  5980. #: ../../../CHANGELOG.md:2269
  5981. msgid "Upgrade path for people running an external Postgres server"
  5982. msgstr ""
  5983. #: ../../../CHANGELOG.md:2271
  5984. msgid ""
  5985. "For people using the internal Postgres server (the default for the "
  5986. "playbook):"
  5987. msgstr ""
  5988. #: ../../../CHANGELOG.md:2272
  5989. msgid ""
  5990. "we automatically create an additional `matrix_mautrix_facebook` Postgres "
  5991. "database and credentials to access it"
  5992. msgstr ""
  5993. #: ../../../CHANGELOG.md:2273
  5994. msgid ""
  5995. "we automatically adjust the bridge's `matrix_mautrix_facebook_database_*`"
  5996. " variables to point the bridge to that Postgres database"
  5997. msgstr ""
  5998. #: ../../../CHANGELOG.md:2274
  5999. msgid ""
  6000. "we use [pgloader](https://pgloader.io/) to automatically import the "
  6001. "existing SQLite data for the bridge into the `matrix_mautrix_facebook` "
  6002. "Postgres database"
  6003. msgstr ""
  6004. #: ../../../CHANGELOG.md:2276
  6005. msgid ""
  6006. "If you are using an [external Postgres server](docs/configuring-playbook-"
  6007. "external-postgres.md), unfortunately we currently can't do any of that "
  6008. "for you."
  6009. msgstr ""
  6010. #: ../../../CHANGELOG.md:2278
  6011. msgid "You have 3 ways to proceed:"
  6012. msgstr ""
  6013. #: ../../../CHANGELOG.md:2280
  6014. msgid "contribute to the playbook to make this possible (difficult)"
  6015. msgstr ""
  6016. #: ../../../CHANGELOG.md:2281
  6017. msgid "or, do the migration \"steps\" manually:"
  6018. msgstr ""
  6019. #: ../../../CHANGELOG.md:2282
  6020. msgid "stop the bridge (`systemctl stop matrix-mautrix-facebook`)"
  6021. msgstr ""
  6022. #: ../../../CHANGELOG.md:2283
  6023. msgid "create a new `matrix_mautrix_facebook` Postgres database for it"
  6024. msgstr ""
  6025. #: ../../../CHANGELOG.md:2284
  6026. msgid ""
  6027. "run [pgloader](https://pgloader.io/) manually (we import this bridge's "
  6028. "data using default settings and it works well)"
  6029. msgstr ""
  6030. #: ../../../CHANGELOG.md:2285
  6031. msgid ""
  6032. "define `matrix_mautrix_facebook_database_*` variables in your `vars.yml` "
  6033. "file (credentials, etc.) - you can find their defaults in `roles/custom"
  6034. "/matrix-mautrix-facebook/defaults/main.yml`"
  6035. msgstr ""
  6036. #: ../../../CHANGELOG.md:2286
  6037. msgid ""
  6038. "switch the bridge to Postgres (`matrix_mautrix_facebook_database_engine: "
  6039. "'postgres'` in your `vars.yml` file)"
  6040. msgstr ""
  6041. #: ../../../CHANGELOG.md:2287
  6042. msgid ""
  6043. "re-run the playbook (`--tags=setup-all,start`) and ensure the bridge "
  6044. "works (`systemctl status matrix-mautrix-facebook` and `journalctl -fu "
  6045. "matrix-mautrix-facebook`)"
  6046. msgstr ""
  6047. #: ../../../CHANGELOG.md:2288
  6048. msgid "send a `login` message to the Facebook bridge bot again"
  6049. msgstr ""
  6050. #: ../../../CHANGELOG.md:2289
  6051. msgid ""
  6052. "or, [stay on SQLite for a little longer (temporary solution)](#staying-"
  6053. "on-sqlite-for-a-little-longer-temporary-solution)"
  6054. msgstr ""
  6055. #: ../../../CHANGELOG.md:2291
  6056. msgid "Staying on SQLite for a little longer (temporary solution)"
  6057. msgstr ""
  6058. #: ../../../CHANGELOG.md:2293
  6059. msgid ""
  6060. "To keep using this bridge with SQLite for a little longer (**not "
  6061. "recommended**), use the following configuration in your `vars.yml` file:"
  6062. msgstr ""
  6063. #: ../../../CHANGELOG.md:2303
  6064. msgid ""
  6065. "If you do this, keep in mind that **you can't run this forever**. This "
  6066. "SQLite-supporting bridge version is not getting any updates and will "
  6067. "break sooner or later. The playbook will also drop support for SQLite at "
  6068. "some point in the future."
  6069. msgstr ""
  6070. #: ../../../CHANGELOG.md:2306
  6071. msgid "2021-01-17"
  6072. msgstr ""
  6073. #: ../../../CHANGELOG.md:2308
  6074. msgid "matrix-corporal goes 2.0"
  6075. msgstr ""
  6076. #: ../../../CHANGELOG.md:2310
  6077. msgid ""
  6078. "[matrix-corporal v2 has been released](https://github.com/devture/matrix-"
  6079. "corporal/releases/tag/2.0.0) and the playbook also supports it now."
  6080. msgstr ""
  6081. #: ../../../CHANGELOG.md:2312
  6082. msgid "No manual intervention is required in the common case."
  6083. msgstr ""
  6084. #: ../../../CHANGELOG.md:2314
  6085. msgid ""
  6086. "The new [matrix-corporal](https://github.com/devture/matrix-corporal) "
  6087. "version is also the first one to support Interactive Authentication. If "
  6088. "you wish to enable that (hint: you should), you'll need to set up the "
  6089. "[REST auth password provider](docs/configuring-playbook-rest-auth.md). "
  6090. "There's more information in [our matrix-corporal docs](docs/configuring-"
  6091. "playbook-matrix-corporal.md)."
  6092. msgstr ""
  6093. #: ../../../CHANGELOG.md:2317
  6094. msgid "2021-01-14"
  6095. msgstr ""
  6096. #: ../../../CHANGELOG.md:2319
  6097. msgid "Moving from cronjobs to systemd timers"
  6098. msgstr ""
  6099. #: ../../../CHANGELOG.md:2321
  6100. msgid ""
  6101. "We no longer use cronjobs for Let's Encrypt SSL renewal and `matrix-"
  6102. "nginx-proxy`/`matrix-coturn` reloading. Instead, we've switched to "
  6103. "systemd timers."
  6104. msgstr ""
  6105. #: ../../../CHANGELOG.md:2323
  6106. msgid ""
  6107. "The largest benefit of this is that we no longer require you to install a"
  6108. " cron daemon, thus simplifying our install procedure."
  6109. msgstr ""
  6110. #: ../../../CHANGELOG.md:2325
  6111. msgid ""
  6112. "The playbook will migrate you from cronjobs to systemd timers "
  6113. "automatically. This is just a heads up."
  6114. msgstr ""
  6115. #: ../../../CHANGELOG.md:2328
  6116. msgid "2021-01-08"
  6117. msgstr ""
  6118. #: ../../../CHANGELOG.md:2330
  6119. msgid "(Breaking Change) New SSL configuration"
  6120. msgstr ""
  6121. #: ../../../CHANGELOG.md:2332
  6122. msgid ""
  6123. "SSL configuration (protocols, ciphers) can now be more easily controlled "
  6124. "thanks to us making use of configuration presets."
  6125. msgstr ""
  6126. #: ../../../CHANGELOG.md:2334
  6127. msgid ""
  6128. "We define a few presets (old, intermediate, modern), following the "
  6129. "[Mozilla SSL Configuration Generator](https://ssl-"
  6130. "config.mozilla.org/#server=nginx)."
  6131. msgstr ""
  6132. #: ../../../CHANGELOG.md:2336
  6133. msgid ""
  6134. "A new variable `matrix_nginx_proxy_ssl_preset` controls which preset is "
  6135. "used (defaults to `\"intermediate\"`)."
  6136. msgstr ""
  6137. #: ../../../CHANGELOG.md:2338
  6138. msgid ""
  6139. "Compared to before, this changes nginx's `ssl_prefer_server_ciphers` to "
  6140. "`off` (used to default to `on`). It also add some more ciphers to the "
  6141. "list, giving better performance on mobile devices, and removes some weak "
  6142. "ciphers. More information in the [documentation](docs/configuring-"
  6143. "playbook-nginx.md)."
  6144. msgstr ""
  6145. #: ../../../CHANGELOG.md:2340
  6146. msgid "To revert to the old behaviour, set the following variables:"
  6147. msgstr ""
  6148. #: ../../../CHANGELOG.md:2347
  6149. msgid ""
  6150. "Just like before, you can still use your own custom protocols by "
  6151. "specifying them in `matrix_nginx_proxy_ssl_protocols`. Doing so overrides"
  6152. " the values coming from the preset."
  6153. msgstr ""
  6154. #: ../../../CHANGELOG.md:2350
  6155. msgid "2021-01-03"
  6156. msgstr ""
  6157. #: ../../../CHANGELOG.md:2352
  6158. msgid "Signal bridging support via mautrix-signal"
  6159. msgstr ""
  6160. #: ../../../CHANGELOG.md:2354
  6161. msgid ""
  6162. "Thanks to [laszabine](https://github.com/laszabine)'s efforts, the "
  6163. "playbook now supports bridging to [Signal](https://www.signal.org/) via "
  6164. "the [mautrix-signal](https://github.com/tulir/mautrix-signal) bridge. See"
  6165. " our [Setting up Mautrix Signal bridging](docs/configuring-playbook-"
  6166. "bridge-mautrix-signal.md) documentation page for getting started."
  6167. msgstr ""
  6168. #: ../../../CHANGELOG.md:2356
  6169. msgid ""
  6170. "If you had installed the mautrix-signal bridge while its Pull Request was"
  6171. " still work-in-progress, you can migrate your data to the new and final "
  6172. "setup by referring to [this comment](https://github.com/spantaleev"
  6173. "/matrix-docker-ansible-deploy/pull/686#issuecomment-753510789)."
  6174. msgstr ""
  6175. #: ../../../CHANGELOG.md:2359
  6176. msgid "2020-12-23"
  6177. msgstr ""
  6178. #: ../../../CHANGELOG.md:2361
  6179. msgid "The big move to all-on-Postgres (potentially dangerous)"
  6180. msgstr ""
  6181. #: ../../../CHANGELOG.md:2363
  6182. msgid ""
  6183. "**TLDR**: all your bridges (and other services) will likely be auto-"
  6184. "migrated from SQLite/nedb to Postgres, hopefully without trouble. You can"
  6185. " opt-out (see how below), if too worried about breakage."
  6186. msgstr ""
  6187. #: ../../../CHANGELOG.md:2365
  6188. msgid ""
  6189. "Until now, we've only used Postgres as a database for Synapse. All other "
  6190. "services (bridges, bots, etc.) were kept simple and used a file-based "
  6191. "database (SQLite or nedb)."
  6192. msgstr ""
  6193. #: ../../../CHANGELOG.md:2367
  6194. msgid ""
  6195. "Since [this huge pull request](https://github.com/spantaleev/matrix-"
  6196. "docker-ansible-deploy/pull/740), **all of our services now use Postgres "
  6197. "by default**. Thanks to [Johanna Dorothea "
  6198. "Reichmann](https://github.com/jdreichmann) for starting the work on it "
  6199. "and for providing great input!"
  6200. msgstr ""
  6201. #: ../../../CHANGELOG.md:2369
  6202. msgid "Moving all services to Postgres brings a few **benefits** to us:"
  6203. msgstr ""
  6204. #: ../../../CHANGELOG.md:2371
  6205. msgid "**improved performance**"
  6206. msgstr ""
  6207. #: ../../../CHANGELOG.md:2372
  6208. msgid ""
  6209. "**improved compatibility**. Most bridges are deprecating SQLite/nedb "
  6210. "support or offer less features when not on Postgres."
  6211. msgstr ""
  6212. #: ../../../CHANGELOG.md:2373
  6213. msgid ""
  6214. "**easier backups**. It's still some effort to take a proper backup "
  6215. "(Postgres dump + various files, keys), but a Postgres dump now takes you "
  6216. "much further."
  6217. msgstr ""
  6218. #: ../../../CHANGELOG.md:2374
  6219. msgid ""
  6220. "we're now **more prepared to introduce other services** that need a "
  6221. "Postgres database - [Dendrite](https://github.com/matrix-org/dendrite), "
  6222. "the [mautrix-signal](https://github.com/tulir/mautrix-signal) bridge "
  6223. "(existing [pull request](https://github.com/spantaleev/matrix-docker-"
  6224. "ansible-deploy/pull/686)), etc."
  6225. msgstr ""
  6226. #: ../../../CHANGELOG.md:2376
  6227. msgid "Key takeway"
  6228. msgstr ""
  6229. #: ../../../CHANGELOG.md:2378
  6230. msgid ""
  6231. "existing installations that use an [external "
  6232. "Postgres](https://github.com/spantaleev/matrix-docker-ansible-"
  6233. "deploy/blob/master/docs/configuring-playbook-external-postgres.md) server"
  6234. " should be unaffected (they remain on SQLite/nedb for all services, "
  6235. "except Synapse)"
  6236. msgstr ""
  6237. #: ../../../CHANGELOG.md:2380
  6238. msgid ""
  6239. "for existing installations which use our integrated Postgres database "
  6240. "server (`matrix-postgres`, which is the default), **we automatically "
  6241. "migrate data** from SQLite/nedb to Postgres and **archive the database "
  6242. "files** (`something.db` -> `something.db.backup`), so you can restore "
  6243. "them if you need to go back (see how below)."
  6244. msgstr ""
  6245. #: ../../../CHANGELOG.md:2382
  6246. msgid "Opting-out of the Postgres migration"
  6247. msgstr ""
  6248. #: ../../../CHANGELOG.md:2384
  6249. msgid ""
  6250. "This is a **very large and somewhat untested change** (potentially "
  6251. "dangerous), so **if you're not feeling confident/experimental, opt-out** "
  6252. "of it for now. Still, it's the new default and what we (and various "
  6253. "bridges) will focus on going forward, so don't stick to old ways for too "
  6254. "long."
  6255. msgstr ""
  6256. #: ../../../CHANGELOG.md:2386
  6257. msgid ""
  6258. "You can remain on SQLite/nedb (at least for now) by adding a variable "
  6259. "like this to your `vars.yml` file for each service you use: "
  6260. "`matrix_COMPONENT_database_engine: sqlite` (e.g. "
  6261. "`matrix_mautrix_facebook_database_engine: sqlite`)."
  6262. msgstr ""
  6263. #: ../../../CHANGELOG.md:2388
  6264. msgid ""
  6265. "Some services (like `appservice-irc` and `appservice-slack`) don't use "
  6266. "SQLite, so use `nedb`, instead of `sqlite` for them."
  6267. msgstr ""
  6268. #: ../../../CHANGELOG.md:2390
  6269. msgid "Going back to SQLite/nedb if things went wrong"
  6270. msgstr ""
  6271. #: ../../../CHANGELOG.md:2392
  6272. msgid ""
  6273. "If you went with the Postgres migration and it went badly for you (some "
  6274. "bridge not working as expected or not working at all), do this:"
  6275. msgstr ""
  6276. #: ../../../CHANGELOG.md:2394
  6277. msgid ""
  6278. "stop all services (`ansible-playbook -i inventory/hosts setup.yml "
  6279. "--tags=stop`)"
  6280. msgstr ""
  6281. #: ../../../CHANGELOG.md:2395
  6282. msgid ""
  6283. "SSH into the server and rename the old database files "
  6284. "(`something.db.backup` -> `something.db`). Example: `mv /matrix/mautrix-"
  6285. "facebook/data/mautrix-facebook.db.backup /matrix/mautrix-facebook/data"
  6286. "/mautrix-facebook.db`"
  6287. msgstr ""
  6288. #: ../../../CHANGELOG.md:2396
  6289. msgid ""
  6290. "switch the affected service back to SQLite (e.g. "
  6291. "`matrix_mautrix_facebook_database_engine: sqlite`). Some services (like "
  6292. "`appservice-irc` and `appservice-slack`) don't use SQLite, so use `nedb`,"
  6293. " instead of `sqlite` for them."
  6294. msgstr ""
  6295. #: ../../../CHANGELOG.md:2397
  6296. msgid ""
  6297. "re-run the playbook (`ansible-playbook -i inventory/hosts setup.yml "
  6298. "--tags=setup-all,start`)"
  6299. msgstr ""
  6300. #: ../../../CHANGELOG.md:2398
  6301. msgid "[get in touch](README.md#support) with us"
  6302. msgstr ""
  6303. #: ../../../CHANGELOG.md:2400
  6304. msgid "2020-12-11"
  6305. msgstr ""
  6306. #: ../../../CHANGELOG.md:2402
  6307. msgid "synapse-janitor support removed"
  6308. msgstr ""
  6309. #: ../../../CHANGELOG.md:2404
  6310. msgid ""
  6311. "We've removed support for the unmaintained [synapse-"
  6312. "janitor](https://github.com/xwiki-labs/synapse_scripts) script. There's "
  6313. "been past reports of it corrupting the Synapse database. Since there "
  6314. "hasn't been any new development on it and it doesn't seem too useful "
  6315. "nowadays, there's no point in including it in the playbook."
  6316. msgstr ""
  6317. #: ../../../CHANGELOG.md:2406
  6318. msgid ""
  6319. "If you need to clean up or compact your database, consider using the "
  6320. "Synapse Admin APIs directly. See our [Synapse maintenance](docs"
  6321. "/maintenance-synapse.md) and [Postgres maintenance](docs/maintenance-"
  6322. "postgres.md) documentation pages for more details."
  6323. msgstr ""
  6324. #: ../../../CHANGELOG.md:2408
  6325. msgid "Docker 20.10 is here"
  6326. msgstr ""
  6327. #: ../../../CHANGELOG.md:2410
  6328. msgid ""
  6329. "(No need to do anything special in relation to this. Just something to "
  6330. "keep in mind)"
  6331. msgstr ""
  6332. #: ../../../CHANGELOG.md:2412
  6333. msgid ""
  6334. "Docker 20.10 got released recently and your server will likely get it the"
  6335. " next time you update."
  6336. msgstr ""
  6337. #: ../../../CHANGELOG.md:2414
  6338. msgid ""
  6339. "This is the first major Docker update in a long time and it packs a lot "
  6340. "of changes. Some of them introduced some breakage for us initially (see "
  6341. "[here](https://github.com/spantaleev/matrix-docker-ansible-"
  6342. "deploy/commit/d08b27784f222effcbce2abf924bf07bbe0893be) and "
  6343. "[here](https://github.com/spantaleev/matrix-docker-ansible-"
  6344. "deploy/commit/7593d969e316cc0144bce378a5be58c76c2c37ee)), but it should "
  6345. "be all good now."
  6346. msgstr ""
  6347. #: ../../../CHANGELOG.md:2417
  6348. msgid "2020-12-08"
  6349. msgstr ""
  6350. #: ../../../CHANGELOG.md:2419
  6351. msgid ""
  6352. "openid APIs exposed by default on the federation port when federation "
  6353. "disabled"
  6354. msgstr ""
  6355. #: ../../../CHANGELOG.md:2421
  6356. msgid ""
  6357. "We've changed some defaults. People running with our default "
  6358. "configuration (federation enabled), are not affected at all."
  6359. msgstr ""
  6360. #: ../../../CHANGELOG.md:2423
  6361. msgid ""
  6362. "If you are running an unfederated server "
  6363. "(`matrix_synapse_federation_enabled: false`), this may be of interest to "
  6364. "you."
  6365. msgstr ""
  6366. #: ../../../CHANGELOG.md:2425
  6367. msgid ""
  6368. "When federation is disabled, but ma1sd or Dimension are enabled, we'll "
  6369. "now expose the `openid` APIs on the federation port. These APIs are "
  6370. "necessary for some ma1sd features to work. If you'd like to prevent this,"
  6371. " you can: `matrix_synapse_federation_port_openid_resource_required: "
  6372. "false`."
  6373. msgstr ""
  6374. #: ../../../CHANGELOG.md:2428
  6375. msgid "2020-11-27"
  6376. msgstr ""
  6377. #: ../../../CHANGELOG.md:2430
  6378. msgid "Recent Jitsi updates may require configuration changes"
  6379. msgstr ""
  6380. #: ../../../CHANGELOG.md:2432
  6381. msgid ""
  6382. "We've recently [updated from Jitsi build 4857 to build "
  6383. "5142](https://github.com/spantaleev/matrix-docker-ansible-"
  6384. "deploy/pull/719), which brings a lot of configuration changes."
  6385. msgstr ""
  6386. #: ../../../CHANGELOG.md:2434
  6387. msgid "**If you use our default Jitsi settings, you won't have to do anything.**"
  6388. msgstr ""
  6389. #: ../../../CHANGELOG.md:2436
  6390. msgid ""
  6391. "People who have [fine-tuned Jitsi](docs/configuring-playbook-jitsi.md"
  6392. "#optional-fine-tune-jitsi) may find that some options got renamed now, "
  6393. "others are gone and yet others still need to be defined in another way."
  6394. msgstr ""
  6395. #: ../../../CHANGELOG.md:2438
  6396. msgid ""
  6397. "The next time you run the playbook [installation](docs/installing.md) "
  6398. "command, our validation logic will tell you if you're using some "
  6399. "variables like that and will recommend a migration path for each one."
  6400. msgstr ""
  6401. #: ../../../CHANGELOG.md:2440
  6402. msgid ""
  6403. "Additionally, we've recently disabled transcriptions "
  6404. "(`jitsi_enable_transcriptions: false`) and recording "
  6405. "(`jitsi_enable_recording: false`) by default. These features did not work"
  6406. " anyway, because we don't install the required dependencies for them "
  6407. "(Jigasi and Jibri, respectively). If you've been somehow pointing your "
  6408. "Jitsi installation to some manually installed Jigasi/Jibri service, you "
  6409. "may need to toggle these flags back to enabled to have transcriptions and"
  6410. " recordings working."
  6411. msgstr ""
  6412. #: ../../../CHANGELOG.md:2443
  6413. msgid "2020-11-23"
  6414. msgstr ""
  6415. #: ../../../CHANGELOG.md:2445 ../../../CHANGELOG.md:2453
  6416. msgid "Breaking change matrix-sms-bridge"
  6417. msgstr ""
  6418. #: ../../../CHANGELOG.md:2447
  6419. msgid ""
  6420. "Because of many problems using gammu as SMS provider, matrix-sms-bridge "
  6421. "now uses (https://github.com/RebekkaMa/android-sms-gateway-server) by "
  6422. "default. See (the docs)[./docs/configuring-playbook-bridge-matrix-bridge-"
  6423. "sms.md] which new vars you need to add."
  6424. msgstr ""
  6425. #: ../../../CHANGELOG.md:2449
  6426. msgid ""
  6427. "If you are using this playbook to deploy matrix-sms-bridge and still "
  6428. "really want to use gammu as SMS provider, we could possibly add support "
  6429. "for both android-sms-gateway-server and gammu."
  6430. msgstr ""
  6431. #: ../../../CHANGELOG.md:2451
  6432. msgid "2020-11-13"
  6433. msgstr ""
  6434. #: ../../../CHANGELOG.md:2455
  6435. msgid ""
  6436. "The new version of [matrix-sms-bridge](https://github.com/benkuly/matrix-"
  6437. "sms-bridge) changed its database from neo4j to h2. You need to sync the "
  6438. "bridge at the first start. Note that this only will sync rooms where the "
  6439. "@smsbot:yourServer is member. For rooms without @smsbot:yourServer you "
  6440. "need to kick and invite the telephone number **or** invite "
  6441. "@smsbot:yourServer."
  6442. msgstr ""
  6443. #: ../../../CHANGELOG.md:2457
  6444. msgid ""
  6445. "Add the following to your `vars.yml` file: "
  6446. "`matrix_sms_bridge_container_extra_arguments=['--env "
  6447. "SPRING_PROFILES_ACTIVE=initialsync']`"
  6448. msgstr ""
  6449. #: ../../../CHANGELOG.md:2458
  6450. msgid ""
  6451. "Login to your host shell and remove old systemd file from your host: `rm "
  6452. "/etc/systemd/system/matrix-sms-bridge-database.service`"
  6453. msgstr ""
  6454. #: ../../../CHANGELOG.md:2459
  6455. msgid ""
  6456. "Run `ansible-playbook -i inventory/hosts setup.yml --tags=setup-matrix-"
  6457. "sms-bridge,start`"
  6458. msgstr ""
  6459. #: ../../../CHANGELOG.md:2460
  6460. msgid ""
  6461. "Login to your host shell and check the logs with `journalctl -u matrix-"
  6462. "sms-bridge` until the sync finished."
  6463. msgstr ""
  6464. #: ../../../CHANGELOG.md:2461
  6465. msgid "Remove the var from the first step."
  6466. msgstr ""
  6467. #: ../../../CHANGELOG.md:2462
  6468. msgid ""
  6469. "Run `ansible-playbook -i inventory/hosts setup.yml --tags=setup-"
  6470. "all,start`."
  6471. msgstr ""
  6472. #: ../../../CHANGELOG.md:2464
  6473. msgid "2020-11-10"
  6474. msgstr ""
  6475. #: ../../../CHANGELOG.md:2466
  6476. msgid "Dynamic DNS support"
  6477. msgstr ""
  6478. #: ../../../CHANGELOG.md:2468
  6479. msgid ""
  6480. "Thanks to [Scott Crossen](https://github.com/scottcrossen), the playbook "
  6481. "can now manage Dynamic DNS for you using "
  6482. "[ddclient](https://ddclient.net/)."
  6483. msgstr ""
  6484. #: ../../../CHANGELOG.md:2470
  6485. msgid ""
  6486. "To learn more, follow our [Dynamic DNS docs page](docs/configuring-"
  6487. "playbook-dynamic-dns.md)."
  6488. msgstr ""
  6489. #: ../../../CHANGELOG.md:2473
  6490. msgid "2020-10-28"
  6491. msgstr ""
  6492. #: ../../../CHANGELOG.md:2475
  6493. msgid ""
  6494. "(Compatibility Break) https://matrix.example.com/ now redirects to "
  6495. "https://element.example.com/"
  6496. msgstr ""
  6497. #: ../../../CHANGELOG.md:2477
  6498. msgid ""
  6499. "Until now, we used to serve a static page coming from Synapse at "
  6500. "`https://matrix.example.com/`. This page was not very useful to anyone."
  6501. msgstr ""
  6502. #: ../../../CHANGELOG.md:2479
  6503. msgid ""
  6504. "Since `matrix.example.com` may be accessed by regular users in certain "
  6505. "conditions, it's probably better to redirect them to a better place (e.g."
  6506. " to [Element Web](docs/configuring-playbook-client-element-web.md))."
  6507. msgstr ""
  6508. #: ../../../CHANGELOG.md:2481
  6509. msgid ""
  6510. "If Element Web is installed (`matrix_client_element_enabled: true`, which"
  6511. " it is by default), we now redirect people to it, instead of showing them"
  6512. " a Synapse static page."
  6513. msgstr ""
  6514. #: ../../../CHANGELOG.md:2483
  6515. msgid ""
  6516. "If you'd like to control where the redirect goes, use the "
  6517. "`matrix_nginx_proxy_proxy_matrix_client_redirect_root_uri_to_domain` "
  6518. "variable. To restore the old behavior of not redirecting anywhere and "
  6519. "serving the Synapse static page, set it to an empty value "
  6520. "(`matrix_nginx_proxy_proxy_matrix_client_redirect_root_uri_to_domain: "
  6521. "\"\"`)."
  6522. msgstr ""
  6523. #: ../../../CHANGELOG.md:2486
  6524. msgid "2020-10-26"
  6525. msgstr ""
  6526. #: ../../../CHANGELOG.md:2488
  6527. msgid ""
  6528. "(Compatibility Break) /_synapse/admin is no longer publicly exposed by "
  6529. "default"
  6530. msgstr ""
  6531. #: ../../../CHANGELOG.md:2490
  6532. msgid ""
  6533. "We used to expose the Synapse Admin APIs publicly (at "
  6534. "`https://matrix.example.com/_synapse/admin`). These APIs require "
  6535. "authentication with a valid access token, so it's not that big a deal to "
  6536. "expose them."
  6537. msgstr ""
  6538. #: ../../../CHANGELOG.md:2492
  6539. msgid ""
  6540. "However, following [official Synapse's reverse-proxying "
  6541. "recommendations](https://github.com/element-"
  6542. "hq/synapse/blob/master/docs/reverse_proxy.md#synapse-administration-"
  6543. "endpoints), we're no longer exposing `/_synapse/admin` by default."
  6544. msgstr ""
  6545. #: ../../../CHANGELOG.md:2494
  6546. msgid ""
  6547. "If you'd like to restore restore the old behavior and expose "
  6548. "`/_synapse/admin` publicly, you can use the following configuration (in "
  6549. "your `vars.yml`):"
  6550. msgstr ""
  6551. #: ../../../CHANGELOG.md:2501
  6552. msgid "2020-10-02"
  6553. msgstr ""
  6554. #: ../../../CHANGELOG.md:2503
  6555. msgid "Minimum Ansible version raised to v2.7.0"
  6556. msgstr ""
  6557. #: ../../../CHANGELOG.md:2505
  6558. msgid ""
  6559. "We were claiming to support [Ansible](https://www.ansible.com/) v2.5.2 "
  6560. "and higher, but issues like [#662](https://github.com/spantaleev/matrix-"
  6561. "docker-ansible-deploy/issues/662) demonstrate that we need at least "
  6562. "v2.7.0."
  6563. msgstr ""
  6564. #: ../../../CHANGELOG.md:2507
  6565. msgid ""
  6566. "If you've been using the playbook without getting any errors until now, "
  6567. "you're probably on a version higher than that already (or you're not "
  6568. "using the `matrix-ma1sd` and `matrix-client-element` roles)."
  6569. msgstr ""
  6570. #: ../../../CHANGELOG.md:2509
  6571. msgid ""
  6572. "Our [Ansible docs page](docs/ansible.md) contains information on how to "
  6573. "run a more up-to-date version of Ansible."
  6574. msgstr ""
  6575. #: ../../../CHANGELOG.md:2512
  6576. msgid "2020-10-01"
  6577. msgstr ""
  6578. #: ../../../CHANGELOG.md:2514
  6579. msgid "Postgres 13 support"
  6580. msgstr ""
  6581. #: ../../../CHANGELOG.md:2516
  6582. msgid ""
  6583. "The playbook now installs [Postgres "
  6584. "13](https://www.postgresql.org/about/news/postgresql-13-released-2077/) "
  6585. "by default."
  6586. msgstr ""
  6587. #: ../../../CHANGELOG.md:2518
  6588. msgid ""
  6589. "If you have have an existing setup, it's likely running on an older "
  6590. "Postgres version (9.x, 10.x, 11.x or 12.x). You can easily upgrade by "
  6591. "following the [upgrading PostgreSQL guide](docs/maintenance-postgres.md"
  6592. "#upgrading-postgresql)."
  6593. msgstr ""
  6594. #: ../../../CHANGELOG.md:2520
  6595. msgid "2020-09-01"
  6596. msgstr ""
  6597. #: ../../../CHANGELOG.md:2522
  6598. msgid "matrix-registration support"
  6599. msgstr ""
  6600. #: ../../../CHANGELOG.md:2524
  6601. msgid ""
  6602. "The playbook can now help you set up [matrix-"
  6603. "registration](https://github.com/ZerataX/matrix-registration) - an "
  6604. "application that lets you keep your Matrix server's registration private,"
  6605. " but still allow certain users (those having a unique registration link) "
  6606. "to register by themselves."
  6607. msgstr ""
  6608. #: ../../../CHANGELOG.md:2526
  6609. msgid ""
  6610. "See our [Setting up matrix-registration](docs/configuring-playbook-"
  6611. "matrix-registration.md) documentation page to get started."
  6612. msgstr ""
  6613. #: ../../../CHANGELOG.md:2529
  6614. msgid "2020-08-21"
  6615. msgstr ""
  6616. #: ../../../CHANGELOG.md:2531
  6617. msgid "rust-synapse-compress-state support"
  6618. msgstr ""
  6619. #: ../../../CHANGELOG.md:2533
  6620. msgid ""
  6621. "The playbook can now help you use [rust-synapse-compress-"
  6622. "state](https://github.com/matrix-org/rust-synapse-compress-state) to "
  6623. "compress the state groups in your Synapse database."
  6624. msgstr ""
  6625. #: ../../../CHANGELOG.md:2535
  6626. msgid ""
  6627. "See our [Compressing state with rust-synapse-compress-state](docs"
  6628. "/maintenance-synapse.md#compressing-state-with-rust-synapse-compress-"
  6629. "state) documentation page to get started."
  6630. msgstr ""
  6631. #: ../../../CHANGELOG.md:2538
  6632. msgid "2020-07-22"
  6633. msgstr ""
  6634. #: ../../../CHANGELOG.md:2540
  6635. msgid "Synapse Admin support"
  6636. msgstr ""
  6637. #: ../../../CHANGELOG.md:2542
  6638. msgid ""
  6639. "The playbook can now help you set up [synapse-admin](https://github.com"
  6640. "/Awesome-Technologies/synapse-admin)."
  6641. msgstr ""
  6642. #: ../../../CHANGELOG.md:2544
  6643. msgid ""
  6644. "See our [Setting up Synapse Admin](docs/configuring-playbook-synapse-"
  6645. "admin.md) documentation to get started."
  6646. msgstr ""
  6647. #: ../../../CHANGELOG.md:2547
  6648. msgid "2020-07-20"
  6649. msgstr ""
  6650. #: ../../../CHANGELOG.md:2549
  6651. msgid "matrix-reminder-bot support"
  6652. msgstr ""
  6653. #: ../../../CHANGELOG.md:2551
  6654. msgid ""
  6655. "The playbook can now help you set up [matrix-reminder-"
  6656. "bot](https://github.com/anoadragon453/matrix-reminder-bot)."
  6657. msgstr ""
  6658. #: ../../../CHANGELOG.md:2553
  6659. msgid ""
  6660. "See our [Setting up matrix-reminder-bot](docs/configuring-playbook-bot-"
  6661. "matrix-reminder-bot.md) documentation to get started."
  6662. msgstr ""
  6663. #: ../../../CHANGELOG.md:2556
  6664. msgid "2020-07-17"
  6665. msgstr ""
  6666. #: ../../../CHANGELOG.md:2558
  6667. msgid "(Compatibility Break) Riot is now Element"
  6668. msgstr ""
  6669. #: ../../../CHANGELOG.md:2560
  6670. msgid ""
  6671. "As per the official announcement, [Riot has been rebraned to "
  6672. "Element](https://element.io/blog/welcome-to-element/)."
  6673. msgstr ""
  6674. #: ../../../CHANGELOG.md:2562
  6675. msgid ""
  6676. "The playbook follows suit. Existing installations have a few options for "
  6677. "how to handle this."
  6678. msgstr ""
  6679. #: ../../../CHANGELOG.md:2564
  6680. msgid ""
  6681. "See our [Migrating to Element Web](docs/configuring-playbook-riot-web.md"
  6682. "#migrating-to-element) documentation page for more details."
  6683. msgstr ""
  6684. #: ../../../CHANGELOG.md:2567
  6685. msgid "2020-07-03"
  6686. msgstr ""
  6687. #: ../../../CHANGELOG.md:2569
  6688. msgid "Steam bridging support via mx-puppet-steam"
  6689. msgstr ""
  6690. #: ../../../CHANGELOG.md:2571
  6691. msgid ""
  6692. "Thanks to [Hugues Morisset](https://github.com/izissise)'s efforts, the "
  6693. "playbook now supports bridging to [Steam](https://steamapp.com/) via the "
  6694. "[mx-puppet-steam](https://github.com/icewind1991/mx-puppet-steam) bridge."
  6695. " See our [Setting up MX Puppet Steam bridging](docs/configuring-playbook-"
  6696. "bridge-mx-puppet-steam.md) documentation page for getting started."
  6697. msgstr ""
  6698. #: ../../../CHANGELOG.md:2574
  6699. msgid "2020-07-01"
  6700. msgstr ""
  6701. #: ../../../CHANGELOG.md:2576
  6702. msgid "Discord bridging support via mx-puppet-discord"
  6703. msgstr ""
  6704. #: ../../../CHANGELOG.md:2578
  6705. msgid ""
  6706. "Thanks to [Hugues Morisset](https://github.com/izissise)'s efforts, the "
  6707. "playbook now supports bridging to [Discord](https://discordapp.com/) via "
  6708. "the [mx-puppet-discord](https://github.com/Sorunome/mx-puppet-discord) "
  6709. "bridge. See our [Setting up MX Puppet Discord bridging](docs/configuring-"
  6710. "playbook-bridge-mx-puppet-discord.md) documentation page for getting "
  6711. "started."
  6712. msgstr ""
  6713. #: ../../../CHANGELOG.md:2580
  6714. msgid ""
  6715. "**Note**: this is a new Discord bridge. The playbook still retains "
  6716. "Discord bridging via [matrix-appservice-discord](docs/configuring-"
  6717. "playbook-bridge-appservice-discord.md). You're free too use the bridge "
  6718. "that serves you better, or even both (for different users and use-cases)."
  6719. msgstr ""
  6720. #: ../../../CHANGELOG.md:2583
  6721. msgid "2020-06-30"
  6722. msgstr ""
  6723. #: ../../../CHANGELOG.md:2585
  6724. msgid "Instagram and Twitter bridging support"
  6725. msgstr ""
  6726. #: ../../../CHANGELOG.md:2587
  6727. msgid ""
  6728. "Thanks to [Johanna Dorothea Reichmann](https://github.com/jdreichmann)'s "
  6729. "efforts, the playbook now supports bridging to "
  6730. "[Instagram](https://www.instagram.com/) via the [mx-puppet-"
  6731. "instagram](https://github.com/Sorunome/mx-puppet-instagram) bridge. See "
  6732. "our [Setting up MX Puppet Instagram bridging](docs/configuring-playbook-"
  6733. "bridge-mx-puppet-instagram.md) documentation page for getting started."
  6734. msgstr ""
  6735. #: ../../../CHANGELOG.md:2589
  6736. msgid ""
  6737. "Thanks to [Tulir Asokan](https://github.com/tulir)'s efforts, the "
  6738. "playbook now supports bridging to [Twitter](https://twitter.com/) via the"
  6739. " [mx-puppet-twitter](https://github.com/Sorunome/mx-puppet-twitter) "
  6740. "bridge. See our [Setting up MX Puppet Twitter bridging](docs/configuring-"
  6741. "playbook-bridge-mx-puppet-twitter.md) documentation page for getting "
  6742. "started."
  6743. msgstr ""
  6744. #: ../../../CHANGELOG.md:2592
  6745. msgid "2020-06-28"
  6746. msgstr ""
  6747. #: ../../../CHANGELOG.md:2594
  6748. msgid ""
  6749. "(Post Mortem / fixed Security Issue) Re-enabling User Directory search "
  6750. "powered by the ma1sd Identity Server"
  6751. msgstr ""
  6752. #: ../../../CHANGELOG.md:2596 ../../../CHANGELOG.md:2625
  6753. msgid ""
  6754. "User Directory search requests used to go to the ma1sd identity server by"
  6755. " default, which queried its own stores and the Synapse database."
  6756. msgstr ""
  6757. #: ../../../CHANGELOG.md:2598
  6758. msgid ""
  6759. "ma1sd's [security issue](https://github.com/ma1uta/ma1sd/issues/44) has "
  6760. "been fixed in version `2.4.0`, with [this "
  6761. "commit](ma1uta/ma1sd@2bb5a734d11662b06471113cf3d6b4cee5e33a85). `ma1sd "
  6762. "2.4.0` is now the default version for this playbook. For more information"
  6763. " on what happened, please check the mentioned issue."
  6764. msgstr ""
  6765. #: ../../../CHANGELOG.md:2600
  6766. msgid ""
  6767. "We are re-enabling user directory search with this update. Those who "
  6768. "would like to keep it disabled can use this configuration: "
  6769. "`matrix_nginx_proxy_proxy_matrix_user_directory_search_enabled: false`"
  6770. msgstr ""
  6771. #: ../../../CHANGELOG.md:2602
  6772. msgid "As always, re-running the playbook is enough to get the updated bits."
  6773. msgstr ""
  6774. #: ../../../CHANGELOG.md:2604
  6775. msgid "2020-06-11"
  6776. msgstr ""
  6777. #: ../../../CHANGELOG.md:2606
  6778. msgid "SMS bridging requires db reset"
  6779. msgstr ""
  6780. #: ../../../CHANGELOG.md:2608
  6781. msgid ""
  6782. "The current version of [matrix-sms-bridge](https://github.com/benkuly"
  6783. "/matrix-sms-bridge) needs you to delete the database to work as expected."
  6784. " Just remove `/matrix/matrix-sms-bridge/database/*`. It also adds a new "
  6785. "requried var `matrix_sms_bridge_default_region`."
  6786. msgstr ""
  6787. #: ../../../CHANGELOG.md:2610
  6788. msgid ""
  6789. "To reuse your existing rooms, invite `@smsbot:yourServer` to the room or "
  6790. "write a message. You are also able to use automated room creation with "
  6791. "telephonenumers by writing `sms send -t 01749292923 \"Hello World\"` in a"
  6792. " room with `@smsbot:yourServer`. See [the "
  6793. "docs](https://github.com/benkuly/matrix-sms-bridge) for more information."
  6794. msgstr ""
  6795. #: ../../../CHANGELOG.md:2612
  6796. msgid "2020-06-05"
  6797. msgstr ""
  6798. #: ../../../CHANGELOG.md:2614
  6799. msgid "SMS bridging support"
  6800. msgstr ""
  6801. #: ../../../CHANGELOG.md:2616
  6802. msgid ""
  6803. "Thanks to [benkuly](https://github.com/benkuly)'s efforts, the playbook "
  6804. "now supports bridging to SMS (with one telephone number only) via "
  6805. "[matrix-sms-bridge](https://github.com/benkuly/matrix-sms-bridge)."
  6806. msgstr ""
  6807. #: ../../../CHANGELOG.md:2618
  6808. msgid ""
  6809. "See our [Setting up Matrix SMS bridging](docs/configuring-playbook-"
  6810. "bridge-matrix-bridge-sms.md) documentation page for getting started."
  6811. msgstr ""
  6812. #: ../../../CHANGELOG.md:2621
  6813. msgid "2020-05-19"
  6814. msgstr ""
  6815. #: ../../../CHANGELOG.md:2623
  6816. msgid ""
  6817. "(Compatibility Break / Security Issue) Disabling User Directory search "
  6818. "powered by the ma1sd Identity Server"
  6819. msgstr ""
  6820. #: ../../../CHANGELOG.md:2627
  6821. msgid ""
  6822. "ma1sd current has [a security "
  6823. "issue](https://github.com/ma1uta/ma1sd/issues/44), which made it leak "
  6824. "information about all users - including users created by bridges, etc."
  6825. msgstr ""
  6826. #: ../../../CHANGELOG.md:2629
  6827. msgid ""
  6828. "Until the issue gets fixed, we're making User Directory search not go to "
  6829. "ma1sd by default. You **need to re-run the playbook and restart services "
  6830. "to apply this workaround**."
  6831. msgstr ""
  6832. #: ../../../CHANGELOG.md:2631
  6833. msgid ""
  6834. "*If you insist on restoring the old behavior* (**which has a security "
  6835. "issue!**), you *might* use this configuration: "
  6836. "`matrix_nginx_proxy_proxy_matrix_user_directory_search_enabled: \"{{ "
  6837. "matrix_ma1sd_enabled }}\"`"
  6838. msgstr ""
  6839. #: ../../../CHANGELOG.md:2634
  6840. msgid "2020-04-28"
  6841. msgstr ""
  6842. #: ../../../CHANGELOG.md:2636
  6843. msgid "Newer IRC bridge (with potential breaking change)"
  6844. msgstr ""
  6845. #: ../../../CHANGELOG.md:2638
  6846. msgid ""
  6847. "This upgrades matrix-appservice-irc from 0.14.1 to 0.16.0. Upstream made"
  6848. " a change to how you define manual mappings. If you added a `mapping` to"
  6849. " your configuration, you will need to update it accoring to the [upstream"
  6850. " instructions](https://github.com/matrix-org/matrix-appservice-"
  6851. "irc/blob/master/CHANGELOG.md#0150-2020-02-05). If you did not include "
  6852. "`mappings` in your configuration for IRC, no change is necessary. "
  6853. "`mappings` is not part of the default configuration."
  6854. msgstr ""
  6855. #: ../../../CHANGELOG.md:2647
  6856. msgid "2020-04-23"
  6857. msgstr ""
  6858. #: ../../../CHANGELOG.md:2649 ../../../CHANGELOG.md:2880
  6859. msgid "Slack bridging support"
  6860. msgstr ""
  6861. #: ../../../CHANGELOG.md:2651
  6862. msgid ""
  6863. "Thanks to [Rodrigo Belem](https://github.com/rbelem)'s efforts, the "
  6864. "playbook now supports bridging to [Slack](https://slack.com) via the [mx-"
  6865. "puppet-slack](https://github.com/Sorunome/mx-puppet-slack) bridge."
  6866. msgstr ""
  6867. #: ../../../CHANGELOG.md:2653
  6868. msgid ""
  6869. "See our [Setting up MX Puppet Slack bridging](docs/configuring-playbook-"
  6870. "bridge-mx-puppet-slack.md) documentation page for getting started."
  6871. msgstr ""
  6872. #: ../../../CHANGELOG.md:2656
  6873. msgid "2020-04-09"
  6874. msgstr ""
  6875. #: ../../../CHANGELOG.md:2658
  6876. msgid "Skype bridging support"
  6877. msgstr ""
  6878. #: ../../../CHANGELOG.md:2660
  6879. msgid ""
  6880. "Thanks to [Rodrigo Belem](https://github.com/rbelem)'s efforts, the "
  6881. "playbook now supports bridging to [Skype](https://www.skype.com) via the "
  6882. "[mx-puppet-skype](https://github.com/Sorunome/mx-puppet-skype) bridge."
  6883. msgstr ""
  6884. #: ../../../CHANGELOG.md:2662
  6885. msgid ""
  6886. "See our [Setting up MX Puppet Skype bridging](docs/configuring-playbook-"
  6887. "bridge-mx-puppet-skype.md) documentation page for getting started."
  6888. msgstr ""
  6889. #: ../../../CHANGELOG.md:2665
  6890. msgid "2020-04-05"
  6891. msgstr ""
  6892. #: ../../../CHANGELOG.md:2667
  6893. msgid "Private Jitsi support"
  6894. msgstr ""
  6895. #: ../../../CHANGELOG.md:2669
  6896. msgid ""
  6897. "The [Jitsi support](#jitsi-support) we had landed a few weeks ago was "
  6898. "working well, but it was always open to the whole world."
  6899. msgstr ""
  6900. #: ../../../CHANGELOG.md:2671
  6901. msgid ""
  6902. "Running such an open instance is not desirable to most people, so "
  6903. "[teutat3s](https://github.com/teutat3s) has contributed support for "
  6904. "making Jitsi use authentication."
  6905. msgstr ""
  6906. #: ../../../CHANGELOG.md:2673
  6907. msgid ""
  6908. "To make your Jitsi server more private, see the [configure internal Jitsi"
  6909. " authentication and guests mode](docs/configuring-playbook-jitsi.md"
  6910. "#optional-configure-internal-jitsi-authentication-and-guests-mode) "
  6911. "section in our Jitsi documentation."
  6912. msgstr ""
  6913. #: ../../../CHANGELOG.md:2676
  6914. msgid "2020-04-03"
  6915. msgstr ""
  6916. #: ../../../CHANGELOG.md:2678
  6917. msgid "(Potential Backward Compatibility Break) ma1sd replaces mxisd"
  6918. msgstr ""
  6919. #: ../../../CHANGELOG.md:2680
  6920. msgid ""
  6921. "Thanks to [Marcel Partap](https://github.com/eMPee584)'s efforts, the "
  6922. "[mxisd](https://github.com/kamax-io/mxisd) identity server, which has "
  6923. "been deprecated for a long time, has finally been replaced by "
  6924. "[ma1sd](https://github.com/ma1uta/ma1sd), a compatible fork."
  6925. msgstr ""
  6926. #: ../../../CHANGELOG.md:2682
  6927. msgid ""
  6928. "**If you're using the default playbook configuration**, you don't need to"
  6929. " do anything -- your mxisd installation will be replaced with ma1sd and "
  6930. "all existing data will be migrated automatically the next time you run "
  6931. "the playbook."
  6932. msgstr ""
  6933. #: ../../../CHANGELOG.md:2684
  6934. msgid ""
  6935. "**If you're doing something more special** (defining custom "
  6936. "`matrix_mxisd_*` variables), the playbook will ask you to rename them to "
  6937. "`matrix_ma1sd_*`. You're also encouraged to test that ma1sd works well "
  6938. "for such a more custom setup."
  6939. msgstr ""
  6940. #: ../../../CHANGELOG.md:2687
  6941. msgid "2020-03-29"
  6942. msgstr ""
  6943. #: ../../../CHANGELOG.md:2689
  6944. msgid "Archlinux support"
  6945. msgstr ""
  6946. #: ../../../CHANGELOG.md:2691
  6947. msgid ""
  6948. "Thanks to [Christian Lupus](https://github.com/christianlupus)'s efforts,"
  6949. " the playbook now supports installing to an "
  6950. "[Archlinux](https://www.archlinux.org/) server."
  6951. msgstr ""
  6952. #: ../../../CHANGELOG.md:2694
  6953. msgid "2020-03-24"
  6954. msgstr ""
  6955. #: ../../../CHANGELOG.md:2696
  6956. msgid "Jitsi support"
  6957. msgstr ""
  6958. #: ../../../CHANGELOG.md:2698
  6959. msgid ""
  6960. "The playbook can now (optionally) install the [Jitsi](https://jitsi.org/)"
  6961. " video-conferencing platform and integrate it with [Riot](docs"
  6962. "/configuring-playbook-riot-web.md)."
  6963. msgstr ""
  6964. #: ../../../CHANGELOG.md:2700
  6965. msgid ""
  6966. "See our [Jitsi documentation page](docs/configuring-playbook-jitsi.md) to"
  6967. " get started."
  6968. msgstr ""
  6969. #: ../../../CHANGELOG.md:2703
  6970. msgid "2020-03-15"
  6971. msgstr ""
  6972. #: ../../../CHANGELOG.md:2705
  6973. msgid "Raspberry Pi support"
  6974. msgstr ""
  6975. #: ../../../CHANGELOG.md:2707
  6976. msgid ""
  6977. "Thanks to [Gergely Horváth](https://github.com/hooger)'s effort, the "
  6978. "playbook supports installing to a Raspberry Pi server, for at least some "
  6979. "of the services."
  6980. msgstr ""
  6981. #: ../../../CHANGELOG.md:2709
  6982. msgid ""
  6983. "Since most ready-made container images do not support that architecture, "
  6984. "we achieve this by building images locally on the device itself. See our "
  6985. "[Self-building documentation page](docs/self-building.md) for how to get "
  6986. "started."
  6987. msgstr ""
  6988. #: ../../../CHANGELOG.md:2712
  6989. msgid "2020-02-26"
  6990. msgstr ""
  6991. #: ../../../CHANGELOG.md:2714
  6992. msgid "Riot-web themes are here"
  6993. msgstr ""
  6994. #: ../../../CHANGELOG.md:2716
  6995. msgid "The playbook now makes it easy to install custom riot-web themes."
  6996. msgstr ""
  6997. #: ../../../CHANGELOG.md:2718
  6998. msgid ""
  6999. "To learn more, take a look at our [riot-web documentation on Themes](docs"
  7000. "/configuring-playbook-riot-web.md#themes)."
  7001. msgstr ""
  7002. #: ../../../CHANGELOG.md:2721
  7003. msgid "2020-02-24"
  7004. msgstr ""
  7005. #: ../../../CHANGELOG.md:2723
  7006. msgid "Customize the server name in Riot's login page"
  7007. msgstr ""
  7008. #: ../../../CHANGELOG.md:2725
  7009. msgid ""
  7010. "You can now customize the server name string that Riot-web displays in "
  7011. "its login page."
  7012. msgstr ""
  7013. #: ../../../CHANGELOG.md:2727
  7014. msgid "These playbook variables, with these default values, have been added:"
  7015. msgstr ""
  7016. #: ../../../CHANGELOG.md:2733
  7017. msgid ""
  7018. "The login page previously said \"Sign in to your Matrix account on "
  7019. "matrix.example.org\" (the homeserver's domain name). It will now say "
  7020. "\"Sign in … on example.org\" (the server name) by default, or \"Sign in …"
  7021. " on Our Server\" if you set the variable to \"Our Server\"."
  7022. msgstr ""
  7023. #: ../../../CHANGELOG.md:2735
  7024. msgid ""
  7025. "To support this, the config.json template is changed to use the "
  7026. "configuration key `default_server_config` for setting the default HS/IS, "
  7027. "and the new configuration key `server_name` is added in there."
  7028. msgstr ""
  7029. #: ../../../CHANGELOG.md:2738
  7030. msgid "2020-01-30"
  7031. msgstr ""
  7032. #: ../../../CHANGELOG.md:2740
  7033. msgid "Disabling TLSv1.1"
  7034. msgstr ""
  7035. #: ../../../CHANGELOG.md:2742
  7036. msgid ""
  7037. "To improve security, we've removed TLSv1.1 support from our default "
  7038. "matrix-nginx-proxy configuration."
  7039. msgstr ""
  7040. #: ../../../CHANGELOG.md:2744
  7041. msgid ""
  7042. "If you need to support old clients, you can re-enable it with the "
  7043. "following configuration: `matrix_nginx_proxy_ssl_protocols: \"TLSv1.1 "
  7044. "TLSv1.2 TLSv1.3\"`"
  7045. msgstr ""
  7046. #: ../../../CHANGELOG.md:2747
  7047. msgid "2020-01-21"
  7048. msgstr ""
  7049. #: ../../../CHANGELOG.md:2749
  7050. msgid "Postgres collation changes (action required!)"
  7051. msgstr ""
  7052. #: ../../../CHANGELOG.md:2751
  7053. msgid ""
  7054. "By default, we've been using a UTF-8 collation for Postgres. This is "
  7055. "known to cause Synapse some troubles (see the [relevant "
  7056. "issue](https://github.com/matrix-org/synapse/issues/6722)) on systems "
  7057. "that use [glibc](https://www.gnu.org/software/libc/). We run Postgres in "
  7058. "an [Alpine Linux](https://alpinelinux.org/) container (which uses "
  7059. "[musl](https://www.musl-libc.org/), and not glibc), so our users are "
  7060. "likely not affected by the index corruption problem observed by others."
  7061. msgstr ""
  7062. #: ../../../CHANGELOG.md:2753
  7063. msgid ""
  7064. "Still, we might become affected in the future. In any case, it's imminent"
  7065. " that Synapse will complain about databases which do not use a C "
  7066. "collation."
  7067. msgstr ""
  7068. #: ../../../CHANGELOG.md:2755
  7069. msgid "To avoid future problems, we recommend that you run the following command:"
  7070. msgstr ""
  7071. #: ../../../CHANGELOG.md:2761
  7072. msgid ""
  7073. "It forces a [Postgres database upgrade](docs/maintenance-postgres.md"
  7074. "#upgrading-postgresql), which would recreate your Postgres database using"
  7075. " the proper (`C`) collation. If you are low on disk space, or run into "
  7076. "trouble, refer to the Postgres database upgrade documentation page."
  7077. msgstr ""
  7078. #: ../../../CHANGELOG.md:2764
  7079. msgid "2020-01-14"
  7080. msgstr ""
  7081. #: ../../../CHANGELOG.md:2766
  7082. msgid "Added support for Appservice Webhooks"
  7083. msgstr ""
  7084. #: ../../../CHANGELOG.md:2768
  7085. msgid ""
  7086. "Thanks to a contribution from [Björn "
  7087. "Marten](https://github.com/tripleawwy) from "
  7088. "[netresearch](https://www.netresearch.de/), the playbook can now install "
  7089. "and configure [matrix-appservice-webhooks](https://github.com/turt2live"
  7090. "/matrix-appservice-webhooks) for you. This bridge provides support for "
  7091. "Slack-compatible webhooks."
  7092. msgstr ""
  7093. #: ../../../CHANGELOG.md:2770
  7094. msgid ""
  7095. "Learn more in [Setting up Appservice Webhooks bridging](docs/configuring-"
  7096. "playbook-bridge-appservice-webhooks.md)."
  7097. msgstr ""
  7098. #: ../../../CHANGELOG.md:2773
  7099. msgid "2020-01-12"
  7100. msgstr ""
  7101. #: ../../../CHANGELOG.md:2775
  7102. msgid "Added support for automatic Double Puppeting for all Mautrix bridges"
  7103. msgstr ""
  7104. #: ../../../CHANGELOG.md:2777
  7105. msgid ""
  7106. "Double Puppeting can now be easily enabled for all Mautrix bridges "
  7107. "supported by the playbook (Facebook, Hangouts, Whatsapp, Telegram)."
  7108. msgstr ""
  7109. #: ../../../CHANGELOG.md:2779
  7110. msgid ""
  7111. "This is possible due to those bridges' integration with [matrix-synapse-"
  7112. "shared-secret-auth](https://github.com/devture/matrix-synapse-shared-"
  7113. "secret-auth) - yet another component that this playbook can install for "
  7114. "you."
  7115. msgstr ""
  7116. #: ../../../CHANGELOG.md:2781
  7117. msgid ""
  7118. "To get started, following the playbook's documentation for the bridge "
  7119. "you'd like to configure."
  7120. msgstr ""
  7121. #: ../../../CHANGELOG.md:2784
  7122. msgid "2019-12-06"
  7123. msgstr ""
  7124. #: ../../../CHANGELOG.md:2786
  7125. msgid "Added support for an alternative method for using another webserver"
  7126. msgstr ""
  7127. #: ../../../CHANGELOG.md:2788
  7128. msgid ""
  7129. "We have added support for making `matrix-nginx-proxy` not being so "
  7130. "invasive, so that it would be easier to [use your own webserver](docs"
  7131. "/configuring-playbook-own-webserver.md)."
  7132. msgstr ""
  7133. #: ../../../CHANGELOG.md:2790
  7134. msgid ""
  7135. "The documentation has been updated with a **Method 2**, which might make "
  7136. "\"own webserver\" setup easier in some cases (such as [reverse-proxying "
  7137. "using Traefik](https://github.com/spantaleev/matrix-docker-ansible-"
  7138. "deploy/issues/296))."
  7139. msgstr ""
  7140. #: ../../../CHANGELOG.md:2792
  7141. msgid ""
  7142. "**Existing users** are not affected by this and **don't need to change "
  7143. "anything**. The defaults are still the same (`matrix-nginx-proxy` "
  7144. "obtaining SSL certificates and doing everything for you automatically)."
  7145. msgstr ""
  7146. #: ../../../CHANGELOG.md:2795
  7147. msgid "2019-11-10"
  7148. msgstr ""
  7149. #: ../../../CHANGELOG.md:2797
  7150. msgid "Tightened security around room directory publishing"
  7151. msgstr ""
  7152. #: ../../../CHANGELOG.md:2799
  7153. msgid ""
  7154. "As per this [advisory blog post](https://matrix.org/blog/2019/11/09"
  7155. "/avoiding-unwelcome-visitors-on-private-matrix-servers), we've decided to"
  7156. " change the default publishing rules for the Matrix room directory."
  7157. msgstr ""
  7158. #: ../../../CHANGELOG.md:2801
  7159. msgid ""
  7160. "Our general goal is to favor privacy and security when running personal "
  7161. "(family & friends) and corporate homeservers. Both of these likely "
  7162. "benefit from having a more secure default of **not showing the room "
  7163. "directory without authentication** and **not publishing the room "
  7164. "directory over federation**."
  7165. msgstr ""
  7166. #: ../../../CHANGELOG.md:2803
  7167. msgid ""
  7168. "As with anything else, these new defaults can be overriden by changing "
  7169. "the `matrix_synapse_allow_public_rooms_without_auth` and "
  7170. "`matrix_synapse_allow_public_rooms_over_federation` variables, "
  7171. "respectively."
  7172. msgstr ""
  7173. #: ../../../CHANGELOG.md:2806
  7174. msgid "2019-10-05"
  7175. msgstr ""
  7176. #: ../../../CHANGELOG.md:2808
  7177. msgid "Improved Postgres upgrading/importing"
  7178. msgstr ""
  7179. #: ../../../CHANGELOG.md:2810
  7180. msgid ""
  7181. "Postgres [upgrading](docs/maintenance-postgres.md#upgrading-postgresql) "
  7182. "and [importing](docs/importing-postgres.md) have been improved to add "
  7183. "support for multiple databases and roles."
  7184. msgstr ""
  7185. #: ../../../CHANGELOG.md:2812
  7186. msgid ""
  7187. "Previously, the playbook would only take care of the `homeserver` "
  7188. "database and `synapse` user. We now back up and restore all databases and"
  7189. " users on the Postgres server."
  7190. msgstr ""
  7191. #: ../../../CHANGELOG.md:2814
  7192. msgid ""
  7193. "For now, the playbook only uses that one database (`homeserver`) and that"
  7194. " one single user (`synapse`), so it's all the same. However, in the "
  7195. "future, additional components besides Synapse may also make use the "
  7196. "Postgres database server. One such example is the [matrix-appservice-"
  7197. "slack](https://github.com/matrix-org/matrix-appservice-slack) bridge, "
  7198. "which strongly encourages use of Postgres in its v1.0 release. We are yet"
  7199. " to upgrade to it."
  7200. msgstr ""
  7201. #: ../../../CHANGELOG.md:2816
  7202. msgid ""
  7203. "Additionally, Postgres [upgrading](docs/maintenance-postgres.md"
  7204. "#upgrading-postgresql) now uses gzipped dump files by default, to "
  7205. "minimize disk space usage."
  7206. msgstr ""
  7207. #: ../../../CHANGELOG.md:2819
  7208. msgid "2019-10-04"
  7209. msgstr ""
  7210. #: ../../../CHANGELOG.md:2821
  7211. msgid "Postgres 12 support"
  7212. msgstr ""
  7213. #: ../../../CHANGELOG.md:2823
  7214. msgid ""
  7215. "The playbook now installs [Postgres "
  7216. "12](https://www.postgresql.org/about/news/1976/) by default."
  7217. msgstr ""
  7218. #: ../../../CHANGELOG.md:2825
  7219. msgid ""
  7220. "If you have have an existing setup, it's likely running on an older "
  7221. "Postgres version (9.x, 10.x or 11.x). You can easily upgrade by following"
  7222. " the [upgrading PostgreSQL guide](docs/maintenance-postgres.md#upgrading-"
  7223. "postgresql)."
  7224. msgstr ""
  7225. #: ../../../CHANGELOG.md:2828
  7226. msgid "2019-10-03"
  7227. msgstr ""
  7228. #: ../../../CHANGELOG.md:2830
  7229. msgid "Synapse 1.4.0"
  7230. msgstr ""
  7231. #: ../../../CHANGELOG.md:2832
  7232. msgid ""
  7233. "Synapse 1.4.0 [is "
  7234. "out](https://matrix.org/blog/2019/10/03/synapse-1-4-0-released) with lots"
  7235. " of changes related to privacy."
  7236. msgstr ""
  7237. #: ../../../CHANGELOG.md:2834
  7238. msgid ""
  7239. "Its new defaults (which we adopt as well) mean that certain old data will"
  7240. " automatically get purged after a certain number of days. 1.4.0 "
  7241. "automatically garbage collects redacted messages (defaults to 7 days) and"
  7242. " removes unused IP and user agent information stored in the user_ips "
  7243. "table (defaults to 30 days). If you'd like to preserve this data, we "
  7244. "encourage you to look at the `redaction_retention_period` and "
  7245. "`user_ips_max_age` options (controllable by the "
  7246. "`matrix_synapse_redaction_retention_period` and "
  7247. "`matrix_synapse_user_ips_max_age` playbook variables, respectively) "
  7248. "before doing the upgrade. If you'd like to keep data indefinitely, set "
  7249. "these variables to `null` (e.g. "
  7250. "`matrix_synapse_redaction_retention_period: ~`)."
  7251. msgstr ""
  7252. #: ../../../CHANGELOG.md:2836
  7253. msgid ""
  7254. "From now on the `trusted_key_servers` setting for Synapse is "
  7255. "configurable. It still defaults to `matrix.org` just like it always has, "
  7256. "but in a more explicit way now. If you'd like to use another trusted key "
  7257. "server, adjust the `matrix_synapse_trusted_key_servers` playbook "
  7258. "variable."
  7259. msgstr ""
  7260. #: ../../../CHANGELOG.md:2838
  7261. msgid ""
  7262. "Synapse 1.4.0 also changes lots of things related to identity server "
  7263. "integration. Because Synapse will now by default be responsible for "
  7264. "validating email addresses for user accounts, running without an identity"
  7265. " server looks more feasible. We still [have "
  7266. "concerns](https://github.com/spantaleev/matrix-docker-ansible-"
  7267. "deploy/pull/275/files#r331104117) over disabling the identity server by "
  7268. "default, so for now it remains enabled."
  7269. msgstr ""
  7270. #: ../../../CHANGELOG.md:2841
  7271. msgid "2019-09-09"
  7272. msgstr ""
  7273. #: ../../../CHANGELOG.md:2843
  7274. msgid "Synapse Simple Antispam support"
  7275. msgstr ""
  7276. #: ../../../CHANGELOG.md:2845
  7277. msgid ""
  7278. "There have been lots of invite-spam attacks lately and "
  7279. "[Travis](https://github.com/t2bot) has created a Synapse module "
  7280. "([synapse-simple-antispam](https://github.com/t2bot/synapse-simple-"
  7281. "antispam)) to let people protect themselves."
  7282. msgstr ""
  7283. #: ../../../CHANGELOG.md:2847
  7284. msgid ""
  7285. "From now on, you can easily install and configure this spam checker "
  7286. "module through the playbook."
  7287. msgstr ""
  7288. #: ../../../CHANGELOG.md:2849
  7289. msgid ""
  7290. "Learn more in [Setting up Synapse Simple Antispam](docs/configuring-"
  7291. "playbook-synapse-simple-antispam.md)."
  7292. msgstr ""
  7293. #: ../../../CHANGELOG.md:2852
  7294. msgid "2019-08-25"
  7295. msgstr ""
  7296. #: ../../../CHANGELOG.md:2854
  7297. msgid "Extensible Riot-web configuration"
  7298. msgstr ""
  7299. #: ../../../CHANGELOG.md:2856
  7300. msgid ""
  7301. "Similarly to [Extensible Synapse configuration](#extensible-synapse-"
  7302. "configuration) (below), Riot-web configuration is also extensible now."
  7303. msgstr ""
  7304. #: ../../../CHANGELOG.md:2858
  7305. msgid ""
  7306. "From now on, you can extend/override Riot-web's configuration by making "
  7307. "use of the `matrix_riot_web_configuration_extension_json` variable. This "
  7308. "should be enough for most customization needs."
  7309. msgstr ""
  7310. #: ../../../CHANGELOG.md:2860
  7311. msgid ""
  7312. "If you need even more power, you can now also take full control and "
  7313. "override `matrix_riot_web_configuration_default` (or "
  7314. "`matrix_riot_web_configuration`) directly."
  7315. msgstr ""
  7316. #: ../../../CHANGELOG.md:2862
  7317. msgid ""
  7318. "Learn more in [Configuring Riot-web](docs/configuring-playbook-riot-"
  7319. "web.md)."
  7320. msgstr ""
  7321. #: ../../../CHANGELOG.md:2865
  7322. msgid "2019-08-22"
  7323. msgstr ""
  7324. #: ../../../CHANGELOG.md:2867
  7325. msgid "Extensible Synapse configuration"
  7326. msgstr ""
  7327. #: ../../../CHANGELOG.md:2869
  7328. msgid ""
  7329. "Previously, we had to create custom Ansible variables for each and every "
  7330. "Synapse setting. This lead to too much effort (and configuration "
  7331. "ugliness) to all of Synapse's settings, so naturally, not all features of"
  7332. " Synapse could be controlled through the playbook."
  7333. msgstr ""
  7334. #: ../../../CHANGELOG.md:2871
  7335. msgid ""
  7336. "From now on, you can extend/override the Synapse server's configuration "
  7337. "by making use of the `matrix_synapse_configuration_extension_yaml` "
  7338. "variable. This should be enough for most customization needs."
  7339. msgstr ""
  7340. #: ../../../CHANGELOG.md:2873
  7341. msgid ""
  7342. "If you need even more power, you can now also take full control and "
  7343. "override `matrix_synapse_configuration` (or "
  7344. "`matrix_synapse_configuration_yaml`) directly."
  7345. msgstr ""
  7346. #: ../../../CHANGELOG.md:2875
  7347. msgid ""
  7348. "Learn more here in [Configuring Synapse](docs/configuring-playbook-"
  7349. "synapse.md)."
  7350. msgstr ""
  7351. #: ../../../CHANGELOG.md:2878
  7352. msgid "2019-08-21"
  7353. msgstr ""
  7354. #: ../../../CHANGELOG.md:2882
  7355. msgid ""
  7356. "Thanks to the [great work](https://github.com/spantaleev/matrix-docker-"
  7357. "ansible-deploy/pull/205) of "
  7358. "[kingoftheconnors](https://github.com/kingoftheconnors) and [Stuart "
  7359. "Mumford (Cadair)](https://github.com/Cadair), the playbook now supports "
  7360. "bridging to [Slack](https://slack.com) via the [appservice-"
  7361. "slack](https://github.com/matrix-org/matrix-appservice-slack) bridge."
  7362. msgstr ""
  7363. #: ../../../CHANGELOG.md:2884
  7364. msgid ""
  7365. "Additional details are available in [Setting up Appservice Slack "
  7366. "bridging](docs/configuring-playbook-bridge-appservice-slack.md)."
  7367. msgstr ""
  7368. #: ../../../CHANGELOG.md:2886
  7369. msgid "Google Hangouts bridging support"
  7370. msgstr ""
  7371. #: ../../../CHANGELOG.md:2888
  7372. msgid ""
  7373. "Thanks to the [great work](https://github.com/spantaleev/matrix-docker-"
  7374. "ansible-deploy/pull/251) of [Eduardo Beltrame "
  7375. "(Munfred)](https://github.com/Munfred) and [Robbie D "
  7376. "(microchipster)](https://github.com/microchipster), the playbook now "
  7377. "supports bridging to [Google Hangouts](https://hangouts.google.com/) via "
  7378. "the [mautrix-hangouts](https://mau.dev/tulir/mautrix-hangouts) bridge."
  7379. msgstr ""
  7380. #: ../../../CHANGELOG.md:2890
  7381. msgid ""
  7382. "Additional details are available in [Setting up Mautrix Hangouts "
  7383. "bridging](docs/configuring-playbook-bridge-mautrix-hangouts.md)."
  7384. msgstr ""
  7385. #: ../../../CHANGELOG.md:2893
  7386. msgid "2019-08-05"
  7387. msgstr ""
  7388. #: ../../../CHANGELOG.md:2895
  7389. msgid "Email2Matrix support"
  7390. msgstr ""
  7391. #: ../../../CHANGELOG.md:2897
  7392. msgid ""
  7393. "Support for [Email2Matrix](https://github.com/devture/email2matrix) has "
  7394. "been added."
  7395. msgstr ""
  7396. #: ../../../CHANGELOG.md:2899
  7397. msgid "It's an optional feature that you can enable via the playbook."
  7398. msgstr ""
  7399. #: ../../../CHANGELOG.md:2901
  7400. msgid ""
  7401. "To learn more, see the [playbook's documentation on Email2Matrix](./docs"
  7402. "/configuring-playbook-email2matrix.md)."
  7403. msgstr ""
  7404. #: ../../../CHANGELOG.md:2904
  7405. msgid "2019-08-03"
  7406. msgstr ""
  7407. #: ../../../CHANGELOG.md:2906
  7408. msgid "Synapse logging level has been reduced to WARNING"
  7409. msgstr ""
  7410. #: ../../../CHANGELOG.md:2908
  7411. msgid ""
  7412. "After [some discussion in our support "
  7413. "room](https://matrix.to/#/!PukFFdIcHgtaaHZflT:devture.com/$156476852524179TBeKy:matrix.org?via=devture.com&via=matrix.org&via=librem.one),"
  7414. " we've decided to change the default logging level for Synapse from "
  7415. "`INFO` to `WARNING`."
  7416. msgstr ""
  7417. #: ../../../CHANGELOG.md:2910
  7418. msgid ""
  7419. "This greatly reduces the number of log messages that are being logged, "
  7420. "leading to:"
  7421. msgstr ""
  7422. #: ../../../CHANGELOG.md:2912
  7423. msgid "much less disk space dedicated to Synapse and thus, logs kept for longer"
  7424. msgstr ""
  7425. #: ../../../CHANGELOG.md:2913
  7426. msgid ""
  7427. "easier to find some important `WARNING`, `ERROR` and `CRITICAL` messages,"
  7428. " as they're not longer buried in thousands of non-important `INFO` "
  7429. "messages"
  7430. msgstr ""
  7431. #: ../../../CHANGELOG.md:2915
  7432. msgid ""
  7433. "If you'd like to track down an issue, you [can always increase the "
  7434. "logging level as described here](./docs/maintenance-and-"
  7435. "troubleshooting.md#increasing-synapse-logging)."
  7436. msgstr ""
  7437. #: ../../../CHANGELOG.md:2918
  7438. msgid "2019-07-08"
  7439. msgstr ""
  7440. #: ../../../CHANGELOG.md:2920
  7441. msgid "Synapse Maintenance docs and synapse-janitor support are available"
  7442. msgstr ""
  7443. #: ../../../CHANGELOG.md:2922
  7444. msgid "The playbook can now help you with Synapse's maintenance."
  7445. msgstr ""
  7446. #: ../../../CHANGELOG.md:2924
  7447. msgid ""
  7448. "There's a new documentation page about [Synapse maintenance](./docs"
  7449. "/maintenance-synapse.md) and another section on [Postgres "
  7450. "vacuuming](./docs/maintenance-postgres.md#vacuuming-postgresql)."
  7451. msgstr ""
  7452. #: ../../../CHANGELOG.md:2926
  7453. msgid ""
  7454. "Among other things, if your Postgres database has grown significantly "
  7455. "over time, you may wish to [ask the playbook to purge unused data with "
  7456. "synapse-janitor](./docs/maintenance-synapse.md#purging-unused-data-with-"
  7457. "synapse-janitor) for you."
  7458. msgstr ""
  7459. #: ../../../CHANGELOG.md:2928
  7460. msgid "(BC Break) Rename run control variables"
  7461. msgstr ""
  7462. #: ../../../CHANGELOG.md:2930
  7463. msgid "Some internal playbook control variables have been renamed."
  7464. msgstr ""
  7465. #: ../../../CHANGELOG.md:2932
  7466. msgid ""
  7467. "This change **only affects people who run this playbook's roles from "
  7468. "another playbook**. If you're using this playbook as-is, you're not "
  7469. "affected and don't need to do anything."
  7470. msgstr ""
  7471. #: ../../../CHANGELOG.md:2934
  7472. msgid "The following variables have been renamed:"
  7473. msgstr ""
  7474. #: ../../../CHANGELOG.md:2936
  7475. msgid "from `run_import_postgres` to `run_postgres_import`"
  7476. msgstr ""
  7477. #: ../../../CHANGELOG.md:2937
  7478. msgid "from `run_import_sqlite_db` to `run_postgres_import_sqlite_db`"
  7479. msgstr ""
  7480. #: ../../../CHANGELOG.md:2938
  7481. msgid "from `run_upgrade_postgres` to `run_postgres_upgrade`"
  7482. msgstr ""
  7483. #: ../../../CHANGELOG.md:2939
  7484. msgid "from `run_import_media_store` to `run_synapse_import_media_store`"
  7485. msgstr ""
  7486. #: ../../../CHANGELOG.md:2940
  7487. msgid "from `run_register_user` to `run_synapse_register_user`"
  7488. msgstr ""
  7489. #: ../../../CHANGELOG.md:2941
  7490. msgid "from `run_update_user_password` to `run_synapse_update_user_password`"
  7491. msgstr ""
  7492. #: ../../../CHANGELOG.md:2944
  7493. msgid "2019-07-04"
  7494. msgstr ""
  7495. #: ../../../CHANGELOG.md:2946
  7496. msgid "Synapse no longer logs to text files"
  7497. msgstr ""
  7498. #: ../../../CHANGELOG.md:2948
  7499. msgid ""
  7500. "Following what the official Synapse Docker image is doing "
  7501. "([#5565](https://github.com/matrix-org/synapse/pull/5565)) and what we've"
  7502. " been doing for mostly everything installed by this playbook, **Synapse "
  7503. "no longer logs to text files** (`/matrix/synapse/run/homeserver.log*`)."
  7504. msgstr ""
  7505. #: ../../../CHANGELOG.md:2950
  7506. msgid ""
  7507. "From now on, Synapse would only log to console, which goes to systemd's "
  7508. "journald. To see Synapse's logs, execute: `journalctl -fu matrix-synapse`"
  7509. msgstr ""
  7510. #: ../../../CHANGELOG.md:2952
  7511. msgid ""
  7512. "Because of this, the following variables have become obsolete and were "
  7513. "removed:"
  7514. msgstr ""
  7515. #: ../../../CHANGELOG.md:2954
  7516. msgid "`matrix_synapse_max_log_file_size_mb`"
  7517. msgstr ""
  7518. #: ../../../CHANGELOG.md:2955
  7519. msgid "`matrix_synapse_max_log_files_count`"
  7520. msgstr ""
  7521. #: ../../../CHANGELOG.md:2957
  7522. msgid ""
  7523. "To prevent confusion, it'd be better if you delete all old files manually"
  7524. " after you've upgraded (`rm -f /matrix/synapse/run/homeserver.log*`)."
  7525. msgstr ""
  7526. #: ../../../CHANGELOG.md:2959
  7527. msgid ""
  7528. "Because Synapse is incredibly chatty when it comes to logging (here's "
  7529. "[one such issue](https://github.com/matrix-org/synapse/issues/4751) "
  7530. "describing the problem), if you're running an ancient distribution (like "
  7531. "CentOS 7.0), be advised that systemd's journald default logging "
  7532. "restrictions may not be high enough to capture all log messages generated"
  7533. " by Synapse. This is especially true if you've got a busy (Synapse) "
  7534. "server. We advise that you manually add `RateLimitInterval=0` and "
  7535. "`RateLimitBurst=0` under `[Storage]` in the `/etc/systemd/journald.conf` "
  7536. "file, followed by restarting the logging service (`systemctl restart "
  7537. "systemd-journald`)."
  7538. msgstr ""
  7539. #: ../../../CHANGELOG.md:2962
  7540. msgid "2019-06-27"
  7541. msgstr ""
  7542. #: ../../../CHANGELOG.md:2964
  7543. msgid ""
  7544. "(BC Break) Discord bridge configuration is now entirely managed by the "
  7545. "playbook"
  7546. msgstr ""
  7547. #: ../../../CHANGELOG.md:2966
  7548. msgid ""
  7549. "Until now, the `config.yaml` file for the [Discord bridge](docs"
  7550. "/configuring-playbook-bridge-appservice-discord.md) was managed by the "
  7551. "playbook, but the `registration.yaml` file was not."
  7552. msgstr ""
  7553. #: ../../../CHANGELOG.md:2968
  7554. msgid "From now on, the playbook will keep both configuration files sync for you."
  7555. msgstr ""
  7556. #: ../../../CHANGELOG.md:2970
  7557. msgid ""
  7558. "This means that if you were making manual changes to the `/matrix"
  7559. "/appservice-discord/discord-registration.yaml` configuration file, those "
  7560. "would be lost the next time you run the playbook."
  7561. msgstr ""
  7562. #: ../../../CHANGELOG.md:2972
  7563. msgid ""
  7564. "The bridge now stores configuration in a subdirectory (`/matrix"
  7565. "/appservice-discord/config`)."
  7566. msgstr ""
  7567. #: ../../../CHANGELOG.md:2974
  7568. msgid ""
  7569. "Likewise, data is now also stored in a subdirectory (`/matrix/appservice-"
  7570. "discord/data`). When you run the playbook with an existing database file "
  7571. "(`/matrix/appservice-discord/discord.db`), the playbook will stop the "
  7572. "bridge and relocate the database file to the `./data` directory. There's "
  7573. "no data-loss involved. You'll need to restart the bridge manually though "
  7574. "(`--tags=start`)."
  7575. msgstr ""
  7576. #: ../../../CHANGELOG.md:2976
  7577. msgid ""
  7578. "The main directory (`/matrix/appservice-discord`) may contain some "
  7579. "leftover files (`user-store.db`, `room-store.db`, `config.yaml`, "
  7580. "`discord-registration.yaml`, `invite_link`). These are no longer "
  7581. "necessary and can be deleted manually."
  7582. msgstr ""
  7583. #: ../../../CHANGELOG.md:2978
  7584. msgid ""
  7585. "We're now following the default sample configuration for the Discord "
  7586. "bridge. If you need to override some values, define them in "
  7587. "`matrix_appservice_discord_configuration_extension_yaml`."
  7588. msgstr ""
  7589. #: ../../../CHANGELOG.md:2981
  7590. msgid "2019-06-24"
  7591. msgstr ""
  7592. #: ../../../CHANGELOG.md:2983
  7593. msgid ""
  7594. "(BC Break) WhatsApp bridge configuration is now entirely managed by the "
  7595. "playbook"
  7596. msgstr ""
  7597. #: ../../../CHANGELOG.md:2985
  7598. msgid ""
  7599. "Until now, configuration files for the [WhatsApp bridge](docs"
  7600. "/configuring-playbook-bridge-mautrix-whatsapp.md) were created by the "
  7601. "playbook initially, but never modified later on."
  7602. msgstr ""
  7603. #: ../../../CHANGELOG.md:2987 ../../../CHANGELOG.md:3004
  7604. #: ../../../CHANGELOG.md:3023 ../../../CHANGELOG.md:3062
  7605. msgid "From now on, the playbook will keep the configuration in sync for you."
  7606. msgstr ""
  7607. #: ../../../CHANGELOG.md:2989
  7608. msgid ""
  7609. "This means that if you were making manual changes to the `/matrix"
  7610. "/mautrix-whatsapp/config.yaml` or `/matrix/mautrix-"
  7611. "whatsapp/registration.yaml` configuration files, those would be lost the "
  7612. "next time you run the playbook."
  7613. msgstr ""
  7614. #: ../../../CHANGELOG.md:2991
  7615. msgid ""
  7616. "The bridge now stores configuration in a subdirectory (`/matrix/mautrix-"
  7617. "whatsapp/config`), so your old configuration remains in the base "
  7618. "directory (`/matrix/mautrix-whatsapp`). You need to migrate any manual "
  7619. "changes over to the new "
  7620. "`matrix_mautrix_whatsapp_configuration_extension_yaml` variable, so that "
  7621. "the playbook would apply them for you."
  7622. msgstr ""
  7623. #: ../../../CHANGELOG.md:2993
  7624. msgid ""
  7625. "Likewise, data is now also stored in a subdirectory (`/matrix/mautrix-"
  7626. "whatsapp/data`). When you run the playbook with an existing database file"
  7627. " (`/matrix/mautrix-whatsapp/mautrix-whatsapp.db`), the playbook will stop"
  7628. " the bridge and relocate the database file to the `./data` directory. "
  7629. "There's no data-loss involved. You'll need to restart the bridge manually"
  7630. " though (`--tags=start`)."
  7631. msgstr ""
  7632. #: ../../../CHANGELOG.md:2995
  7633. msgid "We're now following the default configuration for the WhatsApp bridge."
  7634. msgstr ""
  7635. #: ../../../CHANGELOG.md:2998
  7636. msgid "2019-06-20"
  7637. msgstr ""
  7638. #: ../../../CHANGELOG.md:3000
  7639. msgid ""
  7640. "(BC Break) IRC bridge configuration is now entirely managed by the "
  7641. "playbook"
  7642. msgstr ""
  7643. #: ../../../CHANGELOG.md:3002
  7644. msgid ""
  7645. "Until now, configuration files for the [IRC bridge](docs/configuring-"
  7646. "playbook-bridge-appservice-irc.md) were created by the playbook "
  7647. "initially, but never modified later on."
  7648. msgstr ""
  7649. #: ../../../CHANGELOG.md:3006
  7650. msgid ""
  7651. "This means that if you were making manual changes to the `/matrix"
  7652. "/appservice-irc/config.yaml` or `/matrix/appservice-"
  7653. "irc/registration.yaml` configuration files, those would be lost the next "
  7654. "time you run the playbook."
  7655. msgstr ""
  7656. #: ../../../CHANGELOG.md:3008
  7657. msgid ""
  7658. "The bridge now stores configuration in a subdirectory (`/matrix"
  7659. "/appservice-irc/config`), so your old configuration remains in the base "
  7660. "directory (`/matrix/appservice-irc`)."
  7661. msgstr ""
  7662. #: ../../../CHANGELOG.md:3010
  7663. msgid ""
  7664. "Previously, we asked people to configure bridged IRC servers by extending"
  7665. " the bridge configuration "
  7666. "(`matrix_appservice_irc_configuration_extension_yaml`). While this is "
  7667. "still possible and will continue working forever, **we now recommend "
  7668. "defining IRC servers in the easier to use "
  7669. "`matrix_appservice_irc_ircService_servers` variable**. See [our IRC "
  7670. "bridge documentation page](docs/configuring-playbook-bridge-appservice-"
  7671. "irc.md) for an example."
  7672. msgstr ""
  7673. #: ../../../CHANGELOG.md:3012
  7674. msgid ""
  7675. "If you decide to continue using "
  7676. "`matrix_appservice_irc_configuration_extension_yaml`, you might be "
  7677. "interested to know that `ircService.databaseUri` and a few other keys now"
  7678. " have default values in the base configuration "
  7679. "(`matrix_appservice_irc_configuration_yaml`). You may wish to stop "
  7680. "redefining those keys, unless you really intend to override them. You "
  7681. "most likely only need to override `ircService.servers`."
  7682. msgstr ""
  7683. #: ../../../CHANGELOG.md:3014
  7684. msgid ""
  7685. "Bridge data (`passkey.pem` and database files) is now also stored in a "
  7686. "subdirectory (`/matrix/appservice-irc/data`). When you run the playbook "
  7687. "with an existing `/matrix/appservice-irc/passkey.pem` file, the playbook "
  7688. "will stop the bridge and relocate the passkey and database files "
  7689. "(`rooms.db` and `users.db`) to the `./data` directory. There's no data-"
  7690. "loss involved. You'll need to restart the bridge manually though "
  7691. "(`--tags=start`)."
  7692. msgstr ""
  7693. #: ../../../CHANGELOG.md:3017
  7694. msgid "2019-06-15"
  7695. msgstr ""
  7696. #: ../../../CHANGELOG.md:3019
  7697. msgid ""
  7698. "(BC Break) Telegram bridge configuration is now entirely managed by the "
  7699. "playbook"
  7700. msgstr ""
  7701. #: ../../../CHANGELOG.md:3021
  7702. msgid ""
  7703. "Until now, configuration files for the [Telegram bridge](docs"
  7704. "/configuring-playbook-bridge-mautrix-telegram.md) were created by the "
  7705. "playbook initially, but never modified later on."
  7706. msgstr ""
  7707. #: ../../../CHANGELOG.md:3025
  7708. msgid ""
  7709. "This means that if you were making manual changes to the `/matrix"
  7710. "/mautrix-telegram/config.yaml` or `/matrix/mautrix-"
  7711. "telegram/registration.yaml` configuration files, those would be lost the "
  7712. "next time you run the playbook."
  7713. msgstr ""
  7714. #: ../../../CHANGELOG.md:3027
  7715. msgid ""
  7716. "The bridge now stores configuration in a subdirectory (`/matrix/mautrix-"
  7717. "telegram/config`), so your old configuration remains in the base "
  7718. "directory (`/matrix/mautrix-telegram`). You need to migrate any manual "
  7719. "changes over to the new "
  7720. "`matrix_mautrix_telegram_configuration_extension_yaml` variable, so that "
  7721. "the playbook would apply them for you."
  7722. msgstr ""
  7723. #: ../../../CHANGELOG.md:3029
  7724. msgid ""
  7725. "Likewise, data is now also stored in a subdirectory (`/matrix/mautrix-"
  7726. "telegram/data`). When you run the playbook with an existing database file"
  7727. " (`/matrix/mautrix-telegram/mautrix-telegram.db`), the playbook will stop"
  7728. " the bridge and relocate the database file to the `./data` directory. "
  7729. "There's no data-loss involved. You'll need to restart the bridge manually"
  7730. " though (`--tags=start`)."
  7731. msgstr ""
  7732. #: ../../../CHANGELOG.md:3031
  7733. msgid ""
  7734. "Also, we're now following the default configuration for the Telegram "
  7735. "bridge, so some default configuration values are different:"
  7736. msgstr ""
  7737. #: ../../../CHANGELOG.md:3033
  7738. msgid ""
  7739. "`edits_as_replies` (used to be `false`, now `true`) - previously replies "
  7740. "were not sent over to Matrix at all; ow they are sent over as a reply to "
  7741. "the original message"
  7742. msgstr ""
  7743. #: ../../../CHANGELOG.md:3034
  7744. msgid ""
  7745. "`inline_images` (used to be `true`, now `false`) - this has to do with "
  7746. "captioned images. Inline-image (included caption) are said to exhibit "
  7747. "troubles on Riot iOS. When `false`, the caption arrives on the Matrix "
  7748. "side as a separate message."
  7749. msgstr ""
  7750. #: ../../../CHANGELOG.md:3035
  7751. msgid ""
  7752. "`authless_portals` (used to be `false`, now `true`) - creating portals "
  7753. "from the Telegram side is now possible"
  7754. msgstr ""
  7755. #: ../../../CHANGELOG.md:3036
  7756. msgid ""
  7757. "`whitelist_group_admins` (used to be `false`, now `true`) - allows "
  7758. "Telegram group admins to use the bot commands"
  7759. msgstr ""
  7760. #: ../../../CHANGELOG.md:3038
  7761. msgid ""
  7762. "If the new values are not to your liking, use "
  7763. "`matrix_mautrix_telegram_configuration_extension_yaml` to specify an "
  7764. "override (refer to `matrix_mautrix_telegram_configuration_yaml` to figure"
  7765. " out which variable goes where)."
  7766. msgstr ""
  7767. #: ../../../CHANGELOG.md:3041
  7768. msgid "2019-06-12"
  7769. msgstr ""
  7770. #: ../../../CHANGELOG.md:3043
  7771. msgid "Synapse v1.0"
  7772. msgstr ""
  7773. #: ../../../CHANGELOG.md:3045
  7774. msgid ""
  7775. "With [Synapse v1.0 now available](https://matrix.org/blog/2019/06/11"
  7776. "/introducing-matrix-1-0-and-the-matrix-org-foundation) and most people "
  7777. "being on at least Synapse v0.99, it's time to remove the `_matrix._tcp` "
  7778. "DNS SRV record that we've been keeping for compatibility with old Synapse"
  7779. " versions (<= 0.34)."
  7780. msgstr ""
  7781. #: ../../../CHANGELOG.md:3047
  7782. msgid ""
  7783. "According to the [Server Discovery "
  7784. "specification](https://matrix.org/docs/spec/server_server/r0.1.2.html"
  7785. "#server-discovery), it's no harm to keep the DNS SRV record. But since "
  7786. "it's not necessary for federating with the larger Matrix network anymore,"
  7787. " you should be safe to get rid of it."
  7788. msgstr ""
  7789. #: ../../../CHANGELOG.md:3049
  7790. msgid ""
  7791. "**Note**: don't confuse the `_matrix._tcp` and `_matrix-identity._tcp` "
  7792. "DNS SRV records. The latter, **must not** be removed."
  7793. msgstr ""
  7794. #: ../../../CHANGELOG.md:3051
  7795. msgid ""
  7796. "For completeness, we must say that using a `_matrix._tcp` [SRV record for"
  7797. " Server Delegation](docs/howto-server-delegation.md#server-delegation-"
  7798. "via-a-dns-srv-record-advanced) is still valid and useful for certain "
  7799. "deployments. It's just that our guide recommends the [`/.well-"
  7800. "known/matrix/server` Server Delegation method](docs/howto-server-"
  7801. "delegation.md#server-delegation-via-a-well-known-file), due to its easier"
  7802. " implementation when using this playbook."
  7803. msgstr ""
  7804. #: ../../../CHANGELOG.md:3053
  7805. msgid ""
  7806. "Besides this optional/non-urgent DNS change, assuming you're already on "
  7807. "Synapse v0.99, upgrading to Synapse v1.0 should be as simple as [re-"
  7808. "running the playbook](docs/maintenance-upgrading-services.md)."
  7809. msgstr ""
  7810. #: ../../../CHANGELOG.md:3056
  7811. msgid "2019-06-07"
  7812. msgstr ""
  7813. #: ../../../CHANGELOG.md:3058
  7814. msgid ""
  7815. "(BC Break) Facebook bridge configuration is now entirely managed by the "
  7816. "playbook"
  7817. msgstr ""
  7818. #: ../../../CHANGELOG.md:3060
  7819. msgid ""
  7820. "Until now, configuration files for the [Facebook bridge](docs"
  7821. "/configuring-playbook-bridge-mautrix-facebook.md) were created by the "
  7822. "playbook initially, but never modified later on."
  7823. msgstr ""
  7824. #: ../../../CHANGELOG.md:3064
  7825. msgid ""
  7826. "This means that if you were making manual changes to the `/matrix"
  7827. "/mautrix-facebook/config.yaml` or `/matrix/mautrix-"
  7828. "facebook/registration.yaml` configuration files, those would be lost the "
  7829. "next time you run the playbook."
  7830. msgstr ""
  7831. #: ../../../CHANGELOG.md:3066
  7832. msgid ""
  7833. "The bridge now stores configuration in a subdirectory (`/matrix/mautrix-"
  7834. "facebook/config`), so your old configuration remains in the base "
  7835. "directory (`/matrix/mautrix-facebook`). You need to migrate any manual "
  7836. "changes over to the new "
  7837. "`matrix_mautrix_facebook_configuration_extension_yaml` variable, so that "
  7838. "the playbook would apply them for you."
  7839. msgstr ""
  7840. #: ../../../CHANGELOG.md:3068
  7841. msgid ""
  7842. "Likewise, data is now also stored in a subdirectory (`/matrix/mautrix-"
  7843. "facebook/data`). When you run the playbook with an existing database file"
  7844. " (`/matrix/mautrix-facebook/mautrix-facebook.db`), the playbook will stop"
  7845. " the bridge and relocate the database file to the `./data` directory. "
  7846. "There's no data-loss involved. You'll need to restart the bridge manually"
  7847. " though (`--tags=start`)."
  7848. msgstr ""
  7849. #: ../../../CHANGELOG.md:3071
  7850. msgid "2019-05-25"
  7851. msgstr ""
  7852. #: ../../../CHANGELOG.md:3073
  7853. msgid "Support for exposing container ports publicly (not just to the host)"
  7854. msgstr ""
  7855. #: ../../../CHANGELOG.md:3075
  7856. msgid ""
  7857. "Until now, various roles supported a `matrix_*_expose_port` variable, "
  7858. "which would expose their container's port to the host. This was mostly "
  7859. "useful for reverse-proxying manually (in case `matrix-nginx-proxy` was "
  7860. "disabled). It could also be used for installing some playbook services "
  7861. "(e.g. bridges, etc.) and wiring them to a separate (manual) Matrix setup."
  7862. msgstr ""
  7863. #: ../../../CHANGELOG.md:3077
  7864. msgid ""
  7865. "`matrix_*_expose_port` variables were not granular enough - sometimes "
  7866. "they would expose one port, other times multiple. They also didn't "
  7867. "provide control over **where** to expose (to which port number and to "
  7868. "which network interface), because they would usually hardcode something "
  7869. "like `127.0.0.1:8080`."
  7870. msgstr ""
  7871. #: ../../../CHANGELOG.md:3079
  7872. msgid ""
  7873. "All such variables have been superseded by a better (more flexible) way "
  7874. "to do it."
  7875. msgstr ""
  7876. #: ../../../CHANGELOG.md:3081
  7877. msgid ""
  7878. "**Most** people (including those not using `matrix-nginx-proxy`), **don't"
  7879. " need** to bother with this."
  7880. msgstr ""
  7881. #: ../../../CHANGELOG.md:3083
  7882. msgid "Porting examples follow for people having more customized setups:"
  7883. msgstr ""
  7884. #: ../../../CHANGELOG.md:3085
  7885. msgid ""
  7886. "**from** `matrix_synapse_container_expose_client_api_port: true` **to** "
  7887. "`matrix_synapse_container_client_api_host_bind_port: '127.0.0.1:8008'`"
  7888. msgstr ""
  7889. #: ../../../CHANGELOG.md:3087
  7890. msgid ""
  7891. "**from** `matrix_synapse_container_expose_federation_api_port: true` "
  7892. "**to** `matrix_synapse_container_federation_api_plain_host_bind_port: "
  7893. "'127.0.0.1:8048'` and possibly "
  7894. "`matrix_synapse_container_federation_api_tls_host_bind_port: '8448'`"
  7895. msgstr ""
  7896. #: ../../../CHANGELOG.md:3089
  7897. msgid ""
  7898. "**from** `matrix_synapse_container_expose_metrics_port: true` **to** "
  7899. "`matrix_synapse_container_metrics_api_host_bind_port: '127.0.0.1:9100'`"
  7900. msgstr ""
  7901. #: ../../../CHANGELOG.md:3091
  7902. msgid ""
  7903. "**from** `matrix_riot_web_container_expose_port: true` **to** "
  7904. "`matrix_riot_web_container_http_host_bind_port: '127.0.0.1:8765'`"
  7905. msgstr ""
  7906. #: ../../../CHANGELOG.md:3093
  7907. msgid ""
  7908. "**from** `matrix_mxisd_container_expose_port: true` **to** "
  7909. "`matrix_mxisd_container_http_host_bind_port: '127.0.0.1:8090'`"
  7910. msgstr ""
  7911. #: ../../../CHANGELOG.md:3095
  7912. msgid ""
  7913. "**from** `matrix_dimension_container_expose_port: true` **to** "
  7914. "`matrix_dimension_container_http_host_bind_port: '127.0.0.1:8184'`"
  7915. msgstr ""
  7916. #: ../../../CHANGELOG.md:3097
  7917. msgid ""
  7918. "**from** `matrix_corporal_container_expose_ports: true` **to** "
  7919. "`matrix_corporal_container_http_gateway_host_bind_port: "
  7920. "'127.0.0.1:41080'` and possibly "
  7921. "`matrix_corporal_container_http_api_host_bind_port: '127.0.0.1:41081'`"
  7922. msgstr ""
  7923. #: ../../../CHANGELOG.md:3099
  7924. msgid ""
  7925. "**from** `matrix_appservice_irc_container_expose_client_server_api_port: "
  7926. "true` **to** `matrix_appservice_irc_container_http_host_bind_port: "
  7927. "'127.0.0.1:9999'`"
  7928. msgstr ""
  7929. #: ../../../CHANGELOG.md:3101
  7930. msgid ""
  7931. "**from** "
  7932. "`matrix_appservice_discord_container_expose_client_server_api_port: true`"
  7933. " **to** `matrix_appservice_discord_container_http_host_bind_port: "
  7934. "'127.0.0.1:9005'`"
  7935. msgstr ""
  7936. #: ../../../CHANGELOG.md:3103
  7937. msgid ""
  7938. "As always, if you forget to remove usage of some outdated variable, the "
  7939. "playbook will warn you."
  7940. msgstr ""
  7941. #: ../../../CHANGELOG.md:3106
  7942. msgid "2019-05-23"
  7943. msgstr ""
  7944. #: ../../../CHANGELOG.md:3108
  7945. msgid "(BC Break) Ansible 2.8 compatibility"
  7946. msgstr ""
  7947. #: ../../../CHANGELOG.md:3110
  7948. msgid ""
  7949. "Thanks to [@danbob](https://github.com/danbob), the playbook now "
  7950. "[supports the new Ansible 2.8](https://github.com/spantaleev/matrix-"
  7951. "docker-ansible-deploy/pull/187)."
  7952. msgstr ""
  7953. #: ../../../CHANGELOG.md:3112
  7954. msgid ""
  7955. "A manual change is required to the `inventory/hosts` file, changing the "
  7956. "group name from `matrix-servers` to `matrix_servers` (dash to "
  7957. "underscore)."
  7958. msgstr ""
  7959. #: ../../../CHANGELOG.md:3114
  7960. msgid "To avoid doing it manually, run this:"
  7961. msgstr ""
  7962. #: ../../../CHANGELOG.md:3115
  7963. msgid "Linux: `sed -i 's/matrix-servers/matrix_servers/g' inventory/hosts`"
  7964. msgstr ""
  7965. #: ../../../CHANGELOG.md:3116
  7966. msgid "Mac: `sed -i '' 's/matrix-servers/matrix_servers/g' inventory/hosts`"
  7967. msgstr ""
  7968. #: ../../../CHANGELOG.md:3119
  7969. msgid "2019-05-21"
  7970. msgstr ""
  7971. #: ../../../CHANGELOG.md:3121
  7972. msgid "Synapse no longer required"
  7973. msgstr ""
  7974. #: ../../../CHANGELOG.md:3123
  7975. msgid ""
  7976. "The playbook no longer insists on installing [Synapse](https://github.com"
  7977. "/element-hq/synapse) via the `matrix-synapse` role."
  7978. msgstr ""
  7979. #: ../../../CHANGELOG.md:3125
  7980. msgid ""
  7981. "If you would prefer to install Synapse another way and just use the "
  7982. "playbook to install other services, it should be possible "
  7983. "(`matrix_synapse_enabled: false`)."
  7984. msgstr ""
  7985. #: ../../../CHANGELOG.md:3127
  7986. msgid ""
  7987. "Note that it won't necessarily be the best experience, since the playbook"
  7988. " wires things to Synapse by default. If you're using your own Synapse "
  7989. "instance (especially one not running in a container), you may have to "
  7990. "override many variables to point them to the correct place."
  7991. msgstr ""
  7992. #: ../../../CHANGELOG.md:3129
  7993. msgid ""
  7994. "Having Synapse not be a required component potentially opens the door for"
  7995. " installing alternative Matrix homeservers."
  7996. msgstr ""
  7997. #: ../../../CHANGELOG.md:3131
  7998. msgid "Bridges are now separate from the Synapse role"
  7999. msgstr ""
  8000. #: ../../../CHANGELOG.md:3133
  8001. msgid ""
  8002. "Bridges are no longer part of the `matrix-synapse` role. Each bridge now "
  8003. "lives in its own separate role (`roles/custom/matrix-bridge-*`)."
  8004. msgstr ""
  8005. #: ../../../CHANGELOG.md:3135
  8006. msgid ""
  8007. "These bridge roles are independent of the `matrix-synapse` role, so it "
  8008. "should be possible to use them with a Synapse instance installed another "
  8009. "way (not through the playbook)."
  8010. msgstr ""
  8011. #: ../../../CHANGELOG.md:3137
  8012. msgid "Renaming inconsistently-named Synapse variables"
  8013. msgstr ""
  8014. #: ../../../CHANGELOG.md:3139
  8015. msgid "For better consistency, the following variables have been renamed:"
  8016. msgstr ""
  8017. #: ../../../CHANGELOG.md:3141
  8018. msgid ""
  8019. "`matrix_enable_room_list_search` was renamed to "
  8020. "`matrix_synapse_enable_room_list_search`"
  8021. msgstr ""
  8022. #: ../../../CHANGELOG.md:3142
  8023. msgid ""
  8024. "`matrix_alias_creation_rules` was renamed to "
  8025. "`matrix_synapse_alias_creation_rules`"
  8026. msgstr ""
  8027. #: ../../../CHANGELOG.md:3143
  8028. msgid ""
  8029. "`matrix_nginx_proxy_matrix_room_list_publication_rulesdata_path` was "
  8030. "renamed to `matrix_synapse_room_list_publication_rules`"
  8031. msgstr ""
  8032. #: ../../../CHANGELOG.md:3146
  8033. msgid "2019-05-09"
  8034. msgstr ""
  8035. #: ../../../CHANGELOG.md:3148
  8036. msgid ""
  8037. "Besides a myriad of bug fixes and minor improvements, here are the more "
  8038. "notable (bigger) features we can announce today."
  8039. msgstr ""
  8040. #: ../../../CHANGELOG.md:3150
  8041. msgid "Mautrix Facebook/Messenger bridging support"
  8042. msgstr ""
  8043. #: ../../../CHANGELOG.md:3152
  8044. msgid ""
  8045. "The playbook now supports bridging with "
  8046. "[Facebook](https://www.facebook.com/) by installing the [mautrix-"
  8047. "facebook](https://github.com/tulir/mautrix-facebook) bridge. This "
  8048. "playbook functionality is available thanks to "
  8049. "[@izissise](https://github.com/izissise)."
  8050. msgstr ""
  8051. #: ../../../CHANGELOG.md:3154
  8052. msgid ""
  8053. "Additional details are available in [Setting up Mautrix Facebook "
  8054. "bridging](docs/configuring-playbook-bridge-mautrix-facebook.md)."
  8055. msgstr ""
  8056. #: ../../../CHANGELOG.md:3156
  8057. msgid "mxisd Registration feature integration"
  8058. msgstr ""
  8059. #: ../../../CHANGELOG.md:3158
  8060. msgid ""
  8061. "The playbook can now help you integrate with mxisd's "
  8062. "[Registration](https://github.com/kamax-"
  8063. "matrix/mxisd/blob/master/docs/features/registration.md) feature."
  8064. msgstr ""
  8065. #: ../../../CHANGELOG.md:3160
  8066. msgid ""
  8067. "Learn more in [mxisd-controlled Registration](docs/configuring-playbook-"
  8068. "mxisd.md#mxisd-controlled-registration)."
  8069. msgstr ""
  8070. #: ../../../CHANGELOG.md:3163
  8071. msgid "2019-04-16"
  8072. msgstr ""
  8073. #: ../../../CHANGELOG.md:3165
  8074. msgid "Caddy webserver examples"
  8075. msgstr ""
  8076. #: ../../../CHANGELOG.md:3167
  8077. msgid ""
  8078. "If you prefer using the [Caddy](https://caddyserver.com/) webserver "
  8079. "instead of our own integrated nginx, we now have examples for it in the "
  8080. "[`examples/caddy`](examples/caddy) directory"
  8081. msgstr ""
  8082. #: ../../../CHANGELOG.md:3169
  8083. msgid "2019-04-10"
  8084. msgstr ""
  8085. #: ../../../CHANGELOG.md:3171
  8086. msgid "Goofys support for other S3-compatible object stores"
  8087. msgstr ""
  8088. #: ../../../CHANGELOG.md:3173
  8089. msgid ""
  8090. "Until now, you could optionally host Synapse's media repository on Amazon"
  8091. " S3, but we now also support [using other S3-compatible object "
  8092. "stores](docs/configuring-playbook-s3.md),"
  8093. msgstr ""
  8094. #: ../../../CHANGELOG.md:3176
  8095. msgid "2019-04-03"
  8096. msgstr ""
  8097. #: ../../../CHANGELOG.md:3178
  8098. msgid "Ansible >= 2.5 is required"
  8099. msgstr ""
  8100. #: ../../../CHANGELOG.md:3180
  8101. msgid ""
  8102. "Due to recent playbook improvements and the fact that the world keeps "
  8103. "turning, we're bumping the [version requirement for "
  8104. "Ansible](docs/ansible.md#supported-ansible-versions) (2.4 -> 2.5)."
  8105. msgstr ""
  8106. #: ../../../CHANGELOG.md:3182
  8107. msgid ""
  8108. "We've also started building our own Docker image of Ansible "
  8109. "([devture/ansible](https://hub.docker.com/r/devture/ansible/)), which is "
  8110. "useful for people who can't upgrade their local Ansible installation (see"
  8111. " [Using Ansible via Docker](docs/ansible.md#using-ansible-via-docker))."
  8112. msgstr ""
  8113. #: ../../../CHANGELOG.md:3185
  8114. msgid "2019-03-19"
  8115. msgstr ""
  8116. #: ../../../CHANGELOG.md:3187
  8117. msgid "TLS support for Coturn"
  8118. msgstr ""
  8119. #: ../../../CHANGELOG.md:3189
  8120. msgid ""
  8121. "We've added TLS support to the Coturn TURN server installed by the "
  8122. "playbook by default. The certificates from the Matrix domain will be used"
  8123. " for the Coturn server."
  8124. msgstr ""
  8125. #: ../../../CHANGELOG.md:3191
  8126. msgid ""
  8127. "This feature is enabled by default for new installations. To make use of "
  8128. "TLS support for your existing Matrix server's Coturn, make sure to "
  8129. "rebuild both Coturn and Synapse:"
  8130. msgstr ""
  8131. #: ../../../CHANGELOG.md:3197
  8132. msgid ""
  8133. "People who have an extra firewall (besides the iptables firewall, which "
  8134. "Docker manages automatically), will need to open these additional "
  8135. "firewall ports: `5349/tcp` (TURN over TCP) and `5349/udp` (TURN over "
  8136. "UDP)."
  8137. msgstr ""
  8138. #: ../../../CHANGELOG.md:3199
  8139. msgid ""
  8140. "People who build their own custom playbook from our roles should be aware"
  8141. " that:"
  8142. msgstr ""
  8143. #: ../../../CHANGELOG.md:3201
  8144. msgid ""
  8145. "the `matrix-coturn` role and actually starting Coturn (e.g. "
  8146. "`--tags=start`), requires that certificates are already put in place. For"
  8147. " this reason, it's usually a good idea to have the `matrix-coturn` role "
  8148. "execute after `matrix-nginx-proxy` (which retrieves the certificates)."
  8149. msgstr ""
  8150. #: ../../../CHANGELOG.md:3203
  8151. msgid ""
  8152. "there are a few variables that can help you enable TLS support for "
  8153. "Coturn. See the `matrix-coturn` section in [group_vars/matrix-"
  8154. "servers](./group_vars/matrix-servers)."
  8155. msgstr ""
  8156. #: ../../../CHANGELOG.md:3206
  8157. msgid "2019-03-12"
  8158. msgstr ""
  8159. #: ../../../CHANGELOG.md:3208
  8160. msgid "matrix-nginx-proxy support for serving the base domain"
  8161. msgstr ""
  8162. #: ../../../CHANGELOG.md:3210
  8163. msgid ""
  8164. "If you don't have a dedicated server for your base domain and want to set"
  8165. " up [Server Delegation via a well-known file](docs/howto-server-"
  8166. "delegation.md#server-delegation-via-a-well-known-file), the playbook has "
  8167. "got you covered now."
  8168. msgstr ""
  8169. #: ../../../CHANGELOG.md:3212
  8170. msgid ""
  8171. "It's now possible for the playbook to obtain an SSL certificate and serve"
  8172. " the necessary files for Matrix Server Delegation on your base domain. "
  8173. "Take a look at the new [Serving the base domain](docs/configuring-"
  8174. "playbook-base-domain-serving.md) documentation page."
  8175. msgstr ""
  8176. #: ../../../CHANGELOG.md:3214
  8177. msgid "(BC break) matrix-nginx-proxy data variable renamed"
  8178. msgstr ""
  8179. #: ../../../CHANGELOG.md:3216
  8180. msgid ""
  8181. "`matrix_nginx_proxy_data_path` was renamed to "
  8182. "`matrix_nginx_proxy_base_path`."
  8183. msgstr ""
  8184. #: ../../../CHANGELOG.md:3218
  8185. msgid ""
  8186. "There's a new `matrix_nginx_proxy_data_path` variable, which has a "
  8187. "different use-purpose now (it's a subdirectory of "
  8188. "`matrix_nginx_proxy_base_path` and is meant for storing various data "
  8189. "files)."
  8190. msgstr ""
  8191. #: ../../../CHANGELOG.md:3221
  8192. msgid "2019-03-10"
  8193. msgstr ""
  8194. #: ../../../CHANGELOG.md:3223
  8195. msgid "Dimension integration manager support"
  8196. msgstr ""
  8197. #: ../../../CHANGELOG.md:3225
  8198. msgid ""
  8199. "Thanks to [NullIsNot0](https://github.com/NullIsNot0), the playbook can "
  8200. "now (optionally) install the [Dimension](https://dimension.t2bot.io/) "
  8201. "integration manager. To learn more, see the [Setting up Dimension](docs"
  8202. "/configuring-playbook-dimension.md) documentation page."
  8203. msgstr ""
  8204. #: ../../../CHANGELOG.md:3228
  8205. msgid "2019-03-07"
  8206. msgstr ""
  8207. #: ../../../CHANGELOG.md:3230
  8208. msgid "Ability to customize mxisd's email templates"
  8209. msgstr ""
  8210. #: ../../../CHANGELOG.md:3232
  8211. msgid ""
  8212. "Thanks to [Sylvia van Os](https://github.com/TheLastProject), mxisd's "
  8213. "email templates can now be customized easily. To learn more, see the "
  8214. "[Customizing email templates](docs/configuring-playbook-mxisd.md"
  8215. "#customizing-email-templates) documentation page."
  8216. msgstr ""
  8217. #: ../../../CHANGELOG.md:3235
  8218. msgid "2019-03-05"
  8219. msgstr ""
  8220. #: ../../../CHANGELOG.md:3237
  8221. msgid "Discord bridging support"
  8222. msgstr ""
  8223. #: ../../../CHANGELOG.md:3239
  8224. msgid ""
  8225. "[@Lionstiger](https://github.com/Lionstiger) has done some great work "
  8226. "adding Discord bridging support via [matrix-appservice-"
  8227. "discord](https://github.com/matrix-org/matrix-appservice-discord). To "
  8228. "learn more, see the [Setting up Appservice Discord bridging](docs"
  8229. "/configuring-playbook-bridge-appservice-discord.md) documentation page."
  8230. msgstr ""
  8231. #: ../../../CHANGELOG.md:3242
  8232. msgid "2019-02-19"
  8233. msgstr ""
  8234. #: ../../../CHANGELOG.md:3244
  8235. msgid "Renaming variables"
  8236. msgstr ""
  8237. #: ../../../CHANGELOG.md:3246 ../../../CHANGELOG.md:3563
  8238. #: ../../../CHANGELOG.md:3648 ../../../CHANGELOG.md:3768
  8239. msgid "The following playbook variables were renamed:"
  8240. msgstr ""
  8241. #: ../../../CHANGELOG.md:3248
  8242. msgid "from `host_specific_hostname_identity` to `matrix_domain`"
  8243. msgstr ""
  8244. #: ../../../CHANGELOG.md:3249
  8245. msgid "from `hostname_identity` to `matrix_domain`"
  8246. msgstr ""
  8247. #: ../../../CHANGELOG.md:3250
  8248. msgid "from `hostname_matrix` to `matrix_server_fqn_matrix`"
  8249. msgstr ""
  8250. #: ../../../CHANGELOG.md:3251
  8251. msgid "from `hostname_riot` to `matrix_server_fqn_riot`"
  8252. msgstr ""
  8253. #: ../../../CHANGELOG.md:3252
  8254. msgid ""
  8255. "from `host_specific_matrix_ssl_lets_encrypt_support_email` to "
  8256. "`matrix_ssl_lets_encrypt_support_email`"
  8257. msgstr ""
  8258. #: ../../../CHANGELOG.md:3254
  8259. msgid ""
  8260. "Doing that, we've simplified things, made names less confusing "
  8261. "(hopefully) and moved all variable names under the `matrix_` prefix."
  8262. msgstr ""
  8263. #: ../../../CHANGELOG.md:3257
  8264. msgid "2019-02-16"
  8265. msgstr ""
  8266. #: ../../../CHANGELOG.md:3259
  8267. msgid "Riot v1.0.1 support"
  8268. msgstr ""
  8269. #: ../../../CHANGELOG.md:3261
  8270. msgid "You can now use the brand new and redesigned Riot."
  8271. msgstr ""
  8272. #: ../../../CHANGELOG.md:3263
  8273. msgid ""
  8274. "The new version no longer has a homepage by default, so we've also "
  8275. "removed the custom homepage that we've been installing."
  8276. msgstr ""
  8277. #: ../../../CHANGELOG.md:3265
  8278. msgid ""
  8279. "However, we still provide you with hooks to install your own `home.html` "
  8280. "file by specifying the `matrix_riot_web_embedded_pages_home_path` "
  8281. "variable (used to be called `matrix_riot_web_homepage_template` before)."
  8282. msgstr ""
  8283. #: ../../../CHANGELOG.md:3268
  8284. msgid "2019-02-14"
  8285. msgstr ""
  8286. #: ../../../CHANGELOG.md:3270
  8287. msgid "Synapse v0.99.1"
  8288. msgstr ""
  8289. #: ../../../CHANGELOG.md:3272
  8290. msgid ""
  8291. "As we're moving toward Synapse v1.0, things are beginning to stabilize. "
  8292. "Upgrading from v0.99.0 to v0.99.1 should be painless."
  8293. msgstr ""
  8294. #: ../../../CHANGELOG.md:3274
  8295. msgid ""
  8296. "If you've been overriding the default configuration so that you can "
  8297. "terminate TLS at the Synapse side (`matrix_synapse_no_tls: false`), "
  8298. "you'll now have to replace this custom configuration with "
  8299. "`matrix_synapse_tls_federation_listener_enabled: true`. The "
  8300. "`matrix_synapse_no_tls` variable is no more."
  8301. msgstr ""
  8302. #: ../../../CHANGELOG.md:3277
  8303. msgid "2019-02-06"
  8304. msgstr ""
  8305. #: ../../../CHANGELOG.md:3279
  8306. msgid "Synapse v0.99 support and preparation for Synapse v1.0"
  8307. msgstr ""
  8308. #: ../../../CHANGELOG.md:3281
  8309. msgid ""
  8310. "Matrix is undergoing a lot of changes as it matures towards Synapse v1.0."
  8311. " The first step is the Synapse v0.99 transitional release, which this "
  8312. "playbook now supports."
  8313. msgstr ""
  8314. #: ../../../CHANGELOG.md:3283
  8315. msgid ""
  8316. "If you've been using this playbook successfully until now, you'd be aware"
  8317. " that we've been doing [Server Delegation](docs/howto-server-"
  8318. "delegation.md) using a `_matrix._tcp` DNS SRV record (as per [Configuring"
  8319. " DNS](docs/configuring-dns.md))."
  8320. msgstr ""
  8321. #: ../../../CHANGELOG.md:3285
  8322. msgid ""
  8323. "Due to changes related to certificate file requirements that will affect "
  8324. "us at Synapse v1.0, we'll have to stop using a **`_matrix._tcp` DNS SRV "
  8325. "record in the future** (when Synapse goes to v1.0 - around 5th of March "
  8326. "2019). We **still need to keep the SRV record for now**, for backward "
  8327. "compatibility with older Synapse versions (lower than v0.99)."
  8328. msgstr ""
  8329. #: ../../../CHANGELOG.md:3287
  8330. msgid ""
  8331. "**What you need to do now** is make use of this transitional Synapse "
  8332. "v0.99 release to **prepare your federation settings for the future**. You"
  8333. " have 2 choices to prepare yourself for compatibility with the future "
  8334. "Synapse v1.0:"
  8335. msgstr ""
  8336. #: ../../../CHANGELOG.md:3289
  8337. msgid ""
  8338. "(recommended) set up [Server Delegation via a well-known file](docs"
  8339. "/howto-server-delegation.md#server-delegation-via-a-well-known-file), "
  8340. "unless you are affected by the [Downsides of well-known-based Server "
  8341. "Delegation](docs/howto-server-delegation.md#downsides-of-well-known-"
  8342. "based-server-delegation). If you had previously set up the well-known "
  8343. "`client` file, depending on how you've done it, it may be that there is "
  8344. "nothing new required of you (besides [upgrading](docs/maintenance-"
  8345. "upgrading-services.md)). After upgrading, you can [run a self-check](docs"
  8346. "/maintenance-checking-services.md), which will tell you if you need to do"
  8347. " anything extra with regard to setting up [Server Delegation via a well-"
  8348. "known file](docs/howto-server-delegation.md#server-delegation-via-a-well-"
  8349. "known-file). After some time, when most people have upgraded to Synapse "
  8350. "v0.99 and older releases have disappeared, be prepared to drop your "
  8351. "`_matrix._tcp` SRV record."
  8352. msgstr ""
  8353. #: ../../../CHANGELOG.md:3291
  8354. msgid ""
  8355. "(more advanced) if the [Downsides of well-known-based Server "
  8356. "Delegation](docs/howto-server-delegation.md#downsides-of-well-known-"
  8357. "based-server-delegation) are not to your liking, **as an alternative**, "
  8358. "you can set up [Server Delegation via a DNS SRV record](docs/howto-"
  8359. "server-delegation.md#server-delegation-via-a-dns-srv-record-advanced). In"
  8360. " such a case, you get to keep using your existing `_matrix._tcp` DNS SRV "
  8361. "record forever and need to NOT set up a `/.well-known/matrix/server` "
  8362. "file. Don't forget that you need to do certificate changes though. Follow"
  8363. " the guide at [Server Delegation via a DNS SRV record](docs/howto-server-"
  8364. "delegation.md#server-delegation-via-a-dns-srv-record-advanced)."
  8365. msgstr ""
  8366. #: ../../../CHANGELOG.md:3294
  8367. msgid "2019-02-01"
  8368. msgstr ""
  8369. #: ../../../CHANGELOG.md:3296
  8370. msgid "TLS v1.3 support"
  8371. msgstr ""
  8372. #: ../../../CHANGELOG.md:3298
  8373. msgid ""
  8374. "Now that the [nginx Docker image](https://hub.docker.com/_/nginx) has "
  8375. "[added support for TLS v1.3](https://github.com/nginxinc/docker-"
  8376. "nginx/issues/190), we have enabled that protocol by default."
  8377. msgstr ""
  8378. #: ../../../CHANGELOG.md:3300
  8379. msgid "When using:"
  8380. msgstr ""
  8381. #: ../../../CHANGELOG.md:3302
  8382. msgid ""
  8383. "the **integrated nginx server**: TLS v1.3 support might not kick in "
  8384. "immediately, because the nginx version hasn't been bumped and you may "
  8385. "have an older build of the nginx Docker image (currently "
  8386. "`nginx:1.15.8-alpine`). Typically, we do not re-pull images that you "
  8387. "already have. When the nginx version gets bumped in the future, everyone "
  8388. "will get the update. Until then, you could manually force-pull the "
  8389. "rebuilt Docker image by running this on the server: `docker pull "
  8390. "nginx:1.15.8-alpine`."
  8391. msgstr ""
  8392. #: ../../../CHANGELOG.md:3304
  8393. msgid ""
  8394. "**your own external nginx server**: if your external nginx server is too "
  8395. "old, the new configuration we generate for you in `/matrix/nginx-"
  8396. "proxy/conf.d/` might not work anymore, because it mentions `TLSv1.3` and "
  8397. "your nginx version might not support that. You can adjust the SSL "
  8398. "protocol list by overriding the `matrix_nginx_proxy_ssl_protocols` "
  8399. "variable. Learn more in the documentation page for [Using your own "
  8400. "webserver, instead of this playbook's nginx proxy](docs/configuring-"
  8401. "playbook-own-webserver.md)"
  8402. msgstr ""
  8403. #: ../../../CHANGELOG.md:3306
  8404. msgid ""
  8405. "**another web server**: you don't need to do anything to accommodate this"
  8406. " change"
  8407. msgstr ""
  8408. #: ../../../CHANGELOG.md:3309
  8409. msgid "2019-01-31"
  8410. msgstr ""
  8411. #: ../../../CHANGELOG.md:3311
  8412. msgid "IRC bridging support"
  8413. msgstr ""
  8414. #: ../../../CHANGELOG.md:3313
  8415. msgid ""
  8416. "[Devon Maloney (@Plailect)](https://github.com/Plailect) has done some "
  8417. "great work bringing IRC bridging support via [matrix-appservice-"
  8418. "irc](https://github.com/TeDomum/matrix-appservice-irc). To learn more, "
  8419. "see the [Setting up Appservice IRC bridging](docs/configuring-playbook-"
  8420. "bridge-appservice-irc.md) documentation page."
  8421. msgstr ""
  8422. #: ../../../CHANGELOG.md:3316
  8423. msgid "2019-01-29"
  8424. msgstr ""
  8425. #: ../../../CHANGELOG.md:3318
  8426. msgid ""
  8427. "Running container processes as non-root, without capabilities and read-"
  8428. "only"
  8429. msgstr ""
  8430. #: ../../../CHANGELOG.md:3320
  8431. msgid ""
  8432. "To improve security, this playbook no longer starts container processes "
  8433. "as the `root` user. Most containers were dropping privileges anyway, but "
  8434. "we were trusting them with `root` privileges until they would do that. "
  8435. "Not anymore -- container processes now start as a non-root user (usually "
  8436. "`matrix`) from the get-go."
  8437. msgstr ""
  8438. #: ../../../CHANGELOG.md:3322
  8439. msgid ""
  8440. "For additional security, various capabilities are also dropped (see [why "
  8441. "it's important](https://github.com/projectatomic/atomic-site/issues/203))"
  8442. " for all containers."
  8443. msgstr ""
  8444. #: ../../../CHANGELOG.md:3324
  8445. msgid ""
  8446. "Additionally, most containers now use a read-only filesystem (see [why "
  8447. "it's important](https://www.projectatomic.io/blog/2015/12/making-docker-"
  8448. "images-write-only-in-production/)). Containers are given write access "
  8449. "only to the directories they need to write to."
  8450. msgstr ""
  8451. #: ../../../CHANGELOG.md:3326
  8452. msgid ""
  8453. "A minor breaking change is the "
  8454. "`matrix_nginx_proxy_proxy_matrix_client_api_client_max_body_size` "
  8455. "variable having being renamed to "
  8456. "`matrix_nginx_proxy_proxy_matrix_client_api_client_max_body_size_mb` "
  8457. "(note the `_mb` suffix). The new variable expects a number value (e.g. "
  8458. "`25M` -> `25`). If you weren't customizing this variable, this wouldn't "
  8459. "affect you."
  8460. msgstr ""
  8461. #: ../../../CHANGELOG.md:3328
  8462. msgid "matrix-mailer is now based on Exim, not Postfix"
  8463. msgstr ""
  8464. #: ../../../CHANGELOG.md:3330
  8465. msgid ""
  8466. "While we would have preferred to stay with "
  8467. "[Postfix](http://www.postfix.org/), we found out that it cannot run as a "
  8468. "non-root user. We've had to replace it with [Exim](https://www.exim.org/)"
  8469. " (via the [devture/exim-relay](https://hub.docker.com/r/devture/exim-"
  8470. "relay) container image)."
  8471. msgstr ""
  8472. #: ../../../CHANGELOG.md:3332
  8473. msgid ""
  8474. "The internal `matrix-mailer` service (running in a container) now listens"
  8475. " on port `8025` (used to be `587` before). The playbook will update your "
  8476. "Synapse and mxisd email settings to match (`matrix-mailer:587` -> "
  8477. "`matrix-mailer:8025`)."
  8478. msgstr ""
  8479. #: ../../../CHANGELOG.md:3334
  8480. msgid ""
  8481. "Using the [devture/exim-relay](https://hub.docker.com/r/devture/exim-"
  8482. "relay) container image instead of "
  8483. "[panubo/postfix](https://hub.docker.com/r/panubo/postfix/) also gives us "
  8484. "a nice disk usage reduction (~200MB -> 8MB)."
  8485. msgstr ""
  8486. #: ../../../CHANGELOG.md:3337
  8487. msgid "2019-01-17"
  8488. msgstr ""
  8489. #: ../../../CHANGELOG.md:3339
  8490. msgid "(BC Break) Making the playbook's roles more independent of one another"
  8491. msgstr ""
  8492. #: ../../../CHANGELOG.md:3341
  8493. msgid ""
  8494. "The following change **affects people running a more non-standard setup**"
  8495. " - external Postgres or using our roles in their own other playbook. "
  8496. "**Most users don't need to do anything**, besides becoming aware of the "
  8497. "new glue variables file [`group_vars/matrix-servers`](group_vars/matrix-"
  8498. "servers)."
  8499. msgstr ""
  8500. #: ../../../CHANGELOG.md:3344
  8501. msgid ""
  8502. "Because people like using the playbook's components independently "
  8503. "(outside of this playbook) and because it's much better for "
  8504. "maintainability, we've continued working on separating them. Still, we'd "
  8505. "like to offer a turnkey solution for running a fully-featured Matrix "
  8506. "server, so this playbook remains important for wiring up the various "
  8507. "components."
  8508. msgstr ""
  8509. #: ../../../CHANGELOG.md:3346
  8510. msgid ""
  8511. "With the new changes, **all roles are now only dependent on the minimal "
  8512. "`matrix-base` role**. They are no longer dependent among themselves."
  8513. msgstr ""
  8514. #: ../../../CHANGELOG.md:3348
  8515. msgid ""
  8516. "In addition, the following components can now be completely disabled (for"
  8517. " those who want/need to):"
  8518. msgstr ""
  8519. #: ../../../CHANGELOG.md:3349
  8520. msgid "`matrix-coturn` by using `matrix_coturn_enabled: false`"
  8521. msgstr ""
  8522. #: ../../../CHANGELOG.md:3350
  8523. msgid "`matrix-mailer` by using `matrix_mailer_enabled: false`"
  8524. msgstr ""
  8525. #: ../../../CHANGELOG.md:3351
  8526. msgid "`matrix-postgres` by using `matrix_postgres_enabled: false`"
  8527. msgstr ""
  8528. #: ../../../CHANGELOG.md:3353
  8529. msgid "The following changes had to be done:"
  8530. msgstr ""
  8531. #: ../../../CHANGELOG.md:3355
  8532. msgid ""
  8533. "glue variables had to be introduced to the playbook, so it can wire "
  8534. "together the various components. Those glue vars are stored in the "
  8535. "[`group_vars/matrix-servers`](group_vars/matrix-servers) file. When "
  8536. "overriding variables for a given component (role), you need to be aware "
  8537. "of both the role defaults (`role/ROLE/defaults/main.yml`) and the role's "
  8538. "corresponding section in the [`group_vars/matrix-servers`](group_vars"
  8539. "/matrix-servers) file."
  8540. msgstr ""
  8541. #: ../../../CHANGELOG.md:3357
  8542. msgid ""
  8543. "`matrix_postgres_use_external` has been superceeded by the more "
  8544. "consistently named `matrix_postgres_enabled` variable and a few other "
  8545. "`matrix_synapse_database_` variables. See the [Using an external "
  8546. "PostgreSQL server (optional)](docs/configuring-playbook-external-"
  8547. "postgres.md) documentation page for an up-to-date replacement."
  8548. msgstr ""
  8549. #: ../../../CHANGELOG.md:3359
  8550. msgid ""
  8551. "Postgres tools (`matrix-postgres-cli` and `matrix-make-user-admin`) are "
  8552. "no longer installed if you're not enabling the `matrix-postgres` role "
  8553. "(`matrix_postgres_enabled: false`)"
  8554. msgstr ""
  8555. #: ../../../CHANGELOG.md:3361
  8556. msgid ""
  8557. "roles, being more independent now, are more minimal and do not do so much"
  8558. " magic for you. People that are building their own playbook using our "
  8559. "roles will definitely need to take a look at the [`group_vars/matrix-"
  8560. "servers`](group_vars/matrix-servers) file and adapt their playbooks with "
  8561. "the same (or similar) wiring logic."
  8562. msgstr ""
  8563. #: ../../../CHANGELOG.md:3364
  8564. msgid "2019-01-16"
  8565. msgstr ""
  8566. #: ../../../CHANGELOG.md:3366
  8567. msgid "Splitting the playbook into multiple roles"
  8568. msgstr ""
  8569. #: ../../../CHANGELOG.md:3368
  8570. msgid ""
  8571. "For better maintainability, the playbook logic (which all used to reside "
  8572. "in a single `matrix-server` role) has been split out into a number of "
  8573. "different roles: `matrix-synapse`, `matrix-postgres`, `matrix-riot-web`, "
  8574. "`matrix-mxisd`, etc. (see the `roles/` directory)."
  8575. msgstr ""
  8576. #: ../../../CHANGELOG.md:3371
  8577. msgid ""
  8578. "To keep the filesystem more consistent with this separation, the "
  8579. "**Postgres data had to be relocated**."
  8580. msgstr ""
  8581. #: ../../../CHANGELOG.md:3373
  8582. msgid ""
  8583. "The default value of `matrix_postgres_data_path` was changed from "
  8584. "`/matrix/postgres` to `/matrix/postgres/data`. The `/matrix/postgres` "
  8585. "directory is what we consider a base path now (new variable "
  8586. "`matrix_postgres_base_path`). **Your Postgres data files will "
  8587. "automatically be relocated by the playbook** (`/matrix/postgres/*` -> "
  8588. "`/matrix/postgres/data/`) when you run with `--tags=setup-all` (or "
  8589. "`--tags=setup-postgres`). While this shouldn't cause data-loss, **it's "
  8590. "better if you do a Postgres backup just in case**. You'd need to restart "
  8591. "all services after this migration (`--tags=start`)."
  8592. msgstr ""
  8593. #: ../../../CHANGELOG.md:3376
  8594. msgid "2019-01-11"
  8595. msgstr ""
  8596. #: ../../../CHANGELOG.md:3378
  8597. msgid "(BC Break) mxisd configuration changes"
  8598. msgstr ""
  8599. #: ../../../CHANGELOG.md:3380
  8600. msgid ""
  8601. "To be more flexible and to support the upcoming "
  8602. "[mxisd](https://github.com/kamax-io/mxisd) 1.3.0 (when it gets released),"
  8603. " we've had to redo how mxisd gets configured."
  8604. msgstr ""
  8605. #: ../../../CHANGELOG.md:3383
  8606. msgid "The following variables are no longer supported by this playbook:"
  8607. msgstr ""
  8608. #: ../../../CHANGELOG.md:3385
  8609. msgid "`matrix_mxisd_ldap_enabled`"
  8610. msgstr ""
  8611. #: ../../../CHANGELOG.md:3386
  8612. msgid "`matrix_mxisd_ldap_connection_host`"
  8613. msgstr ""
  8614. #: ../../../CHANGELOG.md:3387
  8615. msgid "`matrix_mxisd_ldap_connection_tls`"
  8616. msgstr ""
  8617. #: ../../../CHANGELOG.md:3388
  8618. msgid "`matrix_mxisd_ldap_connection_port`"
  8619. msgstr ""
  8620. #: ../../../CHANGELOG.md:3389
  8621. msgid "`matrix_mxisd_ldap_connection_baseDn`"
  8622. msgstr ""
  8623. #: ../../../CHANGELOG.md:3390
  8624. msgid "`matrix_mxisd_ldap_connection_baseDns`"
  8625. msgstr ""
  8626. #: ../../../CHANGELOG.md:3391 ../../../CHANGELOG.md:3392
  8627. msgid "`matrix_mxisd_ldap_connection_bindDn`"
  8628. msgstr ""
  8629. #: ../../../CHANGELOG.md:3393 ../../../CHANGELOG.md:3397
  8630. msgid "`matrix_mxisd_ldap_connection_bindPassword`"
  8631. msgstr ""
  8632. #: ../../../CHANGELOG.md:3394
  8633. msgid "`matrix_mxisd_ldap_filter`"
  8634. msgstr ""
  8635. #: ../../../CHANGELOG.md:3395
  8636. msgid "`matrix_mxisd_ldap_attribute_uid_type`"
  8637. msgstr ""
  8638. #: ../../../CHANGELOG.md:3396
  8639. msgid "`matrix_mxisd_ldap_attribute_uid_value`"
  8640. msgstr ""
  8641. #: ../../../CHANGELOG.md:3398
  8642. msgid "`matrix_mxisd_ldap_attribute_name`"
  8643. msgstr ""
  8644. #: ../../../CHANGELOG.md:3399
  8645. msgid "`matrix_mxisd_ldap_attribute_threepid_email`"
  8646. msgstr ""
  8647. #: ../../../CHANGELOG.md:3400
  8648. msgid "`matrix_mxisd_ldap_attribute_threepid_msisdn`"
  8649. msgstr ""
  8650. #: ../../../CHANGELOG.md:3401
  8651. msgid "`matrix_mxisd_ldap_identity_filter`"
  8652. msgstr ""
  8653. #: ../../../CHANGELOG.md:3402
  8654. msgid "`matrix_mxisd_ldap_identity_medium`"
  8655. msgstr ""
  8656. #: ../../../CHANGELOG.md:3403
  8657. msgid "`matrix_mxisd_ldap_auth_filter`"
  8658. msgstr ""
  8659. #: ../../../CHANGELOG.md:3404
  8660. msgid "`matrix_mxisd_ldap_directory_filter`"
  8661. msgstr ""
  8662. #: ../../../CHANGELOG.md:3405
  8663. msgid "`matrix_mxisd_template_config`"
  8664. msgstr ""
  8665. #: ../../../CHANGELOG.md:3407
  8666. msgid ""
  8667. "You are encouraged to use the `matrix_mxisd_configuration_extension_yaml`"
  8668. " variable to define your own mxisd configuration additions and overrides."
  8669. " Refer to the [default variables file](roles/custom/matrix-"
  8670. "mxisd/defaults/main.yml) for more information."
  8671. msgstr ""
  8672. #: ../../../CHANGELOG.md:3409
  8673. msgid "This new way of configuring mxisd is beneficial because:"
  8674. msgstr ""
  8675. #: ../../../CHANGELOG.md:3411
  8676. msgid ""
  8677. "it lets us support all mxisd configuration options, as the playbook "
  8678. "simply forwards them to mxisd without needing to care or understand them"
  8679. msgstr ""
  8680. #: ../../../CHANGELOG.md:3412
  8681. msgid ""
  8682. "it lets you upgrade to newer mxisd versions and make use of their "
  8683. "features, without us having to add support for them explicitly"
  8684. msgstr ""
  8685. #: ../../../CHANGELOG.md:3415
  8686. msgid "2019-01-08"
  8687. msgstr ""
  8688. #: ../../../CHANGELOG.md:3417
  8689. msgid "(BC Break) Cronjob schedule no longer configurable"
  8690. msgstr ""
  8691. #: ../../../CHANGELOG.md:3419
  8692. msgid ""
  8693. "Due to the way we manage cronjobs now, you can no longer configure the "
  8694. "schedule they're invoked at."
  8695. msgstr ""
  8696. #: ../../../CHANGELOG.md:3421
  8697. msgid ""
  8698. "If you were previously using "
  8699. "`matrix_ssl_lets_encrypt_renew_cron_time_definition` or "
  8700. "`matrix_nginx_proxy_reload_cron_time_definition` to set a custom "
  8701. "schedule, you should note that these variables don't affect anything "
  8702. "anymore."
  8703. msgstr ""
  8704. #: ../../../CHANGELOG.md:3424
  8705. msgid ""
  8706. "If you miss this functionality, please [open an "
  8707. "Issue](https://github.com/spantaleev/matrix-docker-ansible-"
  8708. "deploy/issues/new) and let us know about your use case!"
  8709. msgstr ""
  8710. #: ../../../CHANGELOG.md:3427
  8711. msgid "2018-12-23"
  8712. msgstr ""
  8713. #: ../../../CHANGELOG.md:3429
  8714. msgid "(BC Break) More SSL certificate retrieval methods"
  8715. msgstr ""
  8716. #: ../../../CHANGELOG.md:3431
  8717. msgid ""
  8718. "The playbook now lets you decide between 3 different SSL certificate "
  8719. "retrieval methods:"
  8720. msgstr ""
  8721. #: ../../../CHANGELOG.md:3432
  8722. msgid "(default) obtaining free SSL certificates from Let's Encrypt"
  8723. msgstr ""
  8724. #: ../../../CHANGELOG.md:3433
  8725. msgid "generating self-signed SSL certificates"
  8726. msgstr ""
  8727. #: ../../../CHANGELOG.md:3434
  8728. msgid "managing SSL certificates manually"
  8729. msgstr ""
  8730. #: ../../../CHANGELOG.md:3436
  8731. msgid ""
  8732. "Learn more in [Adjusting SSL certificate retrieval](docs/configuring-"
  8733. "playbook-ssl-certificates.md)."
  8734. msgstr ""
  8735. #: ../../../CHANGELOG.md:3438
  8736. msgid ""
  8737. "For people who use Let's Encrypt (mostly everyone, since it's the "
  8738. "default), you'll also have to rename a variable in your configuration:"
  8739. msgstr ""
  8740. #: ../../../CHANGELOG.md:3440
  8741. msgid "before: `host_specific_matrix_ssl_support_email`"
  8742. msgstr ""
  8743. #: ../../../CHANGELOG.md:3441
  8744. msgid "after: `host_specific_matrix_ssl_lets_encrypt_support_email`"
  8745. msgstr ""
  8746. #: ../../../CHANGELOG.md:3443
  8747. msgid "(BC Break) mxisd upgrade with multiple base DN support"
  8748. msgstr ""
  8749. #: ../../../CHANGELOG.md:3445
  8750. msgid ""
  8751. "mxisd has bee upgraded to [version 1.2.2](https://github.com/kamax-"
  8752. "matrix/mxisd/releases/tag/v1.2.2), which supports [multiple base "
  8753. "DNs](https://github.com/kamax-"
  8754. "matrix/mxisd/blob/v1.2.2/docs/stores/ldap.md#base)."
  8755. msgstr ""
  8756. #: ../../../CHANGELOG.md:3447
  8757. msgid ""
  8758. "If you were configuring this playbook's "
  8759. "`matrix_mxisd_ldap_connection_baseDn` variable until now (a string "
  8760. "containing a single base DN), you'll need to change to configuring the "
  8761. "`matrix_mxisd_ldap_connection_baseDns` variable (an array containing "
  8762. "multiple base DNs)."
  8763. msgstr ""
  8764. #: ../../../CHANGELOG.md:3449
  8765. msgid "Example change:"
  8766. msgstr ""
  8767. #: ../../../CHANGELOG.md:3451
  8768. msgid "before: `matrix_mxisd_ldap_connection_baseDn: OU=Users,DC=example,DC=org`"
  8769. msgstr ""
  8770. #: ../../../CHANGELOG.md:3452
  8771. msgid ""
  8772. "after: `matrix_mxisd_ldap_connection_baseDns: "
  8773. "['OU=Users,DC=example,DC=org']`"
  8774. msgstr ""
  8775. #: ../../../CHANGELOG.md:3455
  8776. msgid "2018-12-21"
  8777. msgstr ""
  8778. #: ../../../CHANGELOG.md:3457
  8779. msgid "Synapse 0.34.0 and Python 3"
  8780. msgstr ""
  8781. #: ../../../CHANGELOG.md:3459
  8782. msgid ""
  8783. "Synapse has been upgraded to 0.34.0 and now uses Python 3. Based on "
  8784. "feedback from others, running Synapse on Python 3 is supposed to decrease"
  8785. " memory usage significantly (~2x)."
  8786. msgstr ""
  8787. #: ../../../CHANGELOG.md:3462
  8788. msgid "2018-12-12"
  8789. msgstr ""
  8790. #: ../../../CHANGELOG.md:3464
  8791. msgid "Riot homepage customization"
  8792. msgstr ""
  8793. #: ../../../CHANGELOG.md:3466
  8794. msgid ""
  8795. "You can now customize some parts of the Riot homepage (or even completely"
  8796. " replace it with your own custom page). See the "
  8797. "`matrix_riot_web_homepage_` variables in `roles/custom/matrix-riot-"
  8798. "web/defaults/main.yml`."
  8799. msgstr ""
  8800. #: ../../../CHANGELOG.md:3469
  8801. msgid "2018-12-04"
  8802. msgstr ""
  8803. #: ../../../CHANGELOG.md:3471
  8804. msgid "mxisd extensibility"
  8805. msgstr ""
  8806. #: ../../../CHANGELOG.md:3473
  8807. msgid ""
  8808. "The [LDAP identity store for mxisd](https://github.com/kamax-"
  8809. "matrix/mxisd/blob/master/docs/stores/ldap.md) can now be configured "
  8810. "easily using playbook variables (see the `matrix_mxisd_ldap_` variables "
  8811. "in `roles/custom/matrix-server/defaults/main.yml`)."
  8812. msgstr ""
  8813. #: ../../../CHANGELOG.md:3476
  8814. msgid "2018-11-28"
  8815. msgstr ""
  8816. #: ../../../CHANGELOG.md:3478
  8817. msgid "More scripts"
  8818. msgstr ""
  8819. #: ../../../CHANGELOG.md:3480
  8820. msgid "matrix-remove-all allows to uninstall everything with a single command"
  8821. msgstr ""
  8822. #: ../../../CHANGELOG.md:3481
  8823. msgid "matrix-make-user-admin allows to upgrade a user's privileges"
  8824. msgstr ""
  8825. #: ../../../CHANGELOG.md:3483
  8826. msgid "LDAP auth support via matrix-synapse-ldap3"
  8827. msgstr ""
  8828. #: ../../../CHANGELOG.md:3485
  8829. msgid ""
  8830. "The playbook can now install and configure [LDAP auth "
  8831. "support](https://github.com/matrix-org/matrix-synapse-ldap3) for you."
  8832. msgstr ""
  8833. #: ../../../CHANGELOG.md:3487
  8834. msgid ""
  8835. "Additional details are available in [Setting up the LDAP authentication "
  8836. "password provider module](docs/configuring-playbook-ldap-auth.md)."
  8837. msgstr ""
  8838. #: ../../../CHANGELOG.md:3490
  8839. msgid "2018-11-23"
  8840. msgstr ""
  8841. #: ../../../CHANGELOG.md:3492
  8842. msgid "Support for controlling public registration and room auto-join"
  8843. msgstr ""
  8844. #: ../../../CHANGELOG.md:3494
  8845. msgid ""
  8846. "The playbook now lets you enable public registration for users "
  8847. "(controlled via `matrix_synapse_enable_registration`). By default, public"
  8848. " registration is forbidden."
  8849. msgstr ""
  8850. #: ../../../CHANGELOG.md:3496
  8851. msgid ""
  8852. "You can also make people automatically get auto-joined to rooms "
  8853. "(controlled via `matrix_synapse_auto_join_rooms`)."
  8854. msgstr ""
  8855. #: ../../../CHANGELOG.md:3498
  8856. msgid "Support for changing the welcome user ID (welcome bot)"
  8857. msgstr ""
  8858. #: ../../../CHANGELOG.md:3500
  8859. msgid ""
  8860. "By default, `@riot-bot:matrix.org` is used to welcome newly registered "
  8861. "users. This can be changed to something else (or disabled) via the new "
  8862. "`matrix_riot_web_welcome_user_id` variable."
  8863. msgstr ""
  8864. #: ../../../CHANGELOG.md:3503
  8865. msgid "2018-11-14"
  8866. msgstr ""
  8867. #: ../../../CHANGELOG.md:3505
  8868. msgid "Ability to set Synapse log levels"
  8869. msgstr ""
  8870. #: ../../../CHANGELOG.md:3507
  8871. msgid ""
  8872. "The playbook now allows you to set the log levels used by Synapse. The "
  8873. "default logging levels remain the same."
  8874. msgstr ""
  8875. #: ../../../CHANGELOG.md:3509
  8876. msgid ""
  8877. "You can now override following variables with any of the supported log "
  8878. "levels listed here: https://docs.python.org/3/library/logging.html"
  8879. "#logging-levels"
  8880. msgstr ""
  8881. #: ../../../CHANGELOG.md:3518
  8882. msgid "2018-11-03"
  8883. msgstr ""
  8884. #: ../../../CHANGELOG.md:3520
  8885. msgid "Customize parts of Riot's config"
  8886. msgstr ""
  8887. #: ../../../CHANGELOG.md:3522
  8888. msgid ""
  8889. "You can now customize some parts of Riot's `config.json`. These playbook "
  8890. "variables, with these default values, have been added:"
  8891. msgstr ""
  8892. #: ../../../CHANGELOG.md:3533
  8893. msgid ""
  8894. "This now allows you use a custom integration manager like "
  8895. "[Dimension](https://dimension.t2bot.io). For example, if you wish to use "
  8896. "the Dimension instance hosted at dimension.t2bot.io, you can set the "
  8897. "following in your vars.yml file:"
  8898. msgstr ""
  8899. #: ../../../CHANGELOG.md:3542
  8900. msgid "SSL protocols used to serve Riot and Synapse"
  8901. msgstr ""
  8902. #: ../../../CHANGELOG.md:3544
  8903. msgid ""
  8904. "There's now a new `matrix_nginx_proxy_ssl_protocols` playbook variable, "
  8905. "which controls the SSL protocols used to serve Riot and Synapse. Its "
  8906. "default value is `TLSv1.1 TLSv1.2`. This playbook previously used `TLSv1 "
  8907. "TLSv1.1 TLSv1.2` to serve Riot and Synapse."
  8908. msgstr ""
  8909. #: ../../../CHANGELOG.md:3546
  8910. msgid ""
  8911. "You may wish to reenable TLSv1 if you need to access Riot in older "
  8912. "browsers."
  8913. msgstr ""
  8914. #: ../../../CHANGELOG.md:3548
  8915. msgid ""
  8916. "Note: Currently the dockerized nginx doesn't support TLSv1.3. See "
  8917. "https://github.com/nginxinc/docker-nginx/issues/190 for more details."
  8918. msgstr ""
  8919. #: ../../../CHANGELOG.md:3551
  8920. msgid "2018-11-01"
  8921. msgstr ""
  8922. #: ../../../CHANGELOG.md:3553
  8923. msgid "Postgres 11 support"
  8924. msgstr ""
  8925. #: ../../../CHANGELOG.md:3555
  8926. msgid ""
  8927. "The playbook now installs [Postgres "
  8928. "11](https://www.postgresql.org/about/news/1894/) by default."
  8929. msgstr ""
  8930. #: ../../../CHANGELOG.md:3557
  8931. msgid ""
  8932. "If you have have an existing setup, it's likely running on an older "
  8933. "Postgres version (9.x or 10.x). You can easily upgrade by following the "
  8934. "[upgrading PostgreSQL guide](docs/maintenance-postgres.md#upgrading-"
  8935. "postgresql)."
  8936. msgstr ""
  8937. #: ../../../CHANGELOG.md:3559 ../../../CHANGELOG.md:3646
  8938. #: ../../../CHANGELOG.md:3766
  8939. msgid "(BC Break) Renaming playbook variables"
  8940. msgstr ""
  8941. #: ../../../CHANGELOG.md:3561
  8942. msgid ""
  8943. "Due to the large amount of features added to this playbook lately, to "
  8944. "keep things manageable we've had to reorganize its configuration "
  8945. "variables a bit."
  8946. msgstr ""
  8947. #: ../../../CHANGELOG.md:3565
  8948. msgid "from `matrix_docker_image_mxisd` to `matrix_mxisd_docker_image`"
  8949. msgstr ""
  8950. #: ../../../CHANGELOG.md:3566
  8951. msgid ""
  8952. "from `matrix_docker_image_mautrix_telegram` to "
  8953. "`matrix_mautrix_telegram_docker_image`"
  8954. msgstr ""
  8955. #: ../../../CHANGELOG.md:3567
  8956. msgid ""
  8957. "from `matrix_docker_image_mautrix_whatsapp` to "
  8958. "`matrix_mautrix_whatsapp_docker_image`"
  8959. msgstr ""
  8960. #: ../../../CHANGELOG.md:3568
  8961. msgid "from `matrix_docker_image_mailer` to `matrix_mailer_docker_image`"
  8962. msgstr ""
  8963. #: ../../../CHANGELOG.md:3569
  8964. msgid "from `matrix_docker_image_coturn` to `matrix_coturn_docker_image`"
  8965. msgstr ""
  8966. #: ../../../CHANGELOG.md:3570
  8967. msgid "from `matrix_docker_image_goofys` to `matrix_s3_goofys_docker_image`"
  8968. msgstr ""
  8969. #: ../../../CHANGELOG.md:3571
  8970. msgid "from `matrix_docker_image_riot` to `matrix_riot_web_docker_image`"
  8971. msgstr ""
  8972. #: ../../../CHANGELOG.md:3572
  8973. msgid "from `matrix_docker_image_nginx` to `matrix_nginx_proxy_docker_image`"
  8974. msgstr ""
  8975. #: ../../../CHANGELOG.md:3573
  8976. msgid "from `matrix_docker_image_synapse` to `matrix_synapse_docker_image`"
  8977. msgstr ""
  8978. #: ../../../CHANGELOG.md:3574
  8979. msgid ""
  8980. "from `matrix_docker_image_postgres_v9` to "
  8981. "`matrix_postgres_docker_image_v9`"
  8982. msgstr ""
  8983. #: ../../../CHANGELOG.md:3575
  8984. msgid ""
  8985. "from `matrix_docker_image_postgres_v10` to "
  8986. "`matrix_postgres_docker_image_v10`"
  8987. msgstr ""
  8988. #: ../../../CHANGELOG.md:3576
  8989. msgid ""
  8990. "from `matrix_docker_image_postgres_latest` to "
  8991. "`matrix_postgres_docker_image_latest`"
  8992. msgstr ""
  8993. #: ../../../CHANGELOG.md:3579
  8994. msgid "2018-10-26"
  8995. msgstr ""
  8996. #: ../../../CHANGELOG.md:3581
  8997. msgid "Mautrix Whatsapp bridging support"
  8998. msgstr ""
  8999. #: ../../../CHANGELOG.md:3583
  9000. msgid ""
  9001. "The playbook now supports bridging with "
  9002. "[Whatsapp](https://www.whatsapp.com/) by installing the [mautrix-"
  9003. "whatsapp](https://github.com/tulir/mautrix-whatsapp) bridge. This "
  9004. "playbook functionality is available thanks to "
  9005. "[@izissise](https://github.com/izissise)."
  9006. msgstr ""
  9007. #: ../../../CHANGELOG.md:3585
  9008. msgid ""
  9009. "Additional details are available in [Setting up Mautrix Whatsapp "
  9010. "bridging](docs/configuring-playbook-bridge-mautrix-whatsapp.md)."
  9011. msgstr ""
  9012. #: ../../../CHANGELOG.md:3588
  9013. msgid "2018-10-25"
  9014. msgstr ""
  9015. #: ../../../CHANGELOG.md:3590
  9016. msgid "Support for controlling Matrix federation"
  9017. msgstr ""
  9018. #: ../../../CHANGELOG.md:3592
  9019. msgid ""
  9020. "The playbook can now help you with [Controlling Matrix federation](docs"
  9021. "/configuring-playbook-federation), should you wish to run a more private "
  9022. "(isolated) server."
  9023. msgstr ""
  9024. #: ../../../CHANGELOG.md:3595
  9025. msgid "2018-10-24"
  9026. msgstr ""
  9027. #: ../../../CHANGELOG.md:3597
  9028. msgid "Disabling riot-web guests"
  9029. msgstr ""
  9030. #: ../../../CHANGELOG.md:3599
  9031. msgid ""
  9032. "From now on, Riot's configuration setting `disable_guests` would be set "
  9033. "to `true`. The homeserver was rejecting guests anyway, so this is just a "
  9034. "cosmetic change affecting Riot's UI."
  9035. msgstr ""
  9036. #: ../../../CHANGELOG.md:3602
  9037. msgid "2018-10-21"
  9038. msgstr ""
  9039. #: ../../../CHANGELOG.md:3604
  9040. msgid "Self-check maintenance command"
  9041. msgstr ""
  9042. #: ../../../CHANGELOG.md:3606
  9043. msgid ""
  9044. "The playbook can now [check if services are configured correctly](docs"
  9045. "/maintenance-checking-services.md)."
  9046. msgstr ""
  9047. #: ../../../CHANGELOG.md:3609
  9048. msgid "2018-10-05"
  9049. msgstr ""
  9050. #: ../../../CHANGELOG.md:3611
  9051. msgid "Presence tracking made configurable"
  9052. msgstr ""
  9053. #: ../../../CHANGELOG.md:3613
  9054. msgid ""
  9055. "The playbook can now enable/disable user presence-status tracking in "
  9056. "Synapse, through the playbook's `matrix_synapse_use_presence` variable "
  9057. "(having a default value of `true` - enabled)."
  9058. msgstr ""
  9059. #: ../../../CHANGELOG.md:3615
  9060. msgid ""
  9061. "If users participate in large rooms with many other servers, disabling "
  9062. "presence will decrease server load significantly."
  9063. msgstr ""
  9064. #: ../../../CHANGELOG.md:3618
  9065. msgid "2018-09-27"
  9066. msgstr ""
  9067. #: ../../../CHANGELOG.md:3620
  9068. msgid "Synapse Cache Factor made configurable"
  9069. msgstr ""
  9070. #: ../../../CHANGELOG.md:3622
  9071. msgid ""
  9072. "The playbook now makes the Synapse cache factor configurable, through the"
  9073. " playbook's `matrix_synapse_cache_factor` variable (having a default "
  9074. "value of `0.5`)."
  9075. msgstr ""
  9076. #: ../../../CHANGELOG.md:3624
  9077. msgid ""
  9078. "Changing that value allows you to potentially decrease RAM usage or to "
  9079. "increase performance by caching more stuff. Some information on it is "
  9080. "available here: https://github.com/element-hq/synapse#help-synapse-eats-"
  9081. "all-my-ram"
  9082. msgstr ""
  9083. #: ../../../CHANGELOG.md:3627
  9084. msgid "2018-09-26"
  9085. msgstr ""
  9086. #: ../../../CHANGELOG.md:3629
  9087. msgid "Disabling Docker container logging"
  9088. msgstr ""
  9089. #: ../../../CHANGELOG.md:3631
  9090. msgid "`--log-driver=none` is used for all Docker containers now."
  9091. msgstr ""
  9092. #: ../../../CHANGELOG.md:3633
  9093. msgid ""
  9094. "All these containers are started through systemd anyway and get logged in"
  9095. " journald, so there's no need for Docker to be logging the same thing "
  9096. "using the default `json-file` driver. Doing that was growing "
  9097. "`/var/lib/docker/containers/..` infinitely until service/container "
  9098. "restart."
  9099. msgstr ""
  9100. #: ../../../CHANGELOG.md:3635
  9101. msgid ""
  9102. "As a result of this, things like `docker logs matrix-synapse` won't work "
  9103. "anymore. `journalctl -u matrix-synapse` is how one can see the logs."
  9104. msgstr ""
  9105. #: ../../../CHANGELOG.md:3638
  9106. msgid "2018-09-17"
  9107. msgstr ""
  9108. #: ../../../CHANGELOG.md:3640
  9109. msgid "Service discovery support"
  9110. msgstr ""
  9111. #: ../../../CHANGELOG.md:3642
  9112. msgid ""
  9113. "The playbook now helps you set up [service "
  9114. "discovery](https://matrix.org/docs/spec/client_server/r0.4.0.html#server-"
  9115. "discovery) using a `/.well-known/matrix/client` file."
  9116. msgstr ""
  9117. #: ../../../CHANGELOG.md:3644
  9118. msgid ""
  9119. "Additional details are available in [Configuring service discovery via "
  9120. ".well-known](docs/configuring-well-known.md)."
  9121. msgstr ""
  9122. #: ../../../CHANGELOG.md:3650
  9123. msgid "from `matrix_nginx_riot_web_data_path` to `matrix_riot_web_data_path`"
  9124. msgstr ""
  9125. #: ../../../CHANGELOG.md:3651
  9126. msgid ""
  9127. "from `matrix_riot_web_default_identity_server_url` to "
  9128. "`matrix_identity_server_url`"
  9129. msgstr ""
  9130. #: ../../../CHANGELOG.md:3654
  9131. msgid "2018-09-07"
  9132. msgstr ""
  9133. #: ../../../CHANGELOG.md:3656
  9134. msgid "Mautrix Telegram bridging support"
  9135. msgstr ""
  9136. #: ../../../CHANGELOG.md:3658
  9137. msgid ""
  9138. "The playbook now supports bridging with [Telegram](https://telegram.org/)"
  9139. " by installing the [mautrix-telegram](https://github.com/tulir/mautrix-"
  9140. "telegram) bridge. This playbook functionality is available thanks to "
  9141. "[@izissise](https://github.com/izissise)."
  9142. msgstr ""
  9143. #: ../../../CHANGELOG.md:3660
  9144. msgid ""
  9145. "Additional details are available in [Setting up Mautrix Telegram "
  9146. "bridging](docs/configuring-playbook-bridge-mautrix-telegram.md)."
  9147. msgstr ""
  9148. #: ../../../CHANGELOG.md:3662
  9149. msgid "Events cache size increase and configurability for Matrix Synapse"
  9150. msgstr ""
  9151. #: ../../../CHANGELOG.md:3664
  9152. msgid ""
  9153. "The playbook now lets you configure Matrix Synapse's `event_cache_size` "
  9154. "configuration via the `matrix_synapse_event_cache_size` playbook "
  9155. "variable."
  9156. msgstr ""
  9157. #: ../../../CHANGELOG.md:3666
  9158. msgid ""
  9159. "Previously, this value was hardcoded to `\"10K\"`. From now on, a more "
  9160. "reasonable default of `\"100K\"` is used."
  9161. msgstr ""
  9162. #: ../../../CHANGELOG.md:3668
  9163. msgid "Password-peppering support for Matrix Synapse"
  9164. msgstr ""
  9165. #: ../../../CHANGELOG.md:3670
  9166. msgid ""
  9167. "The playbook now supports enabling password-peppering for increased "
  9168. "security in Matrix Synapse via the "
  9169. "`matrix_synapse_password_config_pepper` playbook variable. Using a "
  9170. "password pepper is disabled by default (just like it used to be before "
  9171. "this playbook variable got introduced) and is not to be enabled/disabled "
  9172. "after initial setup, as that would invalidate all existing passwords."
  9173. msgstr ""
  9174. #: ../../../CHANGELOG.md:3672
  9175. msgid "Statistics-reporting support for Matrix Synapse"
  9176. msgstr ""
  9177. #: ../../../CHANGELOG.md:3674
  9178. msgid ""
  9179. "There's now a new `matrix_synapse_report_stats` playbook variable, which "
  9180. "controls the `report_stats` configuration option for Matrix Synapse. It "
  9181. "defaults to `false`, so no change is required to retain your privacy."
  9182. msgstr ""
  9183. #: ../../../CHANGELOG.md:3676
  9184. msgid ""
  9185. "If you'd like to start reporting statistics about your homeserver (things"
  9186. " like number of users, number of messages sent, uptime, load, etc.) to "
  9187. "matrix.org, you can turn on stats reporting."
  9188. msgstr ""
  9189. #: ../../../CHANGELOG.md:3679
  9190. msgid "2018-08-29"
  9191. msgstr ""
  9192. #: ../../../CHANGELOG.md:3681
  9193. msgid "Changing the way SSL certificates are retrieved"
  9194. msgstr ""
  9195. #: ../../../CHANGELOG.md:3683
  9196. msgid ""
  9197. "We've been using [acmetool](https://github.com/hlandau/acme) (with the "
  9198. "[willwill/acme-docker](https://hub.docker.com/r/willwill/acme-docker/) "
  9199. "Docker image) until now."
  9200. msgstr ""
  9201. #: ../../../CHANGELOG.md:3685
  9202. msgid ""
  9203. "Due to the Docker image being deprecated, and things looking bleak for "
  9204. "acmetool's support of the newer ACME v2 API endpoint, we've switched to "
  9205. "using [certbot](https://certbot.eff.org/) (with the "
  9206. "[certbot/certbot](https://hub.docker.com/r/certbot/certbot/) Docker "
  9207. "image)."
  9208. msgstr ""
  9209. #: ../../../CHANGELOG.md:3687
  9210. msgid ""
  9211. "Simply re-running the playbook will retrieve new certificates (via "
  9212. "certbot) for you. To ensure you don't leave any old files behind, though,"
  9213. " you'd better do this:"
  9214. msgstr ""
  9215. #: ../../../CHANGELOG.md:3689
  9216. msgid "`systemctl stop 'matrix*'`"
  9217. msgstr ""
  9218. #: ../../../CHANGELOG.md:3690
  9219. msgid ""
  9220. "stop your custom webserver, if you're running one (only affects you if "
  9221. "you've installed with `matrix_nginx_proxy_enabled: false`)"
  9222. msgstr ""
  9223. #: ../../../CHANGELOG.md:3691
  9224. msgid "`mv /matrix/ssl /matrix/ssl-acmetool-delete-later`"
  9225. msgstr ""
  9226. #: ../../../CHANGELOG.md:3692
  9227. msgid "re-run the playbook's [installation](docs/installing.md)"
  9228. msgstr ""
  9229. #: ../../../CHANGELOG.md:3693
  9230. msgid "possibly delete `/matrix/ssl-acmetool-delete-later`"
  9231. msgstr ""
  9232. #: ../../../CHANGELOG.md:3696
  9233. msgid "2018-08-21"
  9234. msgstr ""
  9235. #: ../../../CHANGELOG.md:3698
  9236. msgid "Matrix Corporal support"
  9237. msgstr ""
  9238. #: ../../../CHANGELOG.md:3700
  9239. msgid ""
  9240. "The playbook can now install and configure [matrix-"
  9241. "corporal](https://github.com/devture/matrix-corporal) for you."
  9242. msgstr ""
  9243. #: ../../../CHANGELOG.md:3702
  9244. msgid ""
  9245. "Additional details are available in [Setting up Matrix Corporal](docs"
  9246. "/configuring-playbook-matrix-corporal.md)."
  9247. msgstr ""
  9248. #: ../../../CHANGELOG.md:3705
  9249. msgid "2018-08-20"
  9250. msgstr ""
  9251. #: ../../../CHANGELOG.md:3707
  9252. msgid "Matrix Synapse rate limit control variables"
  9253. msgstr ""
  9254. #: ../../../CHANGELOG.md:3709
  9255. msgid ""
  9256. "The following new variables can now be configured to control Matrix "
  9257. "Synapse's rate-limiting (default values are shown below)."
  9258. msgstr ""
  9259. #: ../../../CHANGELOG.md:3716
  9260. msgid "Shared Secret Auth support via matrix-synapse-shared-secret-auth"
  9261. msgstr ""
  9262. #: ../../../CHANGELOG.md:3718
  9263. msgid ""
  9264. "The playbook can now install and configure [matrix-synapse-shared-secret-"
  9265. "auth](https://github.com/devture/matrix-synapse-shared-secret-auth) for "
  9266. "you."
  9267. msgstr ""
  9268. #: ../../../CHANGELOG.md:3720
  9269. msgid ""
  9270. "Additional details are available in [Setting up the Shared Secret Auth "
  9271. "password provider module](docs/configuring-playbook-shared-secret-"
  9272. "auth.md)."
  9273. msgstr ""
  9274. #: ../../../CHANGELOG.md:3723
  9275. msgid "2018-08-17"
  9276. msgstr ""
  9277. #: ../../../CHANGELOG.md:3725
  9278. msgid "REST auth support via matrix-synapse-rest-auth"
  9279. msgstr ""
  9280. #: ../../../CHANGELOG.md:3727
  9281. msgid ""
  9282. "The playbook can now install and configure [matrix-synapse-rest-"
  9283. "auth](https://github.com/kamax-io/matrix-synapse-rest-auth) for you."
  9284. msgstr ""
  9285. #: ../../../CHANGELOG.md:3729
  9286. msgid ""
  9287. "Additional details are available in [Setting up the REST authentication "
  9288. "password provider module](docs/configuring-playbook-rest-auth.md)."
  9289. msgstr ""
  9290. #: ../../../CHANGELOG.md:3731
  9291. msgid "Compression improvements"
  9292. msgstr ""
  9293. #: ../../../CHANGELOG.md:3733
  9294. msgid ""
  9295. "Shifted Matrix Synapse compression from happening in the Matrix Synapse, "
  9296. "to happening in the nginx proxy that's in front of it."
  9297. msgstr ""
  9298. #: ../../../CHANGELOG.md:3736
  9299. msgid ""
  9300. "Additionally, `riot-web` also gets compressed now (in the nginx proxy), "
  9301. "which drops the initial page load's size from 5.31MB to 1.86MB."
  9302. msgstr ""
  9303. #: ../../../CHANGELOG.md:3739
  9304. msgid "Disabling some unnecessary Synapse services"
  9305. msgstr ""
  9306. #: ../../../CHANGELOG.md:3741
  9307. msgid "The following services are not necessary, so they have been disabled:"
  9308. msgstr ""
  9309. #: ../../../CHANGELOG.md:3742
  9310. msgid "on the federation port (8448): the `client` service"
  9311. msgstr ""
  9312. #: ../../../CHANGELOG.md:3743
  9313. msgid ""
  9314. "on the http port (8008, exposed over 443): the old Angular `webclient` "
  9315. "and the `federation` service"
  9316. msgstr ""
  9317. #: ../../../CHANGELOG.md:3745
  9318. msgid ""
  9319. "Federation runs only on the federation port (8448) now. The Client APIs "
  9320. "run only on the http port (8008) now."
  9321. msgstr ""
  9322. #: ../../../CHANGELOG.md:3748
  9323. msgid "2018-08-15"
  9324. msgstr ""
  9325. #: ../../../CHANGELOG.md:3750
  9326. msgid "mxisd Identity Server support"
  9327. msgstr ""
  9328. #: ../../../CHANGELOG.md:3752
  9329. msgid ""
  9330. "The playbook now sets up an [mxisd](https://github.com/kamax-io/mxisd) "
  9331. "Identity Server for you by default. Additional details are available in "
  9332. "[Setting up ma1sd Identity Server](docs/configuring-playbook-mxisd.md)."
  9333. msgstr ""
  9334. #: ../../../CHANGELOG.md:3755
  9335. msgid "2018-08-14"
  9336. msgstr ""
  9337. #: ../../../CHANGELOG.md:3757
  9338. msgid "Email-sending support"
  9339. msgstr ""
  9340. #: ../../../CHANGELOG.md:3759
  9341. msgid ""
  9342. "The playbook now configures an email-sending service (postfix) by "
  9343. "default. Additional details are available in [Adjusting email-sending "
  9344. "settings](docs/configuring-playbook-email.md)."
  9345. msgstr ""
  9346. #: ../../../CHANGELOG.md:3761
  9347. msgid ""
  9348. "With this, Matrix Synapse is able to send email notifications for missed "
  9349. "messages, etc."
  9350. msgstr ""
  9351. #: ../../../CHANGELOG.md:3764
  9352. msgid "2018-08-08"
  9353. msgstr ""
  9354. #: ../../../CHANGELOG.md:3770
  9355. msgid "from `matrix_max_upload_size_mb` to `matrix_synapse_max_upload_size_mb`"
  9356. msgstr ""
  9357. #: ../../../CHANGELOG.md:3771
  9358. msgid ""
  9359. "from `matrix_max_log_file_size_mb` to "
  9360. "`matrix_synapse_max_log_file_size_mb`"
  9361. msgstr ""
  9362. #: ../../../CHANGELOG.md:3772
  9363. msgid "from `matrix_max_log_files_count` to `matrix_synapse_max_log_files_count`"
  9364. msgstr ""
  9365. #: ../../../CHANGELOG.md:3773
  9366. msgid "from `docker_matrix_image` to `matrix_docker_image_synapse`"
  9367. msgstr ""
  9368. #: ../../../CHANGELOG.md:3774
  9369. msgid "from `docker_nginx_image` to `matrix_docker_image_nginx`"
  9370. msgstr ""
  9371. #: ../../../CHANGELOG.md:3775
  9372. msgid "from `docker_riot_image` to `matrix_docker_image_riot`"
  9373. msgstr ""
  9374. #: ../../../CHANGELOG.md:3776
  9375. msgid "from `docker_goofys_image` to `matrix_docker_image_goofys`"
  9376. msgstr ""
  9377. #: ../../../CHANGELOG.md:3777
  9378. msgid "from `docker_coturn_image` to `matrix_docker_image_coturn`"
  9379. msgstr ""
  9380. #: ../../../CHANGELOG.md:3779
  9381. msgid ""
  9382. "If you're overriding any of them in your `vars.yml` file, you'd need to "
  9383. "change to the new names."
  9384. msgstr ""
  9385. #: ../../../CHANGELOG.md:3781
  9386. msgid "Renaming Ansible playbook tag"
  9387. msgstr ""
  9388. #: ../../../CHANGELOG.md:3783
  9389. msgid ""
  9390. "The command for executing the whole playbook has changed. The `setup-"
  9391. "main` tag got renamed to `setup-all`."
  9392. msgstr ""
  9393. #: ../../../CHANGELOG.md:3785
  9394. msgid "Docker container linking"
  9395. msgstr ""
  9396. #: ../../../CHANGELOG.md:3787
  9397. msgid ""
  9398. "Changed the way the Docker containers are linked together. The ones that "
  9399. "need to communicate with others operate in a `matrix` network now and not"
  9400. " in the default bridge network."
  9401. msgstr ""