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.
 
 
 

11138 line
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: bg\n"
  17. "Language-Team: bg <LL@li.org>\n"
  18. "Plural-Forms: nplurals=2; plural=(n != 1);\n"
  19. "MIME-Version: 1.0\n"
  20. "Content-Type: text/plain; charset=utf-8\n"
  21. "Content-Transfer-Encoding: 8bit\n"
  22. "Generated-By: Babel 2.16.0\n"
  23. #: ../../../CHANGELOG.md:1
  24. msgid "2024-11-26"
  25. msgstr ""
  26. #: ../../../CHANGELOG.md:3
  27. msgid ""
  28. "(Backward Compatibility Break) Synapse now defaults to enabling "
  29. "authenticated media"
  30. msgstr ""
  31. #: ../../../CHANGELOG.md:5
  32. msgid ""
  33. "**TLDR**: with this update, your Synapse homeserver will start requiring "
  34. "authentication for newly-uploaded media files. While the majority of the "
  35. "ecosystem (clients, bots, etc.) should support this, certain software may"
  36. " lack support for it (and you may wish to turn it off, if it's causing "
  37. "issues)."
  38. msgstr ""
  39. #: ../../../CHANGELOG.md:7
  40. msgid ""
  41. "The default configuration for the Synapse homeserver now [enforces "
  42. "Authenticated media by default](https://element-"
  43. "hq.github.io/synapse/v1.120/upgrade.html#authenticated-media-is-now-"
  44. "enforced-by-default)."
  45. msgstr ""
  46. #: ../../../CHANGELOG.md:9
  47. msgid ""
  48. "Servers like `matrix.org` have already [sunset unauthenticated "
  49. "media](https://matrix.org/blog/2024/06/26/sunsetting-unauthenticated-"
  50. "media/) months ago."
  51. msgstr ""
  52. #: ../../../CHANGELOG.md:11
  53. msgid ""
  54. "Now that **various clients, bots, bridges and extra services have caught "
  55. "up with authenticated media support**, Synapse developers seem confident "
  56. "that it's time to enable authenticated media by default."
  57. msgstr ""
  58. #: ../../../CHANGELOG.md:13
  59. msgid ""
  60. "We're changing the playbook configuration for authenticated media to keep"
  61. " up with upstream defaults changing."
  62. msgstr ""
  63. #: ../../../CHANGELOG.md:15
  64. msgid ""
  65. "Old and unmaintained bridges (like all mx-puppet bridges, etc.) do not "
  66. "support authenticated media. Other software may be similarly affected. If"
  67. " you experience issues with some Matrix-related software, you may wish to"
  68. " disable authenticated media and contact the software maintainers to let "
  69. "them know."
  70. msgstr ""
  71. #: ../../../CHANGELOG.md:17
  72. msgid ""
  73. "You can disable authenticated media at any time by setting "
  74. "`matrix_synapse_enable_authenticated_media: false` in your `vars.yml` "
  75. "configuration file and re-running the playbook."
  76. msgstr ""
  77. #: ../../../CHANGELOG.md:20
  78. msgid "2024-11-23"
  79. msgstr ""
  80. #: ../../../CHANGELOG.md:22
  81. msgid ""
  82. "(Backward Compatibility Break) The playbook now defaults to Valkey, "
  83. "instead of KeyDB"
  84. msgstr ""
  85. #: ../../../CHANGELOG.md:24
  86. msgid ""
  87. "**TLDR**: if the playbook installed KeyDB (or Redis) as a dependency for "
  88. "you before, it will now replace it with [Valkey](https://valkey.io/) (a "
  89. "drop-in alternative). We [previously switched from Redis to KeyDB"
  90. "](#backward-compatibility-break-the-playbook-now-defaults-to-keydb-"
  91. "instead-of-redis), but Valkey is a better alternative, so we're switching"
  92. " again."
  93. msgstr ""
  94. #: ../../../CHANGELOG.md:26
  95. msgid ""
  96. "The playbook used to install Redis or KeyDB if services have a need for a"
  97. " Redis-compatible implementation ([enabling worker support for "
  98. "Synapse](docs/configuring-playbook-synapse.md#load-balancing-with-"
  99. "workers), [enabling Hookshot encryption](docs/configuring-playbook-"
  100. "bridge-hookshot.md#end-to-bridge-encryption), etc.)."
  101. msgstr ""
  102. #: ../../../CHANGELOG.md:28
  103. msgid ""
  104. "Earlier this year, we switched from Redis to KeyDB - see [(Backward "
  105. "Compatibility Break) The playbook now defaults to KeyDB, instead of Redis"
  106. "](#backward-compatibility-break-the-playbook-now-defaults-to-keydb-"
  107. "instead-of-redis)."
  108. msgstr ""
  109. #: ../../../CHANGELOG.md:30
  110. msgid ""
  111. "Because Valkey seems to be a better successor to Redis (than KeyDB) and "
  112. "likely doesn't suffer from [issues like this "
  113. "one](https://github.com/spantaleev/matrix-docker-ansible-"
  114. "deploy/issues/3544), we now replace KeyDB with Valkey."
  115. msgstr ""
  116. #: ../../../CHANGELOG.md:32
  117. msgid ""
  118. "Valkey (like KeyDB and Redis in the past) is an implicitly enabled "
  119. "dependency - you don't need custom configuration in `vars.yml` to enable "
  120. "it."
  121. msgstr ""
  122. #: ../../../CHANGELOG.md:34
  123. msgid ""
  124. "Next time your run the playbook (via the `setup-all` tag), **KeyDB will "
  125. "be automatically uninstalled and replaced with Valkey**. Some Synapse "
  126. "downtime may occur while the switch happens."
  127. msgstr ""
  128. #: ../../../CHANGELOG.md:36
  129. msgid ""
  130. "Users on `arm32` should be aware that there's **neither a prebuilt "
  131. "`arm32` container image for Valkey**, nor the Valkey role supports self-"
  132. "building yet. Users on this architecture likely don't run Synapse with "
  133. "workers, etc., so they're likely in no need of Valkey (or Redis/KeyDB). "
  134. "If Redis is necessary in an `arm32` deployment, disabling Valkey and "
  135. "making the playbook fall back to Redis is possible (see below)."
  136. msgstr ""
  137. #: ../../../CHANGELOG.md:38 ../../../CHANGELOG.md:378
  138. msgid ""
  139. "**The playbook still supports Redis** and you can keep using Redis (for "
  140. "now) if you'd like, by adding this additional configuration to your "
  141. "`vars.yml` file:"
  142. msgstr ""
  143. #: ../../../CHANGELOG.md:49
  144. msgid ""
  145. "**The playbook still supports KeyDB** and you can keep using KeyDB (for "
  146. "now) if you'd like, by adding this additional configuration to your "
  147. "`vars.yml` file:"
  148. msgstr ""
  149. #: ../../../CHANGELOG.md:59
  150. msgid ""
  151. "At some point in time in the future, we'll remove both KeyDB and Redis "
  152. "from the playbook, so we recommend that you migrate to Valkey earlier "
  153. "anyway."
  154. msgstr ""
  155. #: ../../../CHANGELOG.md:62
  156. msgid "2024-11-14"
  157. msgstr ""
  158. #: ../../../CHANGELOG.md:64
  159. msgid "HTTP-compression support for Traefik-based setups"
  160. msgstr ""
  161. #: ../../../CHANGELOG.md:66
  162. msgid ""
  163. "The playbook now **automatically enables HTTP-compression support** for "
  164. "major services powered by the playbook, like [Cinny](./docs/configuring-"
  165. "playbook-client-cinny.md), [Element Web](./docs/configuring-playbook-"
  166. "client-element-web.md), [Hydrogen](./docs/configuring-playbook-client-"
  167. "hydrogen.md), as well as for Matrix Client-Server and Federation APIs "
  168. "(`matrix.example.com`)."
  169. msgstr ""
  170. #: ../../../CHANGELOG.md:68
  171. msgid ""
  172. "Other services installed by the playbook are currently not compression-"
  173. "enabled, but may become so over time. This change is rolled out on a per-"
  174. "service basis (as opposed to doing it globally, at the Traefik entrypoint"
  175. " level) to allow certain services or route endpoints which do not behave "
  176. "well when compressed (e.g. [issue 3749](https://github.com/spantaleev"
  177. "/matrix-docker-ansible-deploy/issues/3749)) to be excluded from "
  178. "compression."
  179. msgstr ""
  180. #: ../../../CHANGELOG.md:70
  181. msgid ""
  182. "A long time ago, various services were operating with `gzip`-compression "
  183. "enabled at the nginx level. Since the switch to Traefik (see [Goodbye, "
  184. "`matrix-nginx-proxy` 🪦](https://github.com/spantaleev/matrix-docker-"
  185. "ansible-deploy/blob/57c5271d9d6265a34a9d9cceb93365f685074f96/CHANGELOG.md"
  186. "#goodbye-matrix-nginx-proxy-)), all services (with the exception of "
  187. "Matrix APIs for Synapse worker-enabled setups which are powered by "
  188. "`nginx` via `synapse-reverse-proxy-companion`) have been operating "
  189. "without HTTP-compression support."
  190. msgstr ""
  191. #: ../../../CHANGELOG.md:72
  192. msgid ""
  193. "HTTP-compression is now done via Traefik's "
  194. "[compress](https://doc.traefik.io/traefik/middlewares/http/compress/) "
  195. "middleware. We use the default configuration for this middleware, which "
  196. "enables `zstd`, `br` and `gzip` support (in this order). This "
  197. "middleware's configuration can be configured via variables in the Traefik"
  198. " role (see "
  199. "`traefik_config_http_middlewares_compression_middleware_options`)."
  200. msgstr ""
  201. #: ../../../CHANGELOG.md:74
  202. msgid ""
  203. "If you're using your own Traefik reverse-proxy server ([Traefik managed "
  204. "by you](./docs/configuring-playbook-own-webserver.md#traefik-managed-by-"
  205. "you)) instead of the playbook's integrated Traefik service, you can "
  206. "benefit from the same by:"
  207. msgstr ""
  208. #: ../../../CHANGELOG.md:76
  209. msgid ""
  210. "defining a "
  211. "[compress](https://doc.traefik.io/traefik/middlewares/http/compress/) "
  212. "middleware (via the "
  213. "[file](https://doc.traefik.io/traefik/providers/file/) or "
  214. "[Docker](https://doc.traefik.io/traefik/providers/docker/) providers)"
  215. msgstr ""
  216. #: ../../../CHANGELOG.md:77
  217. msgid ""
  218. "setting "
  219. "`matrix_playbook_reverse_proxy_traefik_middleware_compression_enabled` to"
  220. " `true`"
  221. msgstr ""
  222. #: ../../../CHANGELOG.md:78
  223. msgid ""
  224. "specifying the middleware's name in "
  225. "`matrix_playbook_reverse_proxy_traefik_middleware_compression_name` (e.g."
  226. " `matrix_playbook_reverse_proxy_traefik_middleware_compression_name: my-"
  227. "compression-middleware@file`)"
  228. msgstr ""
  229. #: ../../../CHANGELOG.md:80
  230. msgid "Timeout adjustments for Traefik-based setups"
  231. msgstr ""
  232. #: ../../../CHANGELOG.md:82
  233. msgid ""
  234. "The playbook now supports configuring various "
  235. "[transport.respondingTimeouts](https://doc.traefik.io/traefik/routing/entrypoints/#respondingtimeouts)"
  236. " timeout values (`readTimeout`, `writeTimeout`, `idleTimeout`) for the "
  237. "`web`, `web-secure` and `matrix-federation` entrypoints."
  238. msgstr ""
  239. #: ../../../CHANGELOG.md:84
  240. msgid ""
  241. "If you're using your own Traefik reverse-proxy server ([Traefik managed "
  242. "by you](./docs/configuring-playbook-own-webserver.md#traefik-managed-by-"
  243. "you)) instead of the playbook's integrated Traefik service, you may wish "
  244. "to do similar configuration changes to your setup manually."
  245. msgstr ""
  246. #: ../../../CHANGELOG.md:86
  247. msgid ""
  248. "The most interesting of these is the `readTimeout` configuration value "
  249. "(the maximum duration for reading the entire request, including the "
  250. "body), which used to default to `60s`. For large and slowly progressing "
  251. "file uploads, `60s` would often not be enough for the transfer to finish "
  252. "and uploads would end up being interrupted. The playbook now raises the "
  253. "`readTimeout` value to 5 minutes (`300s`) to improve this use-case."
  254. msgstr ""
  255. #: ../../../CHANGELOG.md:88
  256. msgid ""
  257. "The `traefik_config_entrypoint_web_transport_respondingTimeouts_*` "
  258. "variables (for the `web` entrypoint) cascade to affecting the timeout "
  259. "values for the `web-secure` and `matrix-federation` entrypoints, so you "
  260. "can easily adjust all timeout values using them."
  261. msgstr ""
  262. #: ../../../CHANGELOG.md:90
  263. msgid "Example of the default timeout values used by the playbook:"
  264. msgstr ""
  265. #: ../../../CHANGELOG.md:101
  266. msgid ""
  267. "Alternatively, you may adjust the timeout values for specific entrypoints"
  268. " (like `web-secure` and `matrix-federation`) using dedicated variables "
  269. "(like "
  270. "`traefik_config_entrypoint_web_secure_transport_respondingTimeouts_readTimeout`"
  271. " and "
  272. "`matrix_playbook_public_matrix_federation_api_traefik_entrypoint_config_transport_respondingTimeouts_readTimeout`)."
  273. msgstr ""
  274. #: ../../../CHANGELOG.md:104
  275. msgid "2024-11-08"
  276. msgstr ""
  277. #: ../../../CHANGELOG.md:106
  278. msgid ""
  279. "Support for synapse-admin auto-configuration via /.well-"
  280. "known/matrix/client"
  281. msgstr ""
  282. #: ../../../CHANGELOG.md:108
  283. msgid ""
  284. "You can administrate your Synapse-powered homeserver using synapse-admin "
  285. "hosted externally (e.g. [admin.etke.cc](https://admin.etke.cc/)) and the "
  286. "synapse-admin instance would still auto-configure itself correctly for "
  287. "your server by [reading its `/.well-known/matrix/client` "
  288. "file](https://github.com/etkecc/synapse-admin/pull/126)."
  289. msgstr ""
  290. #: ../../../CHANGELOG.md:110
  291. msgid ""
  292. "The playbook now configures the `/.well-known/matrix/client` file for "
  293. "this by default, injecting into it a `cc.etke.synapse-admin` section that"
  294. " contains the full synapse-admin configuration. This is done even if you "
  295. "don't enable the synapse-admin service in your configuration. The reason "
  296. "for always doing it is to allow users to skip the (small) overhead of "
  297. "self-hosting the non-core synapse-admin service, yet still be able to use"
  298. " it from elsewhere when needed."
  299. msgstr ""
  300. #: ../../../CHANGELOG.md:112
  301. msgid ""
  302. "If you don't ever plan on using synapse-admin from other servers (besides"
  303. " your own due to [self-hosting synapse-admin](./docs/configuring-"
  304. "playbook-synapse-admin.md)), you **can disable this** `/.well-"
  305. "known/matrix/client` configuration via "
  306. "`matrix_static_files_file_matrix_client_property_cc_etke_synapse_admin_enabled:"
  307. " false`"
  308. msgstr ""
  309. #: ../../../CHANGELOG.md:115
  310. msgid "2024-10-28"
  311. msgstr ""
  312. #: ../../../CHANGELOG.md:117
  313. msgid "(BC Break) Postmoogle's variable names need adjustments"
  314. msgstr ""
  315. #: ../../../CHANGELOG.md:119
  316. msgid ""
  317. "Due to the recategorization of [Postmoogle](./docs/configuring-playbook-"
  318. "bridge-postmoogle.md) from the bot to the bridge, its variables were "
  319. "renamed (`matrix_bot_postmoogle_` -> `matrix_postmoogle_`). You need to "
  320. "adjust your `vars.yml` configuration accordingly."
  321. msgstr ""
  322. #: ../../../CHANGELOG.md:121
  323. msgid "2024-10-19"
  324. msgstr ""
  325. #: ../../../CHANGELOG.md:123
  326. msgid "Support for Matrix Authentication Service"
  327. msgstr ""
  328. #: ../../../CHANGELOG.md:125
  329. msgid ""
  330. "The playbook now supports installing and configuring [Matrix "
  331. "Authentication Service](./docs/configuring-playbook-matrix-"
  332. "authentication-service.md) (MAS)."
  333. msgstr ""
  334. #: ../../../CHANGELOG.md:127
  335. msgid ""
  336. "Huge thanks to [Quentin Gliech](https://github.com/sandhose) from the "
  337. "[Element](https://element.io/) / [Matrix Authentication "
  338. "Service](https://github.com/element-hq/matrix-authentication-service) "
  339. "team for answering our numerous questions about MAS."
  340. msgstr ""
  341. #: ../../../CHANGELOG.md:129
  342. msgid ""
  343. "This is an **experimental service** and there are **still certain issues "
  344. "with it** (see [Expectations](./docs/configuring-playbook-matrix-"
  345. "authentication-service.md#expectations)). Matrix server administrators "
  346. "should only consider switching if they identify with one or more [reasons"
  347. " to use Matrix Authentication Service](./docs/configuring-playbook-"
  348. "matrix-authentication-service.md#reasons-to-use-matrix-authentication-"
  349. "service). As MAS adoption improves and more services are adjusted to "
  350. "support it, we expect that using MAS will become the norm."
  351. msgstr ""
  352. #: ../../../CHANGELOG.md:131
  353. msgid ""
  354. "Our [Setting up Matrix Authentication Service](./docs/configuring-"
  355. "playbook-matrix-authentication-service.md) documentation page has more "
  356. "details about this new service, what you might expect from the switch and"
  357. " how you can migrate your existing (Synapse) homeserver setup to MAS."
  358. msgstr ""
  359. #: ../../../CHANGELOG.md:134
  360. msgid "2024-09-27"
  361. msgstr ""
  362. #: ../../../CHANGELOG.md:136
  363. msgid ""
  364. "(BC Break) Postgres & Traefik roles have been relocated and variable "
  365. "names need adjustments"
  366. msgstr ""
  367. #: ../../../CHANGELOG.md:138
  368. msgid ""
  369. "Various roles have been relocated from the "
  370. "[devture](https://github.com/devture) organization to the [mother-of-all-"
  371. "self-hosting](https://github.com/mother-of-all-self-hosting) "
  372. "organization."
  373. msgstr ""
  374. #: ../../../CHANGELOG.md:140
  375. msgid ""
  376. "Along with the relocation, the `devture_` prefix was dropped from their "
  377. "variable names, so you need to adjust your `vars.yml` configuration."
  378. msgstr ""
  379. #: ../../../CHANGELOG.md:142
  380. msgid "You need to do the following replacements:"
  381. msgstr ""
  382. #: ../../../CHANGELOG.md:144
  383. msgid "`devture_postgres_` -> `postgres_`"
  384. msgstr ""
  385. #: ../../../CHANGELOG.md:145
  386. msgid "`devture_traefik_` -> `traefik_`"
  387. msgstr ""
  388. #: ../../../CHANGELOG.md:147
  389. msgid ""
  390. "As always, the playbook would let you know about this and point out any "
  391. "variables you may have missed."
  392. msgstr ""
  393. #: ../../../CHANGELOG.md:150
  394. msgid "2024-09-12"
  395. msgstr ""
  396. #: ../../../CHANGELOG.md:152
  397. msgid "Support for baibot"
  398. msgstr ""
  399. #: ../../../CHANGELOG.md:154
  400. msgid ""
  401. "The playbook now supports installing [baibot](./docs/configuring-"
  402. "playbook-bot-baibot.md) (pronounced bye-bot) - a "
  403. "[Matrix](https://matrix.org/) bot developed by "
  404. "[etke.cc](https://etke.cc/) that exposes the power of "
  405. "[AI](https://en.wikipedia.org/wiki/Artificial_intelligence) / [Large "
  406. "Language Models](https://en.wikipedia.org/wiki/Large_language_model) to "
  407. "you. 🤖"
  408. msgstr ""
  409. #: ../../../CHANGELOG.md:156
  410. msgid ""
  411. "It supports [OpenAI](https://openai.com/)'s "
  412. "[ChatGPT](https://openai.com/blog/chatgpt/) models, as well as many other"
  413. " [☁️ "
  414. "providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md)."
  415. msgstr ""
  416. #: ../../../CHANGELOG.md:158
  417. msgid ""
  418. "It's designed as a more private and [✨ "
  419. "featureful](https://github.com/etkecc/baibot/?tab=readme-ov-"
  420. "file#-features) alternative to the now-unmaintained [matrix-chatgpt-"
  421. "bot](./docs/configuring-playbook-bot-chatgpt.md)."
  422. msgstr ""
  423. #: ../../../CHANGELOG.md:160
  424. msgid ""
  425. "To get started, see the [Setting up baibot](./docs/configuring-playbook-"
  426. "bot-baibot.md) documentation page."
  427. msgstr ""
  428. #: ../../../CHANGELOG.md:162
  429. msgid "Switching synapse-admin to etke.cc's fork"
  430. msgstr ""
  431. #: ../../../CHANGELOG.md:164
  432. msgid ""
  433. "The playbook now installs [etke.cc](https://etke.cc/)'s "
  434. "[fork](https://github.com/etkecc/synapse-admin) of [synapse-"
  435. "admin](https://github.com/Awesome-Technologies/synapse-admin) (originally"
  436. " developed by [Awesome-Technologies](https://github.com/Awesome-"
  437. "Technologies)). This fork is a drop-in replacement for the original "
  438. "software."
  439. msgstr ""
  440. #: ../../../CHANGELOG.md:166
  441. msgid ""
  442. "The creation of the fork has been provoked by users frequently "
  443. "encountering issues with the original synapse-admin software, such as "
  444. "unintentionally deleting their one-and-only admin user account (fixed "
  445. "[here](https://github.com/etkecc/synapse-admin/pull/1) and also "
  446. "contributed upstream [here](https://github.com/Awesome-Technologies"
  447. "/synapse-admin/pull/608) - to no avail for now). Since its inception, [a "
  448. "bunch of other quality-of-life improvements](https://github.com/etkecc"
  449. "/synapse-admin?tab=readme-ov-file#changes) have been made to the fork."
  450. msgstr ""
  451. #: ../../../CHANGELOG.md:168
  452. msgid ""
  453. "If upstream synapse-admin picks up the pace and improves, the etke.cc "
  454. "fork may disappear and the playbook may switch to the original software "
  455. "again. Until that time comes, we believe that etke.cc's fork is the "
  456. "better software to use right now."
  457. msgstr ""
  458. #: ../../../CHANGELOG.md:170
  459. msgid ""
  460. "If you'd like to switch back to the original synapse-admin software, you "
  461. "can do so by adding the following configuration to your `vars.yml` file:"
  462. msgstr ""
  463. #: ../../../CHANGELOG.md:183
  464. msgid "2024-08-17"
  465. msgstr ""
  466. #: ../../../CHANGELOG.md:185
  467. msgid "New appservice-double-puppet service for better double-puppeting"
  468. msgstr ""
  469. #: ../../../CHANGELOG.md:187
  470. msgid ""
  471. "Mautrix bridges are undergoing large changes as announced in the [August "
  472. "2024 releases & progress](https://mau.fi/blog/2024-08-mautrix-release/) "
  473. "blog post."
  474. msgstr ""
  475. #: ../../../CHANGELOG.md:189
  476. msgid ""
  477. "The playbook has already upgraded to the rewritten mautrix-slack "
  478. "([v0.1.0](https://github.com/mautrix/slack/releases/tag/v0.1.0)) and "
  479. "mautrix-signal "
  480. "([v0.7.0](https://github.com/mautrix/signal/releases/tag/v0.7.0)) "
  481. "bridges."
  482. msgstr ""
  483. #: ../../../CHANGELOG.md:191
  484. msgid ""
  485. "The newly rewritten bridges do not support double-puppeting via [Shared "
  486. "Secret Auth](./docs/configuring-playbook-shared-secret-auth.md) anymore, "
  487. "which has prompted us to switch to the new & better [appservice "
  488. "method](https://docs.mau.fi/bridges/general/double-puppeting.html"
  489. "#appservice-method-new) for double-puppeting. The playbook automates this"
  490. " double-puppeting setup for you if you enable the new [Appservice Double "
  491. "Puppet](./docs/configuring-playbook-appservice-double-puppet.md) service."
  492. msgstr ""
  493. #: ../../../CHANGELOG.md:193
  494. msgid ""
  495. "All non-deprecated mautrix bridges in the playbook have been reworked to "
  496. "support double-puppeting via an Appservice. Most bridges still support "
  497. "double-puppeting via [Shared Secret Auth](./docs/configuring-playbook-"
  498. "shared-secret-auth.md), so the playbook supports it too. If only Shared "
  499. "Secret Auth is enabled, double-puppeting will be configured using that "
  500. "method (for the bridges that support it). That said, **Shared Secret Auth"
  501. " double-puppeting is being phased out and we recommend replacing it with "
  502. "the new Appservice method**."
  503. msgstr ""
  504. #: ../../../CHANGELOG.md:195
  505. msgid ""
  506. "We recommend **enabling double-puppeting via the new Appservice method** "
  507. "by adding the following configuration to your `vars.yml` file:"
  508. msgstr ""
  509. #: ../../../CHANGELOG.md:201
  510. msgid ""
  511. "You can still **keep** [Shared Secret Auth](./docs/configuring-playbook-"
  512. "shared-secret-auth.md) enabled. Non-mautrix bridges and other services "
  513. "(e.g. [matrix-corporal](./docs/configuring-playbook-matrix-corporal.md)) "
  514. "may still require it."
  515. msgstr ""
  516. #: ../../../CHANGELOG.md:203
  517. msgid ""
  518. "When both double-puppeting methods are enabled, the playbook will "
  519. "automatically choose the new and better Appservice method for bridges "
  520. "that support it."
  521. msgstr ""
  522. #: ../../../CHANGELOG.md:206
  523. msgid "2024-08-15"
  524. msgstr ""
  525. #: ../../../CHANGELOG.md:208
  526. msgid "matrix-media-repo now configured for Authenticated Media"
  527. msgstr ""
  528. #: ../../../CHANGELOG.md:210
  529. msgid ""
  530. "Thanks to [Michael Hollister](https://github.com/Michael-Hollister) from "
  531. "[FUTO](https://www.futo.org/), our matrix-media-repo implementation now "
  532. "automatically [sets up signing keys](https://docs.t2bot.io/matrix-media-"
  533. "repo/v1.3.5/installation/signing-key/) for Authenticated Media (as per "
  534. "[MSC3916](https://github.com/matrix-org/matrix-spec-"
  535. "proposals/pull/3916))."
  536. msgstr ""
  537. #: ../../../CHANGELOG.md:212
  538. msgid ""
  539. "If you had never heard of Authenticated Media before, the [Sunsetting "
  540. "unauthenticated media](https://matrix.org/blog/2024/06/26/sunsetting-"
  541. "unauthenticated-media/) article on [matrix.org](https://matrix.org/) is a"
  542. " good introduction."
  543. msgstr ""
  544. #: ../../../CHANGELOG.md:214
  545. msgid ""
  546. "This feature is enabled for matrix-media-repo installations by default "
  547. "and will append an additional (matrix-media-repo-generated signing key) "
  548. "to your homeserver's (Synapse or Dendrite) signing key. See the [Signing "
  549. "keys](./docs/configuring-playbook-matrix-media-repo.md#signing-keys) and "
  550. "[Key backup and revoking](./docs/configuring-playbook-matrix-media-"
  551. "repo.md#key-backup-and-revoking) sections of the matrix-media-repo "
  552. "documentation for more details."
  553. msgstr ""
  554. #: ../../../CHANGELOG.md:216
  555. msgid ""
  556. "If you'd like to avoid this new feature, you can disable it by setting "
  557. "`matrix_media_repo_generate_signing_key: false` in your `vars.yml` "
  558. "configuration file."
  559. msgstr ""
  560. #: ../../../CHANGELOG.md:219
  561. msgid "2024-08-08"
  562. msgstr ""
  563. #: ../../../CHANGELOG.md:221
  564. msgid "(Backward Compatibility Break) matrix-corporal has been upgraded to v3"
  565. msgstr ""
  566. #: ../../../CHANGELOG.md:223
  567. msgid ""
  568. "The playbook now installs [matrix-corporal](https://github.com/devture"
  569. "/matrix-corporal) v3.0.0, which brings support for **power-level "
  570. "management** (thanks to [this PR](https://github.com/devture/matrix-"
  571. "corporal/pull/32))."
  572. msgstr ""
  573. #: ../../../CHANGELOG.md:225
  574. msgid ""
  575. "This upgrade necessitates configuration policy changes as described in "
  576. "[matrix-corporal's changelog entry](https://github.com/devture/matrix-"
  577. "corporal/blob/5287cb81c82cd3b951c2a099b4697c3e0b384559/CHANGELOG.md#version-300-2024-08-08)."
  578. msgstr ""
  579. #: ../../../CHANGELOG.md:227
  580. msgid ""
  581. "If you'd like to remain on the old (v2) version of matrix-corporal, you "
  582. "can do so by adding the following configuration to your `vars.yml` file:"
  583. msgstr ""
  584. #: ../../../CHANGELOG.md:233
  585. msgid "2024-07-25"
  586. msgstr ""
  587. #: ../../../CHANGELOG.md:235
  588. msgid "synapse-usage-exporter support"
  589. msgstr ""
  590. #: ../../../CHANGELOG.md:237
  591. msgid ""
  592. "Thanks to [Michael Hollister](https://github.com/Michael-Hollister) from "
  593. "[FUTO](https://www.futo.org/), the creators of the [Circles "
  594. "app](https://circu.li/), the playbook can now set up [synapse-usage-"
  595. "exporter](https://github.com/loelkes/synapse-usage-exporter) - a small "
  596. "[Flask](https://flask.palletsprojects.com)-based webservice which can "
  597. "capture usage statistics from Synapse (via HTTP `PUT`) and then make them"
  598. " available for Prometheus to scrape."
  599. msgstr ""
  600. #: ../../../CHANGELOG.md:239
  601. msgid ""
  602. "To learn more see our [Enabling synapse-usage-exporter for Synapse usage "
  603. "statistics](docs/configuring-playbook-synapse-usage-exporter.md) "
  604. "documentation page."
  605. msgstr ""
  606. #: ../../../CHANGELOG.md:242
  607. msgid "2024-07-06"
  608. msgstr ""
  609. #: ../../../CHANGELOG.md:244
  610. msgid "matrix-alertmanager-receiver support"
  611. msgstr ""
  612. #: ../../../CHANGELOG.md:246
  613. msgid ""
  614. "For those wishing to more easily integrate "
  615. "[Prometheus](https://prometheus.io/)' alerting service "
  616. "([Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/))"
  617. " with Matrix, the playbook can now set up [matrix-alertmanager-"
  618. "receiver](https://github.com/metio/matrix-alertmanager-receiver)."
  619. msgstr ""
  620. #: ../../../CHANGELOG.md:248
  621. msgid ""
  622. "See [Setting up Prometheus Alertmanager integration via matrix-"
  623. "alertmanager-receiver](./docs/configuring-playbook-alertmanager-"
  624. "receiver.md) for more details."
  625. msgstr ""
  626. #: ../../../CHANGELOG.md:250
  627. msgid "Traefik v3 and HTTP/3 are here now"
  628. msgstr ""
  629. #: ../../../CHANGELOG.md:252
  630. msgid ""
  631. "**TLDR**: Traefik was migrated from v2 to v3. Minor changes were done to "
  632. "the playbook. Mostly everything else worked out of the box. Most people "
  633. "will not have to do any tweaks to their configuration. In addition, "
  634. "[HTTP/3](https://en.wikipedia.org/wiki/HTTP/3) support is now auto-"
  635. "enabled for the `web-secure` (port 443) and `matrix-federation` (port "
  636. "`8448`) entrypoints. If you have a firewall in front of your server and "
  637. "you wish to benefit from `HTTP3`, you will need to open the `443` and "
  638. "`8448` UDP ports in it."
  639. msgstr ""
  640. #: ../../../CHANGELOG.md:254
  641. msgid "Traefik v3"
  642. msgstr ""
  643. #: ../../../CHANGELOG.md:256
  644. msgid ""
  645. "The reverse-proxy that the playbook uses by default (Traefik) has "
  646. "recently been upgraded to v3 (see [this blog "
  647. "post](https://traefik.io/blog/announcing-traefik-proxy-v3-rc/) to learn "
  648. "about its new features). Version 3 includes some small breaking "
  649. "configuration changes requiring a "
  650. "[migration](https://doc.traefik.io/traefik/migration/v2-to-v3/)."
  651. msgstr ""
  652. #: ../../../CHANGELOG.md:258
  653. msgid ""
  654. "We have **updated the playbook to Traefik v3** (make sure to run `just "
  655. "roles` / `make roles` to get it)."
  656. msgstr ""
  657. #: ../../../CHANGELOG.md:260
  658. msgid ""
  659. "There were **only minor playbook changes required** to adapt to Traefik "
  660. "v3, and only to the Ansible role for [matrix-media-repo](./docs"
  661. "/configuring-playbook-matrix-media-repo.md) where we changed a few "
  662. "[`PathPrefix` instances to "
  663. "`PathRegexp`](https://doc.traefik.io/traefik/routing/routers/#path-"
  664. "pathprefix-and-pathregexp), because these instances were using a regular "
  665. "expression instead of a fixed path. For fixed-path values, `PathPrefix` "
  666. "is still the preferred matcher function to use."
  667. msgstr ""
  668. #: ../../../CHANGELOG.md:262
  669. msgid "**Most people using the playbook should not have to do any changes**."
  670. msgstr ""
  671. #: ../../../CHANGELOG.md:264
  672. msgid ""
  673. "If you're using the playbook's Traefik instance to reverse-proxy to some "
  674. "other services of your own (not managed by the playbook), you may wish to"
  675. " review their Traefik labels and make sure they're in line with the "
  676. "[Traefik v2 to v3 migration "
  677. "guide](https://doc.traefik.io/traefik/migration/v2-to-v3/)."
  678. msgstr ""
  679. #: ../../../CHANGELOG.md:266
  680. msgid ""
  681. "If you've tweaked any of this playbook's `_path_prefix` variables and "
  682. "made them use a regular expression, you will now need to make additional "
  683. "adjustments. The playbook makes extensive use of `PathPrefix()` matchers "
  684. "in Traefik rules and `PathPrefix` does not support regular expressions "
  685. "anymore. To work around it, you may now need to override a whole "
  686. "`_traefik_rule` variable and switch it from [`PathPrefix` to "
  687. "`PathRegexp`](https://doc.traefik.io/traefik/routing/routers/#path-"
  688. "pathprefix-and-pathregexp)."
  689. msgstr ""
  690. #: ../../../CHANGELOG.md:268
  691. msgid ""
  692. "If you're not using [matrix-media-repo](./docs/configuring-playbook-"
  693. "matrix-media-repo.md) (the only role we had to tweak to adapt it to "
  694. "Traefik v3), you **may potentially downgrade to Traefik v2** (if "
  695. "necessary) by adding `traefik_verison: v2.11.4` to your configuration. "
  696. "People using `matrix-media-repo` cannot downgrade this way, because "
  697. "`matrix-media-repo` has been adjusted to use `PathRegexp` - a [routing "
  698. "matcher](https://doc.traefik.io/traefik/v2.11/routing/routers/#rule) that"
  699. " Traefik v2 does not understand."
  700. msgstr ""
  701. #: ../../../CHANGELOG.md:270
  702. msgid "HTTP/3 is enabled by default"
  703. msgstr ""
  704. #: ../../../CHANGELOG.md:272
  705. msgid ""
  706. "In Traefik v3, [HTTP/3](https://en.wikipedia.org/wiki/HTTP/3) support is "
  707. "no longer considered experimental now. Due to this, **the playbook auto-"
  708. "enables HTTP3** for the `web-secure` (port 443) and `matrix-federation` "
  709. "(port `8448`) entrypoints."
  710. msgstr ""
  711. #: ../../../CHANGELOG.md:274
  712. msgid ""
  713. "HTTP3 uses the UDP protocol and **the playbook (together with Docker) "
  714. "will make sure that the appropriate ports** (`443` over UDP & `8448` over"
  715. " UDP) **are exposed and whitelisted in your server's firewall**. However,"
  716. " **if you have another firewall in front of your server** (as is the case"
  717. " for many cloud providers), **you will need to manually open these UDP "
  718. "ports**."
  719. msgstr ""
  720. #: ../../../CHANGELOG.md:276
  721. msgid ""
  722. "If you do not open the UDP ports correctly or there is some other issue, "
  723. "clients (browsers, mostly) will fall-back to "
  724. "[HTTP/2](https://en.wikipedia.org/wiki/HTTP/2) or even "
  725. "[HTTP/1.1](https://en.wikipedia.org/wiki/HTTP)."
  726. msgstr ""
  727. #: ../../../CHANGELOG.md:278
  728. msgid ""
  729. "Still, if HTTP/3 cannot function correctly in your setup, it's best to "
  730. "disable advertising support for it (and misleading clients into trying to"
  731. " use HTTP/3)."
  732. msgstr ""
  733. #: ../../../CHANGELOG.md:280
  734. msgid "To **disable HTTP/3**, you can use the following configuration:"
  735. msgstr ""
  736. #: ../../../CHANGELOG.md:294
  737. msgid ""
  738. "If you are using [your own webserver](./docs/configuring-playbook-own-"
  739. "webserver.md) (in front of Traefik), port binding on UDP port `8448` by "
  740. "default due to HTTP/3 is either unnecessary or [may get in the "
  741. "way](https://github.com/spantaleev/matrix-docker-ansible-"
  742. "deploy/issues/3402). If it does, you can disable it:"
  743. msgstr ""
  744. #: ../../../CHANGELOG.md:307
  745. msgid "2024-07-01"
  746. msgstr ""
  747. #: ../../../CHANGELOG.md:309
  748. msgid "synapse-admin is now restricted to your homeserver's URL by default"
  749. msgstr ""
  750. #: ../../../CHANGELOG.md:311
  751. msgid ""
  752. "A new feature introduced in synapse-admin [v0.10.0](https://github.com"
  753. "/Awesome-Technologies/synapse-admin/releases/tag/0.10.0) (released and "
  754. "supported by the playbook since a a few months ago) provides the ability "
  755. "to [restrict its usage to a specific homeserver](https://github.com"
  756. "/Awesome-Technologies/synapse-"
  757. "admin/blob/e21e44362c879ac41f47c580b04210842b6ff3d7/README.md"
  758. "#restricting-available-homeserver) (or multiple homeservers)."
  759. msgstr ""
  760. #: ../../../CHANGELOG.md:313
  761. msgid ""
  762. "The playbook has just started making use of this feature. **From now on, "
  763. "your synapse-admin instance will be restricted to the homeserver you're "
  764. "managing via the playbook**. When configured like this, the *Homeserver "
  765. "URL* field in synapse-admin's web UI changes from a text field to a "
  766. "dropdown having a single value (the URL of your homeserver). This makes "
  767. "usage simpler for most people, as they won't need to manually enter a "
  768. "*Homeserver URL* anymore."
  769. msgstr ""
  770. #: ../../../CHANGELOG.md:315
  771. msgid ""
  772. "If you'd like **to go back to the old unrestricted behavior**, use the "
  773. "following configuration:"
  774. msgstr ""
  775. #: ../../../CHANGELOG.md:323
  776. msgid "2024-06-25"
  777. msgstr ""
  778. #: ../../../CHANGELOG.md:325
  779. msgid "The URL-prefix for Hookshot generic webhooks has changed"
  780. msgstr ""
  781. #: ../../../CHANGELOG.md:327
  782. msgid ""
  783. "Until now, generic Hookshot webhook URLs looked like this: "
  784. "`https://matrix.example.com/hookshot/webhooks/:hookId`."
  785. msgstr ""
  786. #: ../../../CHANGELOG.md:329
  787. msgid ""
  788. "The `/hookshot/webhooks` common prefix gets stripped by Traefik "
  789. "automatically, so Hookshot only sees the part that comes after "
  790. "(`/:hookId`)."
  791. msgstr ""
  792. #: ../../../CHANGELOG.md:331
  793. msgid ""
  794. "[A few years ago](https://github.com/spantaleev/matrix-docker-ansible-"
  795. "deploy/issues/1681), Hookshot started to prefer to handle webhooks at a "
  796. "`/webhook/:hookId` path (instead of directly at `/:hookId`)."
  797. msgstr ""
  798. #: ../../../CHANGELOG.md:333
  799. msgid ""
  800. "To avoid future problems, we've "
  801. "[reconfigured](https://github.com/spantaleev/matrix-docker-ansible-"
  802. "deploy/commit/4704a60718946fd469aeee7fc3ae8127c633bb6b) our Hookshot "
  803. "configuration to use webhook URLs that include `/webhook` in the URL "
  804. "suffix (e.g. `/hookshot/webhooks/webhook/:hookId`, instead of "
  805. "`/hookshot/webhooks/:hookId`). This means that when we strip the common "
  806. "prefi (`/hookshot/webhooks`), we'll end up sending `/webhook/:hookId` to "
  807. "Hookshot, just like recommended."
  808. msgstr ""
  809. #: ../../../CHANGELOG.md:335
  810. msgid ""
  811. "When generating new webhooks, you should start seeing the new URLs being "
  812. "used."
  813. msgstr ""
  814. #: ../../../CHANGELOG.md:337
  815. msgid ""
  816. "**For now**, **both** old URLs (`/hookshot/webhooks/:hookId`) and new "
  817. "URLs (`/hookshot/webhooks/webhook/:hookId`) **continue to work**, so your"
  818. " webhooks will not break just yet."
  819. msgstr ""
  820. #: ../../../CHANGELOG.md:339
  821. msgid ""
  822. "However, **we recommend that you update all your old webhook URLs** "
  823. "(configured in other systems) to include the new `/webhook` path "
  824. "component, so that future Hookshot changes (whenever they come) will not "
  825. "break your webhooks. You don't need to do anything on the Hookshot side -"
  826. " you merely need to reconfigure the remote systems that use your webhook "
  827. "URLs."
  828. msgstr ""
  829. #: ../../../CHANGELOG.md:342
  830. msgid "2024-06-22"
  831. msgstr ""
  832. #: ../../../CHANGELOG.md:344
  833. msgid "The maubot user is now managed by the playbook"
  834. msgstr ""
  835. #: ../../../CHANGELOG.md:346
  836. msgid ""
  837. "To make things easier and to be consistent with other roles, the "
  838. "[maubot](./docs/configuring-playbook-bot-maubot.md) user (`bot.maubot` by"
  839. " default) is [now](https://github.com/spantaleev/matrix-docker-ansible-"
  840. "deploy/pull/3376) automatically created be the playbook."
  841. msgstr ""
  842. #: ../../../CHANGELOG.md:348
  843. msgid ""
  844. "If you have an existing maubot installation, you will need to specify "
  845. "`matrix_bot_maubot_initial_password` in your `vars.yml` file to make the "
  846. "playbook not complain about it being undefined. Since the bot is already "
  847. "registered in your installation, there's nothing for the playbook to do "
  848. "anyway. In case you don't remember the password you've registered your "
  849. "maubot user account with, you can specify any value for this variable."
  850. msgstr ""
  851. #: ../../../CHANGELOG.md:350
  852. msgid ""
  853. "If you've registered another username for the bot (other than the "
  854. "recommended default of `bot.maubot`), consider adjusting the "
  855. "`matrix_bot_maubot_login` variable (e.g. `matrix_bot_maubot_login: "
  856. "my.maubot.username`)."
  857. msgstr ""
  858. #: ../../../CHANGELOG.md:353
  859. msgid "2024-06-03"
  860. msgstr ""
  861. #: ../../../CHANGELOG.md:355
  862. msgid "WeChat bridging support"
  863. msgstr ""
  864. #: ../../../CHANGELOG.md:357
  865. msgid ""
  866. "Thanks to [Tobias Diez](https://github.com/tobiasdiez)'s "
  867. "[efforts](https://github.com/spantaleev/matrix-docker-ansible-"
  868. "deploy/pull/3241), the playbook now supports bridging to "
  869. "[WeChat](https://www.wechat.com/) via the [matrix-"
  870. "wechat](https://github.com/duo/matrix-wechat) bridge."
  871. msgstr ""
  872. #: ../../../CHANGELOG.md:359
  873. msgid ""
  874. "See our [Setting up WeChat bridging](docs/configuring-playbook-bridge-"
  875. "wechat.md) documentation page for getting started."
  876. msgstr ""
  877. #: ../../../CHANGELOG.md:362
  878. msgid "2024-03-26"
  879. msgstr ""
  880. #: ../../../CHANGELOG.md:364
  881. msgid ""
  882. "(Backward Compatibility Break) The playbook now defaults to KeyDB, "
  883. "instead of Redis"
  884. msgstr ""
  885. #: ../../../CHANGELOG.md:366
  886. msgid ""
  887. "**TLDR**: if the playbook used installed Redis as a dependency for you "
  888. "before, it will now replace it with [KeyDB](https://docs.keydb.dev/) (a "
  889. "drop-in alternative) due to [Redis having changed its "
  890. "license](https://redis.com/blog/redis-adopts-dual-source-available-"
  891. "licensing/)."
  892. msgstr ""
  893. #: ../../../CHANGELOG.md:368
  894. msgid ""
  895. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  896. "[etke.cc](https://etke.cc/), the playbook now uses "
  897. "[KeyDB](https://docs.keydb.dev/) (a drop-in alternative for Redis), "
  898. "instead of [Redis](https://redis.io/)."
  899. msgstr ""
  900. #: ../../../CHANGELOG.md:370
  901. msgid ""
  902. "The playbook used to install Redis (and now installs KeyDB in its place) "
  903. "if services have a need for it ([enabling worker support for "
  904. "Synapse](docs/configuring-playbook-synapse.md#load-balancing-with-"
  905. "workers), [enabling Hookshot encryption](docs/configuring-playbook-"
  906. "bridge-hookshot.md#end-to-bridge-encryption), etc.) or if you explicitly "
  907. "enabled the service (`redis_enabled: true` or `keydb_enabled: true`)."
  908. msgstr ""
  909. #: ../../../CHANGELOG.md:372
  910. msgid ""
  911. "This change is provoked by the fact that [Redis is now \"source "
  912. "available\"](https://redis.com/blog/redis-adopts-dual-source-available-"
  913. "licensing/). According to the Limitations of [the new "
  914. "license](https://redis.com/legal/rsalv2-agreement/) (as best as we "
  915. "understand them, given that we're not lawyers), using Redis in the "
  916. "playbook (even in a commercial FOSS service like "
  917. "[etke.cc](https://etke.cc/)) does not violate the new Redis license. That"
  918. " said, we'd rather neither risk it, nor endorse shady licenses and "
  919. "products that pretend to be free-software. Another high-quality "
  920. "alternative to Redis seems to be "
  921. "[Dragonfly](https://www.dragonflydb.io/), but the [Dragonfly "
  922. "license](https://github.com/dragonflydb/dragonfly?tab=License-1-ov-"
  923. "file#readme) is no better than Redis's."
  924. msgstr ""
  925. #: ../../../CHANGELOG.md:374
  926. msgid ""
  927. "Next time your run the playbook (via the `setup-all` tag), **Redis will "
  928. "be automatically uninstalled and replaced with KeyDB**. Some Synapse "
  929. "downtime may occur while the switch happens."
  930. msgstr ""
  931. #: ../../../CHANGELOG.md:376
  932. msgid ""
  933. "Users on `arm32` should be aware that there's **neither a prebuilt "
  934. "`arm32` container image for KeyDB**, nor the KeyDB role supports self-"
  935. "building yet. Users on this architecture likely don't run Synapse with "
  936. "workers, etc., so they're likely in no need of KeyDB (or Redis). If Redis"
  937. " is necessary in an `arm32` deployment, disabling KeyDB and making the "
  938. "playbook fall back to Redis is possible (see below)."
  939. msgstr ""
  940. #: ../../../CHANGELOG.md:387
  941. msgid "2024-03-24"
  942. msgstr ""
  943. #: ../../../CHANGELOG.md:389
  944. msgid "Initial work on IPv6 support"
  945. msgstr ""
  946. #: ../../../CHANGELOG.md:391
  947. msgid ""
  948. "Thanks to [Tilo Spannagel](https://github.com/tilosp), the playbook can "
  949. "now enable IPv6 for container networks for various components (roles) via"
  950. " [the `devture_systemd_docker_base_ipv6_enabled` "
  951. "variable](https://github.com/devture/com.devture.ansible.role.systemd_docker_base/blob/c11a526bb8e318b42eb52055056377bb31154f13/defaults/main.yml#L14-L31)."
  952. msgstr ""
  953. #: ../../../CHANGELOG.md:393
  954. msgid "It should be noted that:"
  955. msgstr ""
  956. #: ../../../CHANGELOG.md:395
  957. msgid ""
  958. "Matrix roles (`roles/custom/matrix-*`) respect this variable, but "
  959. "external roles (those defined in `requirements.yml` and installed via "
  960. "`just roles`) do not respect it yet. Additional work is necessary"
  961. msgstr ""
  962. #: ../../../CHANGELOG.md:396
  963. msgid ""
  964. "changing the variable subsequently may not change existing container "
  965. "networks. Refer to [these "
  966. "instructions](https://github.com/devture/com.devture.ansible.role.systemd_docker_base/blob/c11a526bb8e318b42eb52055056377bb31154f13/defaults/main.yml#L26-L30)"
  967. msgstr ""
  968. #: ../../../CHANGELOG.md:397
  969. msgid "this is all very new and untested"
  970. msgstr ""
  971. #: ../../../CHANGELOG.md:399
  972. msgid "Pantalaimon support"
  973. msgstr ""
  974. #: ../../../CHANGELOG.md:401
  975. msgid ""
  976. "Thanks to [Julian Foad](https://matrix.to/#/@julian:foad.me.uk), the "
  977. "playbook can now install the [Pantalaimon](https://github.com/matrix-"
  978. "org/pantalaimon) E2EE aware proxy daemon for you. It's already possible "
  979. "to integrate it with [Draupnir](docs/configuring-playbook-bot-"
  980. "draupnir.md) to allow it to work in E2EE rooms - see our Draupnir docs "
  981. "for details."
  982. msgstr ""
  983. #: ../../../CHANGELOG.md:403
  984. msgid ""
  985. "See our [Setting up Pantalaimon](docs/configuring-playbook-"
  986. "pantalaimon.md) documentation to get started."
  987. msgstr ""
  988. #: ../../../CHANGELOG.md:406
  989. msgid "2024-03-05"
  990. msgstr ""
  991. #: ../../../CHANGELOG.md:408
  992. msgid "Support for Draupnir-for-all"
  993. msgstr ""
  994. #: ../../../CHANGELOG.md:410
  995. msgid ""
  996. "Thanks to [FSG-Cat](https://github.com/FSG-Cat), the playbook can now "
  997. "install [Draupnir for all](./docs/configuring-playbook-appservice-"
  998. "draupnir-for-all.md) (aka multi-instance Draupnir running in appservice "
  999. "mode)."
  1000. msgstr ""
  1001. #: ../../../CHANGELOG.md:412
  1002. msgid ""
  1003. "This is an alternative to [running Draupnir in bot mode](./docs"
  1004. "/configuring-playbook-bot-draupnir.md), which is still supported by the "
  1005. "playbook."
  1006. msgstr ""
  1007. #: ../../../CHANGELOG.md:414
  1008. msgid ""
  1009. "The documentation page for [Draupnir for all](./docs/configuring-"
  1010. "playbook-appservice-draupnir-for-all.md) contains more information on how"
  1011. " to install it."
  1012. msgstr ""
  1013. #: ../../../CHANGELOG.md:417
  1014. msgid "2024-02-19"
  1015. msgstr ""
  1016. #: ../../../CHANGELOG.md:419
  1017. msgid "Support for bridging to Facebook/Messenger via the new mautrix-meta bridge"
  1018. msgstr ""
  1019. #: ../../../CHANGELOG.md:421
  1020. msgid ""
  1021. "The [mautrix-facebook](./docs/configuring-playbook-bridge-mautrix-"
  1022. "facebook.md) and [mautrix-instagram](./docs/configuring-playbook-bridge-"
  1023. "mautrix-instagram.md) bridges are being [superseded by a new "
  1024. "bridge](https://github.com/mautrix/facebook/issues/332) - the [mautrix-"
  1025. "meta](https://github.com/mautrix/meta) bridge."
  1026. msgstr ""
  1027. #: ../../../CHANGELOG.md:423
  1028. msgid ""
  1029. "The playbook now supports the new mautrix-meta bridge - a single bridge, "
  1030. "which can run in different modes and bridge to Messenger (via "
  1031. "[Facebook](https://facebook.com/), Facebook over "
  1032. "[Tor](https://www.torproject.org/) or via "
  1033. "[Messenger](https://messenger.com/)) and "
  1034. "[Instagram](https://instagram.com/). The playbook makes this bridge "
  1035. "available via 2 separate Ansible roles, allowing you to easily run 2 "
  1036. "instances of mautrix-meta, for bridging to both services at the same "
  1037. "time."
  1038. msgstr ""
  1039. #: ../../../CHANGELOG.md:425
  1040. msgid ""
  1041. "If you're using mautrix-facebook or mautrix-instagram right now, **you "
  1042. "can still continue using the old bridges, but may wish to change to the "
  1043. "new bridge implementations**. See:"
  1044. msgstr ""
  1045. #: ../../../CHANGELOG.md:427
  1046. msgid ""
  1047. "[Setting up Instagram bridging via Mautrix Meta](docs/configuring-"
  1048. "playbook-bridge-mautrix-meta-instagram.md)"
  1049. msgstr ""
  1050. #: ../../../CHANGELOG.md:429
  1051. msgid ""
  1052. "[Setting up Messenger bridging via Mautrix Meta](docs/configuring-"
  1053. "playbook-bridge-mautrix-meta-messenger.md)"
  1054. msgstr ""
  1055. #: ../../../CHANGELOG.md:431
  1056. msgid "The documentation pages contain more information on how to migrate."
  1057. msgstr ""
  1058. #: ../../../CHANGELOG.md:434
  1059. msgid "2024-02-14"
  1060. msgstr ""
  1061. #: ../../../CHANGELOG.md:436
  1062. msgid "Much larger Synapse caches and cache auto-tuning enabled by default"
  1063. msgstr ""
  1064. #: ../../../CHANGELOG.md:438
  1065. msgid ""
  1066. "Thanks to [FSG-Cat](https://github.com/FSG-Cat), the playbook now uses "
  1067. "much larger caches and enables Synapse's [cache auto-tuning "
  1068. "functionality](https://matrix-"
  1069. "org.github.io/synapse/latest/usage/configuration/config_documentation.html"
  1070. "#caches-and-associated-values). This work and the default values used by "
  1071. "the playbook are inspired by [Tom Foster](https://github.com/tcpipuk)'s "
  1072. "[Synapse homeserver "
  1073. "guide](https://tcpipuk.github.io/synapse/deployment/synapse.html)."
  1074. msgstr ""
  1075. #: ../../../CHANGELOG.md:440
  1076. msgid ""
  1077. "The playbook has always used a very conservative cache factor "
  1078. "(`matrix_synapse_caches_global_factor`) value of `0.5`, which may be OK "
  1079. "for small and underactive deployments, but is not ideal for larger "
  1080. "servers. Paradoxically, a small global cache factor value [does not "
  1081. "necessarily decrease RAM usage as a whole](https://github.com/matrix-"
  1082. "org/synapse/issues/3939)."
  1083. msgstr ""
  1084. #: ../../../CHANGELOG.md:442
  1085. msgid ""
  1086. "The playbook now uses **a 20x larger cache factor** (currently `10`), "
  1087. "adjusts a few other cache-related variables, and **enables cache auto-"
  1088. "tuning** via the following variables:"
  1089. msgstr ""
  1090. #: ../../../CHANGELOG.md:444
  1091. msgid ""
  1092. "`matrix_synapse_cache_autotuning_max_cache_memory_usage` - defaults to "
  1093. "1/8 of total RAM with a cap of 2GB; values are specified in bytes"
  1094. msgstr ""
  1095. #: ../../../CHANGELOG.md:445
  1096. msgid ""
  1097. "`matrix_synapse_cache_autotuning_target_cache_memory_usage` - defaults to"
  1098. " 1/16 of total RAM with a cap of 1GB; values are specified in bytes"
  1099. msgstr ""
  1100. #: ../../../CHANGELOG.md:446
  1101. msgid "`matrix_synapse_cache_autotuning_min_cache_ttl` - defaults to `30s`"
  1102. msgstr ""
  1103. #: ../../../CHANGELOG.md:448
  1104. msgid ""
  1105. "These values should be good defaults for most servers, but may change "
  1106. "over time as we experiment further."
  1107. msgstr ""
  1108. #: ../../../CHANGELOG.md:450
  1109. msgid ""
  1110. "Refer to our new [Tuning caches and cache autotuning](docs/maintenance-"
  1111. "synapse.md#tuning-caches-and-cache-autotuning) documentation section for "
  1112. "more details."
  1113. msgstr ""
  1114. #: ../../../CHANGELOG.md:453
  1115. msgid "2024-01-31"
  1116. msgstr ""
  1117. #: ../../../CHANGELOG.md:455
  1118. msgid ""
  1119. "(Backward-compatibility break) Minor changes necessary for some people "
  1120. "serving a static website at the base domain"
  1121. msgstr ""
  1122. #: ../../../CHANGELOG.md:457
  1123. msgid ""
  1124. "This only affects people who are [Serving a static website at the base "
  1125. "domain](./docs/configuring-playbook-base-domain-serving.md#serving-a"
  1126. "-static-website-at-the-base-domain), but not managing its `index.html` "
  1127. "through the playbook."
  1128. msgstr ""
  1129. #: ../../../CHANGELOG.md:459
  1130. msgid ""
  1131. "That is, for people who have "
  1132. "`matrix_static_files_file_index_html_enabled: false` in their `vars.yml` "
  1133. "configuration, the playbook has a new default behavior. Since the "
  1134. "playbook is not managing the `index.html` file, it will default to a more"
  1135. " sensible way of handling the base domain - redirecting "
  1136. "`https://example.com/` to `https://matrix.example.com/`, instead of "
  1137. "serving a 404 page."
  1138. msgstr ""
  1139. #: ../../../CHANGELOG.md:461
  1140. msgid ""
  1141. "If you are managing your static website by yourself (by dropping files "
  1142. "into `/matrix/static-files/public` somehow), then you probably don't wish"
  1143. " for such redirection to happen. You can disable it by adding "
  1144. "`matrix_static_files_container_labels_base_domain_root_path_redirection_enabled:"
  1145. " false` to your `vars.yml` configuration file."
  1146. msgstr ""
  1147. #: ../../../CHANGELOG.md:464
  1148. msgid "2024-01-20"
  1149. msgstr ""
  1150. #: ../../../CHANGELOG.md:466
  1151. msgid "Support for more efficient (specialized) Synapse workers"
  1152. msgstr ""
  1153. #: ../../../CHANGELOG.md:468
  1154. msgid ""
  1155. "Thanks to [Charles Wright](https://github.com/cvwright) from "
  1156. "[FUTO](https://www.futo.org/), the creators of the [Circles "
  1157. "app](https://circu.li/), the playbook has [received "
  1158. "support](https://github.com/spantaleev/matrix-docker-ansible-"
  1159. "deploy/pull/3100) for load-balancing the Synapse workload via "
  1160. "[specialized workers](./docs/configuring-playbook-synapse.md#specialized-"
  1161. "workers) which are supposed to work better than our old [generic "
  1162. "workers](./docs/configuring-playbook-synapse.md#generic-workers) "
  1163. "implementation."
  1164. msgstr ""
  1165. #: ../../../CHANGELOG.md:470
  1166. msgid ""
  1167. "For now, playbook defaults remain unchanged and the `one-of-each` "
  1168. "[workers preset](./docs/configuring-playbook-synapse.md#worker-presets) "
  1169. "continues being the default. However, the default may change in the "
  1170. "future. If you'd like to remain on this preset even if/when the defaults "
  1171. "change, consider explicitly adding `matrix_synapse_workers_preset: one-"
  1172. "of-each` to your `vars.yml` configuration."
  1173. msgstr ""
  1174. #: ../../../CHANGELOG.md:472
  1175. msgid ""
  1176. "Our specialized workers setup is based on recommendations found in [Tom "
  1177. "Foster](https://github.com/tcpipuk)'s [Synapse homeserver "
  1178. "guide](https://tcpipuk.github.io/synapse/index.html). What's special "
  1179. "about our new setup is that we try to parse information out of the "
  1180. "request (who the user is; which room is being operated on) and try to "
  1181. "forward similar requests to the same worker. As an example, this means "
  1182. "that once a worker caches some room information, subsequent requests for "
  1183. "the same room will be routed to the same worker (which supposedly still "
  1184. "has the room's state cached)."
  1185. msgstr ""
  1186. #: ../../../CHANGELOG.md:474
  1187. msgid ""
  1188. "To get started, refer to our [Specialized workers](./docs/configuring-"
  1189. "playbook-synapse.md#specialized-workers) documentation section."
  1190. msgstr ""
  1191. #: ../../../CHANGELOG.md:477
  1192. msgid "2024-01-17"
  1193. msgstr ""
  1194. #: ../../../CHANGELOG.md:479
  1195. msgid "Switching to Element's AGPLv3-licensed Synapse release"
  1196. msgstr ""
  1197. #: ../../../CHANGELOG.md:481
  1198. msgid ""
  1199. "A few months ago, the [Element](https://element.io/) company has "
  1200. "[announced](https://element.io/blog/element-to-adopt-agplv3/) that their "
  1201. "work on the Synapse homeserver would no longer be available under the "
  1202. "permissive [Apache-2.0 "
  1203. "license](https://www.apache.org/licenses/LICENSE-2.0), but only under:"
  1204. msgstr ""
  1205. #: ../../../CHANGELOG.md:483
  1206. msgid ""
  1207. "the [AGPLv3](https://www.gnu.org/licenses/agpl-3.0.en.html) free-software"
  1208. " license - the same license that this Ansible playbook has always used"
  1209. msgstr ""
  1210. #: ../../../CHANGELOG.md:484
  1211. msgid ""
  1212. "a proprietary license, for those wishing for Element to [sell them an "
  1213. "exception](https://gnu.org/philosophy/selling-exceptions.html) to the "
  1214. "AGPLv3 license"
  1215. msgstr ""
  1216. #: ../../../CHANGELOG.md:486
  1217. msgid ""
  1218. "You can also learn more in [this post](https://matrix.org/blog/2023/11/06"
  1219. "/future-of-synapse-dendrite/) by the Matrix Foundation."
  1220. msgstr ""
  1221. #: ../../../CHANGELOG.md:488
  1222. msgid ""
  1223. "The change has [already happened](https://element.io/blog/synapse-now-"
  1224. "lives-at-github-com-element-hq-synapse/) and the first Synapse release "
  1225. "under the new license is here: [v1.99.0](https://github.com/element-"
  1226. "hq/synapse/releases/tag/v1.99.0)."
  1227. msgstr ""
  1228. #: ../../../CHANGELOG.md:490
  1229. msgid ""
  1230. "There is no up-to-date alternative Synapse fork right now and this free-"
  1231. "software (AGPLv3-licensed) playbook is definitely not against free-"
  1232. "software licenses, so we are now switching to the Element-maintained "
  1233. "Synapse release."
  1234. msgstr ""
  1235. #: ../../../CHANGELOG.md:492
  1236. msgid "**What does this mean to you?**"
  1237. msgstr ""
  1238. #: ../../../CHANGELOG.md:494
  1239. msgid ""
  1240. "For most home users, it doesn't mean anything. Your installation will "
  1241. "continue working as it should and you don't need to do anything."
  1242. msgstr ""
  1243. #: ../../../CHANGELOG.md:496
  1244. msgid ""
  1245. "For people building commercial products on top of Synapse, they may have "
  1246. "to either buy a license exception from Element (from what we hear, the "
  1247. "fee depends on the number of monthly-active users on your instance) or "
  1248. "they may need to release all related code as free-software (which is what"
  1249. " we've been doing at [etke.cc](https://etke.cc/) "
  1250. "([here](https://gitlab.com/etke.cc)) all along)."
  1251. msgstr ""
  1252. #: ../../../CHANGELOG.md:498
  1253. msgid ""
  1254. "We're no lawyers and this changelog entry does not aim to give you the "
  1255. "best legal advice, so please research on your own!"
  1256. msgstr ""
  1257. #: ../../../CHANGELOG.md:500
  1258. msgid ""
  1259. "If you'd like to continue using the old Apache-2.0-licensed Synapse (for "
  1260. "a while longer anyway), the playbook makes it possible by intruducing a "
  1261. "new Ansible variable. You can do it like this:"
  1262. msgstr ""
  1263. #: ../../../CHANGELOG.md:512
  1264. msgid "Notes:"
  1265. msgstr ""
  1266. #: ../../../CHANGELOG.md:514
  1267. msgid ""
  1268. "if you had already upgraded Synapse to `v1.99.0` by running this "
  1269. "playbook, you will still be able to downgrade to `v1.98.0`, because both "
  1270. "releases use the same database schema version (`SCHEMA_COMPAT_VERSION = "
  1271. "83` - see [here for v1.98.0](https://github.com/element-"
  1272. "hq/synapse/blob/v1.98.0/synapse/storage/schema/__init__.py#L131-L134) and"
  1273. " [here for v1.99.0](https://github.com/element-"
  1274. "hq/synapse/blob/v1.99.0/synapse/storage/schema/__init__.py#L137-L140)). "
  1275. "More details on Synapse's database schema are available [here](https"
  1276. "://element-"
  1277. "hq.github.io/synapse/develop/development/database_schema.html). It "
  1278. "appears that there are no new database migrations introduced in "
  1279. "`v1.99.0`, so going back to the older release is possible. This is not "
  1280. "guaranteed to hold true for future Synapse releases, so if you're seeing "
  1281. "this early-enough, consider pinning the version and organization before "
  1282. "re-running the playbook and getting upgraded to the latest version"
  1283. msgstr ""
  1284. #: ../../../CHANGELOG.md:516
  1285. msgid ""
  1286. "running an outdated homeserver exposes you to security issues and "
  1287. "incompatibilities. Only consider doing this as a short-term solution."
  1288. msgstr ""
  1289. #: ../../../CHANGELOG.md:518
  1290. msgid "2024-01-16"
  1291. msgstr ""
  1292. #: ../../../CHANGELOG.md:520
  1293. msgid "`Draupnir` has been relicensed to AFL-3.0"
  1294. msgstr ""
  1295. #: ../../../CHANGELOG.md:522
  1296. msgid ""
  1297. "As of [#204](https://github.com/the-draupnir-project/Draupnir/pull/204) "
  1298. "Draupnir changed its licence to AFL-3.0 from the CSL licence. This change"
  1299. " affects playbook users who could not run Draupnir under the old license "
  1300. "restrictions. The new license is considerably less restrictive and is OSI"
  1301. " approved. Draupnir version v1.86.0 and later are covered by this license"
  1302. " change."
  1303. msgstr ""
  1304. #: ../../../CHANGELOG.md:524
  1305. msgid "2024-01-15"
  1306. msgstr ""
  1307. #: ../../../CHANGELOG.md:526
  1308. msgid "Goodbye, `matrix-nginx-proxy` 🪦"
  1309. msgstr ""
  1310. #: ../../../CHANGELOG.md:528
  1311. msgid ""
  1312. "**TLDR**: All traces of the `matrix-nginx-proxy` reverse-proxy component "
  1313. "are now gone. This brought about many other internal changes (and "
  1314. "security improvements), so setups may need minor adjustments or suffer "
  1315. "some (temporary) breakage. People who have been on the Traefik-native "
  1316. "setup may upgrade without much issues. Those running their own Traefik "
  1317. "instance may need minor changes. People who have been postponing the "
  1318. "migration away from `matrix-nginx-proxy` (for more than a year already!) "
  1319. "will now finally need to do something about it."
  1320. msgstr ""
  1321. #: ../../../CHANGELOG.md:530
  1322. msgid "Backstory on `matrix-nginx-proxy`"
  1323. msgstr ""
  1324. #: ../../../CHANGELOG.md:532
  1325. msgid ""
  1326. "We gather here today to celebrate the loss of a once-beloved component in"
  1327. " our stack - `matrix-nginx-proxy`. It's been our "
  1328. "[nginx](https://nginx.org/)-based reverse-proxy of choice since the "
  1329. "[first commit](https://github.com/spantaleev/matrix-docker-ansible-"
  1330. "deploy/tree/87f5883f2455fb115457b65f267f17de305c053c) of this playbook, 7"
  1331. " years ago."
  1332. msgstr ""
  1333. #: ../../../CHANGELOG.md:534
  1334. msgid ""
  1335. "For 6 years, `matrix-nginx-proxy` has been the front-most reverse-proxy "
  1336. "in our setup (doing SSL termination, etc.). After [transitioning to "
  1337. "Traefik last year](#traefik-is-the-default-reverse-proxy-now), `matrix-"
  1338. "nginx-proxy` took a step back. Nevertheless, since it was so ingrained "
  1339. "into the playbook, it still remained in use - even if only internally. "
  1340. "Despite our warnings of its imminent death, many of you have indubitably "
  1341. "continued to use it instead of Traefik. Its suffering continued for too "
  1342. "long, because it served many different purposes and massive effort was "
  1343. "required to transition them to others."
  1344. msgstr ""
  1345. #: ../../../CHANGELOG.md:536
  1346. msgid "To us, `matrix-nginx-proxy` was:"
  1347. msgstr ""
  1348. #: ../../../CHANGELOG.md:538
  1349. msgid "an [nginx](https://nginx.org/)-based reverse-proxy"
  1350. msgstr ""
  1351. #: ../../../CHANGELOG.md:539
  1352. msgid ""
  1353. "an Ansible role organizing the work of "
  1354. "[certbot](https://certbot.eff.org/) - retrieving free [Let's "
  1355. "Encrypt](https://letsencrypt.org/) SSL certificates for `matrix-nginx-"
  1356. "proxy` and for the [Coturn TURN server](./docs/configuring-playbook-"
  1357. "turn.md)"
  1358. msgstr ""
  1359. #: ../../../CHANGELOG.md:540
  1360. msgid ""
  1361. "a central component for reverse-proxying to the [long list of "
  1362. "services](./docs/configuring-playbook.md) supported by the playbook. As "
  1363. "such, it became a dependency that all these services had to inject "
  1364. "themselves into during runtime"
  1365. msgstr ""
  1366. #: ../../../CHANGELOG.md:541
  1367. msgid ""
  1368. "an intermediary through which addons (bridges, bots) communicated with "
  1369. "the homeserver. Going through an intermediary (instead of directly "
  1370. "talking to the homeserver) is useful when certain components (like "
  1371. "[matrix-media-repo](./docs/configuring-playbook-matrix-media-repo.md) or "
  1372. "[matrix-corporal](./docs/configuring-playbook-matrix-corporal.md)) are "
  1373. "enabled, because it lets these services \"steal routes\" from the "
  1374. "homeserver"
  1375. msgstr ""
  1376. #: ../../../CHANGELOG.md:542
  1377. msgid ""
  1378. "a webserver for serving the `/.well-known/matrix` static files (generated"
  1379. " by the `matrix-base` role until now)"
  1380. msgstr ""
  1381. #: ../../../CHANGELOG.md:543
  1382. msgid ""
  1383. "a webserver [serving your base domain](./docs/configuring-playbook-base-"
  1384. "domain-serving.md) (and also generating the `index.html` page for it)"
  1385. msgstr ""
  1386. #: ../../../CHANGELOG.md:544
  1387. msgid ""
  1388. "a central component providing global [HTTP Basic "
  1389. "Auth](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) "
  1390. "password-protection for all `/metrics` endpoints when metrics were "
  1391. "exposed publicly for consumption from a remote Prometheus server"
  1392. msgstr ""
  1393. #: ../../../CHANGELOG.md:546
  1394. msgid ""
  1395. "Talk about a jack of all trades! The [UNIX "
  1396. "philosophy](https://en.wikipedia.org/wiki/Unix_philosophy) (and Docker "
  1397. "container philosophy) of \"do one thing and do it well\" had been "
  1398. "severely violated for too long."
  1399. msgstr ""
  1400. #: ../../../CHANGELOG.md:548
  1401. msgid ""
  1402. "On a related note, we also had a large chain of reverse-proxies in the "
  1403. "mix. In the worst case, it was something like this: (Traefik -> `matrix-"
  1404. "nginx-proxy:8080` -> `matrix-nginx-proxy:12080` -> `matrix-synapse-"
  1405. "reverse-proxy-companion:8008` -> `matrix-synapse:8008`)."
  1406. msgstr ""
  1407. #: ../../../CHANGELOG.md:550
  1408. msgid ""
  1409. "Due to complexity and the playbook's flexibility (trying to accommodate a"
  1410. " mix of tens of components), many layers of indirection were necessary. "
  1411. "We do like reverse-proxies, but.. not quite enough to enjoy going through"
  1412. " a chain of ~4 of them before reaching the target service."
  1413. msgstr ""
  1414. #: ../../../CHANGELOG.md:552
  1415. msgid ""
  1416. "After **a ton of work** in the last weeks (200+ commits, which changed "
  1417. "467 files - 8684 insertions and 8913 deletions), **we're finally saying "
  1418. "goodbye** to `matrix-nginx-proxy`."
  1419. msgstr ""
  1420. #: ../../../CHANGELOG.md:554
  1421. msgid "Going Traefik-native and cutting out all middlemen"
  1422. msgstr ""
  1423. #: ../../../CHANGELOG.md:556
  1424. msgid "In our new setup, you'll see the bare minimum number of reverse-proxies."
  1425. msgstr ""
  1426. #: ../../../CHANGELOG.md:558
  1427. msgid ""
  1428. "In most cases, there's only Traefik and all services being registered "
  1429. "directly with it. When [Synapse workers](./docs/configuring-playbook-"
  1430. "synapse.md#load-balancing-with-workers) are enabled, `matrix-synapse-"
  1431. "reverse-proxy-companion` remains as an extra reverse-proxy that requests "
  1432. "go through (for load-balancing to the correct Synapse worker), but in all"
  1433. " other cases services are exposed directly."
  1434. msgstr ""
  1435. #: ../../../CHANGELOG.md:560
  1436. msgid ""
  1437. "This reduces \"network\" hops (improving performance) and also decreases "
  1438. "the number of components (containers). Each Ansible role in our setup is "
  1439. "now independent and doesn't need to interact with other roles during "
  1440. "runtime."
  1441. msgstr ""
  1442. #: ../../../CHANGELOG.md:562
  1443. msgid "Traefik now has an extra job"
  1444. msgstr ""
  1445. #: ../../../CHANGELOG.md:564
  1446. msgid ""
  1447. "Previously, **Traefik had a single purpose** - being the main reverse-"
  1448. "proxy. It was either front-most (terminating SSL, etc.) or you were "
  1449. "[fronting Traefik with your own other reverse-proxy](./docs/configuring-"
  1450. "playbook-own-webserver.md#fronting-the-integrated-reverse-proxy-"
  1451. "webserver-with-another-reverse-proxy). In any case - it had this central "
  1452. "(yet decentralized) job."
  1453. msgstr ""
  1454. #: ../../../CHANGELOG.md:566
  1455. msgid ""
  1456. "Now, **Traefik has one more role** - it serves as an intermediary which "
  1457. "allows addon services (bridges, bots, etc.) to communicate with the "
  1458. "homeserver. As mentioned above, such an intermediary service is not "
  1459. "strictly necessary in all kinds of setups, but more complex setups "
  1460. "(including [matrix-media-repo](./docs/configuring-playbook-matrix-media-"
  1461. "repo.md) or [matrix-corporal](./docs/configuring-playbook-matrix-"
  1462. "corporal.md)) benefit from it."
  1463. msgstr ""
  1464. #: ../../../CHANGELOG.md:568
  1465. msgid ""
  1466. "To perform this new role, Traefik now has a new internal "
  1467. "[entrypoint](https://doc.traefik.io/traefik/routing/entrypoints/) called "
  1468. "`matrix-internal-matrix-client-api`. All homeservers (Conduit, Dendrite, "
  1469. "Synapse and even `matrix-synapse-reverse-proxy-companion`) and "
  1470. "homeserver-related core services ([matrix-media-repo](./docs/configuring-"
  1471. "playbook-matrix-media-repo.md), [matrix-corporal](./docs/configuring-"
  1472. "playbook-matrix-corporal.md) and potentially others) register their "
  1473. "routes (using [container labels](https://docs.docker.com/config/labels-"
  1474. "custom-metadata/)) not only on the public entrypoints (`web-secure`, "
  1475. "`matrix-federation`), but also on this new internal entrypoint."
  1476. msgstr ""
  1477. #: ../../../CHANGELOG.md:570
  1478. msgid ""
  1479. "Doing so, services can contact Traefik on this entrypoint's dedicated "
  1480. "port (the URL defaults to `http://matrix-traefik:8008`) and reach the "
  1481. "homeserver Client-Server API as they expect. Internally, Traefik takes "
  1482. "care of the routing to the correct service."
  1483. msgstr ""
  1484. #: ../../../CHANGELOG.md:572
  1485. msgid ""
  1486. "We've also considered keeping it simple and having services talk to the "
  1487. "homeserver over the public internet (e.g. `https://matrix.example.com`) "
  1488. "thus reusing all existing Traefik routing labels. In this scenario, "
  1489. "performance was incredibly poor (e.g. 70 rps, instead of 1400 rps) due to"
  1490. " TLS and networking overhead. The need for fast internal communication "
  1491. "(via the new internal non-TLS-enabled Traefik entrypoint) is definitely "
  1492. "there. In our benchmarks, Traefik even proved more efficient than nginx "
  1493. "at doing this: ~1200 rps for Traefik compared to ~900 rps for nginx (out "
  1494. "of ~1400 rps when talking to the Synapse homeserver directly)."
  1495. msgstr ""
  1496. #: ../../../CHANGELOG.md:574
  1497. msgid "Traefik serving this second purpose has a few downsides:"
  1498. msgstr ""
  1499. #: ../../../CHANGELOG.md:576
  1500. msgid ""
  1501. "Traefik becomes a runtime dependency for all homeserver-dependant "
  1502. "container services"
  1503. msgstr ""
  1504. #: ../../../CHANGELOG.md:577
  1505. msgid ""
  1506. "all homeserver-dependant services now need to be connected to the "
  1507. "`traefik` container network, even if they don't need public internet "
  1508. "exposure"
  1509. msgstr ""
  1510. #: ../../../CHANGELOG.md:579
  1511. msgid ""
  1512. "Despite these downsides (which the playbook manages automatically), we "
  1513. "believe it's still a good compromise given the amount of complexity it "
  1514. "eliminates and the performance benefits it yields. One alternative we've "
  1515. "[considered](https://github.com/spantaleev/matrix-docker-ansible-"
  1516. "deploy/pull/3045#issuecomment-1867327001) was adding a new intermediary "
  1517. "service (e.g. `matrix-homeserver-proxy` powered by nginx), but this both "
  1518. "had much higher complexity (one more component in the mix; duplication of"
  1519. " effort to produce nginx-compatible route definitions for it) and "
  1520. "slightly worse performance (see above)."
  1521. msgstr ""
  1522. #: ../../../CHANGELOG.md:581
  1523. msgid ""
  1524. "People running the default Traefik setup do not need to do anything to "
  1525. "make Traefik take on this extra job. Your Traefik configuration will be "
  1526. "updated automatically."
  1527. msgstr ""
  1528. #: ../../../CHANGELOG.md:583
  1529. msgid ""
  1530. "**People runnning their own Traefik reverse-proxy need to do [minor "
  1531. "adjustments](#people-managing-their-own-traefik-instance-need-to-do-"
  1532. "minor-changes)**, as described in the section below."
  1533. msgstr ""
  1534. #: ../../../CHANGELOG.md:585
  1535. msgid ""
  1536. "You may disable Traefik acting as an intermediary by explicitly setting "
  1537. "`matrix_playbook_public_matrix_federation_api_traefik_entrypoint_enabled`"
  1538. " to `false`. Services would then be configured to talk to the homeserver "
  1539. "directly, giving you a slight performance boost and a \"simpler\" Traefik"
  1540. " setup. However, such a configuration is less tested and will cause "
  1541. "troubles, especially if you enable more services (like `matrix-media-"
  1542. "repo`, etc.) in the future. As such, it's not recommended."
  1543. msgstr ""
  1544. #: ../../../CHANGELOG.md:587
  1545. msgid "People managing their own Traefik instance need to do minor changes"
  1546. msgstr ""
  1547. #: ../../../CHANGELOG.md:589
  1548. msgid ""
  1549. "This section is for people [managing their own Traefik instance on the "
  1550. "Matrix server](./docs/configuring-playbook-own-webserver.md#traefik-"
  1551. "managed-by-you). Those [using Traefik managed by the playbook](./docs"
  1552. "/configuring-playbook-own-webserver.md#traefik-managed-by-the-playbook) "
  1553. "don't need to do any changes."
  1554. msgstr ""
  1555. #: ../../../CHANGELOG.md:591
  1556. msgid ""
  1557. "Because [Traefik has an extra job now](#traefik-now-has-an-extra-job), "
  1558. "you need to adapt your configuration to add the additional `matrix-"
  1559. "internal-matrix-client-api` entrypoint and potentially configure the "
  1560. "`matrix_playbook_reverse_proxy_container_network` variable. See the "
  1561. "[Traefik managed by you](./docs/configuring-playbook-own-webserver.md"
  1562. "#traefik-managed-by-you) documentation section for more details."
  1563. msgstr ""
  1564. #: ../../../CHANGELOG.md:593
  1565. msgid ""
  1566. "People fronting Traefik with another reverse proxy need to do minor "
  1567. "changes"
  1568. msgstr ""
  1569. #: ../../../CHANGELOG.md:595
  1570. msgid ""
  1571. "We've already previously mentioned that you need to do some minor "
  1572. "[configuration changes related to `traefik_additional_entrypoints_auto"
  1573. "`](#backward-compatibility-configuration-changes-required-for-people-"
  1574. "fronting-the-integrated-reverse-proxy-webserver-with-another-reverse-"
  1575. "proxy)."
  1576. msgstr ""
  1577. #: ../../../CHANGELOG.md:597
  1578. msgid ""
  1579. "If you don't do these changes (switching from "
  1580. "`traefik_additional_entrypoints_auto` to multiple other variables), your "
  1581. "Traefik setup will not automatically receive the new `matrix-internal-"
  1582. "matrix-client-api` Traefik entrypoint and Traefik would not be able to "
  1583. "perform [its new duty of connecting addons with the homeserver](#traefik-"
  1584. "now-has-an-extra-job)."
  1585. msgstr ""
  1586. #: ../../../CHANGELOG.md:599
  1587. msgid "Supported reverse proxy types are now fewer"
  1588. msgstr ""
  1589. #: ../../../CHANGELOG.md:601
  1590. msgid ""
  1591. "This section is for people using a more custom reverse-proxy setup - "
  1592. "those having `matrix_playbook_reverse_proxy_type` set to a value "
  1593. "different than the default (`playbook-managed-traefik`)."
  1594. msgstr ""
  1595. #: ../../../CHANGELOG.md:603
  1596. msgid ""
  1597. "Previously, we allowed you to set `matrix_playbook_reverse_proxy_type` to"
  1598. " 7 different values to accommodate various reverse-proxy setups."
  1599. msgstr ""
  1600. #: ../../../CHANGELOG.md:605
  1601. msgid "The complexity of this is too high, so we only support 3 values right now:"
  1602. msgstr ""
  1603. #: ../../../CHANGELOG.md:607
  1604. msgid ""
  1605. "(the default) `playbook-managed-traefik`, when you're [using Traefik "
  1606. "managed by the playbook](./docs/configuring-playbook-own-webserver.md"
  1607. "#traefik-managed-by-the-playbook)"
  1608. msgstr ""
  1609. #: ../../../CHANGELOG.md:608
  1610. msgid ""
  1611. "`other-traefik-container`, when you're [managing your own Traefik "
  1612. "instance on the Matrix server](./docs/configuring-playbook-own-"
  1613. "webserver.md#traefik-managed-by-you)"
  1614. msgstr ""
  1615. #: ../../../CHANGELOG.md:609
  1616. msgid ""
  1617. "`none`, when you wish for [no reverse-proxy integration to be done at "
  1618. "all](./docs/configuring-playbook-own-webserver.md#using-no-reverse-proxy-"
  1619. "on-the-matrix-side-at-all)"
  1620. msgstr ""
  1621. #: ../../../CHANGELOG.md:611
  1622. msgid ""
  1623. "The `none` value is not recommended and may not work adequately, due to "
  1624. "lack of testing and [Traefik's new responsibilities](#traefik-now-has-an-"
  1625. "extra-job) in our setup."
  1626. msgstr ""
  1627. #: ../../../CHANGELOG.md:613
  1628. msgid ""
  1629. "**Previous values that are now gone** (and the playbook would report them"
  1630. " as such) are: `playbook-managed-nginx`, `other-nginx-non-container`, "
  1631. "`other-on-same-host` and `other-on-another-host`."
  1632. msgstr ""
  1633. #: ../../../CHANGELOG.md:615
  1634. msgid ""
  1635. "If you were using these values as a way to stay away from Traefik, you "
  1636. "now have 2 options:"
  1637. msgstr ""
  1638. #: ../../../CHANGELOG.md:617
  1639. msgid ""
  1640. "(recommended) [Fronting Traefik with another reverse-proxy](./docs"
  1641. "/configuring-playbook-own-webserver.md#fronting-the-integrated-reverse-"
  1642. "proxy-webserver-with-another-reverse-proxy)"
  1643. msgstr ""
  1644. #: ../../../CHANGELOG.md:618
  1645. msgid ""
  1646. "(not recommended) [Using no reverse-proxy on the Matrix side at "
  1647. "all](./docs/configuring-playbook-own-webserver.md#using-no-reverse-proxy-"
  1648. "on-the-matrix-side-at-all) and reverse-proxying to each and every service"
  1649. " manually"
  1650. msgstr ""
  1651. #: ../../../CHANGELOG.md:620
  1652. msgid "Container networking changes"
  1653. msgstr ""
  1654. #: ../../../CHANGELOG.md:622
  1655. msgid ""
  1656. "Now that `matrix-nginx-proxy` is not in the mix, it became easier to "
  1657. "clear out some other long-overdue technical debt."
  1658. msgstr ""
  1659. #: ../../../CHANGELOG.md:624
  1660. msgid ""
  1661. "Since the very beginning of this playbook, all playbook services were "
  1662. "connected to a single (shared) `matrix` container network. Later on, some"
  1663. " additional container networks appeared, but most services (database, "
  1664. "etc.) still remained in the `matrix` container network. This meant that "
  1665. "any random container in this network could try to talk (or attack) the "
  1666. "Postgres database operating in the same `matrix` network."
  1667. msgstr ""
  1668. #: ../../../CHANGELOG.md:626
  1669. msgid ""
  1670. "Moving components (especially the database) into other container networks"
  1671. " was difficult - it required changes to many other components to ensure "
  1672. "correct connectivity."
  1673. msgstr ""
  1674. #: ../../../CHANGELOG.md:628
  1675. msgid ""
  1676. "All the hard work has been done now. We've added much more isolation "
  1677. "between services by splitting them up into separate networks (`matrix-"
  1678. "homeserver`, `matrix-addons`, `matrix-monitoring`, `matrix-exim-relay`, "
  1679. "etc). Components are only joined to the networks they need and should "
  1680. "(for the most part) not be able to access unrelated things."
  1681. msgstr ""
  1682. #: ../../../CHANGELOG.md:630
  1683. msgid ""
  1684. "Carrying out these container networking changes necessitated modifying "
  1685. "many components, so **we're hoping not too many bugs were introduced in "
  1686. "the process**."
  1687. msgstr ""
  1688. #: ../../../CHANGELOG.md:632
  1689. msgid ""
  1690. "We've refrained from creating too many container networks (e.g. one for "
  1691. "each component), to avoid exhausting Docker's default network pool and "
  1692. "contaminating the container networks list too much."
  1693. msgstr ""
  1694. #: ../../../CHANGELOG.md:634
  1695. msgid "Metrics exposure changes"
  1696. msgstr ""
  1697. #: ../../../CHANGELOG.md:636
  1698. msgid ""
  1699. "This section is for people who are exposing monitoring metrics publicly, "
  1700. "to be consumed by an external Prometheus server."
  1701. msgstr ""
  1702. #: ../../../CHANGELOG.md:638
  1703. msgid ""
  1704. "Previously, `matrix-nginx-proxy` was potentially password-protecting all "
  1705. "`/metrics/*` endpoints with the same username and password (specified as "
  1706. "plain-text in your `vars.yml` configuration file)."
  1707. msgstr ""
  1708. #: ../../../CHANGELOG.md:640
  1709. msgid ""
  1710. "From now on, there are new variables for doing roughly the same - "
  1711. "`matrix_metrics_exposure_enabled`, "
  1712. "`matrix_metrics_exposure_http_basic_auth_enabled` and "
  1713. "`matrix_metrics_exposure_http_basic_auth_users`. See the [Prometheus & "
  1714. "Grafana](./docs/configuring-playbook-prometheus-grafana.md) docs page for"
  1715. " details."
  1716. msgstr ""
  1717. #: ../../../CHANGELOG.md:642
  1718. msgid ""
  1719. "`matrix-nginx-proxy` is not acting as a \"global guardian\" anymore. Now,"
  1720. " each role provides its own metrics exposure and protection by "
  1721. "registering with Traefik. Nevertheless, all roles are wired (via playbook"
  1722. " configuration in `group_vars/matrix_servers`) to obey these new "
  1723. "`matrix_metrics_exposure_*` variables. We've eliminated the "
  1724. "centralization, but have kept the ease of use. Now, you can also do per-"
  1725. "service password-protection (with different credentials), should you need"
  1726. " to do that for some reason."
  1727. msgstr ""
  1728. #: ../../../CHANGELOG.md:644
  1729. msgid ""
  1730. "The playbook will tell you about all variables that you need to migrate "
  1731. "during runtime, so rest assured - you shouldn't be able to miss anything!"
  1732. msgstr ""
  1733. #: ../../../CHANGELOG.md:646
  1734. msgid "Matrix static files"
  1735. msgstr ""
  1736. #: ../../../CHANGELOG.md:648
  1737. msgid ""
  1738. "As mentioned above, static files like `/.well-known/matrix/*` or your "
  1739. "base domain's `index.html` file (when [serving the base domain via the "
  1740. "Matrix server](./docs/configuring-playbook-base-domain-serving.md) was "
  1741. "enabled) were generated by the `matrix-base` or `matrix-nginx-proxy` "
  1742. "roles and put into a `/matrix/static-files` directory on the server. Then"
  1743. " `matrix-nginx-proxy` was serving all these static files."
  1744. msgstr ""
  1745. #: ../../../CHANGELOG.md:650
  1746. msgid ""
  1747. "All of this has been extracted into a new `matrix-static-files` Ansible "
  1748. "role that's part of the playbook. The static files generated by this new "
  1749. "role still live at roughly the same place (`/matrix/static-files/public` "
  1750. "directory, instead of `/matrix/static-files`)."
  1751. msgstr ""
  1752. #: ../../../CHANGELOG.md:652
  1753. msgid ""
  1754. "The playbook will migrate and update the `/.well-known/matrix/*` files "
  1755. "automatically but not your own files in `nginx-proxy/data/matrix-domain/`"
  1756. " you will need to back these up yourself otherwise they will be lost. It "
  1757. "will also warn you about usage of old variable names, so you can adapt to"
  1758. " the new names."
  1759. msgstr ""
  1760. #: ../../../CHANGELOG.md:654
  1761. msgid "A note on performance"
  1762. msgstr ""
  1763. #: ../../../CHANGELOG.md:656
  1764. msgid ""
  1765. "Some of you have been voicing their concerns (for a long time) about "
  1766. "Traefik being too slow and nginx being better."
  1767. msgstr ""
  1768. #: ../../../CHANGELOG.md:658
  1769. msgid ""
  1770. "Some online benchmarks support this by demonstrating slightly higher SSL-"
  1771. "termination performance in favor of nginx. The upcoming Traefik v3 "
  1772. "release is [said to](https://medium.com/beyn-technology/is-nginx-dead-is-"
  1773. "traefik-v3-20-faster-than-traefik-v2-f28ffb7eed3e) improve Traefik's SSL "
  1774. "performance by some 20%, but that still ends up being somewhat slower "
  1775. "than nginx."
  1776. msgstr ""
  1777. #: ../../../CHANGELOG.md:660
  1778. msgid ""
  1779. "We believe that using Traefik provides way too many benefits to worry "
  1780. "about this minor performance impairment."
  1781. msgstr ""
  1782. #: ../../../CHANGELOG.md:662
  1783. msgid ""
  1784. "The heaviest part of running a Matrix homeserver is all the slow and "
  1785. "potentially inefficient things the homeserver (e.g. Synapse) is doing. "
  1786. "These things affect performance much more than whatever reverse-proxy is "
  1787. "in front. Your server will die the same way by joining the famously large"
  1788. " **Matrix HQ** room, no matter which reverse-proxy you put in front."
  1789. msgstr ""
  1790. #: ../../../CHANGELOG.md:664
  1791. msgid ""
  1792. "Even our previously mentioned benchmarks (yielding ~1300 rps) are "
  1793. "synthetic - hitting a useless `/_matrix/client/versions` endpoint. Real-"
  1794. "use does much more than this."
  1795. msgstr ""
  1796. #: ../../../CHANGELOG.md:666
  1797. msgid ""
  1798. "If this is still not convincing enough for you and you want the best "
  1799. "possible performance, consider [Fronting Traefik with another reverse-"
  1800. "proxy](./docs/configuring-playbook-own-webserver.md#fronting-the-"
  1801. "integrated-reverse-proxy-webserver-with-another-reverse-proxy) (thus "
  1802. "having the slowest part - SSL termination - happen elsewhere) or [Using "
  1803. "no reverse-proxy on the Matrix side at all](./docs/configuring-playbook-"
  1804. "own-webserver.md#using-no-reverse-proxy-on-the-matrix-side-at-all). The "
  1805. "playbook will not get in your way of doing that, but these options may "
  1806. "make your life much harder. Performance comes at a cost, after all."
  1807. msgstr ""
  1808. #: ../../../CHANGELOG.md:668
  1809. msgid "Migration procedure"
  1810. msgstr ""
  1811. #: ../../../CHANGELOG.md:670
  1812. msgid ""
  1813. "The updated playbook will automatically perform some migration tasks for "
  1814. "you:"
  1815. msgstr ""
  1816. #: ../../../CHANGELOG.md:672
  1817. msgid ""
  1818. "It will stop and remove the `matrix-nginx-proxy` systemd service and "
  1819. "container for you. This behavior cannot be disabled. It's essential that "
  1820. "this service gets stopped, because it remaining running (and having "
  1821. "container labels) may confuse Traefik as to where to route HTTP requests."
  1822. msgstr ""
  1823. #: ../../../CHANGELOG.md:674
  1824. msgid ""
  1825. "It will delete the `/matrix/nginx-proxy` directory and all files within "
  1826. "it. You can disable this behavior by adding "
  1827. "`matrix_playbook_migration_matrix_nginx_proxy_uninstallation_enabled: "
  1828. "false` to your `vars.yml` configuration file. Doing so will leave its "
  1829. "data around."
  1830. msgstr ""
  1831. #: ../../../CHANGELOG.md:676
  1832. msgid ""
  1833. "It will delete the `/matrix/ssl` directory and all files within it. You "
  1834. "can disable this behavior by adding "
  1835. "`matrix_playbook_migration_matrix_ssl_uninstallation_enabled: false` to "
  1836. "your `vars.yml` configuration file. If you have some important "
  1837. "certificates there for some reason, take them out or temporarily disable "
  1838. "removal of these files until you do."
  1839. msgstr ""
  1840. #: ../../../CHANGELOG.md:678
  1841. msgid ""
  1842. "It will tell you about all variables (`matrix_nginx_proxy_*` and many "
  1843. "others - even from other roles) that have changed during this large "
  1844. "nginx-elimination upgrade. You can disable this behavior by adding "
  1845. "`matrix_playbook_migration_matrix_nginx_proxy_elimination_variable_transition_checks_enabled:"
  1846. " false` to your `vars.yml` configuration file."
  1847. msgstr ""
  1848. #: ../../../CHANGELOG.md:680
  1849. msgid ""
  1850. "It will tell you about any leftover `matrix_nginx_proxy_*` variables in "
  1851. "your `vars.yml` file. You can disable this behavior by adding "
  1852. "`matrix_playbook_migration_matrix_nginx_proxy_leftover_variable_validation_checks_enabled:"
  1853. " false` to your `vars.yml` configuration file."
  1854. msgstr ""
  1855. #: ../../../CHANGELOG.md:682
  1856. msgid ""
  1857. "It will tell you about any leftover `matrix_ssl_*` variables in your "
  1858. "`vars.yml` file. You can disable this behavior by adding "
  1859. "`matrix_playbook_migration_matrix_ssl_leftover_variable_checks_enabled: "
  1860. "false` to your `vars.yml` configuration file."
  1861. msgstr ""
  1862. #: ../../../CHANGELOG.md:684
  1863. msgid ""
  1864. "We don't recommend changing these variables and suppressing warnings, "
  1865. "unless you know what you're doing."
  1866. msgstr ""
  1867. #: ../../../CHANGELOG.md:686
  1868. msgid ""
  1869. "**Most people should just upgrade as per-normal**, bearing in mind that a"
  1870. " lot has changed and some issues may arise. The playbook would guide you "
  1871. "through renamed variables automatically."
  1872. msgstr ""
  1873. #: ../../../CHANGELOG.md:688
  1874. msgid "Conclusion"
  1875. msgstr ""
  1876. #: ../../../CHANGELOG.md:690
  1877. msgid ""
  1878. "Thousands of lines of code were changed across hundreds of files. All "
  1879. "addons (bridges, bots) were rewired in terms of container networking and "
  1880. "in terms of how they reach the homeserver."
  1881. msgstr ""
  1882. #: ../../../CHANGELOG.md:692
  1883. msgid ""
  1884. "I don't actively use all the ~100 components offered by the playbook (no "
  1885. "one does), nor do I operate servers exercising all edge-cases. As such, "
  1886. "issues may arise. Please have patience and report (or try to fix) these "
  1887. "issues!"
  1888. msgstr ""
  1889. #: ../../../CHANGELOG.md:695
  1890. msgid "2024-01-14"
  1891. msgstr ""
  1892. #: ../../../CHANGELOG.md:697
  1893. msgid ""
  1894. "(Backward Compatibility) Configuration changes required for people "
  1895. "fronting the integrated reverse-proxy webserver with another reverse-"
  1896. "proxy"
  1897. msgstr ""
  1898. #: ../../../CHANGELOG.md:699
  1899. msgid ""
  1900. "If you're on the default setup (using the Traefik reverse-proxy as "
  1901. "installed by the playbook), you don't need to do anything."
  1902. msgstr ""
  1903. #: ../../../CHANGELOG.md:701
  1904. msgid ""
  1905. "People who are [Fronting the integrated Traefik reverse-proxy webserver "
  1906. "with another reverse-proxy](./docs/configuring-playbook-own-webserver.md"
  1907. "#fronting-the-integrated-reverse-proxy-webserver-with-another-reverse-"
  1908. "proxy), as per our previous instructions are redefining "
  1909. "`traefik_additional_entrypoints_auto` in their `vars.yml` configuration."
  1910. msgstr ""
  1911. #: ../../../CHANGELOG.md:703
  1912. msgid ""
  1913. "Such a full variable redefinion is intrustive, because it prevents the "
  1914. "playbook from injecting additional entrypoints into the Traefik "
  1915. "webserver. In the future, the playbook may have a need to do so."
  1916. msgstr ""
  1917. #: ../../../CHANGELOG.md:705
  1918. msgid ""
  1919. "For this reason, we no longer recommend completely redefining "
  1920. "`traefik_additional_entrypoints_auto`. The playbook now defines [various "
  1921. "`matrix_playbook_public_matrix_federation_api_traefik_entrypoint_*` "
  1922. "variables in the `defaults/main.yml` file](https://github.com/spantaleev"
  1923. "/matrix-docker-ansible-deploy/blob/master/roles/custom/matrix-"
  1924. "base/defaults/main.yml) of the `matrix-base` role which can be used as a "
  1925. "safer alternative to `traefik_additional_entrypoints_auto`."
  1926. msgstr ""
  1927. #: ../../../CHANGELOG.md:707
  1928. msgid "Adapt your configuration as seen below:"
  1929. msgstr ""
  1930. #: ../../../CHANGELOG.md:740
  1931. msgid ""
  1932. "Also, feel free to read the [Fronting the integrated Traefik reverse-"
  1933. "proxy webserver with another reverse-proxy](./docs/configuring-playbook-"
  1934. "own-webserver.md#fronting-the-integrated-reverse-proxy-webserver-with-"
  1935. "another-reverse-proxy) documentation section again for additional "
  1936. "details."
  1937. msgstr ""
  1938. #: ../../../CHANGELOG.md:743
  1939. msgid "2024-01-13"
  1940. msgstr ""
  1941. #: ../../../CHANGELOG.md:745
  1942. msgid ""
  1943. "matrix-reminder-bot update with more secure (backward-incompatible) "
  1944. "default settings"
  1945. msgstr ""
  1946. #: ../../../CHANGELOG.md:747
  1947. msgid ""
  1948. "**TLDR**: your updated (to [v0.3.0](https://github.com/anoadragon453"
  1949. "/matrix-reminder-bot/releases/tag/v0.3.0)) [matrix-reminder-bot](./docs"
  1950. "/configuring-playbook-bot-matrix-reminder-bot.md) is now more secure. By "
  1951. "default, like other bridges/bots managed by the playbook, it will only "
  1952. "provide its services to users of your own server (not to anyone, even "
  1953. "across the Matrix Federation). If that's fine, there's nothing you need "
  1954. "to do."
  1955. msgstr ""
  1956. #: ../../../CHANGELOG.md:749
  1957. msgid ""
  1958. "Maintenance of [matrix-reminder-bot](./docs/configuring-playbook-bot-"
  1959. "matrix-reminder-bot.md) has been picked up by [Kim "
  1960. "Brose](https://github.com/HarHarLinks) and "
  1961. "[@svierne](https://github.com/svierne)."
  1962. msgstr ""
  1963. #: ../../../CHANGELOG.md:751
  1964. msgid ""
  1965. "Thanks to them, a new [v0.3.0](https://github.com/anoadragon453/matrix-"
  1966. "reminder-bot/releases/tag/v0.3.0) release is out. The new version is now "
  1967. "available for the ARM64 architecture, so playbook users on this "
  1968. "architecture will no longer need to wait for [self-building](./docs/self-"
  1969. "building.md) to happen."
  1970. msgstr ""
  1971. #: ../../../CHANGELOG.md:753
  1972. msgid ""
  1973. "The new version also comes with new `allowlist` and `blocklist` settings,"
  1974. " which make it possible to restrict who can use the bot. Previously "
  1975. "anyone, even across the Matrix Federation could talk to it and schedule "
  1976. "reminders."
  1977. msgstr ""
  1978. #: ../../../CHANGELOG.md:755
  1979. msgid ""
  1980. "The playbook defaults all bridges and bots (where possible) to only be "
  1981. "exposed to users of the current homeserver, not users across federation. "
  1982. "Thanks to the new version of this bot making such a restriction possible,"
  1983. " we're now making use of it. The playbook (via its "
  1984. "`group_vars/matrix_servers` file) automatically enables the `allowlist` "
  1985. "(`matrix_bot_matrix_reminder_bot_allowlist_enabled: true`) and configures"
  1986. " it in such a way "
  1987. "(`matrix_bot_matrix_reminder_bot_allowlist_regexes_auto`) so as to "
  1988. "restrict the bot to your homeserver's users."
  1989. msgstr ""
  1990. #: ../../../CHANGELOG.md:757
  1991. msgid ""
  1992. "If you need **to undo or tweak these security improvements**, you can "
  1993. "change your `vars.yml` file to:"
  1994. msgstr ""
  1995. #: ../../../CHANGELOG.md:759
  1996. msgid ""
  1997. "disable the allowlist (`matrix_bot_matrix_reminder_bot_allowlist_enabled:"
  1998. " false`), making the bot allow usage by anyone, anywhere"
  1999. msgstr ""
  2000. #: ../../../CHANGELOG.md:761
  2001. msgid ""
  2002. "inject additional allowed servers or users by adding **additional** (on "
  2003. "top of the default allowlist in "
  2004. "`matrix_bot_matrix_reminder_bot_allowlist_regexes_auto`) custom regexes "
  2005. "in the `matrix_bot_matrix_reminder_bot_allowlist_regexes_custom` list "
  2006. "variable (see the [syntax reference](https://github.com/anoadragon453"
  2007. "/matrix-reminder-"
  2008. "bot/blob/1e910c0aa3469d280d93ee7e6c6d577227a3460c/sample.config.yaml#L43-L49))"
  2009. msgstr ""
  2010. #: ../../../CHANGELOG.md:763
  2011. msgid ""
  2012. "override the default allowlist (in the `group_vars/matrix_servers` file) "
  2013. "by redefining `matrix_bot_matrix_reminder_bot_allowlist_regexes_auto`"
  2014. msgstr ""
  2015. #: ../../../CHANGELOG.md:766
  2016. msgid "2024-01-05"
  2017. msgstr ""
  2018. #: ../../../CHANGELOG.md:768
  2019. msgid "matrix-mailer has been replaced by the exim-relay external role"
  2020. msgstr ""
  2021. #: ../../../CHANGELOG.md:770 ../../../CHANGELOG.md:1410
  2022. msgid ""
  2023. "We're continuing our effort to make [the playbook use external roles for "
  2024. "some things](#the-playbook-now-uses-external-roles-for-some-things), so "
  2025. "as to avoid doing everything ourselves and to facilitate code re-use."
  2026. msgstr ""
  2027. #: ../../../CHANGELOG.md:772
  2028. msgid ""
  2029. "The `matrix-mailer` role has been moved to its own repository ([ansible-"
  2030. "role-exim-relay](https://github.com/mother-of-all-self-hosting/ansible-"
  2031. "role-exim-relay)) that this playbook now includes."
  2032. msgstr ""
  2033. #: ../../../CHANGELOG.md:774
  2034. msgid "To migrate:"
  2035. msgstr ""
  2036. #: ../../../CHANGELOG.md:776
  2037. msgid "pull the playbook changes, as usual"
  2038. msgstr ""
  2039. #: ../../../CHANGELOG.md:777
  2040. msgid "update your roles (run `just roles` or `make roles`)"
  2041. msgstr ""
  2042. #: ../../../CHANGELOG.md:778
  2043. msgid ""
  2044. "update your `vars.yml`, renaming `matrix_mailer`-prefixed variables to "
  2045. "`exim_relay`-prefixed ones (e.g. `matrix_mailer_sender_address` -> "
  2046. "`exim_relay_sender_address`). If you find none, it means you're using the"
  2047. " default configuration and your migraiton job is even simpler."
  2048. msgstr ""
  2049. #: ../../../CHANGELOG.md:779
  2050. msgid "re-run the playbook (`install-all` or `setup-all`)"
  2051. msgstr ""
  2052. #: ../../../CHANGELOG.md:781
  2053. msgid ""
  2054. "The playbook will take care of stopping the old `matrix-mailer` systemd "
  2055. "service, relocating its directory and restarting it under the new name "
  2056. "(`matrix-exim-relay.service`)."
  2057. msgstr ""
  2058. #: ../../../CHANGELOG.md:784
  2059. msgid "2024-01-02"
  2060. msgstr ""
  2061. #: ../../../CHANGELOG.md:786
  2062. msgid "mautrix-signal now powered by the new Go-based bridge"
  2063. msgstr ""
  2064. #: ../../../CHANGELOG.md:788
  2065. msgid ""
  2066. "The old Python-based [mautrix-signal](https://github.com/mautrix/signal) "
  2067. "bridge is no longer maintained upstream. It's also known to have issues "
  2068. "linking new devices."
  2069. msgstr ""
  2070. #: ../../../CHANGELOG.md:790
  2071. msgid ""
  2072. "It seems like the path forward is to switch to the new mautrix-signal "
  2073. "bridge written in Golang, which we did thanks to [PR "
  2074. "#3031](https://github.com/spantaleev/matrix-docker-ansible-"
  2075. "deploy/pull/3041) by [Pierre 'McFly' Marty](https://github.com/pm-McFly)."
  2076. msgstr ""
  2077. #: ../../../CHANGELOG.md:792
  2078. msgid ""
  2079. "The playbook should **automatically migrate your mautrix-signal "
  2080. "installation to the new bridge code**. You will **need to relink all your"
  2081. " devices** to continue your bridged conversations."
  2082. msgstr ""
  2083. #: ../../../CHANGELOG.md:795
  2084. msgid "2023-10-23"
  2085. msgstr ""
  2086. #: ../../../CHANGELOG.md:797
  2087. msgid "Enabling `allow_public_rooms_over_federation` by default for Synapse"
  2088. msgstr ""
  2089. #: ../../../CHANGELOG.md:799
  2090. msgid ""
  2091. "**TDLR**: if your Matrix server is federating (which it mostly likely is,"
  2092. " unless you've [disabled federation](docs/configuring-playbook-"
  2093. "federation.md#disabling-federation)), your public rooms will not only be "
  2094. "joinable across federation (as they've always been), but from now on will"
  2095. " be discoverable (made available as a list across federation). We're "
  2096. "changing this by flipping the value for Synapse's "
  2097. "`allow_public_rooms_over_federation` setting to `true`, going against the"
  2098. " upstream default. Servers that disable federation are not affected. "
  2099. "Servers that have public rooms which are not published to the room "
  2100. "directory are also not affected."
  2101. msgstr ""
  2102. #: ../../../CHANGELOG.md:801
  2103. msgid ""
  2104. "We generally try to stick to the default configuration for Synapse (and "
  2105. "all other components), unless these defaults seem wrong or harmful. One "
  2106. "such previous case from a few months ago was us [Enabling "
  2107. "`forget_rooms_on_leave` by default for Synapse](#enabling-"
  2108. "forget_rooms_on_leave-by-default-for-synapse) - the default value was "
  2109. "making Synapse more wasteful of resources by default."
  2110. msgstr ""
  2111. #: ../../../CHANGELOG.md:803
  2112. msgid ""
  2113. "Today, we're going against upstream defaults again and flipping the "
  2114. "`allow_public_rooms_over_federation` configuration option to `true`. This"
  2115. " way, public rooms on your server will be made discoverable by others via"
  2116. " federation, using the [`GET /_matrix/federation/v1/publicRooms` of the "
  2117. "Server-Server API](https://spec.matrix.org/v1.8/server-server-"
  2118. "api/#get_matrixfederationv1publicrooms)."
  2119. msgstr ""
  2120. #: ../../../CHANGELOG.md:805
  2121. msgid ""
  2122. "The upstream Synapse default is `false` (disabled), so that public rooms "
  2123. "are not exposed for other servers to discover (learn about their "
  2124. "existence). Nevertheless, even if these rooms are not exposed (listed) "
  2125. "for discovery, they are **still joinable** by anyone who knows their "
  2126. "address or is invited to the room by an existing member."
  2127. msgstr ""
  2128. #: ../../../CHANGELOG.md:807
  2129. msgid ""
  2130. "**We go against the upstream default** in an effort to make Matrix "
  2131. "federation more useful - a public room should be globally public - not "
  2132. "only joinable, but also discoverable across federation."
  2133. msgstr ""
  2134. #: ../../../CHANGELOG.md:809
  2135. msgid "The **historical reasoning** behind this change is as follows:"
  2136. msgstr ""
  2137. #: ../../../CHANGELOG.md:811
  2138. msgid ""
  2139. "`allow_public_rooms_over_federation` seems to have been enabled by "
  2140. "default for Synapse until v1.7.0 (~2019), just like we believe it should "
  2141. "be for a globally-federating network - rooms should be joinable and "
  2142. "discoverable across federation."
  2143. msgstr ""
  2144. #: ../../../CHANGELOG.md:813
  2145. msgid ""
  2146. "In Synapse v1.7.0 (~2019), `allow_public_rooms_over_federation` [got "
  2147. "disabled](https://github.com/element-"
  2148. "hq/synapse/blob/e9069c9f919685606506f04527332e83fbfa44d9/docs/upgrade.md?plain=1#L1877-L1891)"
  2149. " by default in a [security-by-"
  2150. "obscurity](https://en.wikipedia.org/wiki/Security_through_obscurity) "
  2151. "workaround for misconfigured servers. See the [Avoiding unwelcome "
  2152. "visitors on private Matrix servers](https://matrix.org/blog/2019/11/09"
  2153. "/avoiding-unwelcome-visitors-on-private-matrix-servers/) `matrix.org` "
  2154. "blog article. We believe that people wishing for a truly private server, "
  2155. "should [disable federation](docs/configuring-playbook-federation.md"
  2156. "#disabling-federation), instead of having a fully-federating server and "
  2157. "trying to hide its public rooms. We also provide other workarounds below."
  2158. " We (and the Synapse team, obviously) believe that Matrix should federate"
  2159. " by default, so federating the public room list seems to make sense."
  2160. msgstr ""
  2161. #: ../../../CHANGELOG.md:815
  2162. #, python-format
  2163. msgid ""
  2164. "[etke.cc](https://etke.cc/) has been developing the free-software [Matrix"
  2165. " Rooms Search](https://github.com/etkecc/mrs) project for a while now. "
  2166. "One public (demo) instance of it is hosted at "
  2167. "[matrixrooms.info](https://matrixrooms.info/). This search engine tries "
  2168. "to go through the Matrix federation and discover & index public rooms to "
  2169. "allow people to find them. We believe it's vital for Matrix (and any chat"
  2170. " or social network for that matter) to be more discoverable, so that "
  2171. "people can find communities and others to talk to. Today (on 23rd of "
  2172. "October 2023), `matrixrooms.info` is indexing `23066` Matrix servers. Of "
  2173. "these, only `1567` servers (7%) are making their public rooms "
  2174. "discoverable. Who knows what wonderful communities and rooms are "
  2175. "available on these 93% other Matrix servers that are supposedly "
  2176. "federating, but are still gate-keeping their public room list. "
  2177. "Indubitably, many of these servers are hosted via matrix-docker-ansible-"
  2178. "deploy, so we feel partially responsible for making Matrix federation "
  2179. "less useful."
  2180. msgstr ""
  2181. #: ../../../CHANGELOG.md:817
  2182. msgid "Here are **actions you may wish to take** as a result of this change:"
  2183. msgstr ""
  2184. #: ../../../CHANGELOG.md:819
  2185. msgid ""
  2186. "(recommended) embrace the new default. If your Matrix server is "
  2187. "federating, your public rooms have always been joinable across federation"
  2188. " anyway. Exposing the list of public rooms does no harm and more-so does "
  2189. "good by contributing to the usefulness of the Matrix network by "
  2190. "facilitating room discovery."
  2191. msgstr ""
  2192. #: ../../../CHANGELOG.md:821
  2193. msgid ""
  2194. "(switch to a better way of doings things on your semi-private server) The"
  2195. " problem that the Synapse team appears to have solved by flipping the "
  2196. "`allow_public_rooms_over_federation` default in Synapse v1.7.0 seems to "
  2197. "for \"mostly private\" servers, which federate and have a bunch of rooms "
  2198. "made public (and published in their room directory) in an effort to allow"
  2199. " people on the same homeserver to easily find and join them (self-"
  2200. "onboarding). With the introduction of Matrix Spaces, you can reorganize "
  2201. "your flow around spaces - you can auto-join your users to a Matrix Space "
  2202. "(via Synapse's `auto_join_rooms` setting - controlled by our "
  2203. "`matrix_synapse_auto_join_rooms` variable), then add a bunch of rooms to "
  2204. "the space and make them joinable by people belonging to the space. That "
  2205. "is to say, do not make rooms public and do not publish them to the room "
  2206. "directory unless they are really public. Instead, use other mechanisms "
  2207. "for semi-public rooms or private rooms. One alternative is to stick to "
  2208. "what you're doing (public rooms published to your rooms directory) but "
  2209. "having a `m.federate: true` flag set during creation (clients like "
  2210. "Element Web have a nice UI checkbox for this) to explicitly disable "
  2211. "federation for them."
  2212. msgstr ""
  2213. #: ../../../CHANGELOG.md:823
  2214. msgid ""
  2215. "(keeping the old behavior) if you wish to keep doing what you're doing "
  2216. "(keeping your Matrix server federating, but hiding its public rooms "
  2217. "list), add `matrix_synapse_allow_public_rooms_over_federation: false` to "
  2218. "your `vars.yml` configuration. This restores the old behavior. You may "
  2219. "also consider [disabling federation](docs/configuring-playbook-"
  2220. "federation.md#disabling-federation) completely instead of relying on "
  2221. "security-by-obscurity measures."
  2222. msgstr ""
  2223. #: ../../../CHANGELOG.md:826
  2224. msgid "2023-10-18"
  2225. msgstr ""
  2226. #: ../../../CHANGELOG.md:828
  2227. msgid "Postgres parameters are automatically tuned now"
  2228. msgstr ""
  2229. #: ../../../CHANGELOG.md:830
  2230. msgid ""
  2231. "The playbook has provided some hints about [Tuning PostgreSQL](docs"
  2232. "/maintenance-postgres.md#tuning-postgresql) for quite a while now."
  2233. msgstr ""
  2234. #: ../../../CHANGELOG.md:832
  2235. msgid ""
  2236. "From now on, the [Postgres Ansible role](https://github.com/mother-of-"
  2237. "all-self-hosting/ansible-role-postgres) automatically tunes your Postgres"
  2238. " configuration with the same [calculation "
  2239. "logic](https://github.com/le0pard/pgtune/blob/master/src/features/configuration/configurationSlice.js)"
  2240. " that powers https://pgtune.leopard.in.ua/."
  2241. msgstr ""
  2242. #: ../../../CHANGELOG.md:834
  2243. msgid ""
  2244. "Our [Tuning PostgreSQL](docs/maintenance-postgres.md#tuning-postgresql) "
  2245. "documentation page has details about how you can turn auto-tuning off or "
  2246. "adjust the automatically-determined Postgres configuration parameters "
  2247. "manually."
  2248. msgstr ""
  2249. #: ../../../CHANGELOG.md:836
  2250. msgid ""
  2251. "People who [enable load-balancing with Synapse workers](docs/configuring-"
  2252. "playbook-synapse.md#load-balancing-with-workers) no longer need to "
  2253. "increase the maximum number of Postgres connections manually (previously "
  2254. "done via `postgres_process_extra_arguments`). There's a new variable "
  2255. "(`postgres_max_connections`) for controlling this number and the playbook"
  2256. " automatically raises its value from `200` to `500` for setups which "
  2257. "enable workers."
  2258. msgstr ""
  2259. #: ../../../CHANGELOG.md:839
  2260. msgid "2023-08-31"
  2261. msgstr ""
  2262. #: ../../../CHANGELOG.md:841
  2263. msgid "SchildiChat Web support"
  2264. msgstr ""
  2265. #: ../../../CHANGELOG.md:843
  2266. msgid ""
  2267. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  2268. "[etke.cc](https://etke.cc/), the playbook can now set up the [SchildiChat"
  2269. " Web](https://github.com/SchildiChat/schildichat-desktop) client."
  2270. msgstr ""
  2271. #: ../../../CHANGELOG.md:845
  2272. msgid ""
  2273. "See our [Configuring SchildiChat Web](docs/configuring-playbook-client-"
  2274. "schildichat-web.md) documentation to get started."
  2275. msgstr ""
  2276. #: ../../../CHANGELOG.md:848
  2277. msgid "2023-08-23"
  2278. msgstr ""
  2279. #: ../../../CHANGELOG.md:850
  2280. msgid "mautrix-wsproxy support"
  2281. msgstr ""
  2282. #: ../../../CHANGELOG.md:852
  2283. msgid ""
  2284. "Thanks to [Johan Swetzén](https://github.com/jswetzen)'s efforts (who "
  2285. "finished what was started by [James Reilly](https://github.com/hanthor) "
  2286. "and [Shreyas Ajjarapu](https://github.com/shreyasajj)), the playbook now "
  2287. "supports bridging to Android SMS and Apple iMessage via the [mautrix-"
  2288. "wsproxy](https://github.com/mautrix/wsproxy) service (in combination with"
  2289. " a [mautrix-imessage](https://github.com/mautrix/imessage) bridge running"
  2290. " on your Mac or Android phone)."
  2291. msgstr ""
  2292. #: ../../../CHANGELOG.md:854
  2293. msgid ""
  2294. "See our [Setting up Mautrix wsproxy for bridging Android SMS or Apple "
  2295. "iMessage](docs/configuring-playbook-bridge-mautrix-wsproxy.md) "
  2296. "documentation page for getting started."
  2297. msgstr ""
  2298. #: ../../../CHANGELOG.md:857
  2299. msgid "2023-07-24"
  2300. msgstr ""
  2301. #: ../../../CHANGELOG.md:859
  2302. msgid "matrix-registration-bot usage changed"
  2303. msgstr ""
  2304. #: ../../../CHANGELOG.md:861
  2305. msgid ""
  2306. "[matrix-registration-bot](docs/configuring-playbook-bot-matrix-"
  2307. "registration-bot.md) got some updates and now supports password-only-"
  2308. "based login. Therefore the bot now doesn't need any manual configuration "
  2309. "except setting a password in your `vars.yml`. The bot will be registered "
  2310. "as admin and access tokens will be obtained automatically by the bot."
  2311. msgstr ""
  2312. #: ../../../CHANGELOG.md:863
  2313. msgid ""
  2314. "**For existing users** You need to set "
  2315. "`matrix_bot_matrix_registration_bot_bot_password` if you previously only "
  2316. "used `matrix_bot_matrix_registration_bot_bot_access_token`. Please also "
  2317. "remove the following deprecated settings"
  2318. msgstr ""
  2319. #: ../../../CHANGELOG.md:865
  2320. msgid "`matrix_bot_matrix_registration_bot_bot_access_token`"
  2321. msgstr ""
  2322. #: ../../../CHANGELOG.md:866
  2323. msgid "`matrix_bot_matrix_registration_bot_api_token`"
  2324. msgstr ""
  2325. #: ../../../CHANGELOG.md:869
  2326. msgid "2023-07-21"
  2327. msgstr ""
  2328. #: ../../../CHANGELOG.md:871
  2329. msgid "mautrix-gmessages support"
  2330. msgstr ""
  2331. #: ../../../CHANGELOG.md:873
  2332. msgid ""
  2333. "Thanks to [Shreyas Ajjarapu](https://github.com/shreyasajj)'s efforts, "
  2334. "the playbook now supports bridging to [Google "
  2335. "Messages](https://messages.google.com/) via the [mautrix-"
  2336. "gmessages](https://github.com/mautrix/gmessages) bridge. See our [Setting"
  2337. " up Mautrix Google Messages bridging](docs/configuring-playbook-bridge-"
  2338. "mautrix-gmessages.md) documentation page for getting started."
  2339. msgstr ""
  2340. #: ../../../CHANGELOG.md:876
  2341. msgid "2023-07-17"
  2342. msgstr ""
  2343. #: ../../../CHANGELOG.md:878
  2344. msgid "matrix-media-repo support"
  2345. msgstr ""
  2346. #: ../../../CHANGELOG.md:880
  2347. msgid ""
  2348. "Thanks to [Michael Hollister](https://github.com/Michael-Hollister) from "
  2349. "[FUTO](https://www.futo.org/), the creators of the [Circles "
  2350. "app](https://circu.li/), the playbook can now set up [matrix-media-"
  2351. "repo](https://github.com/turt2live/matrix-media-repo) - an alternative "
  2352. "way to store homeserver media files, powered by a homeserver-independent "
  2353. "implementation which supports S3 storage, IPFS, deduplication and other "
  2354. "advanced features."
  2355. msgstr ""
  2356. #: ../../../CHANGELOG.md:882
  2357. msgid ""
  2358. "To learn more see our [Storing Matrix media files using matrix-media-"
  2359. "repo](docs/configuring-playbook-matrix-media-repo.md) documentation page."
  2360. msgstr ""
  2361. #: ../../../CHANGELOG.md:885
  2362. msgid "2023-05-25"
  2363. msgstr ""
  2364. #: ../../../CHANGELOG.md:887
  2365. msgid "Enabling `forget_rooms_on_leave` by default for Synapse"
  2366. msgstr ""
  2367. #: ../../../CHANGELOG.md:889
  2368. msgid ""
  2369. "With the [Synapse v1.84.0 update](https://github.com/spantaleev/matrix-"
  2370. "docker-ansible-deploy/pull/2698), we've also **changed the default "
  2371. "value** of the `forget_rooms_on_leave` setting of Synapse to a value of "
  2372. "`true`. This way, **when you leave a room, Synapse will now forget it "
  2373. "automatically**."
  2374. msgstr ""
  2375. #: ../../../CHANGELOG.md:891
  2376. msgid ""
  2377. "The upstream Synapse default is `false` (disabled), so that you must "
  2378. "forget rooms manually after leaving."
  2379. msgstr ""
  2380. #: ../../../CHANGELOG.md:893
  2381. msgid ""
  2382. "**We go against the upstream default** ([somewhat "
  2383. "controversially](https://github.com/spantaleev/matrix-docker-ansible-"
  2384. "deploy/pull/2700)) in an effort to make Synapse leaner and potentially do"
  2385. " what we believe most users would expect their homeserver to be doing."
  2386. msgstr ""
  2387. #: ../../../CHANGELOG.md:895
  2388. msgid ""
  2389. "If you'd like to go back to the old behavior, add the following to your "
  2390. "configuration: `matrix_synapse_forget_rooms_on_leave: false`"
  2391. msgstr ""
  2392. #: ../../../CHANGELOG.md:898
  2393. msgid "2023-04-03"
  2394. msgstr ""
  2395. #: ../../../CHANGELOG.md:900
  2396. msgid "The matrix-jitsi role lives independently now"
  2397. msgstr ""
  2398. #: ../../../CHANGELOG.md:902
  2399. msgid ""
  2400. "**TLDR**: the `matrix-jitsi` role is now included from the [ansible-role-"
  2401. "jitsi](https://github.com/mother-of-all-self-hosting/ansible-role-jitsi) "
  2402. "repository, part of the [MASH playbook](https://github.com/mother-of-all-"
  2403. "self-hosting/mash-playbook). Some variables have been renamed. All "
  2404. "functionality remains intact."
  2405. msgstr ""
  2406. #: ../../../CHANGELOG.md:904
  2407. msgid ""
  2408. "The `matrix-jitsi` role has been relocated in its own repository, part of"
  2409. " the [MASH playbook](https://github.com/mother-of-all-self-hosting/mash-"
  2410. "playbook) project - an Ansible playbook for self-hosting [a growing list "
  2411. "of FOSS software](https://github.com/mother-of-all-self-hosting/mash-"
  2412. "playbook/blob/main/docs/supported-services.md). If hosting a Jitsi stack "
  2413. "on the Matrix server itself did not stand right with you or you always "
  2414. "wanted to host most stuff, you can now use this new playbook to do so."
  2415. msgstr ""
  2416. #: ../../../CHANGELOG.md:906
  2417. msgid ""
  2418. "As part of the extraction process of this role out of the Matrix "
  2419. "playbook, a few other things improved:"
  2420. msgstr ""
  2421. #: ../../../CHANGELOG.md:908
  2422. msgid "**native Traefik support** has been added"
  2423. msgstr ""
  2424. #: ../../../CHANGELOG.md:909
  2425. msgid ""
  2426. "**support for hosting under a subpath** has been added, although it "
  2427. "suffers from a few minor issues listed [here](https://github.com/mother-"
  2428. "of-all-self-hosting/mash-playbook/blob/main/docs/services/jitsi.md#url)"
  2429. msgstr ""
  2430. #: ../../../CHANGELOG.md:911
  2431. msgid ""
  2432. "You need to **update your roles** (`just roles` or `make roles`) "
  2433. "regardless of whether you're using Jitsi or not."
  2434. msgstr ""
  2435. #: ../../../CHANGELOG.md:913
  2436. msgid ""
  2437. "If you're making use of Jitsi via this playbook, you will need to update "
  2438. "variable references in your `vars.yml` file:"
  2439. msgstr ""
  2440. #: ../../../CHANGELOG.md:915
  2441. msgid "`matrix_jitsi_*_docker_image_` -> `matrix_jitsi_*_container_image_`"
  2442. msgstr ""
  2443. #: ../../../CHANGELOG.md:916
  2444. msgid "`matrix_jitsi_` -> `jitsi_`"
  2445. msgstr ""
  2446. #: ../../../CHANGELOG.md:917 ../../../CHANGELOG.md:944
  2447. msgid ""
  2448. "some other internal variables have changed, but the playbook will tell "
  2449. "you about them"
  2450. msgstr ""
  2451. #: ../../../CHANGELOG.md:919
  2452. msgid "2023-03-22"
  2453. msgstr ""
  2454. #: ../../../CHANGELOG.md:921
  2455. msgid "ntfy Web App is disabled by default"
  2456. msgstr ""
  2457. #: ../../../CHANGELOG.md:923
  2458. msgid ""
  2459. "ntfy provides a web app, which is now disabled by default, because it may"
  2460. " be unknown to and unused by most users of this playbook. You can enable "
  2461. "it by setting `ntfy_web_root: \"app\"` (see [ntfy documentation](docs"
  2462. "/configuring-playbook-ntfy.md))."
  2463. msgstr ""
  2464. #: ../../../CHANGELOG.md:925
  2465. msgid ""
  2466. "This change was already applied a while before this entry, but as some "
  2467. "users were reporting the missing web app, this entry was added (see "
  2468. "[#2529](https://github.com/spantaleev/matrix-docker-ansible-"
  2469. "deploy/issues/2529))."
  2470. msgstr ""
  2471. #: ../../../CHANGELOG.md:928
  2472. msgid "2023-03-21"
  2473. msgstr ""
  2474. #: ../../../CHANGELOG.md:930
  2475. msgid "The matrix-prometheus role lives independently now"
  2476. msgstr ""
  2477. #: ../../../CHANGELOG.md:932
  2478. msgid ""
  2479. "**TLDR**: the `matrix-prometheus` role is now included from the [ansible-"
  2480. "role-prometheus](https://github.com/mother-of-all-self-hosting/ansible-"
  2481. "role-prometheus) repository, part of the [MASH "
  2482. "playbook](https://github.com/mother-of-all-self-hosting/mash-playbook). "
  2483. "Some variables have been renamed. All functionality remains intact."
  2484. msgstr ""
  2485. #: ../../../CHANGELOG.md:934
  2486. msgid ""
  2487. "The `matrix-prometheus` role has been relocated in its own repository, "
  2488. "part of the [MASH playbook](https://github.com/mother-of-all-self-hosting"
  2489. "/mash-playbook) project - an Ansible playbook for self-hosting [a growing"
  2490. " list of FOSS software](https://github.com/mother-of-all-self-hosting"
  2491. "/mash-playbook/blob/main/docs/supported-services.md). If hosting a "
  2492. "Prometheus stack on the Matrix server itself did not stand right with you"
  2493. " or you always wanted to host most stuff, you can now use this new "
  2494. "playbook to do so."
  2495. msgstr ""
  2496. #: ../../../CHANGELOG.md:936
  2497. msgid ""
  2498. "Extracting the Prometheus role out of this Matrix playbook required huge "
  2499. "internal refactoring to the way the Prometheus configuration (scraping "
  2500. "jobs) is generated. If you notice any breakage after upgrading, let us "
  2501. "know."
  2502. msgstr ""
  2503. #: ../../../CHANGELOG.md:938
  2504. msgid ""
  2505. "You need to **update your roles** (`just roles` or `make roles`) "
  2506. "regardless of whether you're using Prometheus or not."
  2507. msgstr ""
  2508. #: ../../../CHANGELOG.md:940
  2509. msgid ""
  2510. "If you're making use of Prometheus via this playbook, you will need to "
  2511. "update variable references in your `vars.yml` file:"
  2512. msgstr ""
  2513. #: ../../../CHANGELOG.md:942
  2514. msgid "`matrix_prometheus_docker_image_` -> `matrix_prometheus_container_image_`"
  2515. msgstr ""
  2516. #: ../../../CHANGELOG.md:943
  2517. msgid "`matrix_prometheus_` -> `prometheus_`"
  2518. msgstr ""
  2519. #: ../../../CHANGELOG.md:947
  2520. msgid "2023-03-12"
  2521. msgstr ""
  2522. #: ../../../CHANGELOG.md:949
  2523. msgid "synapse-auto-compressor support"
  2524. msgstr ""
  2525. #: ../../../CHANGELOG.md:951
  2526. msgid ""
  2527. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  2528. "[etke.cc](https://etke.cc/), the playbook can now set up [rust-synapse-"
  2529. "compress-state](https://github.com/matrix-org/rust-synapse-compress-"
  2530. "state)'s `synapse_auto_compressor` tool to run periodically."
  2531. msgstr ""
  2532. #: ../../../CHANGELOG.md:953
  2533. msgid ""
  2534. "If enabled, `synapse_auto_compressor` runs on a schedule and compresses "
  2535. "your Synapse database's `state_groups` table. It was possible to run "
  2536. "`rust-synapse-compress-state` manually via the playbook even before - see"
  2537. " [Compressing state with rust-synapse-compress-state](docs/maintenance-"
  2538. "synapse.md#compressing-state-with-rust-synapse-compress-state). However, "
  2539. "using `synapse_auto_compressor` is better, because:"
  2540. msgstr ""
  2541. #: ../../../CHANGELOG.md:955
  2542. msgid "it runs on a more up-to-date version of `rust-synapse-compress-state`"
  2543. msgstr ""
  2544. #: ../../../CHANGELOG.md:956
  2545. msgid ""
  2546. "it's a set-it-and-forget-it tool that you can enable and never have to "
  2547. "deal with manual compression anymore"
  2548. msgstr ""
  2549. #: ../../../CHANGELOG.md:958
  2550. msgid ""
  2551. "This tool needs to be enabled manually, for now. In the future, we're "
  2552. "considering enabling it by default for all Synapse installations."
  2553. msgstr ""
  2554. #: ../../../CHANGELOG.md:960
  2555. msgid ""
  2556. "See our [Setting up synapse-auto-compressor](docs/configuring-playbook-"
  2557. "synapse-auto-compressor.md) documentation to get started."
  2558. msgstr ""
  2559. #: ../../../CHANGELOG.md:963
  2560. msgid "2023-03-07"
  2561. msgstr ""
  2562. #: ../../../CHANGELOG.md:965
  2563. msgid "Sliding Sync proxy (Element X) support"
  2564. msgstr ""
  2565. #: ../../../CHANGELOG.md:967
  2566. msgid ""
  2567. "Thanks to [Benjamin Kampmann](https://github.com/gnunicorn) for [getting "
  2568. "it started](https://github.com/spantaleev/matrix-docker-ansible-"
  2569. "deploy/pull/2515), [FSG-Cat](https://github.com/FSG-Cat) for fixing it up"
  2570. " and me ([Slavi](https://github.com/spantaleev)) for polishing it up, the"
  2571. " playbook can now install and configure the [sliding-sync "
  2572. "proxy](https://github.com/matrix-org/sliding-sync)."
  2573. msgstr ""
  2574. #: ../../../CHANGELOG.md:969
  2575. msgid ""
  2576. "The upcoming Element X clients ([Element X iOS](https://github.com"
  2577. "/vector-im/element-x-ios) and [Element X Android](https://github.com"
  2578. "/vector-im/element-x-android)) require the `sliding-sync` proxy to do "
  2579. "their job. **These clients are still in beta** (especially Element X "
  2580. "Android, which requires manual compilation to get it working with a "
  2581. "non-`matrix.org` homeseserver). Playbook users can now easily give these "
  2582. "clients a try and help test them thanks to us having `sliding-sync` "
  2583. "support."
  2584. msgstr ""
  2585. #: ../../../CHANGELOG.md:971
  2586. msgid ""
  2587. "To get started, see our [Setting up the Sliding Sync proxy](docs"
  2588. "/configuring-playbook-sliding-sync-proxy.md) documentation page."
  2589. msgstr ""
  2590. #: ../../../CHANGELOG.md:974
  2591. msgid "2023-03-02"
  2592. msgstr ""
  2593. #: ../../../CHANGELOG.md:976
  2594. msgid "The matrix-etherpad role lives independently now"
  2595. msgstr ""
  2596. #: ../../../CHANGELOG.md:978
  2597. msgid ""
  2598. "**TLDR**: the `matrix-etherpad` role is now included from [another "
  2599. "repository](https://github.com/mother-of-all-self-hosting/ansible-role-"
  2600. "etherpad). Some variables have been renamed. All functionality remains "
  2601. "intact."
  2602. msgstr ""
  2603. #: ../../../CHANGELOG.md:980
  2604. msgid ""
  2605. "You need to **update your roles** (`just roles` or `make roles`) "
  2606. "regardless of whether you're using Etherpad or not."
  2607. msgstr ""
  2608. #: ../../../CHANGELOG.md:982
  2609. msgid ""
  2610. "If you're making use of Etherpad via this playbook, you will need to "
  2611. "update variable references in your `vars.yml` file:"
  2612. msgstr ""
  2613. #: ../../../CHANGELOG.md:984
  2614. msgid "Rename `matrix_etherpad_public_endpoint` to `etherpad_path_prefix`"
  2615. msgstr ""
  2616. #: ../../../CHANGELOG.md:986
  2617. msgid "Replace `matrix_etherpad_mode: dimension` with:"
  2618. msgstr ""
  2619. #: ../../../CHANGELOG.md:987
  2620. msgid "for `matrix-nginx-proxy` users:"
  2621. msgstr ""
  2622. #: ../../../CHANGELOG.md:988
  2623. msgid "`etherpad_nginx_proxy_dimension_integration_enabled: true`"
  2624. msgstr ""
  2625. #: ../../../CHANGELOG.md:989
  2626. msgid "`etherpad_hostname: \"{{ matrix_server_fqn_dimension }}\"`"
  2627. msgstr ""
  2628. #: ../../../CHANGELOG.md:990
  2629. msgid "for Traefik users:"
  2630. msgstr ""
  2631. #: ../../../CHANGELOG.md:991
  2632. msgid ""
  2633. "define your own `etherpad_hostname` and `etherpad_path_prefix` as you see"
  2634. " fit"
  2635. msgstr ""
  2636. #: ../../../CHANGELOG.md:993
  2637. msgid "Rename all other variables:"
  2638. msgstr ""
  2639. #: ../../../CHANGELOG.md:994
  2640. msgid "`matrix_etherpad_docker_image_` -> `matrix_etherpad_container_image_`"
  2641. msgstr ""
  2642. #: ../../../CHANGELOG.md:995
  2643. msgid "`matrix_etherpad_` -> `etherpad_`"
  2644. msgstr ""
  2645. #: ../../../CHANGELOG.md:997
  2646. msgid "Along with this relocation, the new role also:"
  2647. msgstr ""
  2648. #: ../../../CHANGELOG.md:999
  2649. msgid ""
  2650. "supports [self-building](docs/self-building.md), so it should work on "
  2651. "`arm32` and `arm64` architectures"
  2652. msgstr ""
  2653. #: ../../../CHANGELOG.md:1000
  2654. msgid ""
  2655. "has native Traefik reverse-proxy support (Etherpad requests no longer go "
  2656. "through `matrix-nginx-proxy` when using Traefik)"
  2657. msgstr ""
  2658. #: ../../../CHANGELOG.md:1003
  2659. msgid "2023-02-26"
  2660. msgstr ""
  2661. #: ../../../CHANGELOG.md:1005
  2662. msgid "Traefik is the default reverse-proxy now"
  2663. msgstr ""
  2664. #: ../../../CHANGELOG.md:1007
  2665. msgid ""
  2666. "**TLDR**: new installations will now default to Traefik as their reverse-"
  2667. "proxy. Existing users need to explicitly choose their reverse-proxy type."
  2668. " [Switching to Traefik](#how-do-i-switch-my-existing-setup-to-traefik) is"
  2669. " strongly encouraged. `matrix-nginx-proxy` may break over time and will "
  2670. "ultimately be removed."
  2671. msgstr ""
  2672. #: ../../../CHANGELOG.md:1009
  2673. msgid ""
  2674. "As mentioned 2 weeks ago in [(Backward Compatibility) Reverse-proxy "
  2675. "configuration changes and initial Traefik support](#backward-"
  2676. "compatibility-reverse-proxy-configuration-changes-and-initial-traefik-"
  2677. "support), the playbook is moving to Traefik as its default SSL-"
  2678. "terminating reverse-proxy."
  2679. msgstr ""
  2680. #: ../../../CHANGELOG.md:1011
  2681. msgid ""
  2682. "Until now, we've been doing the migration gradually and keeping full "
  2683. "backward compatibility. New installations were defaulting to `matrix-"
  2684. "nginx-proxy` (just like before), while existing installations were "
  2685. "allowed to remain on `matrix-nginx-proxy` as well. This makes things very"
  2686. " difficult for us, because we need to maintain and think about lots of "
  2687. "different setups:"
  2688. msgstr ""
  2689. #: ../../../CHANGELOG.md:1013
  2690. msgid "Traefik managed by the playbook"
  2691. msgstr ""
  2692. #: ../../../CHANGELOG.md:1014
  2693. msgid "Traefik managed by the user in another way"
  2694. msgstr ""
  2695. #: ../../../CHANGELOG.md:1015
  2696. msgid "another reverse-proxy on the same host (`127.0.0.1` port exposure)"
  2697. msgstr ""
  2698. #: ../../../CHANGELOG.md:1016
  2699. msgid "another reverse-proxy on another host (`0.0.0.0` port exposure)"
  2700. msgstr ""
  2701. #: ../../../CHANGELOG.md:1017
  2702. msgid "`matrix-nginx-proxy` - an `nginx` container managed by the playbook"
  2703. msgstr ""
  2704. #: ../../../CHANGELOG.md:1018
  2705. msgid ""
  2706. "`nginx` webserver operated by the user, running without a container on "
  2707. "the same server"
  2708. msgstr ""
  2709. #: ../../../CHANGELOG.md:1020
  2710. msgid ""
  2711. "Each change we do and each new feature that comes in needs to support all"
  2712. " these different ways of reverse-proxying. Because `matrix-nginx-proxy` "
  2713. "was the default and pretty much everyone was (and still is) using it, "
  2714. "means that new PRs also come with `matrix-nginx-proxy` as their main "
  2715. "focus and Traefik as an afterthought, which means we need to spend hours "
  2716. "fixing up Traefik support."
  2717. msgstr ""
  2718. #: ../../../CHANGELOG.md:1022
  2719. msgid ""
  2720. "We can't spend all this time maintaining so many different configurations"
  2721. " anymore. Traefik support has been an option for 2 weeks and lots of "
  2722. "people have already migrated their server and have tested things out. "
  2723. "Traefik is what we use and preferentially test for."
  2724. msgstr ""
  2725. #: ../../../CHANGELOG.md:1024
  2726. msgid ""
  2727. "It's time for the **next step in our migration process** to Traefik and "
  2728. "elimination of `matrix-nginx-proxy`:"
  2729. msgstr ""
  2730. #: ../../../CHANGELOG.md:1026
  2731. msgid "Traefik is now the default reverse-proxy for new installations"
  2732. msgstr ""
  2733. #: ../../../CHANGELOG.md:1027
  2734. msgid ""
  2735. "All existing users need to explicitly choose their reverse-proxy type by "
  2736. "defining the `matrix_playbook_reverse_proxy_type` variable in their "
  2737. "`vars.yml` configuration file. We strongly encourage existing users to "
  2738. "[switch the Traefik](#how-to-switch-an-existing-setup-to-traefik), as the"
  2739. " nginx setup is bound to become more and more broken over time until it's"
  2740. " ultimately removed"
  2741. msgstr ""
  2742. #: ../../../CHANGELOG.md:1029
  2743. msgid "How do I switch my existing setup to Traefik?"
  2744. msgstr ""
  2745. #: ../../../CHANGELOG.md:1031
  2746. msgid ""
  2747. "**For users who are on `matrix-nginx-proxy`** (the default reverse-proxy "
  2748. "provided by the playbook), switching to Traefik can happen with a simple "
  2749. "configuration change. Follow this section from 2 weeks ago: [How do I "
  2750. "explicitly switch to Traefik right now?](#how-do-i-explicitly-switch-to-"
  2751. "traefik-right-now)."
  2752. msgstr ""
  2753. #: ../../../CHANGELOG.md:1033
  2754. msgid "If you experience trouble:"
  2755. msgstr ""
  2756. #: ../../../CHANGELOG.md:1035
  2757. msgid ""
  2758. "Follow [How do I remain on matrix-nginx-proxy?](#how-do-i-remain-on-"
  2759. "matrix-nginx-proxy) to bring your server back online using the old "
  2760. "reverse-proxy"
  2761. msgstr ""
  2762. #: ../../../CHANGELOG.md:1036
  2763. msgid "Ask for help in our [support channels](README.md#support)"
  2764. msgstr ""
  2765. #: ../../../CHANGELOG.md:1037
  2766. msgid "Try switching to Traefik again later"
  2767. msgstr ""
  2768. #: ../../../CHANGELOG.md:1039
  2769. msgid ""
  2770. "**For users with a more special reverse-proxying setup** (another nginx "
  2771. "server, Apache, Caddy, etc.), the migration may not be so smooth. Follow "
  2772. "the [Using your own webserver](docs/configuring-playbook-own-"
  2773. "webserver.md) guide. Ideally, your custom reverse-proxy will be "
  2774. "configured in such a way that it **fronts the Traefik reverse-proxy** "
  2775. "provided by the playbook. Other means of reverse-proxying are more "
  2776. "fragile and may be deprecated in the future."
  2777. msgstr ""
  2778. #: ../../../CHANGELOG.md:1041
  2779. msgid "I already use my own Traefik server. How do I plug that in?"
  2780. msgstr ""
  2781. #: ../../../CHANGELOG.md:1043
  2782. msgid ""
  2783. "See the [Traefik managed by the playbook](docs/configuring-playbook-own-"
  2784. "webserver.md#traefik-managed-by-the-playbook) section."
  2785. msgstr ""
  2786. #: ../../../CHANGELOG.md:1045
  2787. msgid "Why is matrix-nginx-proxy used even after switching to Traefik?"
  2788. msgstr ""
  2789. #: ../../../CHANGELOG.md:1047
  2790. msgid ""
  2791. "This playbook manages many different services. All these services were "
  2792. "initially integrated with `matrix-nginx-proxy`."
  2793. msgstr ""
  2794. #: ../../../CHANGELOG.md:1049
  2795. msgid ""
  2796. "While we migrate all these components to have native Traefik support, "
  2797. "some still go through nginx internally (Traefik -> local `matrix-nginx-"
  2798. "proxy` -> component). As time goes on, internal reliance on `matrix-"
  2799. "nginx-proxy` will gradually decrease until it's completely removed."
  2800. msgstr ""
  2801. #: ../../../CHANGELOG.md:1051
  2802. msgid "How do I remain on matrix-nginx-proxy?"
  2803. msgstr ""
  2804. #: ../../../CHANGELOG.md:1053
  2805. msgid ""
  2806. "Most new work and testing targets Traefik, so remaining on nginx is "
  2807. "**not** \"the good old stable\" option, but rather the \"still available,"
  2808. " but largely untested and likely to be broken very soon\" option."
  2809. msgstr ""
  2810. #: ../../../CHANGELOG.md:1055
  2811. msgid ""
  2812. "To proceed regardless of this warning, add "
  2813. "`matrix_playbook_reverse_proxy_type: playbook-managed-nginx` to your "
  2814. "configuration."
  2815. msgstr ""
  2816. #: ../../../CHANGELOG.md:1057
  2817. msgid ""
  2818. "At some point in the **near** future (days, or even weeks at most), we "
  2819. "hope to completely get rid of `matrix-nginx-proxy` (or break it enough to"
  2820. " make it unusable), so you **will soon be forced to migrate** anyway. "
  2821. "Plan your migration accordingly."
  2822. msgstr ""
  2823. #: ../../../CHANGELOG.md:1059
  2824. msgid "How do I keep using my own other reverse-proxy?"
  2825. msgstr ""
  2826. #: ../../../CHANGELOG.md:1061
  2827. msgid ""
  2828. "We recommend that you follow the guide for [Fronting the integrated "
  2829. "reverse-proxy webserver with another reverse-proxy](docs/configuring-"
  2830. "playbook-own-webserver.md#fronting-the-integrated-reverse-proxy-"
  2831. "webserver-with-another-reverse-proxy)."
  2832. msgstr ""
  2833. #: ../../../CHANGELOG.md:1064
  2834. msgid "2023-02-25"
  2835. msgstr ""
  2836. #: ../../../CHANGELOG.md:1066
  2837. msgid "rageshake support"
  2838. msgstr ""
  2839. #: ../../../CHANGELOG.md:1068
  2840. msgid ""
  2841. "Thanks to [Benjamin Kampmann](https://github.com/gnunicorn), the playbook"
  2842. " can now install and configure the [rageshake](https://github.com/matrix-"
  2843. "org/rageshake) bug report server."
  2844. msgstr ""
  2845. #: ../../../CHANGELOG.md:1070
  2846. msgid ""
  2847. "Additional details are available in [Setting up rageshake](docs"
  2848. "/configuring-playbook-rageshake.md)."
  2849. msgstr ""
  2850. #: ../../../CHANGELOG.md:1073
  2851. msgid "2023-02-17"
  2852. msgstr ""
  2853. #: ../../../CHANGELOG.md:1075
  2854. msgid "Synapse templates customization support"
  2855. msgstr ""
  2856. #: ../../../CHANGELOG.md:1077
  2857. msgid "The playbook can now help you customize Synapse's templates."
  2858. msgstr ""
  2859. #: ../../../CHANGELOG.md:1079
  2860. msgid ""
  2861. "Additional details are available in the [Customizing templates](docs"
  2862. "/configuring-playbook-synapse.md#customizing-templates) section of our "
  2863. "Synapse documentation."
  2864. msgstr ""
  2865. #: ../../../CHANGELOG.md:1081
  2866. msgid "The matrix-redis role lives independently now"
  2867. msgstr ""
  2868. #: ../../../CHANGELOG.md:1083
  2869. msgid ""
  2870. "**TLDR**: the `matrix-redis` role is now included from another "
  2871. "repository. Some variables have been renamed. All functionality remains "
  2872. "intact."
  2873. msgstr ""
  2874. #: ../../../CHANGELOG.md:1085
  2875. msgid ""
  2876. "The `matrix-redis` role (which configures [Redis](https://redis.io/)) has"
  2877. " been extracted from the playbook and now lives in its [own "
  2878. "repository](https://github.com/mother-of-all-self-hosting/ansible-role-"
  2879. "redis). This makes it possible to easily use it in other Ansible "
  2880. "playbooks."
  2881. msgstr ""
  2882. #: ../../../CHANGELOG.md:1087
  2883. msgid ""
  2884. "You need to **update your roles** (`just roles` or `make roles`) "
  2885. "regardless of whether you're enabling Ntfy or not. If you're making use "
  2886. "of Ntfy via this playbook, you will need to update variable references in"
  2887. " your `vars.yml` file (`matrix_redis_` -> `redis_`)."
  2888. msgstr ""
  2889. #: ../../../CHANGELOG.md:1089
  2890. msgid "The matrix-ntfy role lives independently now"
  2891. msgstr ""
  2892. #: ../../../CHANGELOG.md:1091
  2893. msgid ""
  2894. "**TLDR**: the `matrix-ntfy` role is now included from another repository."
  2895. " Some variables have been renamed. All functionality remains intact."
  2896. msgstr ""
  2897. #: ../../../CHANGELOG.md:1093
  2898. msgid ""
  2899. "The `matrix-ntfy` role (which configures [Ntfy](https://ntfy.sh/)) has "
  2900. "been extracted from the playbook and now lives in its [own "
  2901. "repository](https://github.com/mother-of-all-self-hosting/ansible-role-"
  2902. "ntfy). This makes it possible to easily use it in other Ansible "
  2903. "playbooks."
  2904. msgstr ""
  2905. #: ../../../CHANGELOG.md:1095
  2906. msgid ""
  2907. "You need to **update your roles** (`just roles` or `make roles`) "
  2908. "regardless of whether you're enabling Ntfy or not. If you're making use "
  2909. "of Ntfy via this playbook, you will need to update variable references in"
  2910. " your `vars.yml` file (`matrix_ntfy_` -> `ntfy_`)."
  2911. msgstr ""
  2912. #: ../../../CHANGELOG.md:1098
  2913. msgid "2023-02-15"
  2914. msgstr ""
  2915. #: ../../../CHANGELOG.md:1100
  2916. msgid "The matrix-grafana role lives independently now"
  2917. msgstr ""
  2918. #: ../../../CHANGELOG.md:1102
  2919. msgid ""
  2920. "**TLDR**: the `matrix-grafana` role is now included from another "
  2921. "repository. Some variables have been renamed. All functionality remains "
  2922. "intact."
  2923. msgstr ""
  2924. #: ../../../CHANGELOG.md:1104
  2925. msgid ""
  2926. "The `matrix-grafana` role (which configures [Grafana](docs/configuring-"
  2927. "playbook-prometheus-grafana.md)) has been extracted from the playbook and"
  2928. " now lives in its [own repository](https://github.com/mother-of-all-self-"
  2929. "hosting/ansible-role-grafana). This makes it possible to easily use it in"
  2930. " other Ansible playbooks."
  2931. msgstr ""
  2932. #: ../../../CHANGELOG.md:1106
  2933. msgid ""
  2934. "You need to **update your roles** (`just roles` or `make roles`) "
  2935. "regardless of whether you're enabling Grafana or not. If you're making "
  2936. "use of Grafana via this playbook, you will need to update variable "
  2937. "references in your `vars.yml` file (`matrix_grafana_` -> `grafana_`)."
  2938. msgstr ""
  2939. #: ../../../CHANGELOG.md:1109
  2940. msgid "2023-02-13"
  2941. msgstr ""
  2942. #: ../../../CHANGELOG.md:1111
  2943. msgid "The matrix-backup-borg role lives independently now"
  2944. msgstr ""
  2945. #: ../../../CHANGELOG.md:1113
  2946. msgid ""
  2947. "**TLDR**: the `matrix-backup-borg` role is now included from another "
  2948. "repository. Some variables have been renamed. All functionality remains "
  2949. "intact."
  2950. msgstr ""
  2951. #: ../../../CHANGELOG.md:1115
  2952. msgid ""
  2953. "Thanks to [moan0s](https://github.com/moan0s), the `matrix-backup-borg` "
  2954. "role (which configures [BorgBackup](docs/configuring-playbook-backup-"
  2955. "borg.md)) has been extracted from the playbook and now lives in its [own "
  2956. "repository](https://github.com/mother-of-all-self-hosting/ansible-role-"
  2957. "backup_borg). This makes it possible to easily use it in other Ansible "
  2958. "playbooks and will become part of [nextcloud-docker-ansible-"
  2959. "deploy](https://github.com/spantaleev/nextcloud-docker-ansible-deploy) "
  2960. "soon."
  2961. msgstr ""
  2962. #: ../../../CHANGELOG.md:1117
  2963. msgid ""
  2964. "You need to **update your roles** (`just roles` or `make roles`) "
  2965. "regardless of whether you're enabling Borg's backup functionality or not."
  2966. " If you're making use of BorgBackup via this playbook, you will need to "
  2967. "update variable references in your `vars.yml` file (`matrix_backup_borg_`"
  2968. " -> `backup_borg_`)."
  2969. msgstr ""
  2970. #: ../../../CHANGELOG.md:1120
  2971. msgid "2023-02-12"
  2972. msgstr ""
  2973. #: ../../../CHANGELOG.md:1122
  2974. msgid ""
  2975. "(Backward Compatibility) Reverse-proxy configuration changes and initial "
  2976. "Traefik support"
  2977. msgstr ""
  2978. #: ../../../CHANGELOG.md:1124
  2979. msgid "**TLDR**:"
  2980. msgstr ""
  2981. #: ../../../CHANGELOG.md:1126
  2982. msgid ""
  2983. "there's a new `matrix_playbook_reverse_proxy_type` variable (see "
  2984. "[roles/custom/matrix-base/defaults/main.yml](roles/custom/matrix-"
  2985. "base/defaults/main.yml)), which lets you tell the playbook what reverse-"
  2986. "proxy setup you'd like to have. This makes it easier for people who want "
  2987. "to do reverse-proxying in other ways."
  2988. msgstr ""
  2989. #: ../../../CHANGELOG.md:1127
  2990. msgid ""
  2991. "the default reverse-proxy (`matrix_playbook_reverse_proxy_type`) is still"
  2992. " `playbook-managed-nginx` (via `matrix-nginx-proxy`), for now. **Existing"
  2993. " `matrix-nginx-proxy` users should not observe any changes** and can stay"
  2994. " on this for now."
  2995. msgstr ""
  2996. #: ../../../CHANGELOG.md:1128
  2997. msgid ""
  2998. "**Users who use their [own other webserver](docs/configuring-playbook-"
  2999. "own-webserver.md) (e.g. Apache, etc.) need to change** "
  3000. "`matrix_playbook_reverse_proxy_type` to something like `other-on-same-"
  3001. "host`, `other-on-another-host` or `other-nginx-non-container`"
  3002. msgstr ""
  3003. #: ../../../CHANGELOG.md:1129
  3004. msgid ""
  3005. "we now have **optional [Traefik](https://traefik.io/) support**, so you "
  3006. "could easily host Matrix and other Traefik-native services in containers "
  3007. "on the same server. Traefik support is still experimental (albeit, good "
  3008. "enough) and will improve over time. It does work, but certain esoteric "
  3009. "features may not be there yet."
  3010. msgstr ""
  3011. #: ../../../CHANGELOG.md:1130
  3012. msgid ""
  3013. "**Traefik will become the default reverse-proxy in the near future**. "
  3014. "`matrix-nginx-proxy` will either remain as an option, or be completely "
  3015. "removed to simplify the playbook"
  3016. msgstr ""
  3017. #: ../../../CHANGELOG.md:1132
  3018. msgid "Motivation for redoing our reverse-proxy setup"
  3019. msgstr ""
  3020. #: ../../../CHANGELOG.md:1134
  3021. msgid ""
  3022. "The playbook has supported various reverse-proxy setups for a long time. "
  3023. "We have various configuration variables (`matrix_nginx_proxy_enabled`, "
  3024. "various `_host_bind_port` variables, etc.) which allow the playbook to "
  3025. "adapt to these different setups. The whole situation was messy though - "
  3026. "hard to figure out and with lots of variables to toggle to make things "
  3027. "work as you'd expect - huge **operational complexity**."
  3028. msgstr ""
  3029. #: ../../../CHANGELOG.md:1136
  3030. msgid ""
  3031. "We love containers, proven by the fact that **everything** that this "
  3032. "playbook manages runs in a container. Yet, we weren't allowing people to "
  3033. "easily host other web-exposed containers alongside Matrix services on the"
  3034. " same server. We were using `matrix-nginx-proxy` (our integrated "
  3035. "[nginx](https://nginx.org/) server), which was handling web-exposure and "
  3036. "SSL termination for our own services, but we **weren't helping you with "
  3037. "all your other containers**."
  3038. msgstr ""
  3039. #: ../../../CHANGELOG.md:1138
  3040. msgid ""
  3041. "People who were **using `matrix-nginx-proxy`** were on the happy path on "
  3042. "which everything worked well by default (Matrix-wise), **but** could not "
  3043. "easily run other web-exposed services on their Matrix server because "
  3044. "`matrix-nginx-proxy` was occupying ports `80` and `443`. Other services "
  3045. "which wanted to get web exposure either had to be plugged into `matrix-"
  3046. "nginx-proxy` (somewhat difficult) or people had to forgo using `matrix-"
  3047. "nginx-proxy` in favor of something else."
  3048. msgstr ""
  3049. #: ../../../CHANGELOG.md:1140
  3050. msgid ""
  3051. "Of those that decided to forgo `matrix-nginx-proxy`, many were **using "
  3052. "nginx** on the same server without a container. This was likely some "
  3053. "ancient nginx version, depending on your choice of distro. The Matrix "
  3054. "playbook was trying to be helpful and even with "
  3055. "`matrix_nginx_proxy_enabled: false` was still generating nginx "
  3056. "configuration in `/matrix/nginx-proxy/conf.d`. Those configuration files "
  3057. "were adapted for inclusion into an nginx server running locally. "
  3058. "Disabling the `matrix-nginx-proxy` role like this, yet still having it "
  3059. "produce files is a bit disgusting, but it's what we've had since the "
  3060. "early beginnings of this playbook."
  3061. msgstr ""
  3062. #: ../../../CHANGELOG.md:1142
  3063. msgid ""
  3064. "Others still, wanted to run Matrix locally (no SSL certificates), "
  3065. "regardless of which web server technology this relied on, and then "
  3066. "**reverse-proxy from another machine on the network** which was doing SSL"
  3067. " termination. These people were:"
  3068. msgstr ""
  3069. #: ../../../CHANGELOG.md:1144
  3070. msgid ""
  3071. "*either* relying on `matrix_nginx_proxy_enabled: false` as well, combined"
  3072. " with exposing services manually (setting `_bind_port` variables)"
  3073. msgstr ""
  3074. #: ../../../CHANGELOG.md:1145
  3075. msgid ""
  3076. "*or* better yet, they were keeping `matrix-nginx-proxy` enabled, but in "
  3077. "`http`-only mode (no SSL certificate retrieval)."
  3078. msgstr ""
  3079. #: ../../../CHANGELOG.md:1147
  3080. msgid ""
  3081. "Despite this operational complexity, things worked and were reasonably "
  3082. "flexible to adapt to all these situations."
  3083. msgstr ""
  3084. #: ../../../CHANGELOG.md:1149
  3085. msgid ""
  3086. "When using `matrix-nginx-proxy` as is, we still had another problem - one"
  3087. " of **internal playbook complexity**. Too many services need to be web-"
  3088. "exposed (port 80/443, SSL certificates). Because of this, they all had to"
  3089. " integrate with the `matrix-nginx-proxy` role. Tens of different roles "
  3090. "explicitly integrating with `matrix-nginx-proxy` is not what we call "
  3091. "clean. The `matrix-nginx-proxy` role contains variables for many of these"
  3092. " roles (yikes). Other roles were more decoupled from it and were "
  3093. "injecting configuration into `matrix-nginx-proxy` at runtime - see all "
  3094. "the `inject_into_nginx_proxy.yml` task files in this playbook (more "
  3095. "decoupled, but still.. yikes)."
  3096. msgstr ""
  3097. #: ../../../CHANGELOG.md:1151
  3098. msgid ""
  3099. "The next problem is one of **efficiency, interoperability and cost-"
  3100. "saving**. We're working on other playbooks:"
  3101. msgstr ""
  3102. #: ../../../CHANGELOG.md:1153
  3103. msgid ""
  3104. "[vaultwarden-docker-ansible-deploy](https://github.com/spantaleev"
  3105. "/vaultwarden-docker-ansible-deploy) for hosting the "
  3106. "[Vaultwarden](https://github.com/dani-garcia/vaultwarden) server - an "
  3107. "alternative implementation of the [Bitwarden](https://bitwarden.com/) "
  3108. "password manager"
  3109. msgstr ""
  3110. #: ../../../CHANGELOG.md:1154
  3111. msgid ""
  3112. "[gitea-docker-ansible-deploy](https://github.com/spantaleev/gitea-docker-"
  3113. "ansible-deploy) - for hosting the [Gitea](https://gitea.io/) git source "
  3114. "code hosting service"
  3115. msgstr ""
  3116. #: ../../../CHANGELOG.md:1155
  3117. msgid ""
  3118. "[nextcloud-docker-ansible-deploy](https://github.com/spantaleev"
  3119. "/nextcloud-docker-ansible-deploy) - for hosting the "
  3120. "[Nextcloud](https://nextcloud.com/) groupware platform"
  3121. msgstr ""
  3122. #: ../../../CHANGELOG.md:1157
  3123. msgid ""
  3124. "We'd love for users to be able to **seamlessly use all these playbooks "
  3125. "(and others, even) against a single server**. We don't want `matrix-"
  3126. "nginx-proxy` to have a monopoly on port `80`/`443` and make it hard for "
  3127. "other services to join in on the party. Such a thing forces people into "
  3128. "running multiple servers (one for each service), which does provide nice "
  3129. "security benefits, but is costly and ineffiecient. We'd like to make "
  3130. "self-hosting these services cheap and easy."
  3131. msgstr ""
  3132. #: ../../../CHANGELOG.md:1159
  3133. msgid ""
  3134. "These other playbooks have been using [Traefik](https://traefik.io/) as "
  3135. "their default reverse-proxy for a long time. They can all coexist nicely "
  3136. "together (as an example, see the "
  3137. "[Interoperability](https://github.com/spantaleev/nextcloud-docker-"
  3138. "ansible-deploy/blob/master/docs/configuring-playbook-interoperability.md)"
  3139. " documentation for the [Nextcloud playbook](https://github.com/spantaleev"
  3140. "/nextcloud-docker-ansible-deploy)). Now that this playbook is gaining "
  3141. "Traefik support, it will be able to interoperate with them. If you're "
  3142. "going this way, make sure to have the Matrix playbook install Traefik and"
  3143. " have the others use `*_reverse_proxy_type: other-traefik-container`."
  3144. msgstr ""
  3145. #: ../../../CHANGELOG.md:1161
  3146. msgid ""
  3147. "Finally, at [etke.cc - a managed Matrix server hosting "
  3148. "service](https://etke.cc) (built on top of this playbook, and "
  3149. "coincidentally [turning 2 years old today](https://etke.cc/news"
  3150. "/upsyw4ykbtgmwhz8k7ukldx0zbbfq-fh0iqi3llixi0/) 🎉), we're allowing people "
  3151. "to host some additional services besides Matrix components. Exposing "
  3152. "these services to the web requires ugly hacks and configuration files "
  3153. "being dropped into `/matrix/nginx-proxy/conf.d`. We believe that "
  3154. "everything should run in independent containers and be exposed to the web"
  3155. " via a Traefik server, without a huge Ansible role like `matrix-nginx-"
  3156. "proxy` that everything else needs to integrate with."
  3157. msgstr ""
  3158. #: ../../../CHANGELOG.md:1163
  3159. msgid "How do these changes fix all these problems?"
  3160. msgstr ""
  3161. #: ../../../CHANGELOG.md:1165
  3162. msgid ""
  3163. "The new `matrix_playbook_reverse_proxy_type` lets you easily specify your"
  3164. " preferred reverse-proxy type, including `other-on-same-host`, `other-on-"
  3165. "another-host` and `none`, so people who'd like to reverse-proxy with "
  3166. "their own web server have more options now."
  3167. msgstr ""
  3168. #: ../../../CHANGELOG.md:1167
  3169. msgid ""
  3170. "Using Traefik greatly simplifies things, so going forward we'll have a "
  3171. "simpler and easier to maintain playbook, which is also interoperable with"
  3172. " other services."
  3173. msgstr ""
  3174. #: ../../../CHANGELOG.md:1169
  3175. msgid ""
  3176. "Traefik is a web server, which has been specifically **designed for "
  3177. "reverse-proxying to services running in containers**. It's ideal for "
  3178. "usage in an Ansible playbook which runs everything in containers."
  3179. msgstr ""
  3180. #: ../../../CHANGELOG.md:1171
  3181. msgid ""
  3182. "**Traefik obtains SSL certificates automatically**, so there's no need "
  3183. "for plugging additional tools like [Certbot](https://certbot.eff.org/) "
  3184. "into your web server (like we were doing in the `matrix-nginx-proxy` "
  3185. "role). No more certificate renewal timers, web server reloading timers, "
  3186. "etc. It's just simpler."
  3187. msgstr ""
  3188. #: ../../../CHANGELOG.md:1173
  3189. msgid ""
  3190. "Traefik is a **modern web server**. "
  3191. "[HTTP/3](https://doc.traefik.io/traefik/routing/entrypoints/#http3) is "
  3192. "supported already (experimentally) and will move to stable soon, in the "
  3193. "upcoming Traefik v3 release."
  3194. msgstr ""
  3195. #: ../../../CHANGELOG.md:1175
  3196. msgid ""
  3197. "Traefik does not lock important functionality we'd like to use into [plus"
  3198. " packages like nginx does](https://www.nginx.com/products/nginx/), "
  3199. "leading us to resolve to configuration workarounds. The default Traefik "
  3200. "package is good enough as it is."
  3201. msgstr ""
  3202. #: ../../../CHANGELOG.md:1177
  3203. msgid "Where we're at right now?"
  3204. msgstr ""
  3205. #: ../../../CHANGELOG.md:1179
  3206. msgid ""
  3207. "`matrix_playbook_reverse_proxy_type` still defaults to a value of "
  3208. "`playbook-managed-nginx`."
  3209. msgstr ""
  3210. #: ../../../CHANGELOG.md:1181
  3211. msgid ""
  3212. "Unless we have some regression, **existing `matrix-nginx-proxy` users "
  3213. "should be able to update their Matrix server and not observe any "
  3214. "changes**. Their setup should still remain on nginx and everything should"
  3215. " still work as expected."
  3216. msgstr ""
  3217. #: ../../../CHANGELOG.md:1183
  3218. msgid ""
  3219. "**Users using [their own webservers](docs/configuring-playbook-own-"
  3220. "webserver.md) will need to change `matrix_playbook_reverse_proxy_type`** "
  3221. "to something like `other-on-same-host`, `other-on-another-host` or "
  3222. "`other-nginx-non-container`. Previously, they could toggle "
  3223. "`matrix_nginx_proxy_enabled` to `false`, and that made the playbook "
  3224. "automatically expose services locally. Currently, we only do this if you "
  3225. "change the reverse-proxy type to `other-on-same-host`, `other-on-another-"
  3226. "host` or `other-nginx-non-container`."
  3227. msgstr ""
  3228. #: ../../../CHANGELOG.md:1185
  3229. msgid "How do I explicitly switch to Traefik right now?"
  3230. msgstr ""
  3231. #: ../../../CHANGELOG.md:1187
  3232. msgid ""
  3233. "**Users who wish to migrate to Traefik** today, can do so by **adding** "
  3234. "this to their configuration:"
  3235. msgstr ""
  3236. #: ../../../CHANGELOG.md:1195
  3237. msgid ""
  3238. "You may still need to keep certain old `matrix_nginx_proxy_*` variables "
  3239. "(like `matrix_nginx_proxy_base_domain_serving_enabled`), even when using "
  3240. "Traefik. For now, we recommend keeping all `matrix_nginx_proxy_*` "
  3241. "variables just in case. In the future, reliance on `matrix-nginx-proxy` "
  3242. "will be removed."
  3243. msgstr ""
  3244. #: ../../../CHANGELOG.md:1197
  3245. msgid ""
  3246. "Switching to Traefik will obtain new SSL certificates from Let's Encrypt "
  3247. "(stored in `/matrix/traefik/ssl/acme.json`). **The switch is "
  3248. "reversible**. You can always go back to `playbook-managed-nginx` if "
  3249. "Traefik is causing you trouble."
  3250. msgstr ""
  3251. #: ../../../CHANGELOG.md:1199
  3252. msgid ""
  3253. "**Note**: toggling `matrix_playbook_reverse_proxy_type` between Traefik "
  3254. "and nginx will uninstall the Traefik role and all of its data (under "
  3255. "`/matrix/traefik`), so you may run into a Let's Encrypt rate limit if you"
  3256. " do it often."
  3257. msgstr ""
  3258. #: ../../../CHANGELOG.md:1201
  3259. msgid ""
  3260. "Treafik directly reverse-proxies to **some** services right now, but for "
  3261. "most other services it goes through `matrix-nginx-proxy` (e.g. Traefik ->"
  3262. " `matrix-nginx-proxy` -> [Ntfy](docs/configuring-playbook-ntfy.md)). So, "
  3263. "even if you opt into Traefik, you'll still see `matrix-nginx-proxy` being"
  3264. " installed in local-only mode. This will improve with time."
  3265. msgstr ""
  3266. #: ../../../CHANGELOG.md:1203
  3267. msgid ""
  3268. "Some services (like [Coturn](docs/configuring-playbook-turn.md) and "
  3269. "[Postmoogle](docs/configuring-playbook-bridge-postmoogle.md)) cannot be "
  3270. "reverse-proxied to directly from Traefik, so they require direct access "
  3271. "to SSL certificate files extracted out of Traefik. The playbook does this"
  3272. " automatically thanks to a new "
  3273. "[com.devture.ansible.role.traefik_certs_dumper](https://github.com/devture/com.devture.ansible.role.traefik_certs_dumper)"
  3274. " role utilizing the [traefik-certs-dumper](https://github.com/ldez"
  3275. "/traefik-certs-dumper) tool."
  3276. msgstr ""
  3277. #: ../../../CHANGELOG.md:1205
  3278. msgid ""
  3279. "Our Traefik setup mostly works, but certain esoteric features may not "
  3280. "work. If you have a default setup, we expect you to have a good "
  3281. "experience."
  3282. msgstr ""
  3283. #: ../../../CHANGELOG.md:1207
  3284. msgid "Where we're going in the near future?"
  3285. msgstr ""
  3286. #: ../../../CHANGELOG.md:1209
  3287. msgid ""
  3288. "The `matrix-nginx-proxy` role is quite messy. It manages both nginx and "
  3289. "Certbot and its certificate renewal scripts and timers. It generates "
  3290. "configuration even when the role is disabled (weird). Although it doesn't"
  3291. " directly reach into variables from other roles, it has explicit "
  3292. "awareness of various other services that it reverse-proxies to "
  3293. "(`roles/custom/matrix-nginx-proxy/templates/nginx/conf.d/matrix-"
  3294. "ntfy.conf.j2`, etc.). We'd like to clean this up. The only way is "
  3295. "probably to just get rid of the whole thing at some point."
  3296. msgstr ""
  3297. #: ../../../CHANGELOG.md:1211
  3298. msgid "For now, `matrix-nginx-proxy` will stay around."
  3299. msgstr ""
  3300. #: ../../../CHANGELOG.md:1213
  3301. msgid ""
  3302. "As mentioned above, Traefik still reverse-proxies to some (most) services"
  3303. " by going through a local-only `matrix-nginx-proxy` server. This has "
  3304. "allowed us to add Traefik support to the playbook early on (without "
  3305. "having to rework all services), but is not the final goal. We'll **work "
  3306. "on making each service support Traefik natively**, so that traffic will "
  3307. "not need to go through `matrix-nginx-proxy` anymore. In the end, choosing"
  3308. " Traefik should only give you a pure Traefik installation with no "
  3309. "`matrix-nginx-proxy` in sight."
  3310. msgstr ""
  3311. #: ../../../CHANGELOG.md:1215
  3312. msgid ""
  3313. "As Traefik support becomes complete and proves to be stable for a while, "
  3314. "especially as a playbook default, we will **most likely remove `matrix-"
  3315. "nginx-proxy` completely**. It will likely be some months before this "
  3316. "happens though. Keeping support for both Traefik and nginx in the "
  3317. "playbook will be a burden, especially with most of us running Traefik in "
  3318. "the future. The Traefik role should do everything nginx does in a better "
  3319. "and cleaner way. Users who use their own `nginx` server on the Matrix "
  3320. "server will be inconvenienced, as nothing will generate ready-to-include "
  3321. "nginx configuration for them. Still, we hope it won't be too hard to "
  3322. "migrate their setup to another way of doing things, like:"
  3323. msgstr ""
  3324. #: ../../../CHANGELOG.md:1217
  3325. msgid ""
  3326. "not using nginx anymore. A common reason for using nginx until now was "
  3327. "that you were running other containers and you need your own nginx to "
  3328. "reverse-proxy to all of them. Just switch them to Traefik as well."
  3329. msgstr ""
  3330. #: ../../../CHANGELOG.md:1218
  3331. msgid ""
  3332. "running Traefik in local-only mode "
  3333. "(`traefik_config_entrypoint_web_secure_enabled: false`) and using some "
  3334. "nginx configuration which reverse-proxies to Traefik (we should introduce"
  3335. " examples for this in `examples/nginx`)."
  3336. msgstr ""
  3337. #: ../../../CHANGELOG.md:1220
  3338. msgid "How do I help?"
  3339. msgstr ""
  3340. #: ../../../CHANGELOG.md:1222
  3341. msgid "You can help by:"
  3342. msgstr ""
  3343. #: ../../../CHANGELOG.md:1224
  3344. msgid ""
  3345. "**explicitly switching your server to Traefik** right now (see example "
  3346. "configuration in [How do I explicitly switch to Traefik right now?](#how-"
  3347. "do-i-explicitly-switch-to-traefik-right-now) above), testing, reporting "
  3348. "troubles"
  3349. msgstr ""
  3350. #: ../../../CHANGELOG.md:1226
  3351. msgid ""
  3352. "**adding native Traefik support to a role** (requires adding Traefik "
  3353. "labels, etc.) - for inspiration, see these roles "
  3354. "([prometheus_node_exporter](https://github.com/mother-of-all-self-hosting"
  3355. "/ansible-role-prometheus-node-exporter), "
  3356. "[prometheus_postgres_exporter](https://github.com/mother-of-all-self-"
  3357. "hosting/ansible-role-prometheus-postgres-exporter)) and how they're "
  3358. "hooked into the playbook via "
  3359. "[group_vars/matrix_servers](group_vars/matrix_servers)."
  3360. msgstr ""
  3361. #: ../../../CHANGELOG.md:1228
  3362. msgid ""
  3363. "**adding reverse-proxying examples for nginx users** in `examples/nginx`."
  3364. " People who insist on using their own `nginx` server on the same Matrix "
  3365. "host, can run Traefik in local-only mode "
  3366. "(`traefik_config_entrypoint_web_secure_enabled: false`) and reverse-proxy"
  3367. " to the Traefik server"
  3368. msgstr ""
  3369. #: ../../../CHANGELOG.md:1231
  3370. msgid "2023-02-10"
  3371. msgstr ""
  3372. #: ../../../CHANGELOG.md:1233
  3373. msgid "Matrix Authentication Support for Jitsi"
  3374. msgstr ""
  3375. #: ../../../CHANGELOG.md:1235
  3376. msgid ""
  3377. "Thanks to [Jakob S.](https://github.com/jakicoll) ([zakk "
  3378. "gGmbH](https://github.com/zakk-it)), Jitsi can now use Matrix for "
  3379. "authentication (via [Matrix User Verification Service](https://github.com"
  3380. "/matrix-org/matrix-user-verification-service))."
  3381. msgstr ""
  3382. #: ../../../CHANGELOG.md:1237
  3383. msgid ""
  3384. "Additional details are available in the [Authenticate using Matrix OpenID"
  3385. " (Auth-Type 'matrix')](docs/configuring-playbook-jitsi.md#authenticate-"
  3386. "using-matrix-openid-auth-type-matrix)."
  3387. msgstr ""
  3388. #: ../../../CHANGELOG.md:1239
  3389. msgid "Draupnir moderation tool (bot) support"
  3390. msgstr ""
  3391. #: ../../../CHANGELOG.md:1241
  3392. msgid ""
  3393. "Thanks to [FSG-Cat](https://github.com/FSG-Cat), the playbook can now "
  3394. "install and configure the [Draupnir](https://github.com/the-draupnir-"
  3395. "project/Draupnir) moderation tool (bot). Draupnir is a fork of "
  3396. "[Mjolnir](docs/configuring-playbook-bot-mjolnir.md) (which the playbook "
  3397. "has supported for a long time) maintained by Mjolnir's former lead "
  3398. "developer."
  3399. msgstr ""
  3400. #: ../../../CHANGELOG.md:1243
  3401. msgid ""
  3402. "Additional details are available in [Setting up Draupnir](docs"
  3403. "/configuring-playbook-bot-draupnir.md)."
  3404. msgstr ""
  3405. #: ../../../CHANGELOG.md:1246
  3406. msgid "2023-02-05"
  3407. msgstr ""
  3408. #: ../../../CHANGELOG.md:1248
  3409. msgid "The matrix-prometheus-postgres-exporter role lives independently now"
  3410. msgstr ""
  3411. #: ../../../CHANGELOG.md:1250
  3412. msgid ""
  3413. "**TLDR**: the `matrix-prometheus-postgres-exporter` role is now included "
  3414. "from another repository. Some variables have been renamed. All "
  3415. "functionality remains intact."
  3416. msgstr ""
  3417. #: ../../../CHANGELOG.md:1252
  3418. msgid ""
  3419. "The `matrix-prometheus-postgres-exporter` role (which configures "
  3420. "[Prometheus Postgres Exporter](https://github.com/prometheus-"
  3421. "community/postgres_exporter)) has been extracted from the playbook and "
  3422. "now lives in its own repository at https://github.com/mother-of-all-self-"
  3423. "hosting/ansible-role-prometheus-postgres-exporter"
  3424. msgstr ""
  3425. #: ../../../CHANGELOG.md:1254
  3426. msgid ""
  3427. "It's still part of the playbook, but is now installed via `ansible-"
  3428. "galaxy` (by running `just roles` / `make roles`). Some variables have "
  3429. "been renamed (`matrix_prometheus_postgres_exporter_` -> "
  3430. "`prometheus_postgres_exporter_`, etc.). The playbook will report all "
  3431. "variables that you need to rename to get upgraded. All functionality "
  3432. "remains intact."
  3433. msgstr ""
  3434. #: ../../../CHANGELOG.md:1256
  3435. msgid ""
  3436. "The `matrix-prometheus-services-proxy-connect` role has bee adjusted to "
  3437. "help integrate the new `prometheus_postgres_exporter` role with our own "
  3438. "services (`matrix-nginx-proxy`)"
  3439. msgstr ""
  3440. #: ../../../CHANGELOG.md:1258 ../../../CHANGELOG.md:1300
  3441. msgid ""
  3442. "Other roles which aren't strictly related to Matrix are likely to follow "
  3443. "this fate of moving to their own repositories. Extracting them out allows"
  3444. " other Ansible playbooks to make use of these roles easily."
  3445. msgstr ""
  3446. #: ../../../CHANGELOG.md:1261
  3447. msgid "2023-01-26"
  3448. msgstr ""
  3449. #: ../../../CHANGELOG.md:1263
  3450. msgid "Coturn can now use host-networking"
  3451. msgstr ""
  3452. #: ../../../CHANGELOG.md:1265
  3453. msgid ""
  3454. "Large Coturn deployments (with a huge range of ports specified via "
  3455. "`matrix_coturn_turn_udp_min_port` and `matrix_coturn_turn_udp_max_port`) "
  3456. "experience a huge slowdown with how Docker publishes all these ports "
  3457. "(setting up firewall forwarding rules), which leads to a very slow Coturn"
  3458. " service startup and shutdown."
  3459. msgstr ""
  3460. #: ../../../CHANGELOG.md:1267
  3461. msgid ""
  3462. "Such deployments don't need to run Coturn within a private container "
  3463. "network anymore. Coturn can now run with host-networking by using "
  3464. "configuration like this:"
  3465. msgstr ""
  3466. #: ../../../CHANGELOG.md:1273
  3467. msgid ""
  3468. "With such a configuration, **Docker no longer needs to configure "
  3469. "thousands of firewall forwarding rules** each time Coturn starts and "
  3470. "stops. This, however, means that **you will need to ensure these ports "
  3471. "are open** in your firewall yourself."
  3472. msgstr ""
  3473. #: ../../../CHANGELOG.md:1275
  3474. msgid ""
  3475. "Thanks to us [tightening Coturn security](#backward-compatibility-"
  3476. "tightening-coturn-security-can-lead-to-connectivity-issues), running "
  3477. "Coturn with host-networking should be safe and not expose neither other "
  3478. "services running on the host, nor other services running on the local "
  3479. "network."
  3480. msgstr ""
  3481. #: ../../../CHANGELOG.md:1277
  3482. msgid ""
  3483. "(Backward Compatibility) Tightening Coturn security can lead to "
  3484. "connectivity issues"
  3485. msgstr ""
  3486. #: ../../../CHANGELOG.md:1279
  3487. msgid ""
  3488. "**TLDR**: users who run and access their Matrix server on a private "
  3489. "network (likely a small minority of users) may experience connectivity "
  3490. "issues with our new default Coturn blocklists. They may need to override "
  3491. "`matrix_coturn_denied_peer_ips` and remove some IP ranges from it."
  3492. msgstr ""
  3493. #: ../../../CHANGELOG.md:1281
  3494. msgid ""
  3495. "Inspired by [this security "
  3496. "article](https://www.rtcsec.com/article/cve-2020-26262-bypass-of-coturns-"
  3497. "access-control-protection/), we've decided to make use of Coturn's "
  3498. "`denied-peer-ip` functionality to prevent relaying network traffic to "
  3499. "certain private IP subnets. This ensures that your Coturn server won't "
  3500. "accidentally try to forward traffic to certain services running on your "
  3501. "local networks. We run Coturn in a container and in a private container "
  3502. "network by default, which should prevent such access anyway, but having "
  3503. "additional block layers in place is better."
  3504. msgstr ""
  3505. #: ../../../CHANGELOG.md:1283
  3506. msgid ""
  3507. "If you access your Matrix server from a local network and need Coturn to "
  3508. "relay to private IP addresses, you may observe that relaying is now "
  3509. "blocked due to our new default `denied-peer-ip` lists (specified in "
  3510. "`matrix_coturn_denied_peer_ips`). If you experience such connectivity "
  3511. "problems, consider overriding this setting in your `vars.yml` file and "
  3512. "removing certain networks from it."
  3513. msgstr ""
  3514. #: ../../../CHANGELOG.md:1285
  3515. msgid ""
  3516. "We've also added `no-multicast-peers` to the default Coturn "
  3517. "configuration, but we don't expect this to cause trouble for most people."
  3518. msgstr ""
  3519. #: ../../../CHANGELOG.md:1288
  3520. msgid "2023-01-21"
  3521. msgstr ""
  3522. #: ../../../CHANGELOG.md:1290
  3523. msgid "The matrix-prometheus-node-exporter role lives independently now"
  3524. msgstr ""
  3525. #: ../../../CHANGELOG.md:1292
  3526. msgid ""
  3527. "**TLDR**: the `matrix-prometheus-node-exporter` role is now included from"
  3528. " another repository. Some variables have been renamed. All functionality "
  3529. "remains intact."
  3530. msgstr ""
  3531. #: ../../../CHANGELOG.md:1294
  3532. msgid ""
  3533. "The `matrix-prometheus-node-exporter` role (which configures [Prometheus "
  3534. "node exporter](https://github.com/prometheus/node_exporter)) has been "
  3535. "extracted from the playbook and now lives in its own repository at "
  3536. "https://github.com/mother-of-all-self-hosting/ansible-role-prometheus-"
  3537. "node-exporter"
  3538. msgstr ""
  3539. #: ../../../CHANGELOG.md:1296
  3540. msgid ""
  3541. "It's still part of the playbook, but is now installed via `ansible-"
  3542. "galaxy` (by running `just roles` / `make roles`). Some variables have "
  3543. "been renamed (`matrix_prometheus_node_exporter_` -> "
  3544. "`prometheus_node_exporter_`, etc.). The playbook will report all "
  3545. "variables that you need to rename to get upgraded. All functionality "
  3546. "remains intact."
  3547. msgstr ""
  3548. #: ../../../CHANGELOG.md:1298
  3549. msgid ""
  3550. "A new `matrix-prometheus-services-proxy-connect` role was added to the "
  3551. "playbook to help integrate the new `prometheus_node_exporter` role with "
  3552. "our own services (`matrix-nginx-proxy`)"
  3553. msgstr ""
  3554. #: ../../../CHANGELOG.md:1303
  3555. msgid "2023-01-13"
  3556. msgstr ""
  3557. #: ../../../CHANGELOG.md:1305
  3558. msgid "Support for running commands via just"
  3559. msgstr ""
  3560. #: ../../../CHANGELOG.md:1307
  3561. msgid ""
  3562. "We've previously used [make](https://www.gnu.org/software/make/) for "
  3563. "easily running some playbook commands (e.g. `make roles` which triggers "
  3564. "`ansible-galaxy`, see [Makefile](Makefile)). Our `Makefile` is still "
  3565. "around and you can still run these commands."
  3566. msgstr ""
  3567. #: ../../../CHANGELOG.md:1309
  3568. msgid ""
  3569. "In addition, we've added support for running commands via "
  3570. "[just](https://github.com/casey/just) - a more modern command-runner "
  3571. "alternative to `make`. Instead of `make roles`, you can now run `just "
  3572. "roles` to accomplish the same."
  3573. msgstr ""
  3574. #: ../../../CHANGELOG.md:1311
  3575. msgid ""
  3576. "Our [justfile](justfile) already defines some additional helpful "
  3577. "**shortcut** commands that weren't part of our `Makefile`. Here are some "
  3578. "examples:"
  3579. msgstr ""
  3580. #: ../../../CHANGELOG.md:1313
  3581. msgid ""
  3582. "`just install-all` to trigger the much longer `ansible-playbook -i "
  3583. "inventory/hosts setup.yml --tags=install-all,ensure-matrix-users-"
  3584. "created,start` command"
  3585. msgstr ""
  3586. #: ../../../CHANGELOG.md:1314
  3587. msgid ""
  3588. "`just install-all --ask-vault-pass` - commands also support additional "
  3589. "arguments (`--ask-vault-pass` will be appended to the above installation "
  3590. "command)"
  3591. msgstr ""
  3592. #: ../../../CHANGELOG.md:1315
  3593. msgid ""
  3594. "`just run-tags install-mautrix-slack,start` - to run specific playbook "
  3595. "tags"
  3596. msgstr ""
  3597. #: ../../../CHANGELOG.md:1316
  3598. msgid "`just start-all` - (re-)starts all services"
  3599. msgstr ""
  3600. #: ../../../CHANGELOG.md:1317
  3601. msgid "`just stop-group postgres` - to stop only the Postgres service"
  3602. msgstr ""
  3603. #: ../../../CHANGELOG.md:1318
  3604. msgid ""
  3605. "`just register-user alice secret-password yes` - registers an `alice` "
  3606. "user with the `secret-password` password and admin access (admin = `yes`)"
  3607. msgstr ""
  3608. #: ../../../CHANGELOG.md:1320
  3609. msgid "Additional helpful commands and shortcuts may be defined in the future."
  3610. msgstr ""
  3611. #: ../../../CHANGELOG.md:1322
  3612. msgid ""
  3613. "This is all completely optional. If you find it difficult to [install "
  3614. "`just`](https://github.com/casey/just#installation) or don't find any of "
  3615. "this convenient, feel free to run all commands manually."
  3616. msgstr ""
  3617. #: ../../../CHANGELOG.md:1325
  3618. msgid "2023-01-11"
  3619. msgstr ""
  3620. #: ../../../CHANGELOG.md:1327
  3621. msgid "mautrix-slack support"
  3622. msgstr ""
  3623. #: ../../../CHANGELOG.md:1329
  3624. msgid ""
  3625. "Thanks to [Cody Neiman](https://github.com/xangelix)'s efforts, the "
  3626. "playbook now supports bridging to [Slack](https://slack.com/) via the "
  3627. "[mautrix-slack](https://mau.dev/mautrix/slack) bridge. See our [Setting "
  3628. "up Mautrix Slack bridging](docs/configuring-playbook-bridge-mautrix-"
  3629. "slack.md) documentation page for getting started."
  3630. msgstr ""
  3631. #: ../../../CHANGELOG.md:1331
  3632. msgid ""
  3633. "**Note**: this is a new Slack bridge. The playbook still retains Slack "
  3634. "bridging via [matrix-appservice-slack](docs/configuring-playbook-bridge-"
  3635. "appservice-slack.md) and [mx-puppet-slack](docs/configuring-playbook-"
  3636. "bridge-mx-puppet-slack.md). You're free to use the bridge that serves you"
  3637. " better, or even all three of them (for different users and use-cases)."
  3638. msgstr ""
  3639. #: ../../../CHANGELOG.md:1334
  3640. msgid "2023-01-10"
  3641. msgstr ""
  3642. #: ../../../CHANGELOG.md:1336
  3643. msgid "ChatGPT support"
  3644. msgstr ""
  3645. #: ../../../CHANGELOG.md:1338
  3646. msgid ""
  3647. "Thanks to [@bertybuttface](https://github.com/bertybuttface), the "
  3648. "playbook can now help you set up [matrix-chatgpt-"
  3649. "bot](https://github.com/matrixgpt/matrix-chatgpt-bot) - a bot through "
  3650. "which you can talk to the [ChatGPT](https://openai.com/blog/chatgpt/) "
  3651. "model."
  3652. msgstr ""
  3653. #: ../../../CHANGELOG.md:1340
  3654. msgid ""
  3655. "See our [Setting up matrix-bot-chatgpt](docs/configuring-playbook-bot-"
  3656. "chatgpt.md) documentation to get started."
  3657. msgstr ""
  3658. #: ../../../CHANGELOG.md:1343
  3659. msgid "2022-11-30"
  3660. msgstr ""
  3661. #: ../../../CHANGELOG.md:1345
  3662. msgid ""
  3663. "matrix-postgres-backup has been replaced by the ansible-role-postgres-"
  3664. "backup external role"
  3665. msgstr ""
  3666. #: ../../../CHANGELOG.md:1347
  3667. msgid ""
  3668. "Just like we've [replaced Postgres with an external role](#matrix-"
  3669. "postgres-has-been-replaced-by-the-comdevtureansiblerolepostgres-external-"
  3670. "role) on 2022-11-28, we're now replacing `matrix-postgres-backup` with an"
  3671. " external role - "
  3672. "[com.devture.ansible.role.postgres_backup](https://github.com/mother-of-"
  3673. "all-self-hosting/ansible-role-postgres_backup)."
  3674. msgstr ""
  3675. #: ../../../CHANGELOG.md:1349
  3676. msgid ""
  3677. "You'll need to rename your `matrix_postgres_backup`-prefixed variables "
  3678. "such that they use a `postgres_backup` prefix."
  3679. msgstr ""
  3680. #: ../../../CHANGELOG.md:1352
  3681. msgid "2022-11-28"
  3682. msgstr ""
  3683. #: ../../../CHANGELOG.md:1354
  3684. msgid ""
  3685. "matrix-postgres has been replaced by the ansible-role-postgres external "
  3686. "role"
  3687. msgstr ""
  3688. #: ../../../CHANGELOG.md:1356
  3689. msgid ""
  3690. "**TLDR**: the tasks that install the integrated Postgres server now live "
  3691. "in an external role - [ansible-role-postgres](https://github.com/mother-"
  3692. "of-all-self-hosting/ansible-role-postgres). You'll need to run `make "
  3693. "roles` to install it, and to also rename your `matrix_postgres`-prefixed "
  3694. "variables to use a `devture_postgres` prefix (e.g. "
  3695. "`matrix_postgres_connection_password` -> `postgres_connection_password`)."
  3696. " All your data will still be there! Some scripts have moved "
  3697. "(`/usr/local/bin/matrix-postgres-cli` -> `/matrix/postgres/bin/cli`)."
  3698. msgstr ""
  3699. #: ../../../CHANGELOG.md:1358
  3700. msgid ""
  3701. "The `matrix-postgres` role that has been part of the playbook for a long "
  3702. "time has been replaced with the [ansible-role-"
  3703. "postgres](https://github.com/mother-of-all-self-hosting/ansible-role-"
  3704. "postgres) role. This was done as part of our work to [use external roles "
  3705. "for some things](#the-playbook-now-uses-external-roles-for-some-things) "
  3706. "for better code re-use and maintainability."
  3707. msgstr ""
  3708. #: ../../../CHANGELOG.md:1360
  3709. msgid ""
  3710. "The new role is an upgraded version of the old `matrix-postgres` role "
  3711. "with these notable differences:"
  3712. msgstr ""
  3713. #: ../../../CHANGELOG.md:1362
  3714. msgid ""
  3715. "it uses different names for its variables (`matrix_postgres` -> "
  3716. "`devture_postgres`)"
  3717. msgstr ""
  3718. #: ../../../CHANGELOG.md:1363
  3719. msgid ""
  3720. "when [Vacuuming PostgreSQL](docs/maintenance-postgres.md#vacuuming-"
  3721. "postgresql), it will vacuum all your databases, not just the Synapse one"
  3722. msgstr ""
  3723. #: ../../../CHANGELOG.md:1365
  3724. msgid ""
  3725. "You'll need to run `make roles` to install the new role. You would also "
  3726. "need to rename your `matrix_postgres`-prefixed variables to use a "
  3727. "`devture_postgres` prefix."
  3728. msgstr ""
  3729. #: ../../../CHANGELOG.md:1367
  3730. msgid ""
  3731. "Note: the systemd service still remains the same - `matrix-"
  3732. "postgres.service`. Your data will still be in `/matrix/postgres`, etc. "
  3733. "Postgres-related scripts will be moved to `/matrix/postgres/bin` "
  3734. "(`/usr/local/bin/matrix-postgres-cli` -> `/matrix/postgres/bin/cli`, "
  3735. "etc). Also see [The playbook no longer installs scripts in /usr/local/bin"
  3736. "](#the-playbook-no-longer-installs-scripts-in-usrlocalbin)."
  3737. msgstr ""
  3738. #: ../../../CHANGELOG.md:1369
  3739. msgid "The playbook no longer installs scripts to /usr/local/bin"
  3740. msgstr ""
  3741. #: ../../../CHANGELOG.md:1371
  3742. msgid "The locations of various scripts installed by the playbook have changed."
  3743. msgstr ""
  3744. #: ../../../CHANGELOG.md:1373
  3745. msgid ""
  3746. "The playbook no longer contaminates your `/usr/local/bin` directory. All "
  3747. "scripts installed by the playbook now live in `bin/` directories under "
  3748. "`/matrix`. Some examples are below:"
  3749. msgstr ""
  3750. #: ../../../CHANGELOG.md:1375
  3751. msgid "`/usr/local/bin/matrix-remove-all` -> `/matrix/bin/remove-all`"
  3752. msgstr ""
  3753. #: ../../../CHANGELOG.md:1376
  3754. msgid "`/usr/local/bin/matrix-postgres-cli` -> `/matrix/postgres/bin/cli`"
  3755. msgstr ""
  3756. #: ../../../CHANGELOG.md:1377
  3757. msgid ""
  3758. "`/usr/local/bin/matrix-ssl-lets-encrypt-certificates-renew` -> "
  3759. "`/matrix/ssl/bin/lets-encrypt-certificates-renew`"
  3760. msgstr ""
  3761. #: ../../../CHANGELOG.md:1378
  3762. msgid ""
  3763. "`/usr/local/bin/matrix-synapse-register-user` -> `/matrix/synapse/bin"
  3764. "/register-user`"
  3765. msgstr ""
  3766. #: ../../../CHANGELOG.md:1381
  3767. msgid "2022-11-25"
  3768. msgstr ""
  3769. #: ../../../CHANGELOG.md:1383
  3770. msgid "2x-5x performance improvements in playbook runtime"
  3771. msgstr ""
  3772. #: ../../../CHANGELOG.md:1385
  3773. msgid ""
  3774. "**TLDR**: the playbook is 2x faster for running `--tags=setup-all` (and "
  3775. "various other tags). It also has new `--tags=install-*` tags (like "
  3776. "`--tags=install-all`), which skip uninstallation tasks and bring an "
  3777. "additional 2.5x speedup. In total, the playbook can maintain your server "
  3778. "5 times faster."
  3779. msgstr ""
  3780. #: ../../../CHANGELOG.md:1387
  3781. msgid ""
  3782. "Our [etke.cc managed Matrix hosting service](https://etke.cc) runs "
  3783. "maintenance against hundreds of servers, so the playbook being fast means"
  3784. " a lot. The [etke.cc Ansible playbook](https://github.com/etkecc/ansible)"
  3785. " (which is an extension of this one) is growing to support more and more "
  3786. "services (besides just Matrix), so the Matrix playbook being leaner "
  3787. "prevents runtimes from becoming too slow and improves the customer "
  3788. "experience."
  3789. msgstr ""
  3790. #: ../../../CHANGELOG.md:1389
  3791. msgid ""
  3792. "Even when running `ansible-playbook` manually (as most of us here do), "
  3793. "it's beneficial not to waste time and CPU resources."
  3794. msgstr ""
  3795. #: ../../../CHANGELOG.md:1391
  3796. msgid ""
  3797. "Recently, a few large optimizations have been done to this playbook and "
  3798. "its external roles (see [The playbook now uses external roles for some "
  3799. "things](#the-playbook-now-uses-external-roles-for-some-things) and don't "
  3800. "forget to run `make roles`):"
  3801. msgstr ""
  3802. #: ../../../CHANGELOG.md:1393
  3803. msgid ""
  3804. "Replacing Ansible `import_tasks` calls with `include_tasks`, which "
  3805. "decreased runtime in half. Using `import_tasks` is slower and causes "
  3806. "Ansible to go through and skip way too many tasks (tasks which could have"
  3807. " been skipped altogether by not having Ansible include them in the first "
  3808. "place). On an experimental VM, **deployment time was decreased from ~530 "
  3809. "seconds to ~250 seconds**."
  3810. msgstr ""
  3811. #: ../../../CHANGELOG.md:1395
  3812. msgid ""
  3813. "Introducing new `install-*` tags (`install-all` and `install-COMPONENT`, "
  3814. "e.g. `install-synapse`, `install-bot-mjolnir`), which only run Ansible "
  3815. "tasks pertaining to installation, while skipping uninstallation tasks. In"
  3816. " most cases, people are maintaining the same setup or they're *adding* "
  3817. "new components. Removing components is rare. Running thousands of "
  3818. "uninstallation tasks each time is wasteful. On an experimental VM, "
  3819. "**deployment time was decreased from ~250 seconds (`--tags=setup-all`) to"
  3820. " ~100 seconds (`--tags=install-all`)**."
  3821. msgstr ""
  3822. #: ../../../CHANGELOG.md:1397
  3823. msgid ""
  3824. "You can still use `--tags=setup-all`. In fact, that's the best way to "
  3825. "ensure your server is reconciled with the `vars.yml` configuration."
  3826. msgstr ""
  3827. #: ../../../CHANGELOG.md:1399
  3828. msgid ""
  3829. "If you know you haven't uninstalled any services since the last time you "
  3830. "ran the playbook, you could run `--tags=install-all` instead and benefit "
  3831. "from quicker runtimes. It should be noted that a service may become "
  3832. "\"eligible for uninstallation\" even if your `vars.yml` file remains the "
  3833. "same. In rare cases, we toggle services from being auto-installed to "
  3834. "being optional, like we did on the 17th of March 2022 when we made [ma1sd"
  3835. " not get installed by default](https://github.com/spantaleev/matrix-"
  3836. "docker-ansible-deploy/blob/master/CHANGELOG.md#compatibility-break-ma1sd-"
  3837. "identity-server-no-longer-installed-by-default). In such rare cases, "
  3838. "you'd also need to run `--tags=setup-all`."
  3839. msgstr ""
  3840. #: ../../../CHANGELOG.md:1402
  3841. msgid "2022-11-22"
  3842. msgstr ""
  3843. #: ../../../CHANGELOG.md:1404
  3844. msgid "Automatic `matrix_architecture` determination"
  3845. msgstr ""
  3846. #: ../../../CHANGELOG.md:1406
  3847. msgid ""
  3848. "From now on, the playbook automatically determines your server's "
  3849. "architecture and sets the `matrix_architecture` variable accordingly. You"
  3850. " no longer need to set this variable manually in your `vars.yml` file."
  3851. msgstr ""
  3852. #: ../../../CHANGELOG.md:1408
  3853. msgid "Docker and the Docker SDK for Python are now installed via external roles"
  3854. msgstr ""
  3855. #: ../../../CHANGELOG.md:1412
  3856. msgid ""
  3857. "Docker will now be installed on the server via the "
  3858. "[geerlingguy.docker](https://github.com/geerlingguy/ansible-role-docker) "
  3859. "Ansible role. If you'd like to manage the Docker installation yourself, "
  3860. "you can disable the playbook's installation of Docker by setting "
  3861. "`matrix_playbook_docker_installation_enabled: false`."
  3862. msgstr ""
  3863. #: ../../../CHANGELOG.md:1414
  3864. msgid ""
  3865. "The Docker SDK for Python (named `docker-python`, `python-docker`, etc. "
  3866. "on the different platforms) is now also installed by another role "
  3867. "([com.devture.ansible.role.docker_sdk_for_python](https://github.com/devture/com.devture.ansible.role.docker_sdk_for_python))."
  3868. " To disable this role and install the necessary tools yourself, use "
  3869. "`devture_docker_sdk_for_python_installation_enabled: false`."
  3870. msgstr ""
  3871. #: ../../../CHANGELOG.md:1416
  3872. msgid ""
  3873. "If you're hitting issues with Docker installation or Docker SDK for "
  3874. "Python installation, consider reporting bugs or contributing to these "
  3875. "other projects."
  3876. msgstr ""
  3877. #: ../../../CHANGELOG.md:1418
  3878. msgid ""
  3879. "These additional roles are downloaded into the playbook directory (to "
  3880. "`roles/galaxy`) via an `ansible-galaxy ..` command. `make roles` is an "
  3881. "easy shortcut for invoking the `ansible-galaxy` command to download these"
  3882. " roles."
  3883. msgstr ""
  3884. #: ../../../CHANGELOG.md:1421
  3885. msgid "2022-11-20"
  3886. msgstr ""
  3887. #: ../../../CHANGELOG.md:1423
  3888. msgid ""
  3889. "(Backward Compatibility Break) Changing how reverse-proxying to Synapse "
  3890. "works - now via a `matrix-synapse-reverse-proxy-companion` service"
  3891. msgstr ""
  3892. #: ../../../CHANGELOG.md:1425
  3893. msgid ""
  3894. "**TLDR**: There's now a `matrix-synapse-reverse-proxy-companion` nginx "
  3895. "service, which helps with reverse-proxying to Synapse and its various "
  3896. "worker processes (if workers are enabled), so that `matrix-nginx-proxy` "
  3897. "can be relieved of this role. `matrix-nginx-proxy` still remains as the "
  3898. "public SSL-terminating reverse-proxy in the playbook. `matrix-synapse-"
  3899. "reverse-proxy-companion` is just one more reverse-proxy thrown into the "
  3900. "mix for convenience. People with a more custom reverse-proxying "
  3901. "configuration may be affected - see [Webserver configuration](#webserver-"
  3902. "configuration) below."
  3903. msgstr ""
  3904. #: ../../../CHANGELOG.md:1427
  3905. msgid "Background"
  3906. msgstr ""
  3907. #: ../../../CHANGELOG.md:1429
  3908. msgid ""
  3909. "Previously, `matrix-nginx-proxy` forwarded requests to Synapse directly. "
  3910. "When Synapse is running in worker mode, the reverse-proxying "
  3911. "configuration is more complicated (different requests need to go to "
  3912. "different Synapse worker processes). `matrix-nginx-proxy` had "
  3913. "configuration for sending each URL endpoint to the correct Synapse worker"
  3914. " responsible for handling it. However, sometimes people like to disable "
  3915. "`matrix-nginx-proxy` (for whatever reason) as detailed in [Using your own"
  3916. " webserver, instead of this playbook's nginx proxy](docs/configuring-"
  3917. "playbook-own-webserver.md)."
  3918. msgstr ""
  3919. #: ../../../CHANGELOG.md:1431
  3920. msgid ""
  3921. "Because `matrix-nginx-proxy` was so central to request forwarding, when "
  3922. "it was disabled and Synapse was running with workers enabled, there was "
  3923. "nothing which could forward requests to the correct place anymore.. which"
  3924. " caused [problems such as this one affecting "
  3925. "Dimension](https://github.com/spantaleev/matrix-docker-ansible-"
  3926. "deploy/issues/2090)."
  3927. msgstr ""
  3928. #: ../../../CHANGELOG.md:1433
  3929. msgid "Solution"
  3930. msgstr ""
  3931. #: ../../../CHANGELOG.md:1435
  3932. msgid ""
  3933. "From now on, `matrix-nginx-proxy` is relieved of its function of reverse-"
  3934. "proxying to Synapse and its various worker processes. This role is now "
  3935. "handled by the new `matrix-synapse-reverse-proxy-companion` nginx service"
  3936. " and works even if `matrix-nginx-proxy` is disabled. The purpose of the "
  3937. "new `matrix-synapse-reverse-proxy-companion` service is to:"
  3938. msgstr ""
  3939. #: ../../../CHANGELOG.md:1437
  3940. msgid ""
  3941. "serve as a companion to Synapse and know how to reverse-proxy to Synapse "
  3942. "correctly (no matter if workers are enabled or not)"
  3943. msgstr ""
  3944. #: ../../../CHANGELOG.md:1439
  3945. msgid ""
  3946. "provide a unified container address for reaching Synapse (no matter if "
  3947. "workers are enabled or not)"
  3948. msgstr ""
  3949. #: ../../../CHANGELOG.md:1440
  3950. msgid ""
  3951. "`matrix-synapse-reverse-proxy-companion:8008` for Synapse Client-Server "
  3952. "API traffic"
  3953. msgstr ""
  3954. #: ../../../CHANGELOG.md:1441
  3955. msgid ""
  3956. "`matrix-synapse-reverse-proxy-companion:8048` for Synapse Server-Server "
  3957. "(Federation) API traffic"
  3958. msgstr ""
  3959. #: ../../../CHANGELOG.md:1443
  3960. msgid ""
  3961. "simplify `matrix-nginx-proxy` configuration - it now only needs to send "
  3962. "requests to `matrix-synapse-reverse-proxy-companion` or `matrix-"
  3963. "dendrite`, etc., without having to worry about workers"
  3964. msgstr ""
  3965. #: ../../../CHANGELOG.md:1445
  3966. msgid ""
  3967. "allow reverse-proxying to Synapse, even if `matrix-nginx-proxy` is "
  3968. "disabled"
  3969. msgstr ""
  3970. #: ../../../CHANGELOG.md:1447
  3971. msgid ""
  3972. "`matrix-nginx-proxy` still remains as the public SSL-terminating reverse-"
  3973. "proxy in the playbook. All traffic goes through it before reaching any of"
  3974. " the services. It's just that now the Synapse traffic is routed through "
  3975. "`matrix-synapse-reverse-proxy-companion` like this:"
  3976. msgstr ""
  3977. #: ../../../CHANGELOG.md:1449
  3978. msgid ""
  3979. "(`matrix-nginx-proxy` -> `matrix-synapse-reverse-proxy-companion` -> "
  3980. "(`matrix-synapse` or some Synapse worker))."
  3981. msgstr ""
  3982. #: ../../../CHANGELOG.md:1451
  3983. msgid ""
  3984. "Various services (like Dimension, etc.) still talk to Synapse via "
  3985. "`matrix-nginx-proxy` (e.g. `http://matrix-nginx-proxy:12080`) "
  3986. "preferentially. They only talk to Synapse via the reverse-proxy companion"
  3987. " (e.g. `http://matrix-synapse-reverse-proxy-companion:8008`) if `matrix-"
  3988. "nginx-proxy` is disabled. Services should not be talking to Synapse (e.g."
  3989. " `https://matrix-synapse:8008` directly anymore), because when workers "
  3990. "are enabled, that's the Synapse `master` process and may not be serving "
  3991. "all URL endpoints needed by the service."
  3992. msgstr ""
  3993. #: ../../../CHANGELOG.md:1453
  3994. msgid "Webserver configuration"
  3995. msgstr ""
  3996. #: ../../../CHANGELOG.md:1455
  3997. msgid ""
  3998. "if you're using `matrix-nginx-proxy` (`matrix_nginx_proxy_enabled: true`,"
  3999. " which is the default for the playbook), you don't need to do anything"
  4000. msgstr ""
  4001. #: ../../../CHANGELOG.md:1457
  4002. msgid ""
  4003. "if you're using your own `nginx` webserver running on the server, you "
  4004. "shouldn't be affected. The `/matrix/nginx/conf.d` configuration and "
  4005. "exposed ports that you're relying on will automatically be updated in a "
  4006. "way that should work"
  4007. msgstr ""
  4008. #: ../../../CHANGELOG.md:1459
  4009. msgid ""
  4010. "if you're using another local webserver (e.g. Apache, etc.) and haven't "
  4011. "changed any ports (`matrix_*_host_bind_port` definitions), you shouldn't "
  4012. "be affected. You're likely sending Matrix traffic to `127.0.0.1:8008` and"
  4013. " `127.0.0.1:8048`. These ports (`8008` and `8048`) will still be exposed "
  4014. "on `127.0.0.1` by default - just not by the `matrix-synapse` container "
  4015. "from now on, but by the `matrix-synapse-reverse-proxy-companion` "
  4016. "container instead"
  4017. msgstr ""
  4018. #: ../../../CHANGELOG.md:1461
  4019. msgid ""
  4020. "if you've been exposing `matrix-synapse` ports "
  4021. "(`matrix_synapse_container_client_api_host_bind_port`, etc.) manually, "
  4022. "you should consider exposing `matrix-synapse-reverse-proxy-companion` "
  4023. "ports instead"
  4024. msgstr ""
  4025. #: ../../../CHANGELOG.md:1463
  4026. msgid ""
  4027. "if you're running Traefik and reverse-proxying directly to the `matrix-"
  4028. "synapse` container, you should start reverse-proxying to the `matrix-"
  4029. "synapse-reverse-proxy-companion` container instead. See [our updated "
  4030. "Traefik example configuration](docs/configuring-playbook-own-webserver.md"
  4031. "#sample-configuration-for-running-behind-traefik-20). Note: we now "
  4032. "recommend calling the federation entry point `federation` (instead of "
  4033. "`synapse`) and reverse-proxying the federation traffic via `matrix-nginx-"
  4034. "proxy`, instead of sending it directly to Synapse (or `matrix-synapse-"
  4035. "reverse-proxy-companion`). This makes the configuration simpler."
  4036. msgstr ""
  4037. #: ../../../CHANGELOG.md:1466
  4038. msgid "2022-11-05"
  4039. msgstr ""
  4040. #: ../../../CHANGELOG.md:1468
  4041. msgid "(Backward Compatibility Break) A new default standalone mode for Etherpad"
  4042. msgstr ""
  4043. #: ../../../CHANGELOG.md:1470
  4044. msgid ""
  4045. "Until now, [Etherpad](https://etherpad.org/) (which [the playbook could "
  4046. "install for you](docs/configuring-playbook-etherpad.md)) required the "
  4047. "[Dimension integration manager](docs/configuring-playbook-dimension.md) "
  4048. "to also be installed, because Etherpad was hosted on the Dimension domain"
  4049. " (at `dimension.example.com/etherpad`)."
  4050. msgstr ""
  4051. #: ../../../CHANGELOG.md:1472
  4052. msgid ""
  4053. "From now on, Etherpad can be installed in `standalone` mode on "
  4054. "`etherpad.example.com` and used even without Dimension. This is much more"
  4055. " versatile, so the playbook now defaults to this new mode "
  4056. "(`etherpad_mode: standalone`)."
  4057. msgstr ""
  4058. #: ../../../CHANGELOG.md:1474
  4059. msgid "If you've already got both Etherpad and Dimension in use you could:"
  4060. msgstr ""
  4061. #: ../../../CHANGELOG.md:1476
  4062. msgid ""
  4063. "**either** keep hosting Etherpad under the Dimension domain by adding "
  4064. "`etherpad_mode: dimension` to your `vars.yml` file. All your existing "
  4065. "room widgets will continue working at the same URLs and no other changes "
  4066. "will be necessary."
  4067. msgstr ""
  4068. #: ../../../CHANGELOG.md:1478
  4069. msgid ""
  4070. "**or**, you could change to hosting Etherpad separately on "
  4071. "`etherpad.example.com`. You will need to [configure a DNS record](docs"
  4072. "/configuring-dns.md) for this new domain. You will also need to "
  4073. "reconfigure Dimension to use the new pad URLs "
  4074. "(`https://etherpad.example.com/…`) going forward (refer to our "
  4075. "[configuring Etherpad documentation](docs/configuring-playbook-"
  4076. "etherpad.md)). All your existing room widgets (which still use "
  4077. "`https://dimension.example.com/etherpad/…`) will break as Etherpad is not"
  4078. " hosted there anymore. You will need to re-add them or to consider not "
  4079. "using `standalone` mode"
  4080. msgstr ""
  4081. #: ../../../CHANGELOG.md:1481
  4082. msgid "2022-11-04"
  4083. msgstr ""
  4084. #: ../../../CHANGELOG.md:1483
  4085. msgid "The playbook now uses external roles for some things"
  4086. msgstr ""
  4087. #: ../../../CHANGELOG.md:1485
  4088. msgid ""
  4089. "**TLDR**: when updating the playbook and before running it, you'll need "
  4090. "to run `make roles` to make [ansible-"
  4091. "galaxy](https://docs.ansible.com/ansible/latest/cli/ansible-galaxy.html) "
  4092. "download dependency roles (see the [`requirements.yml` "
  4093. "file](requirements.yml)) to the `roles/galaxy` directory. Without this, "
  4094. "the playbook won't work."
  4095. msgstr ""
  4096. #: ../../../CHANGELOG.md:1487
  4097. msgid ""
  4098. "We're in the process of trimming the playbook and making it reuse Ansible"
  4099. " roles."
  4100. msgstr ""
  4101. #: ../../../CHANGELOG.md:1489
  4102. msgid "Starting now, the playbook is composed of 2 types of Ansible roles:"
  4103. msgstr ""
  4104. #: ../../../CHANGELOG.md:1491
  4105. msgid "those that live within the playbook itself (`roles/custom/*`)"
  4106. msgstr ""
  4107. #: ../../../CHANGELOG.md:1493
  4108. msgid ""
  4109. "those downloaded from other sources (using [ansible-"
  4110. "galaxy](https://docs.ansible.com/ansible/latest/cli/ansible-galaxy.html) "
  4111. "to `roles/galaxy`, based on the [`requirements.yml` "
  4112. "file](requirements.yml)). These roles are maintained by us or by other "
  4113. "people from the Ansible community."
  4114. msgstr ""
  4115. #: ../../../CHANGELOG.md:1495
  4116. msgid ""
  4117. "We're doing this for greater code-reuse (across Ansible playbooks, "
  4118. "including our own related playbooks [gitea-docker-ansible-"
  4119. "deploy](https://github.com/spantaleev/gitea-docker-ansible-deploy) and "
  4120. "[nextcloud-docker-ansible-deploy](https://github.com/spantaleev"
  4121. "/nextcloud-docker-ansible-deploy)) and decreased maintenance burden. "
  4122. "Until now, certain features were copy-pasted across playbooks or were "
  4123. "maintained separately in each one, with improvements often falling "
  4124. "behind. We've also tended to do too much by ourselves - installing Docker"
  4125. " on the server from our `matrix-base` role, etc. - something that we'd "
  4126. "rather not do anymore by switching to the "
  4127. "[geerlingguy.docker](https://galaxy.ansible.com/geerlingguy/docker) role."
  4128. msgstr ""
  4129. #: ../../../CHANGELOG.md:1497
  4130. msgid ""
  4131. "Some variable names will change during the transition to having more and "
  4132. "more external (galaxy) roles. There's a new "
  4133. "`custom/matrix_playbook_migration` role added to the playbook which will "
  4134. "tell you about these changes each time you run the playbook."
  4135. msgstr ""
  4136. #: ../../../CHANGELOG.md:1499
  4137. msgid ""
  4138. "**From now on**, every time you update the playbook (well, every time the"
  4139. " `requirements.yml` file changes), it's best to run `make roles` to "
  4140. "update the roles downloaded from other sources. `make roles` is a "
  4141. "shortcut (a `roles` target defined in [`Makefile`](Makefile) and executed"
  4142. " by the [`make`](https://www.gnu.org/software/make/) utility) which "
  4143. "ultimately runs [ansible-"
  4144. "galaxy](https://docs.ansible.com/ansible/latest/cli/ansible-galaxy.html) "
  4145. "to download Ansible roles. If you don't have `make`, you can also "
  4146. "manually run the commands seen in the `Makefile`."
  4147. msgstr ""
  4148. #: ../../../CHANGELOG.md:1502
  4149. msgid "2022-10-14"
  4150. msgstr ""
  4151. #: ../../../CHANGELOG.md:1504
  4152. msgid "synapse-s3-storage-provider support"
  4153. msgstr ""
  4154. #: ../../../CHANGELOG.md:1506
  4155. msgid ""
  4156. "**`synapse-s3-storage-provider` support is very new and still relatively "
  4157. "untested. Using it may cause data loss.**"
  4158. msgstr ""
  4159. #: ../../../CHANGELOG.md:1508
  4160. msgid ""
  4161. "You can now store your Synapse media repository files on Amazon S3 (or "
  4162. "another S3-compatible object store) using [synapse-s3-storage-"
  4163. "provider](https://github.com/matrix-org/synapse-s3-storage-provider) - a "
  4164. "media provider for Synapse (Python module), which should work faster and "
  4165. "more reliably than our previous [Goofys](docs/configuring-"
  4166. "playbook-s3-goofys.md) implementation (Goofys will continue to work)."
  4167. msgstr ""
  4168. #: ../../../CHANGELOG.md:1510
  4169. msgid ""
  4170. "This is not just for initial installations. Users with existing files "
  4171. "(stored in the local filesystem) can also migrate their files to "
  4172. "`synapse-s3-storage-provider`."
  4173. msgstr ""
  4174. #: ../../../CHANGELOG.md:1512
  4175. msgid ""
  4176. "To get started, see our [Storing Synapse media files on Amazon S3 with "
  4177. "synapse-s3-storage-provider](docs/configuring-playbook-synapse-s3"
  4178. "-storage-provider.md) documentation."
  4179. msgstr ""
  4180. #: ../../../CHANGELOG.md:1514
  4181. msgid "Synapse container image customization support"
  4182. msgstr ""
  4183. #: ../../../CHANGELOG.md:1516
  4184. msgid ""
  4185. "We now support customizing the Synapse container image by adding "
  4186. "additional build steps to its "
  4187. "[`Dockerfile`](https://docs.docker.com/engine/reference/builder/)."
  4188. msgstr ""
  4189. #: ../../../CHANGELOG.md:1518
  4190. msgid ""
  4191. "Our [synapse-s3-storage-provider support](#synapse-s3-storage-provider-"
  4192. "support) is actually built on this. When `s3-storage-provider` is "
  4193. "enabled, we automatically add additional build steps to install its "
  4194. "Python module into the Synapse image."
  4195. msgstr ""
  4196. #: ../../../CHANGELOG.md:1520
  4197. msgid ""
  4198. "Besides this kind of auto-added build steps (for components supported by "
  4199. "the playbook), we also let you inject your own custom build steps using "
  4200. "configuration like this:"
  4201. msgstr ""
  4202. #: ../../../CHANGELOG.md:1531
  4203. msgid ""
  4204. "People who have needed to customize Synapse previously had to fork the "
  4205. "git repository, make their changes to the `Dockerfile` there, point the "
  4206. "playbook to the new repository "
  4207. "(`matrix_synapse_container_image_self_build_repo`) and enable self-"
  4208. "building from scratch (`matrix_synapse_container_image_self_build: "
  4209. "true`). This is harder and slower."
  4210. msgstr ""
  4211. #: ../../../CHANGELOG.md:1533
  4212. msgid ""
  4213. "With the new Synapse-customization feature in the playbook, we use the "
  4214. "original upstream (pre-built, if available) Synapse image and only build "
  4215. "on top of it, right on the Matrix server. This is much faster than "
  4216. "building all of Synapse from scratch."
  4217. msgstr ""
  4218. #: ../../../CHANGELOG.md:1536
  4219. msgid "2022-10-02"
  4220. msgstr ""
  4221. #: ../../../CHANGELOG.md:1538
  4222. msgid "matrix-ldap-registration-proxy support"
  4223. msgstr ""
  4224. #: ../../../CHANGELOG.md:1540
  4225. msgid ""
  4226. "Thanks to [@TheOneWithTheBraid](https://github.com/TheOneWithTheBraid), "
  4227. "we now support installing [matrix-ldap-registration-"
  4228. "proxy](https://gitlab.com/activism.international/matrix_ldap_registration_proxy)"
  4229. " - a proxy which handles Matrix registration requests and forwards them "
  4230. "to LDAP."
  4231. msgstr ""
  4232. #: ../../../CHANGELOG.md:1542
  4233. msgid ""
  4234. "See our [Setting up matrix-ldap-registration-proxy](docs/configuring-"
  4235. "playbook-matrix-ldap-registration-proxy.md) documentation to get started."
  4236. msgstr ""
  4237. #: ../../../CHANGELOG.md:1545
  4238. msgid "2022-09-15"
  4239. msgstr ""
  4240. #: ../../../CHANGELOG.md:1547
  4241. msgid ""
  4242. "(Potential Backward Compatibility Break) Major improvements to Synapse "
  4243. "workers"
  4244. msgstr ""
  4245. #: ../../../CHANGELOG.md:1549
  4246. msgid ""
  4247. "People who are interested in running a Synapse worker setup should know "
  4248. "that **our Synapse worker implementation is much more powerful now**:"
  4249. msgstr ""
  4250. #: ../../../CHANGELOG.md:1551
  4251. msgid "we've added support for [Stream writers](#stream-writers-support)"
  4252. msgstr ""
  4253. #: ../../../CHANGELOG.md:1552
  4254. msgid ""
  4255. "we've added support for [multiple federation sender workers](#multiple-"
  4256. "federation-sender-workers-support)"
  4257. msgstr ""
  4258. #: ../../../CHANGELOG.md:1553
  4259. msgid ""
  4260. "we've added support for [multiple pusher workers](#multiple-pusher-"
  4261. "workers-support)"
  4262. msgstr ""
  4263. #: ../../../CHANGELOG.md:1554
  4264. msgid ""
  4265. "we've added support for [running background tasks on a worker"
  4266. "](#background-tasks-can-run-on-a-worker)"
  4267. msgstr ""
  4268. #: ../../../CHANGELOG.md:1555
  4269. msgid ""
  4270. "we've restored support for [`appservice` workers](#appservice-worker-"
  4271. "support-is-back)"
  4272. msgstr ""
  4273. #: ../../../CHANGELOG.md:1556
  4274. msgid ""
  4275. "we've restored support for [`user_dir` workers](#user-directory-worker-"
  4276. "support-is-back)"
  4277. msgstr ""
  4278. #: ../../../CHANGELOG.md:1557
  4279. msgid ""
  4280. "we've made it possible to [reliably use more than 1 `media_repository` "
  4281. "worker](#using-more-than-1-media-repository-worker-is-now-more-reliable)"
  4282. msgstr ""
  4283. #: ../../../CHANGELOG.md:1558
  4284. msgid ""
  4285. "see the [Potential Backward Incompatibilities after these Synapse worker "
  4286. "changes](#potential-backward-incompatibilities-after-these-synapse-"
  4287. "worker-changes)"
  4288. msgstr ""
  4289. #: ../../../CHANGELOG.md:1560
  4290. msgid "Stream writers support"
  4291. msgstr ""
  4292. #: ../../../CHANGELOG.md:1562
  4293. msgid ""
  4294. "From now on, the playbook lets you easily set up various [stream writer "
  4295. "workers](https://matrix-org.github.io/synapse/latest/workers.html#stream-"
  4296. "writers) which can handle different streams (`events` stream; `typing` "
  4297. "URL endpoints, `to_device` URL endpoints, `account_data` URL endpoints, "
  4298. "`receipts` URL endpoints, `presence` URL endpoints). All of this work was"
  4299. " previously handled by the main Synapse process, but can now be offloaded"
  4300. " to stream writer worker processes."
  4301. msgstr ""
  4302. #: ../../../CHANGELOG.md:1564
  4303. msgid ""
  4304. "If you're using `matrix_synapse_workers_preset: one-of-each`, you'll "
  4305. "automatically get 6 additional workers (one for each of the above stream "
  4306. "types). Our `little-federation-helper` preset (meant to be quite minimal "
  4307. "and focusing in improved federation performance) does not include stream "
  4308. "writer workers."
  4309. msgstr ""
  4310. #: ../../../CHANGELOG.md:1566
  4311. msgid ""
  4312. "If you'd like to customize the number of workers we also make that "
  4313. "possible using these variables:"
  4314. msgstr ""
  4315. #: ../../../CHANGELOG.md:1579
  4316. msgid "Multiple federation sender workers support"
  4317. msgstr ""
  4318. #: ../../../CHANGELOG.md:1581
  4319. msgid ""
  4320. "Until now, we only supported a single `federation_sender` worker "
  4321. "(`matrix_synapse_workers_federation_sender_workers_count` could either be"
  4322. " `0` or `1`). From now on, you can have as many as you want to help with "
  4323. "your federation traffic."
  4324. msgstr ""
  4325. #: ../../../CHANGELOG.md:1583
  4326. msgid "Multiple pusher workers support"
  4327. msgstr ""
  4328. #: ../../../CHANGELOG.md:1585
  4329. msgid ""
  4330. "Until now, we only supported a single `pusher` worker "
  4331. "(`matrix_synapse_workers_pusher_workers_count` could either be `0` or "
  4332. "`1`). From now on, you can have as many as you want to help with pushing "
  4333. "notifications out."
  4334. msgstr ""
  4335. #: ../../../CHANGELOG.md:1587
  4336. msgid "Background tasks can run on a worker"
  4337. msgstr ""
  4338. #: ../../../CHANGELOG.md:1589
  4339. msgid ""
  4340. "From now on, you can put [background task processing on a worker](https"
  4341. "://matrix-org.github.io/synapse/latest/workers.html#background-tasks)."
  4342. msgstr ""
  4343. #: ../../../CHANGELOG.md:1591
  4344. msgid ""
  4345. "With `matrix_synapse_workers_preset: one-of-each`, you'll get one "
  4346. "`background` worker automatically. You can also control the `background` "
  4347. "workers count with `matrix_synapse_workers_background_workers_count`. "
  4348. "Only `0` or `1` workers of this type are supported by Synapse."
  4349. msgstr ""
  4350. #: ../../../CHANGELOG.md:1593
  4351. msgid "Appservice worker support is back"
  4352. msgstr ""
  4353. #: ../../../CHANGELOG.md:1595
  4354. msgid ""
  4355. "We previously had an `appservice` worker type, which [Synapse deprecated "
  4356. "in v1.59.0](https://github.com/element-"
  4357. "hq/synapse/blob/v1.59.0/docs/upgrade.md#deprecation-of-the-"
  4358. "synapseappappservice-and-synapseappuser_dir-worker-application-types). So"
  4359. " did we, at the time."
  4360. msgstr ""
  4361. #: ../../../CHANGELOG.md:1597
  4362. msgid ""
  4363. "The new way to implement such workers is by using a `generic_worker` and "
  4364. "dedicating it to the task of talking to Application Services. From now "
  4365. "on, we have support for this."
  4366. msgstr ""
  4367. #: ../../../CHANGELOG.md:1599
  4368. msgid ""
  4369. "With `matrix_synapse_workers_preset: one-of-each`, you'll get one "
  4370. "`appservice` worker automatically. You can also control the `appservice` "
  4371. "workers count with `matrix_synapse_workers_appservice_workers_count`. "
  4372. "Only `0` or `1` workers of this type are supported by Synapse."
  4373. msgstr ""
  4374. #: ../../../CHANGELOG.md:1601
  4375. msgid "User Directory worker support is back"
  4376. msgstr ""
  4377. #: ../../../CHANGELOG.md:1603
  4378. msgid ""
  4379. "We previously had a `user_dir` worker type, which [Synapse deprecated in "
  4380. "v1.59.0](https://github.com/element-"
  4381. "hq/synapse/blob/v1.59.0/docs/upgrade.md#deprecation-of-the-"
  4382. "synapseappappservice-and-synapseappuser_dir-worker-application-types). So"
  4383. " did we, at the time."
  4384. msgstr ""
  4385. #: ../../../CHANGELOG.md:1605
  4386. msgid ""
  4387. "The new way to implement such workers is by using a `generic_worker` and "
  4388. "dedicating it to the task of serving the user directory. From now on, we "
  4389. "have support for this."
  4390. msgstr ""
  4391. #: ../../../CHANGELOG.md:1607
  4392. msgid ""
  4393. "With `matrix_synapse_workers_preset: one-of-each`, you'll get one "
  4394. "`user_dir` worker automatically. You can also control the `user_dir` "
  4395. "workers count with `matrix_synapse_workers_user_dir_workers_count`. Only"
  4396. " `0` or `1` workers of this type are supported by Synapse."
  4397. msgstr ""
  4398. #: ../../../CHANGELOG.md:1609
  4399. msgid "Using more than 1 media repository worker is now more reliable"
  4400. msgstr ""
  4401. #: ../../../CHANGELOG.md:1611
  4402. msgid ""
  4403. "With `matrix_synapse_workers_preset: one-of-each`, we only launch one "
  4404. "`media_repository` worker."
  4405. msgstr ""
  4406. #: ../../../CHANGELOG.md:1613
  4407. msgid ""
  4408. "If you've been configuring "
  4409. "`matrix_synapse_workers_media_repository_workers_count` manually, you may"
  4410. " have increased that to more workers. When multiple media repository "
  4411. "workers are in use, background tasks related to the media repository must"
  4412. " always be configured to run on a single `media_repository` worker via "
  4413. "`media_instance_running_background_jobs`. Until now, we weren't doing "
  4414. "this correctly, but we now are."
  4415. msgstr ""
  4416. #: ../../../CHANGELOG.md:1615
  4417. msgid "Potential Backward Incompatibilities after these Synapse worker changes"
  4418. msgstr ""
  4419. #: ../../../CHANGELOG.md:1617
  4420. msgid "Below we'll discuss **potential backward incompatibilities**."
  4421. msgstr ""
  4422. #: ../../../CHANGELOG.md:1619
  4423. msgid ""
  4424. "**Worker names** (container names, systemd services, worker configuration"
  4425. " files) **have changed**. Workers are now labeled sequentially (e.g. "
  4426. "`matrix-synapse-worker_generic_worker-18111` -> `matrix-synapse-worker-"
  4427. "generic-0`). The playbook will handle these changes automatically."
  4428. msgstr ""
  4429. #: ../../../CHANGELOG.md:1621
  4430. msgid ""
  4431. "Due to increased worker types support above, people who use "
  4432. "`matrix_synapse_workers_preset: one-of-each` should be aware that with "
  4433. "these changes, **the playbook will deploy 9 additional workers** (6 "
  4434. "stream writers, 1 `appservice` worker, 1 `user_dir` worker, 1 background "
  4435. "task worker). This **may increase RAM/CPU usage**, etc. If you find your "
  4436. "server struggling, consider disabling some workers with the appropriate "
  4437. "`matrix_synapse_workers_*_workers_count` variables."
  4438. msgstr ""
  4439. #: ../../../CHANGELOG.md:1623
  4440. msgid ""
  4441. "**Metric endpoints have also changed** "
  4442. "(`/metrics/synapse/worker/generic_worker-18111` -> "
  4443. "`/metrics/synapse/worker/generic-worker-0`). If you're [collecting "
  4444. "metrics to an external Prometheus server](docs/configuring-playbook-"
  4445. "prometheus-grafana.md#collecting-metrics-to-an-external-prometheus-"
  4446. "server), consider revisiting our [Collecting Synapse worker metrics to an"
  4447. " external Prometheus server](docs/configuring-playbook-prometheus-"
  4448. "grafana.md#collecting-synapse-worker-metrics-to-an-external-prometheus-"
  4449. "server) docs and updating your Prometheus configuration. **If you're "
  4450. "collecting metrics to the integrated Prometheus server** (not enabled by "
  4451. "default), **your Prometheus configuration will be updated "
  4452. "automatically**. Old data (from before this change) may stick around "
  4453. "though."
  4454. msgstr ""
  4455. #: ../../../CHANGELOG.md:1625
  4456. msgid ""
  4457. "**the format of `matrix_synapse_workers_enabled_list` has changed**. You "
  4458. "were never advised to use this variable for directly creating workers (we"
  4459. " advise people to control workers using `matrix_synapse_workers_preset` "
  4460. "or by tweaking `matrix_synapse_workers_*_workers_count` variables only), "
  4461. "but some people may have started using the "
  4462. "`matrix_synapse_workers_enabled_list` variable to gain more control over "
  4463. "workers. If you're one of them, you'll need to adjust its value. See "
  4464. "`roles/custom/matrix-synapse/defaults/main.yml` for more information on "
  4465. "the new format. The playbook will also do basic validation and complain "
  4466. "if you got something wrong."
  4467. msgstr ""
  4468. #: ../../../CHANGELOG.md:1628
  4469. msgid "2022-09-09"
  4470. msgstr ""
  4471. #: ../../../CHANGELOG.md:1630
  4472. msgid "Cactus Comments support"
  4473. msgstr ""
  4474. #: ../../../CHANGELOG.md:1632
  4475. msgid ""
  4476. "Thanks to [Julian-Samuel Gebühr (@moan0s)](https://github.com/moan0s), "
  4477. "the playbook can now set up [Cactus Comments](https://cactus.chat) - "
  4478. "federated comment system for the web based on Matrix."
  4479. msgstr ""
  4480. #: ../../../CHANGELOG.md:1634
  4481. msgid ""
  4482. "See our [Setting up Cactus Comments](docs/configuring-playbook-cactus-"
  4483. "comments.md) documentation to get started."
  4484. msgstr ""
  4485. #: ../../../CHANGELOG.md:1637
  4486. msgid "2022-08-23"
  4487. msgstr ""
  4488. #: ../../../CHANGELOG.md:1639
  4489. msgid "Postmoogle email bridge support"
  4490. msgstr ""
  4491. #: ../../../CHANGELOG.md:1641
  4492. msgid ""
  4493. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  4494. "[etke.cc](https://etke.cc/), the playbook can now set up the new "
  4495. "[Postmoogle](https://github.com/etkecc/postmoogle) email bridge. "
  4496. "Postmoogle is like the [email2matrix "
  4497. "bridge](https://github.com/devture/email2matrix) (also [already supported"
  4498. " by the playbook](docs/configuring-playbook-email2matrix.md)), but more "
  4499. "capable and with the intention to soon support *sending* emails, not just"
  4500. " receiving."
  4501. msgstr ""
  4502. #: ../../../CHANGELOG.md:1643
  4503. msgid ""
  4504. "See our [Setting up Postmoogle email bridging](docs/configuring-playbook-"
  4505. "bridge-postmoogle.md) documentation to get started."
  4506. msgstr ""
  4507. #: ../../../CHANGELOG.md:1646
  4508. msgid "2022-08-10"
  4509. msgstr ""
  4510. #: ../../../CHANGELOG.md:1648
  4511. msgid "mautrix-whatsapp default configuration changes"
  4512. msgstr ""
  4513. #: ../../../CHANGELOG.md:1650
  4514. msgid ""
  4515. "In [Pull Request #2012](https://github.com/spantaleev/matrix-docker-"
  4516. "ansible-deploy/pull/2012), we've made some changes to the default "
  4517. "configuration used by the `mautrix-whatsapp` bridge."
  4518. msgstr ""
  4519. #: ../../../CHANGELOG.md:1652
  4520. msgid ""
  4521. "If you're using this bridge, you should look into this PR and see if the "
  4522. "new configuration suits you. If not, you can always change individual "
  4523. "preferences in your `vars.yml` file."
  4524. msgstr ""
  4525. #: ../../../CHANGELOG.md:1654
  4526. msgid ""
  4527. "Most notably, spaces support has been enabled by default. The bridge will"
  4528. " now group rooms into a Matrix space. **If you've already bridged to "
  4529. "Whatsapp** prior to this update, you will need to send `!wa sync space` "
  4530. "to the bridge bot to make it create the space and put your existing rooms"
  4531. " into it."
  4532. msgstr ""
  4533. #: ../../../CHANGELOG.md:1657
  4534. msgid "2022-08-09"
  4535. msgstr ""
  4536. #: ../../../CHANGELOG.md:1659
  4537. msgid "Conduit support"
  4538. msgstr ""
  4539. #: ../../../CHANGELOG.md:1661
  4540. msgid ""
  4541. "Thanks to [Charles Wright](https://github.com/cvwright), we now have "
  4542. "optional experimental [Conduit](https://conduit.rs) homeserver support "
  4543. "for new installations. This comes as a follow-up to the playbook getting "
  4544. "[Dendrite support](#dendrite-support) earlier this year."
  4545. msgstr ""
  4546. #: ../../../CHANGELOG.md:1663
  4547. msgid ""
  4548. "Existing Synapse or Dendrite installations do **not** need to be updated."
  4549. " **Synapse is still the default homeserver implementation** installed by "
  4550. "the playbook."
  4551. msgstr ""
  4552. #: ../../../CHANGELOG.md:1665
  4553. msgid ""
  4554. "To try out Conduit, we recommend that you **use a new server** and the "
  4555. "following `vars.yml` configuration:"
  4556. msgstr ""
  4557. #: ../../../CHANGELOG.md:1671
  4558. msgid ""
  4559. "**The homeserver implementation of an existing server cannot be changed**"
  4560. " (e.g. from Synapse or Dendrite to Conduit) without data loss."
  4561. msgstr ""
  4562. #: ../../../CHANGELOG.md:1674
  4563. msgid "2022-07-29"
  4564. msgstr ""
  4565. #: ../../../CHANGELOG.md:1676
  4566. msgid "mautrix-discord support"
  4567. msgstr ""
  4568. #: ../../../CHANGELOG.md:1678
  4569. msgid ""
  4570. "Thanks to [MdotAmaan](https://github.com/MdotAmaan)'s efforts, the "
  4571. "playbook now supports bridging to [Discord](https://discordapp.com/) via "
  4572. "the [mautrix-discord](https://mau.dev/mautrix/discord) bridge. See our "
  4573. "[Setting up Mautrix Discord bridging](docs/configuring-playbook-bridge-"
  4574. "mautrix-discord.md) documentation page for getting started."
  4575. msgstr ""
  4576. #: ../../../CHANGELOG.md:1680
  4577. msgid ""
  4578. "**Note**: this is a new Discord bridge. The playbook still retains "
  4579. "Discord bridging via [matrix-appservice-discord](docs/configuring-"
  4580. "playbook-bridge-appservice-discord.md) and [mx-puppet-discord](docs"
  4581. "/configuring-playbook-bridge-mx-puppet-discord.md). You're free to use "
  4582. "the bridge that serves you better, or even all three of them (for "
  4583. "different users and use-cases)."
  4584. msgstr ""
  4585. #: ../../../CHANGELOG.md:1683
  4586. msgid "2022-07-27"
  4587. msgstr ""
  4588. #: ../../../CHANGELOG.md:1685
  4589. msgid "matrix-appservice-kakaotalk support"
  4590. msgstr ""
  4591. #: ../../../CHANGELOG.md:1687
  4592. msgid ""
  4593. "The playbook now supports bridging to "
  4594. "[Kakaotalk](https://www.kakaocorp.com/page/service/service/KakaoTalk?lang=ENG)"
  4595. " via [matrix-appservice-kakaotalk](https://src.miscworks.net/fair/matrix-"
  4596. "appservice-kakaotalk) - a bridge based on [node-"
  4597. "kakao](https://github.com/storycraft/node-kakao) (now unmaintained) and "
  4598. "some [mautrix-facebook](https://github.com/mautrix/facebook) code. Thanks"
  4599. " to [hnarjis](https://github.com/hnarjis) for helping us add support for "
  4600. "this!"
  4601. msgstr ""
  4602. #: ../../../CHANGELOG.md:1689
  4603. msgid ""
  4604. "See our [Setting up Appservice Kakaotalk bridging](docs/configuring-"
  4605. "playbook-bridge-appservice-kakaotalk.md) documentation to get started."
  4606. msgstr ""
  4607. #: ../../../CHANGELOG.md:1692
  4608. msgid "2022-07-20"
  4609. msgstr ""
  4610. #: ../../../CHANGELOG.md:1694
  4611. msgid "maubot support"
  4612. msgstr ""
  4613. #: ../../../CHANGELOG.md:1696
  4614. msgid ""
  4615. "Thanks to [Stuart Mumford (@Cadair)](https://github.com/cadair) for "
  4616. "starting ([PR #373](https://github.com/spantaleev/matrix-docker-ansible-"
  4617. "deploy/pull/373) and [PR #622](https://github.com/spantaleev/matrix-"
  4618. "docker-ansible-deploy/pull/622)) and to [Julian-Samuel Gebühr "
  4619. "(@moan0s)](https://github.com/moan0s) for finishing up (in [PR "
  4620. "#1894](https://github.com/spantaleev/matrix-docker-ansible-"
  4621. "deploy/pull/1894)), the playbook can now help you set up "
  4622. "[maubot](https://github.com/maubot/maubot) - a plugin-based Matrix bot "
  4623. "system."
  4624. msgstr ""
  4625. #: ../../../CHANGELOG.md:1698
  4626. msgid ""
  4627. "See our [Setting up maubot](docs/configuring-playbook-bot-maubot.md) "
  4628. "documentation to get started."
  4629. msgstr ""
  4630. #: ../../../CHANGELOG.md:1701
  4631. msgid "2022-07-14"
  4632. msgstr ""
  4633. #: ../../../CHANGELOG.md:1703
  4634. msgid "mx-puppet-skype removal"
  4635. msgstr ""
  4636. #: ../../../CHANGELOG.md:1705
  4637. msgid ""
  4638. "The playbook no longer includes the [mx-puppet-"
  4639. "skype](https://github.com/Sorunome/mx-puppet-skype) bridge, because it "
  4640. "has been broken and unmaintained for a long time. Users that have "
  4641. "`matrix_mx_puppet_skype_enabled` in their configuration files will "
  4642. "encounter an error when running the playbook until they remove references"
  4643. " to this bridge from their configuration."
  4644. msgstr ""
  4645. #: ../../../CHANGELOG.md:1707
  4646. msgid ""
  4647. "To completely clean up your server from `mx-puppet-skype`'s presence on "
  4648. "it:"
  4649. msgstr ""
  4650. #: ../../../CHANGELOG.md:1709
  4651. msgid ""
  4652. "ensure your Ansible configuration (`vars.yml` file) no longer contains "
  4653. "`matrix_mx_puppet_skype_*` references"
  4654. msgstr ""
  4655. #: ../../../CHANGELOG.md:1710
  4656. msgid ""
  4657. "stop and disable the systemd service (run `systemctl disable --now "
  4658. "matrix-mx-puppet-skype` on the server)"
  4659. msgstr ""
  4660. #: ../../../CHANGELOG.md:1711
  4661. msgid ""
  4662. "delete the systemd service (run `rm /etc/systemd/system/matrix-mx-puppet-"
  4663. "skype.service` on the server)"
  4664. msgstr ""
  4665. #: ../../../CHANGELOG.md:1712
  4666. msgid ""
  4667. "delete `/matrix/mx-puppet-skype` (run `rm -rf /matrix/mx-puppet-skype` on"
  4668. " the server)"
  4669. msgstr ""
  4670. #: ../../../CHANGELOG.md:1713
  4671. msgid ""
  4672. "drop the `matrix_mx_puppet_skype` database (run `/usr/local/bin/matrix-"
  4673. "postgres-cli` on the server, and execute the `DROP DATABASE "
  4674. "matrix_mx_puppet_skype;` query there)"
  4675. msgstr ""
  4676. #: ../../../CHANGELOG.md:1715
  4677. msgid ""
  4678. "If you still need bridging to [Skype](https://www.skype.com/), consider "
  4679. "switching to [go-skype-bridge](https://github.com/kelaresg/go-skype-"
  4680. "bridge) instead. See [Setting up Go Skype Bridge bridging](docs"
  4681. "/configuring-playbook-bridge-go-skype-bridge.md)."
  4682. msgstr ""
  4683. #: ../../../CHANGELOG.md:1717
  4684. msgid ""
  4685. "If you think this is a mistake and `mx-puppet-skype` works for you (or "
  4686. "you get it to work somehow), let us know and we may reconsider this "
  4687. "removal."
  4688. msgstr ""
  4689. #: ../../../CHANGELOG.md:1719
  4690. msgid "signald (0.19.0+) upgrade requires data migration"
  4691. msgstr ""
  4692. #: ../../../CHANGELOG.md:1721
  4693. msgid ""
  4694. "In [Pull Request #1921](https://github.com/spantaleev/matrix-docker-"
  4695. "ansible-deploy/pull/1921) we upgraded [signald](https://signald.org/) "
  4696. "(used by the mautrix-signal bridge) from `v0.18.5` to `v0.20.0`."
  4697. msgstr ""
  4698. #: ../../../CHANGELOG.md:1723
  4699. msgid ""
  4700. "Back in the [`v0.19.0` released of "
  4701. "signald](https://gitlab.com/signald/signald/-/blob/main/releases/0.19.0.md)"
  4702. " (which we skipped and migrated straight to `v0.20.0`), a new `--migrate-"
  4703. "data` command had been added that migrates avatars, group images, "
  4704. "attachments, etc., into the database (those were previously stored in the"
  4705. " filesystem)."
  4706. msgstr ""
  4707. #: ../../../CHANGELOG.md:1725
  4708. msgid ""
  4709. "If you've been using the mautrix-signal bridge for a while, you may have "
  4710. "files stored in the local filesystem, which will need to be upgraded."
  4711. msgstr ""
  4712. #: ../../../CHANGELOG.md:1727
  4713. msgid ""
  4714. "We attempt to do this data migration automatically every time Signald "
  4715. "starts (`matrix-mautrix-signal-daemon.service`) using a `ExecStartPre` "
  4716. "systemd unit definition."
  4717. msgstr ""
  4718. #: ../../../CHANGELOG.md:1729
  4719. msgid ""
  4720. "Keep an eye on your Signal bridge and let us know (in our [support "
  4721. "room](README.md#support) or in [Pull Request "
  4722. "#1921](https://github.com/spantaleev/matrix-docker-ansible-"
  4723. "deploy/pull/1921)) if you experience any trouble!"
  4724. msgstr ""
  4725. #: ../../../CHANGELOG.md:1732
  4726. msgid "2022-07-05"
  4727. msgstr ""
  4728. #: ../../../CHANGELOG.md:1734
  4729. msgid "Ntfy push notifications support"
  4730. msgstr ""
  4731. #: ../../../CHANGELOG.md:1736
  4732. msgid ""
  4733. "Thanks to [Julian Foad](https://matrix.to/#/@julian:foad.me.uk), the "
  4734. "playbook can now install a [ntfy](https://ntfy.sh/) push notifications "
  4735. "server for you."
  4736. msgstr ""
  4737. #: ../../../CHANGELOG.md:1738
  4738. msgid ""
  4739. "See our [Setting up the ntfy push notifications server](docs/configuring-"
  4740. "playbook-ntfy.md) documentation to get started."
  4741. msgstr ""
  4742. #: ../../../CHANGELOG.md:1741
  4743. msgid "2022-06-23"
  4744. msgstr ""
  4745. #: ../../../CHANGELOG.md:1743
  4746. msgid "(Potential Backward Compatibility Break) Changes around metrics collection"
  4747. msgstr ""
  4748. #: ../../../CHANGELOG.md:1745
  4749. msgid ""
  4750. "**TLDR**: we've made extensive **changes to metrics exposure/collection, "
  4751. "which concern people using an external Prometheus server**. If you don't "
  4752. "know what that is, you don't need to read below."
  4753. msgstr ""
  4754. #: ../../../CHANGELOG.md:1747
  4755. msgid ""
  4756. "**Why do major changes to metrics**? Because various services were "
  4757. "exposing metrics in different, hacky, ways. Synapse was exposing metrics "
  4758. "at `/_synapse/metrics` and `/_synapse-worker-…/metrics` on the "
  4759. "`matrix.example.com`. The Hookshot role was **repurposing** the Granana "
  4760. "web UI domain (`stats.example.com`) for exposing its metrics on "
  4761. "`stats.example.com/hookshot/metrics`, while protecting these routes using"
  4762. " Basic Authentication **normally used for Synapse** "
  4763. "(`/_synapse/metrics`). Node-exporter and Postgres-exporter roles were "
  4764. "advising for more `stats.example.com` usage in manual ways. Each role was"
  4765. " doing things differently and mixing variables from other roles. Each "
  4766. "metrics endpoint was ending up in a different place, protected by who "
  4767. "knows what Basic Authentication credentials (if protected at all)."
  4768. msgstr ""
  4769. #: ../../../CHANGELOG.md:1749
  4770. msgid ""
  4771. "**The solution**: a completely revamped way to expose metrics to an "
  4772. "external Prometheus server. We are **introducing new "
  4773. "`https://matrix.example.com/metrics/*` endpoints**, where various "
  4774. "services *can* expose their metrics, for collection by external "
  4775. "Prometheus servers. To enable the `/metrics/*` endpoints, use "
  4776. "`matrix_nginx_proxy_proxy_matrix_metrics_enabled: true`. There's also a "
  4777. "way to protect access using [Basic "
  4778. "Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication)."
  4779. " See the `matrix-nginx-proxy` role or our [Collecting metrics to an "
  4780. "external Prometheus server](docs/configuring-playbook-prometheus-"
  4781. "grafana.md#collecting-metrics-to-an-external-prometheus-server) "
  4782. "documentation for additional variables around "
  4783. "`matrix_nginx_proxy_proxy_matrix_metrics_enabled`."
  4784. msgstr ""
  4785. #: ../../../CHANGELOG.md:1751
  4786. msgid ""
  4787. "**If you are using the [Hookshot bridge](docs/configuring-playbook-"
  4788. "bridge-hookshot.md)**, you may find that:"
  4789. msgstr ""
  4790. #: ../../../CHANGELOG.md:1752
  4791. msgid "**Metrics may not be enabled by default anymore**:"
  4792. msgstr ""
  4793. #: ../../../CHANGELOG.md:1753
  4794. msgid ""
  4795. "If Prometheus is enabled (`prometheus_enabled: true`), then Hookshot "
  4796. "metrics will be enabled automatically (`matrix_hookshot_metrics_enabled: "
  4797. "true`). These metrics will be collected from the local (in-container) "
  4798. "Prometheus over the container network."
  4799. msgstr ""
  4800. #: ../../../CHANGELOG.md:1754
  4801. msgid ""
  4802. "**If Prometheus is not enabled** (you are either not using Prometheus or "
  4803. "are using an external one), **Hookshot metrics will not be enabled by "
  4804. "default anymore**. Feel free to enable them by setting "
  4805. "`matrix_hookshot_metrics_enabled: true`. Also, see below."
  4806. msgstr ""
  4807. #: ../../../CHANGELOG.md:1755
  4808. msgid ""
  4809. "When metrics are meant to be **consumed by an external Prometheus "
  4810. "server**, `matrix_hookshot_metrics_proxying_enabled` needs to be set to "
  4811. "`true`, so that metrics would be exposed (proxied) \"publicly\" on "
  4812. "`https://matrix.example.com/metrics/hookshot`. To make use of this, "
  4813. "you'll also need to enable the new `https://matrix.example.com/metrics/*`"
  4814. " endpoints mentioned above, using "
  4815. "`matrix_nginx_proxy_proxy_matrix_metrics_enabled`. Learn more in our "
  4816. "[Collecting metrics to an external Prometheus server](docs/configuring-"
  4817. "playbook-prometheus-grafana.md#collecting-metrics-to-an-external-"
  4818. "prometheus-server) documentation."
  4819. msgstr ""
  4820. #: ../../../CHANGELOG.md:1756
  4821. msgid ""
  4822. "**We've changed the URL we're exposing Hookshot metrics at** for external"
  4823. " Prometheus servers. Until now, you were advised to consume Hookshot "
  4824. "metrics from `https://stats.example.com/hookshot/metrics` (working in "
  4825. "conjunction with `matrix_nginx_proxy_proxy_synapse_metrics`). From now "
  4826. "on, **this no longer works**. As described above, you need to start "
  4827. "consuming metrics from `https://matrix.example.com/metrics/hookshot`."
  4828. msgstr ""
  4829. #: ../../../CHANGELOG.md:1758
  4830. msgid ""
  4831. "**If you're using node-exporter** "
  4832. "(`matrix_prometheus_node_exporter_enabled: true`) and would like to "
  4833. "collect its metrics from an external Prometheus server, see "
  4834. "`matrix_prometheus_node_exporter_metrics_proxying_enabled` described in "
  4835. "our [Collecting metrics to an external Prometheus server](docs"
  4836. "/configuring-playbook-prometheus-grafana.md#collecting-metrics-to-an-"
  4837. "external-prometheus-server) documentation. You will be able to collect "
  4838. "its metrics from `https://matrix.example.com/metrics/node-exporter`."
  4839. msgstr ""
  4840. #: ../../../CHANGELOG.md:1760
  4841. msgid ""
  4842. "**If you're using [postgres-exporter](docs/configuring-playbook-"
  4843. "prometheus-postgres.md)** (`prometheus_postgres_exporter_enabled: true`) "
  4844. "and would like to collect its metrics from an external Prometheus server,"
  4845. " see "
  4846. "`matrix_prometheus_services_proxy_connect_prometheus_postgres_exporter_metrics_proxying_enabled`"
  4847. " described in our [Collecting metrics to an external Prometheus "
  4848. "server](docs/configuring-playbook-prometheus-grafana.md#collecting-"
  4849. "metrics-to-an-external-prometheus-server) documentation. You will be able"
  4850. " to collect its metrics from `https://matrix.example.com/metrics"
  4851. "/postgres-exporter`."
  4852. msgstr ""
  4853. #: ../../../CHANGELOG.md:1762
  4854. msgid ""
  4855. "**If you're using Synapse** and would like to collect its metrics from an"
  4856. " external Prometheus server, you may find that:"
  4857. msgstr ""
  4858. #: ../../../CHANGELOG.md:1764
  4859. msgid ""
  4860. "Exposing metrics is now done using "
  4861. "`matrix_synapse_metrics_proxying_enabled`, not "
  4862. "`matrix_nginx_proxy_proxy_synapse_metrics: true`. You may still need to "
  4863. "enable metrics using `matrix_synapse_metrics_enabled: true` before "
  4864. "exposing them."
  4865. msgstr ""
  4866. #: ../../../CHANGELOG.md:1765
  4867. msgid ""
  4868. "Protecting metrics endpoints using [Basic "
  4869. "Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication)"
  4870. " is now done in another way. See our [Collecting metrics to an external "
  4871. "Prometheus server](docs/configuring-playbook-prometheus-grafana.md"
  4872. "#collecting-metrics-to-an-external-prometheus-server) documentation"
  4873. msgstr ""
  4874. #: ../../../CHANGELOG.md:1766
  4875. msgid ""
  4876. "If Synapse metrics are exposed, they will be made available at "
  4877. "`https://matrix.example.com/metrics/synapse/main-process` or "
  4878. "`https://matrix.example.com/metrics/synapse/worker/TYPE-ID` (when workers"
  4879. " are enabled), not at `https://matrix.example.com/_synapse/metrics` and "
  4880. "`https://matrix.example.com/_synapse-worker-…/metrics`"
  4881. msgstr ""
  4882. #: ../../../CHANGELOG.md:1767
  4883. msgid ""
  4884. "The playbook still generates an `external_prometheus.yml.example` sample "
  4885. "file for scraping Synapse from Prometheus as described in [Collecting "
  4886. "Synapse worker metrics to an external Prometheus server](docs"
  4887. "/configuring-playbook-prometheus-grafana.md#collecting-synapse-worker-"
  4888. "metrics-to-an-external-prometheus-server), but it's now saved under "
  4889. "`/matrix/synapse` (not `/matrix`)."
  4890. msgstr ""
  4891. #: ../../../CHANGELOG.md:1769
  4892. msgid ""
  4893. "**If you where already using a external Prometheus server** before this "
  4894. "change, and you gave a hashed version of the password as a variable, the "
  4895. "playbook will now take care of hashing the password for you. Thus, you "
  4896. "need to provide the non-hashed version now."
  4897. msgstr ""
  4898. #: ../../../CHANGELOG.md:1771
  4899. msgid "2022-06-13"
  4900. msgstr ""
  4901. #: ../../../CHANGELOG.md:1773
  4902. msgid "go-skype-bridge bridging support"
  4903. msgstr ""
  4904. #: ../../../CHANGELOG.md:1775
  4905. msgid ""
  4906. "Thanks to [CyberShadow](https://github.com/CyberShadow), the playbook can"
  4907. " now install the [go-skype-bridge](https://github.com/kelaresg/go-skype-"
  4908. "bridge) bridge for bridging Matrix to [Skype](https://www.skype.com/)."
  4909. msgstr ""
  4910. #: ../../../CHANGELOG.md:1777
  4911. msgid ""
  4912. "See our [Setting up Go Skype Bridge bridging](docs/configuring-playbook-"
  4913. "bridge-go-skype-bridge.md) documentation to get started."
  4914. msgstr ""
  4915. #: ../../../CHANGELOG.md:1779
  4916. msgid ""
  4917. "The playbook has supported [mx-puppet-skype](https://github.com/Sorunome"
  4918. "/mx-puppet-skype) bridging (see [Setting up MX Puppet Skype "
  4919. "bridging](docs/configuring-playbook-bridge-mx-puppet-skype.md)) since "
  4920. "[2020-04-09](#2020-04-09), but `mx-puppet-skype` is reportedly broken."
  4921. msgstr ""
  4922. #: ../../../CHANGELOG.md:1782
  4923. msgid "2022-06-09"
  4924. msgstr ""
  4925. #: ../../../CHANGELOG.md:1784
  4926. msgid "Running Ansible in a container can now happen on the Matrix server itself"
  4927. msgstr ""
  4928. #: ../../../CHANGELOG.md:1786
  4929. msgid ""
  4930. "If you're tired of being on an old and problematic Ansible version, you "
  4931. "can now run [run Ansible in a container on the Matrix server "
  4932. "itself](docs/ansible.md#running-ansible-in-a-container-on-the-matrix-"
  4933. "server-itself)."
  4934. msgstr ""
  4935. #: ../../../CHANGELOG.md:1789
  4936. msgid "2022-05-31"
  4937. msgstr ""
  4938. #: ../../../CHANGELOG.md:1791
  4939. msgid "Synapse v1.60 upgrade may cause trouble and require manual intervention"
  4940. msgstr ""
  4941. #: ../../../CHANGELOG.md:1793
  4942. msgid ""
  4943. "Synapse v1.60 will try to add a new unique index to `state_group_edges` "
  4944. "upon startup and could fail if your database is corrupted."
  4945. msgstr ""
  4946. #: ../../../CHANGELOG.md:1795
  4947. msgid ""
  4948. "We haven't observed this problem yet, but [the Synapse v1.60.0 upgrade "
  4949. "notes](https://github.com/element-"
  4950. "hq/synapse/blob/v1.60.0/docs/upgrade.md#adding-a-new-unique-index-to-"
  4951. "state_group_edges-could-fail-if-your-database-is-corrupted) mention it, "
  4952. "so we're giving you a heads up here in case you're unlucky."
  4953. msgstr ""
  4954. #: ../../../CHANGELOG.md:1797
  4955. msgid ""
  4956. "**If Synapse fails to start** after your next playbook run, you'll need "
  4957. "to:"
  4958. msgstr ""
  4959. #: ../../../CHANGELOG.md:1799
  4960. msgid "SSH into the Matrix server"
  4961. msgstr ""
  4962. #: ../../../CHANGELOG.md:1800
  4963. msgid "launch `/usr/local/bin/matrix-postgres-cli`"
  4964. msgstr ""
  4965. #: ../../../CHANGELOG.md:1801
  4966. msgid "switch to the `synapse` database: `\\c synapse`"
  4967. msgstr ""
  4968. #: ../../../CHANGELOG.md:1802
  4969. msgid "run the following SQL query:"
  4970. msgstr ""
  4971. #: ../../../CHANGELOG.md:1821
  4972. msgid ""
  4973. "You could then restart services: `ansible-playbook -i inventory/hosts "
  4974. "setup.yml --tags=start`"
  4975. msgstr ""
  4976. #: ../../../CHANGELOG.md:1824
  4977. msgid "2022-04-25"
  4978. msgstr ""
  4979. #: ../../../CHANGELOG.md:1826
  4980. msgid "Buscarron bot support"
  4981. msgstr ""
  4982. #: ../../../CHANGELOG.md:1828
  4983. msgid ""
  4984. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  4985. "[etke.cc](https://etke.cc/), the playbook can now set up [the Buscarron "
  4986. "bot](https://github.com/etkecc/buscarron). It's a bot you can use to send"
  4987. " any form (HTTP POST, HTML) to a (encrypted) Matrix room"
  4988. msgstr ""
  4989. #: ../../../CHANGELOG.md:1830
  4990. msgid ""
  4991. "See our [Setting up Buscarron](docs/configuring-playbook-bot-"
  4992. "buscarron.md) documentation to get started."
  4993. msgstr ""
  4994. #: ../../../CHANGELOG.md:1833
  4995. msgid "2022-04-21"
  4996. msgstr ""
  4997. #: ../../../CHANGELOG.md:1835
  4998. msgid "matrix-registration-bot support"
  4999. msgstr ""
  5000. #: ../../../CHANGELOG.md:1837
  5001. msgid ""
  5002. "Thanks to [Julian-Samuel Gebühr (@moan0s)](https://github.com/moan0s), "
  5003. "the playbook can now help you set up [matrix-registration-"
  5004. "bot](https://github.com/moan0s/matrix-registration-bot) - a bot that is "
  5005. "used to create and manage registration tokens for a Matrix server."
  5006. msgstr ""
  5007. #: ../../../CHANGELOG.md:1839
  5008. msgid ""
  5009. "See our [Setting up matrix-registration-bot](docs/configuring-playbook-"
  5010. "bot-matrix-registration-bot.md) documentation to get started."
  5011. msgstr ""
  5012. #: ../../../CHANGELOG.md:1842
  5013. msgid "2022-04-19"
  5014. msgstr ""
  5015. #: ../../../CHANGELOG.md:1844
  5016. msgid "BorgBackup support"
  5017. msgstr ""
  5018. #: ../../../CHANGELOG.md:1846
  5019. msgid ""
  5020. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  5021. "[etke.cc](https://etke.cc/), the playbook can now set up "
  5022. "[Borg](https://www.borgbackup.org/) backups with "
  5023. "[borgmatic](https://torsion.org/borgmatic/) of your Matrix server."
  5024. msgstr ""
  5025. #: ../../../CHANGELOG.md:1848
  5026. msgid ""
  5027. "See our [Setting up BorgBackup](docs/configuring-playbook-backup-borg.md)"
  5028. " documentation to get started."
  5029. msgstr ""
  5030. #: ../../../CHANGELOG.md:1850
  5031. msgid ""
  5032. "(Compatibility Break) Upgrading to Synapse v1.57 on setups using workers "
  5033. "may require manual action"
  5034. msgstr ""
  5035. #: ../../../CHANGELOG.md:1852
  5036. msgid ""
  5037. "If you're running a worker setup for Synapse "
  5038. "(`matrix_synapse_workers_enabled: true`), the [Synapse v1.57 upgrade "
  5039. "notes](https://github.com/element-"
  5040. "hq/synapse/blob/v1.57.0rc1/docs/upgrade.md#changes-to-database-schema-"
  5041. "for-application-services) say that you may need to take special care when"
  5042. " upgrading:"
  5043. msgstr ""
  5044. #: ../../../CHANGELOG.md:1854
  5045. msgid ""
  5046. "Synapse v1.57.0 includes a change to the way transaction IDs are managed "
  5047. "for application services. If your deployment uses a dedicated worker for "
  5048. "application service traffic, **it must be stopped** when the database is "
  5049. "upgraded (which normally happens when the main process is upgraded), to "
  5050. "ensure the change is made safely without any risk of reusing transaction "
  5051. "IDs."
  5052. msgstr ""
  5053. #: ../../../CHANGELOG.md:1856
  5054. msgid ""
  5055. "If you're not running an `appservice` worker "
  5056. "(`matrix_synapse_workers_preset: little-federation-helper` or "
  5057. "`matrix_synapse_workers_appservice_workers_count: 0`), you are probably "
  5058. "safe to upgrade as per normal, without taking any special care."
  5059. msgstr ""
  5060. #: ../../../CHANGELOG.md:1858
  5061. msgid ""
  5062. "If you are running a setup with an `appservice` worker, or otherwise want"
  5063. " to be on the safe side, we recommend the following upgrade path:"
  5064. msgstr ""
  5065. #: ../../../CHANGELOG.md:1860
  5066. msgid "Pull the latest playbook changes"
  5067. msgstr ""
  5068. #: ../../../CHANGELOG.md:1861
  5069. msgid ""
  5070. "Stop all services (`ansible-playbook -i inventory/hosts setup.yml "
  5071. "--tags=stop`)"
  5072. msgstr ""
  5073. #: ../../../CHANGELOG.md:1862
  5074. msgid ""
  5075. "Re-run the playbook (`ansible-playbook -i inventory/hosts setup.yml "
  5076. "--tags=setup-all`)"
  5077. msgstr ""
  5078. #: ../../../CHANGELOG.md:1863
  5079. msgid "Start Postgres (`systemctl start matrix-postgres` on the server)"
  5080. msgstr ""
  5081. #: ../../../CHANGELOG.md:1864
  5082. msgid ""
  5083. "Start the main Synapse process (`systemctl start matrix-synapse` on the "
  5084. "server)"
  5085. msgstr ""
  5086. #: ../../../CHANGELOG.md:1865
  5087. msgid ""
  5088. "Wait a while so that Synapse can start and complete the database "
  5089. "migrations. You can use `journalctl -fu matrix-synapse` on the server to "
  5090. "get a clue. Waiting a few minutes should also be enough."
  5091. msgstr ""
  5092. #: ../../../CHANGELOG.md:1866
  5093. msgid ""
  5094. "It should now be safe to start all other services. `ansible-playbook -i "
  5095. "inventory/hosts setup.yml --tags=start` will do it for you"
  5096. msgstr ""
  5097. #: ../../../CHANGELOG.md:1869
  5098. msgid "2022-04-14"
  5099. msgstr ""
  5100. #: ../../../CHANGELOG.md:1871
  5101. msgid ""
  5102. "(Compatibility Break) Changes to `docker-src` permissions necessitating "
  5103. "manual action"
  5104. msgstr ""
  5105. #: ../../../CHANGELOG.md:1873
  5106. msgid ""
  5107. "Users who build container images from source will need to manually "
  5108. "correct file permissions of some directories on the server."
  5109. msgstr ""
  5110. #: ../../../CHANGELOG.md:1875
  5111. msgid ""
  5112. "When self-building, the playbook used to `git clone` repositories (into "
  5113. "`/matrix/SERVICE/docker-src`) using the `root` user, but now uses "
  5114. "`matrix` instead to work around [the following issue with git "
  5115. "2.35.2](https://github.com/spantaleev/matrix-docker-ansible-"
  5116. "deploy/issues/1749)."
  5117. msgstr ""
  5118. #: ../../../CHANGELOG.md:1877
  5119. msgid ""
  5120. "If you're on a non-`amd64` architecture (that is, you're overriding "
  5121. "`matrix_architecture` in your `vars.yml` file) or you have enabled self-"
  5122. "building for some service (e.g. `matrix_*_self_build: true`), you're "
  5123. "certainly building some container images from source and have `docker-"
  5124. "src` directories with mixed permissions lying around in various "
  5125. "`/matrix/SERVICE` directories."
  5126. msgstr ""
  5127. #: ../../../CHANGELOG.md:1879
  5128. msgid ""
  5129. "The playbook *could* correct these permissions automatically, but that "
  5130. "requires additional Ansible tasks in some ~45 different places - "
  5131. "something that takes considerable effort. So we ask users observing "
  5132. "errors related to `docker-src` directories to correct the problem "
  5133. "manually by **running this command on the Matrix server** (which deletes "
  5134. "all `/matrix/*/docker-src` directories): `find /matrix -maxdepth 2 -name "
  5135. "'docker-src' | xargs rm -rf`"
  5136. msgstr ""
  5137. #: ../../../CHANGELOG.md:1882
  5138. msgid "2022-03-17"
  5139. msgstr ""
  5140. #: ../../../CHANGELOG.md:1884
  5141. msgid "(Compatibility Break) ma1sd identity server no longer installed by default"
  5142. msgstr ""
  5143. #: ../../../CHANGELOG.md:1886
  5144. msgid ""
  5145. "The playbook no longer installs the "
  5146. "[ma1sd](https://github.com/ma1uta/ma1sd) identity server by default. The "
  5147. "next time you run the playbook, ma1sd will be uninstalled from your "
  5148. "server, unless you explicitly enable the ma1sd service (see how below)."
  5149. msgstr ""
  5150. #: ../../../CHANGELOG.md:1888
  5151. msgid ""
  5152. "The main reason we used to install ma1sd by default in the past was to "
  5153. "prevent Element clients from talking to the `matrix.org` / `vector.im` "
  5154. "identity servers, by forcing it to talk to our own self-hosted (but "
  5155. "otherwise useless) identity server instead, thus preventing contact list "
  5156. "leaks."
  5157. msgstr ""
  5158. #: ../../../CHANGELOG.md:1890
  5159. msgid ""
  5160. "Since Element clients no longer default to using a public identity server"
  5161. " if another one is not provided, we can stop installing ma1sd."
  5162. msgstr ""
  5163. #: ../../../CHANGELOG.md:1892
  5164. msgid ""
  5165. "If you need to install the ma1sd identity server for some reason, you can"
  5166. " explicitly enable it by adding this to your `vars.yml` file:"
  5167. msgstr ""
  5168. #: ../../../CHANGELOG.md:1899
  5169. msgid "2022-02-12"
  5170. msgstr ""
  5171. #: ../../../CHANGELOG.md:1901
  5172. msgid "matrix_encryption_disabler support"
  5173. msgstr ""
  5174. #: ../../../CHANGELOG.md:1903
  5175. msgid ""
  5176. "We now support installing the "
  5177. "[matrix_encryption_disabler](https://github.com/digitalentity/matrix_encryption_disabler)"
  5178. " Synapse module, which lets you prevent End-to-End-Encryption from being "
  5179. "enabled by users on your homeserver. The popular opinion is that this is "
  5180. "dangerous and shouldn't be done, but there are valid use cases for "
  5181. "disabling encryption discussed [here](https://github.com/matrix-"
  5182. "org/synapse/issues/4401)."
  5183. msgstr ""
  5184. #: ../../../CHANGELOG.md:1905
  5185. msgid ""
  5186. "To enable this module (and prevent encryption from being used on your "
  5187. "homserver), add `matrix_synapse_ext_encryption_disabler_enabled: true` to"
  5188. " your configuration. This module provides further customization. Check "
  5189. "its other configuration settings (and defaults) in `roles/custom/matrix-"
  5190. "synapse/defaults/main.yml`."
  5191. msgstr ""
  5192. #: ../../../CHANGELOG.md:1908
  5193. msgid "2022-02-01"
  5194. msgstr ""
  5195. #: ../../../CHANGELOG.md:1910
  5196. msgid "matrix-hookshot bridging support"
  5197. msgstr ""
  5198. #: ../../../CHANGELOG.md:1912
  5199. msgid ""
  5200. "Thanks to [HarHarLinks](https://github.com/HarHarLinks), the playbook can"
  5201. " now install the [matrix-hookshot](https://github.com/matrix-org/matrix-"
  5202. "hookshot) bridge for bridging Matrix to multiple project management "
  5203. "services, such as GitHub, GitLab and JIRA. See our [Setting up matrix-"
  5204. "hookshot](docs/configuring-playbook-bridge-hookshot.md) documentation to "
  5205. "get started."
  5206. msgstr ""
  5207. #: ../../../CHANGELOG.md:1915
  5208. msgid "2022-01-31"
  5209. msgstr ""
  5210. #: ../../../CHANGELOG.md:1917
  5211. msgid "ARM support for matrix-corporal"
  5212. msgstr ""
  5213. #: ../../../CHANGELOG.md:1919
  5214. msgid ""
  5215. "[matrix-corporal](https://github.com/devture/matrix-corporal) (as of "
  5216. "version `2.2.3`) is now published to Docker Hub (see [devture/matrix-"
  5217. "corporal](https://hub.docker.com/r/devture/matrix-corporal)) as a multi-"
  5218. "arch container image with support for all these platforms: `linux/amd64`,"
  5219. " `linux/arm64/v8` and `linux/arm/v7`. The playbook no longer resorts to "
  5220. "self-building matrix-corporal on these ARM architectures."
  5221. msgstr ""
  5222. #: ../../../CHANGELOG.md:1922
  5223. msgid "2022-01-07"
  5224. msgstr ""
  5225. #: ../../../CHANGELOG.md:1924
  5226. msgid "Dendrite support"
  5227. msgstr ""
  5228. #: ../../../CHANGELOG.md:1926
  5229. msgid ""
  5230. "**TLDR**: We now have optional experimental [Dendrite](https://github.com"
  5231. "/matrix-org/dendrite) homeserver support for new installations. "
  5232. "**Existing (Synapse) installations need to be updated**, because some "
  5233. "internals changed. See [Adapting the configuration for existing Synapse "
  5234. "installations](#adapting-the-configuration-for-existing-synapse-"
  5235. "installations)."
  5236. msgstr ""
  5237. #: ../../../CHANGELOG.md:1928
  5238. msgid ""
  5239. "[Jip J. Dekker](https://github.com/Dekker1) did the [initial "
  5240. "work](https://github.com/spantaleev/matrix-docker-ansible-"
  5241. "deploy/pull/818) of adding [Dendrite](https://github.com/matrix-"
  5242. "org/dendrite) support to the playbook back in January 2021. Lots of work "
  5243. "(and time) later, Dendrite support is finally ready for testing."
  5244. msgstr ""
  5245. #: ../../../CHANGELOG.md:1930
  5246. msgid "We believe that 2022 will be the year of the non-Synapse Matrix server!"
  5247. msgstr ""
  5248. #: ../../../CHANGELOG.md:1932
  5249. msgid ""
  5250. "The playbook was previously quite [Synapse](https://github.com/element-"
  5251. "hq/synapse)-centric, but can now accommodate multiple homeserver "
  5252. "implementations. Only one homeserver implementation can be active "
  5253. "(installed) at a given time."
  5254. msgstr ""
  5255. #: ../../../CHANGELOG.md:1934
  5256. msgid ""
  5257. "**Synapse is still the default homeserver implementation** installed by "
  5258. "the playbook. A new variable (`matrix_homeserver_implementation`) "
  5259. "controls which server implementation is enabled (`synapse` or `dendrite` "
  5260. "at the given moment)."
  5261. msgstr ""
  5262. #: ../../../CHANGELOG.md:1936
  5263. msgid "Adapting the configuration for existing Synapse installations"
  5264. msgstr ""
  5265. #: ../../../CHANGELOG.md:1938
  5266. msgid ""
  5267. "Because the playbook is not so Synapse-centric anymore, a small "
  5268. "configuration change is necessary for existing installations to bring "
  5269. "them up to date."
  5270. msgstr ""
  5271. #: ../../../CHANGELOG.md:1940
  5272. msgid ""
  5273. "The `vars.yml` file for **existing installations will need to be "
  5274. "updated** by adding this **additional configuration**:"
  5275. msgstr ""
  5276. #: ../../../CHANGELOG.md:1952
  5277. msgid "Trying out Dendrite"
  5278. msgstr ""
  5279. #: ../../../CHANGELOG.md:1954
  5280. msgid ""
  5281. "Finally, **to try out Dendrite**, we recommend that you **use a new "
  5282. "server** and the following addition to your `vars.yml` configuration:"
  5283. msgstr ""
  5284. #: ../../../CHANGELOG.md:1960
  5285. msgid ""
  5286. "**The homeserver implementation of an existing server cannot be changed**"
  5287. " (e.g. from Synapse to Dendrite) without data loss."
  5288. msgstr ""
  5289. #: ../../../CHANGELOG.md:1962
  5290. msgid ""
  5291. "We're excited to gain support for other homeserver implementations, like "
  5292. "[Conduit](https://conduit.rs/), etc!"
  5293. msgstr ""
  5294. #: ../../../CHANGELOG.md:1964
  5295. msgid "Honoroit bot support"
  5296. msgstr ""
  5297. #: ../../../CHANGELOG.md:1966
  5298. msgid ""
  5299. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  5300. "[etke.cc](https://etke.cc/), the playbook can now help you set up "
  5301. "[Honoroit](https://github.com/etkecc/honoroit) - a helpdesk bot."
  5302. msgstr ""
  5303. #: ../../../CHANGELOG.md:1968
  5304. msgid ""
  5305. "See our [Setting up Honoroit](docs/configuring-playbook-bot-honoroit.md) "
  5306. "documentation to get started."
  5307. msgstr ""
  5308. #: ../../../CHANGELOG.md:1971
  5309. msgid "2022-01-06"
  5310. msgstr ""
  5311. #: ../../../CHANGELOG.md:1973
  5312. msgid "Cinny support"
  5313. msgstr ""
  5314. #: ../../../CHANGELOG.md:1975
  5315. msgid ""
  5316. "Thanks to [Aine](https://gitlab.com/etke.cc) of "
  5317. "[etke.cc](https://etke.cc/), the playbook now supports "
  5318. "[Cinny](https://cinny.in/) - a new simple, elegant and secure Matrix "
  5319. "client."
  5320. msgstr ""
  5321. #: ../../../CHANGELOG.md:1977
  5322. msgid ""
  5323. "By default, we still install Element Web. Still, people who'd like to try"
  5324. " Cinny out can now install it via the playbook."
  5325. msgstr ""
  5326. #: ../../../CHANGELOG.md:1979
  5327. msgid ""
  5328. "Additional details are available in [Setting up Cinny](docs/configuring-"
  5329. "playbook-client-cinny.md)."
  5330. msgstr ""
  5331. #: ../../../CHANGELOG.md:1982
  5332. msgid "2021-12-22"
  5333. msgstr ""
  5334. #: ../../../CHANGELOG.md:1984
  5335. msgid "Twitter bridging support via mautrix-twitter"
  5336. msgstr ""
  5337. #: ../../../CHANGELOG.md:1986
  5338. msgid ""
  5339. "Thanks to [Matthew Cengia](https://github.com/mattcen) and [Shreyas "
  5340. "Ajjarapu](https://github.com/shreyasajj), besides [mx-puppet-"
  5341. "twitter](docs/configuring-playbook-bridge-mx-puppet-twitter.md), bridging"
  5342. " to [Twitter](https://twitter.com/) can now also happen with [mautrix-"
  5343. "twitter](docs/configuring-playbook-bridge-mautrix-twitter.md)."
  5344. msgstr ""
  5345. #: ../../../CHANGELOG.md:1989
  5346. msgid "2021-12-14"
  5347. msgstr ""
  5348. #: ../../../CHANGELOG.md:1991
  5349. msgid ""
  5350. "(Security) Users of the Signal bridge may wish to upgrade it to work "
  5351. "around log4j vulnerability"
  5352. msgstr ""
  5353. #: ../../../CHANGELOG.md:1993
  5354. msgid ""
  5355. "Recently, a security vulnerability affecting the Java logging package "
  5356. "`log4j` [has been discovered](https://www.huntress.com/blog/rapid-"
  5357. "response-critical-rce-vulnerability-is-affecting-java). Software that "
  5358. "uses this Java package is potentially vulnerable."
  5359. msgstr ""
  5360. #: ../../../CHANGELOG.md:1995
  5361. msgid ""
  5362. "One such piece of software that is part of the playbook is the [mautrix-"
  5363. "signal bridge](./docs/configuring-playbook-bridge-mautrix-signal.md), "
  5364. "which [has been patched already](https://github.com/spantaleev/matrix-"
  5365. "docker-ansible-deploy/pull/1452). If you're running this bridge, you may "
  5366. "wish to [upgrade](./docs/maintenance-upgrading-services.md)."
  5367. msgstr ""
  5368. #: ../../../CHANGELOG.md:1998
  5369. msgid "2021-11-11"
  5370. msgstr ""
  5371. #: ../../../CHANGELOG.md:2000
  5372. msgid "Dropped support for Postgres v9.6"
  5373. msgstr ""
  5374. #: ../../../CHANGELOG.md:2002
  5375. msgid ""
  5376. "Postgres v9.6 reached its end of life today, so the playbook will refuse "
  5377. "to run for you if you're still on that version."
  5378. msgstr ""
  5379. #: ../../../CHANGELOG.md:2004
  5380. msgid ""
  5381. "Synapse still supports v9.6 (for now), but we're retiring support for it "
  5382. "early, to avoid having to maintain support for so many Postgres versions."
  5383. " Users that are still on Postgres v9.6 can easily [upgrade Postgres](docs"
  5384. "/maintenance-postgres.md#upgrading-postgresql) via the playbook."
  5385. msgstr ""
  5386. #: ../../../CHANGELOG.md:2007
  5387. msgid "2021-10-23"
  5388. msgstr ""
  5389. #: ../../../CHANGELOG.md:2009
  5390. msgid "Hangouts bridge no longer updated, superseded by a Googlechat bridge"
  5391. msgstr ""
  5392. #: ../../../CHANGELOG.md:2011
  5393. msgid ""
  5394. "The mautrix-hangouts bridge is no longer receiving updates upstream and "
  5395. "is likely to stop working in the future. We still retain support for this"
  5396. " bridge in the playbook, but you're encouraged to switch away from it."
  5397. msgstr ""
  5398. #: ../../../CHANGELOG.md:2013
  5399. msgid ""
  5400. "There's a new [mautrix-googlechat](https://github.com/mautrix/googlechat)"
  5401. " bridge that you can [install using the playbook](docs/configuring-"
  5402. "playbook-bridge-mautrix-googlechat.md). Your **Hangouts bridge data will "
  5403. "not be migrated**, however. You need to start fresh with the new bridge."
  5404. msgstr ""
  5405. #: ../../../CHANGELOG.md:2016
  5406. msgid "2021-08-23"
  5407. msgstr ""
  5408. #: ../../../CHANGELOG.md:2018
  5409. msgid "LinkedIn bridging support via beeper-linkedin"
  5410. msgstr ""
  5411. #: ../../../CHANGELOG.md:2020
  5412. msgid ""
  5413. "Thanks to [Alexandar Mechev](https://github.com/apmechev), the playbook "
  5414. "can now install the [beeper-linkedin](https://gitlab.com/beeper/linkedin)"
  5415. " bridge for bridging to [LinkedIn](https://www.linkedin.com/) Messaging."
  5416. msgstr ""
  5417. #: ../../../CHANGELOG.md:2022
  5418. msgid ""
  5419. "This brings the total number of bridges supported by the playbook up to "
  5420. "20. See all supported bridges [here](docs/configuring-playbook.md"
  5421. "#bridging-other-networks)."
  5422. msgstr ""
  5423. #: ../../../CHANGELOG.md:2024
  5424. msgid ""
  5425. "To get started with bridging to LinkedIn, see [Setting up Beeper LinkedIn"
  5426. " bridging](docs/configuring-playbook-bridge-beeper-linkedin.md)."
  5427. msgstr ""
  5428. #: ../../../CHANGELOG.md:2027
  5429. msgid "2021-08-20"
  5430. msgstr ""
  5431. #: ../../../CHANGELOG.md:2029
  5432. msgid "Sygnal upgraded - ARM support and no longer requires a database"
  5433. msgstr ""
  5434. #: ../../../CHANGELOG.md:2031
  5435. msgid ""
  5436. "The [Sygnal](docs/configuring-playbook-sygnal.md) push gateway has been "
  5437. "upgraded from `v0.9.0` to `v0.10.1`."
  5438. msgstr ""
  5439. #: ../../../CHANGELOG.md:2033
  5440. msgid ""
  5441. "This is an optional component for the playbook, so most of our users "
  5442. "wouldn't care about this announcement."
  5443. msgstr ""
  5444. #: ../../../CHANGELOG.md:2035
  5445. msgid ""
  5446. "Since this feels like a relatively big (and untested, as of yet) Sygnal "
  5447. "change, we're putting up this changelog entry."
  5448. msgstr ""
  5449. #: ../../../CHANGELOG.md:2037
  5450. msgid ""
  5451. "The new version is also available for the ARM architecture. It also no "
  5452. "longer requires a database anymore. If you need to downgrade to the "
  5453. "previous version, changing `matrix_sygnal_version` or "
  5454. "`matrix_sygnal_docker_image` will not be enough, as we've removed the "
  5455. "`database` configuration completely. You'd need to switch to an earlier "
  5456. "playbook commit."
  5457. msgstr ""
  5458. #: ../../../CHANGELOG.md:2040
  5459. msgid "2021-05-21"
  5460. msgstr ""
  5461. #: ../../../CHANGELOG.md:2042
  5462. msgid "Hydrogen support"
  5463. msgstr ""
  5464. #: ../../../CHANGELOG.md:2044
  5465. msgid ""
  5466. "Thanks to [Aaron Raimist](https://github.com/aaronraimist), the playbook "
  5467. "now supports [Hydrogen](https://github.com/vector-im/hydrogen-web) - a "
  5468. "new lightweight Matrix client with legacy and mobile browser support."
  5469. msgstr ""
  5470. #: ../../../CHANGELOG.md:2046
  5471. msgid ""
  5472. "By default, we still install Element Web, as Hydrogen is still not fully-"
  5473. "featured. Still, people who'd like to try Hydrogen out can now install it"
  5474. " via the playbook."
  5475. msgstr ""
  5476. #: ../../../CHANGELOG.md:2048
  5477. msgid ""
  5478. "Additional details are available in [Setting up Hydrogen](docs"
  5479. "/configuring-playbook-client-hydrogen.md)."
  5480. msgstr ""
  5481. #: ../../../CHANGELOG.md:2051
  5482. msgid "2021-05-19"
  5483. msgstr ""
  5484. #: ../../../CHANGELOG.md:2053
  5485. msgid "Heisenbridge support"
  5486. msgstr ""
  5487. #: ../../../CHANGELOG.md:2055
  5488. msgid ""
  5489. "Thanks to [Toni Spets (hifi)](https://github.com/hifi), the playbook now "
  5490. "supports bridging to "
  5491. "[IRC](https://en.wikipedia.org/wiki/Internet_Relay_Chat) using yet "
  5492. "another bridge (besides matrix-appservice-irc), called "
  5493. "[Heisenbridge](https://github.com/hifi/heisenbridge)."
  5494. msgstr ""
  5495. #: ../../../CHANGELOG.md:2057
  5496. msgid ""
  5497. "Additional details are available in [Setting up Heisenbridge bouncer-"
  5498. "style IRC bridging](docs/configuring-playbook-bridge-heisenbridge.md)."
  5499. msgstr ""
  5500. #: ../../../CHANGELOG.md:2060
  5501. msgid "2021-04-16"
  5502. msgstr ""
  5503. #: ../../../CHANGELOG.md:2062
  5504. msgid "Disabling TLSv1 and TLSv1.1 for Coturn"
  5505. msgstr ""
  5506. #: ../../../CHANGELOG.md:2064
  5507. msgid ""
  5508. "To improve security, we've [removed TLSv1 and TLSv1.1 "
  5509. "support](https://github.com/spantaleev/matrix-docker-ansible-"
  5510. "deploy/pull/999) from our default "
  5511. "[Coturn](https://github.com/coturn/coturn) configuration."
  5512. msgstr ""
  5513. #: ../../../CHANGELOG.md:2066
  5514. msgid ""
  5515. "If you need to support old clients, you can re-enable both (or whichever "
  5516. "one you need) with the following configuration:"
  5517. msgstr ""
  5518. #: ../../../CHANGELOG.md:2074
  5519. msgid "2021-04-05"
  5520. msgstr ""
  5521. #: ../../../CHANGELOG.md:2076
  5522. msgid "Automated local Postgres backup support"
  5523. msgstr ""
  5524. #: ../../../CHANGELOG.md:2078
  5525. msgid ""
  5526. "Thanks to [foxcris](https://github.com/foxcris), the playbook can now "
  5527. "make automated local Postgres backups on a fixed schedule using [docker-"
  5528. "postgres-backup-local](https://github.com/prodrigestivill/docker-"
  5529. "postgres-backup-local)."
  5530. msgstr ""
  5531. #: ../../../CHANGELOG.md:2080
  5532. msgid ""
  5533. "Additional details are available in [Setting up postgres backup](docs"
  5534. "/configuring-playbook-postgres-backup.md)."
  5535. msgstr ""
  5536. #: ../../../CHANGELOG.md:2083
  5537. msgid "2021-04-03"
  5538. msgstr ""
  5539. #: ../../../CHANGELOG.md:2085
  5540. msgid "Mjolnir moderation tool (bot) support"
  5541. msgstr ""
  5542. #: ../../../CHANGELOG.md:2087
  5543. msgid ""
  5544. "Thanks to [Aaron Raimist](https://github.com/aaronraimist), the playbook "
  5545. "can now install and configure the [Mjolnir](https://github.com/matrix-"
  5546. "org/mjolnir) moderation tool (bot)."
  5547. msgstr ""
  5548. #: ../../../CHANGELOG.md:2089
  5549. msgid ""
  5550. "Additional details are available in [Setting up Mjolnir](docs"
  5551. "/configuring-playbook-bot-mjolnir.md)."
  5552. msgstr ""
  5553. #: ../../../CHANGELOG.md:2092
  5554. msgid "2021-03-20"
  5555. msgstr ""
  5556. #: ../../../CHANGELOG.md:2094
  5557. msgid "Sygnal push gateway support"
  5558. msgstr ""
  5559. #: ../../../CHANGELOG.md:2096
  5560. msgid ""
  5561. "The playbook can now install the [Sygnal](https://github.com/matrix-"
  5562. "org/sygnal) push gateway for you."
  5563. msgstr ""
  5564. #: ../../../CHANGELOG.md:2098
  5565. msgid ""
  5566. "This is only useful to people who develop/build their own Matrix client "
  5567. "applications."
  5568. msgstr ""
  5569. #: ../../../CHANGELOG.md:2100
  5570. msgid ""
  5571. "Additional details are available in our [Setting up the Sygnal push "
  5572. "gateway](docs/configuring-playbook-sygnal.md) docs."
  5573. msgstr ""
  5574. #: ../../../CHANGELOG.md:2103
  5575. msgid "2021-03-16"
  5576. msgstr ""
  5577. #: ../../../CHANGELOG.md:2105
  5578. msgid "Go-NEB support"
  5579. msgstr ""
  5580. #: ../../../CHANGELOG.md:2107
  5581. msgid ""
  5582. "Thanks to [Zir0h](https://github.com/Zir0h), the playbook can now install"
  5583. " and configure the [Go-NEB](https://github.com/matrix-org/go-neb) bot."
  5584. msgstr ""
  5585. #: ../../../CHANGELOG.md:2109
  5586. msgid ""
  5587. "Additional details are available in [Setting up Go-NEB](docs/configuring-"
  5588. "playbook-bot-go-neb.md)."
  5589. msgstr ""
  5590. #: ../../../CHANGELOG.md:2112
  5591. msgid "2021-02-19"
  5592. msgstr ""
  5593. #: ../../../CHANGELOG.md:2114
  5594. msgid "GroupMe bridging support via mx-puppet-groupme"
  5595. msgstr ""
  5596. #: ../../../CHANGELOG.md:2116
  5597. msgid ""
  5598. "Thanks to [Cody Neiman](https://github.com/xangelix), the playbook can "
  5599. "now install the [mx-puppet-groupme](https://gitlab.com/robintown/mx-"
  5600. "puppet-groupme) bridge for bridging to [GroupMe](https://groupme.com)."
  5601. msgstr ""
  5602. #: ../../../CHANGELOG.md:2118
  5603. msgid ""
  5604. "This brings the total number of bridges supported by the playbook up to "
  5605. "18. See all supported bridges [here](docs/configuring-playbook.md"
  5606. "#bridging-other-networks)."
  5607. msgstr ""
  5608. #: ../../../CHANGELOG.md:2120
  5609. msgid ""
  5610. "To get started, follow our [Setting up MX Puppet GroupMe](docs"
  5611. "/configuring-playbook-bridge-mx-puppet-groupme.md) docs."
  5612. msgstr ""
  5613. #: ../../../CHANGELOG.md:2122
  5614. msgid "Mautrix Instagram bridging support"
  5615. msgstr ""
  5616. #: ../../../CHANGELOG.md:2124
  5617. msgid ""
  5618. "The playbook now supports bridging with "
  5619. "[Instagram](https://www.instagram.com/) by installing the [mautrix-"
  5620. "instagram](https://github.com/tulir/mautrix-instagram) bridge. This "
  5621. "playbook functionality is available thanks to "
  5622. "[@MarcProe](https://github.com/MarcProe)."
  5623. msgstr ""
  5624. #: ../../../CHANGELOG.md:2126
  5625. msgid ""
  5626. "Additional details are available in [Setting up Mautrix Instagram "
  5627. "bridging](docs/configuring-playbook-bridge-mautrix-instagram.md)."
  5628. msgstr ""
  5629. #: ../../../CHANGELOG.md:2128
  5630. msgid "Synapse workers support"
  5631. msgstr ""
  5632. #: ../../../CHANGELOG.md:2130
  5633. msgid ""
  5634. "After [lots and lots of work](https://github.com/spantaleev/matrix-"
  5635. "docker-ansible-deploy/pull/456) (done over many months by [Marcel "
  5636. "Partap](https://github.com/eMPee584), [Max "
  5637. "Klenk](https://github.com/maxklenk), a few others from the [Technical "
  5638. "University of Dresden, Germany](https://tu-dresden.de/) and various other"
  5639. " contributors), support for Synapse workers has finally landed."
  5640. msgstr ""
  5641. #: ../../../CHANGELOG.md:2132
  5642. msgid ""
  5643. "Having support for workers makes the playbook suitable for larger "
  5644. "homeserver deployments."
  5645. msgstr ""
  5646. #: ../../../CHANGELOG.md:2134
  5647. msgid ""
  5648. "Our setup is not yet perfect (we don't support all types of workers; "
  5649. "scaling some of them (like `pusher`, `federation_sender`) beyond a single"
  5650. " instance is not yet supported). Still, it's a great start and can "
  5651. "already power homeservers with thousands of users, like the [Matrix "
  5652. "deployment at TU Dresden](https://doc.matrix.tu-dresden.de/en/) discussed"
  5653. " in [Matrix Live S06E09 - TU Dresden on their Matrix "
  5654. "deployment](https://www.youtube.com/watch?v=UHJX2pmT2gk)."
  5655. msgstr ""
  5656. #: ../../../CHANGELOG.md:2136
  5657. msgid ""
  5658. "By default, workers are disabled and Synapse runs as a single process "
  5659. "(homeservers don't necessarily need the complexity and increased memory "
  5660. "requirements of running a worker-based setup)."
  5661. msgstr ""
  5662. #: ../../../CHANGELOG.md:2138
  5663. msgid ""
  5664. "To enable Synapse workers, follow our [Load balancing with workers](docs"
  5665. "/configuring-playbook-synapse.md#load-balancing-with-workers) "
  5666. "documentation."
  5667. msgstr ""
  5668. #: ../../../CHANGELOG.md:2141
  5669. msgid "2021-02-12"
  5670. msgstr ""
  5671. #: ../../../CHANGELOG.md:2143
  5672. msgid ""
  5673. "(Potential Breaking Change) Monitoring/metrics support using Prometheus "
  5674. "and Grafana"
  5675. msgstr ""
  5676. #: ../../../CHANGELOG.md:2145
  5677. msgid ""
  5678. "Thanks to [@Peetz0r](https://github.com/Peetz0r), the playbook can now "
  5679. "install a bunch of tools for monitoring your Matrix server: the "
  5680. "[Prometheus](https://prometheus.io) time-series database server, the "
  5681. "Prometheus [node-exporter](https://prometheus.io/docs/guides/node-"
  5682. "exporter/) host metrics exporter, and the [Grafana](https://grafana.com/)"
  5683. " web UI."
  5684. msgstr ""
  5685. #: ../../../CHANGELOG.md:2147
  5686. msgid ""
  5687. "To get get these installed, follow our [Enabling metrics and graphs "
  5688. "(Prometheus, Grafana) for your Matrix server](docs/configuring-playbook-"
  5689. "prometheus-grafana.md) docs page."
  5690. msgstr ""
  5691. #: ../../../CHANGELOG.md:2149
  5692. msgid ""
  5693. "This update comes with a **potential breaking change** for people who "
  5694. "were already exposing Synapse metrics (for consumption via another "
  5695. "Prometheus installation). From now on, `matrix_synapse_metrics_enabled: "
  5696. "true` no longer exposes metrics publicly via matrix-nginx-proxy (at "
  5697. "`https://matrix.example.com/_synapse/metrics`). To do so, you'd need to "
  5698. "explicitly set `matrix_nginx_proxy_proxy_synapse_metrics: true`."
  5699. msgstr ""
  5700. #: ../../../CHANGELOG.md:2152
  5701. msgid "2021-01-31"
  5702. msgstr ""
  5703. #: ../../../CHANGELOG.md:2154
  5704. msgid "Etherpad support"
  5705. msgstr ""
  5706. #: ../../../CHANGELOG.md:2156
  5707. msgid ""
  5708. "Thanks to [@pushytoxin](https://github.com/pushytoxin), the playbook can "
  5709. "now install the [Etherpad](https://etherpad.org) realtime collaborative "
  5710. "text editor. It can be used in a [Jitsi](https://jitsi.org/) audio/video "
  5711. "call or integrated as a widget into Matrix chat rooms via the "
  5712. "[Dimension](https://dimension.t2bot.io) integration manager."
  5713. msgstr ""
  5714. #: ../../../CHANGELOG.md:2158
  5715. msgid ""
  5716. "To get it installed, follow [our Etherpad docs page](docs/configuring-"
  5717. "playbook-etherpad.md)."
  5718. msgstr ""
  5719. #: ../../../CHANGELOG.md:2161
  5720. msgid "2021-01-22"
  5721. msgstr ""
  5722. #: ../../../CHANGELOG.md:2163
  5723. msgid "(Breaking Change) Postgres changes that require manual intervention"
  5724. msgstr ""
  5725. #: ../../../CHANGELOG.md:2165
  5726. msgid ""
  5727. "We've made a lot of changes to our Postgres setup and some manual action "
  5728. "is required (described below). Sorry about the hassle."
  5729. msgstr ""
  5730. #: ../../../CHANGELOG.md:2167
  5731. msgid ""
  5732. "**TLDR**: people running an [external Postgres server](docs/configuring-"
  5733. "playbook-external-postgres.md) don't need to change anything for now. "
  5734. "Everyone else (the common/default case) is affected and manual "
  5735. "intervention is required."
  5736. msgstr ""
  5737. #: ../../../CHANGELOG.md:2169
  5738. msgid "Why?"
  5739. msgstr ""
  5740. #: ../../../CHANGELOG.md:2171
  5741. msgid ""
  5742. "we had a default Postgres password (`matrix_postgres_connection_password:"
  5743. " synapse-password`), which we think is **not ideal for security "
  5744. "anymore**. We now ask you to generate/provide a strong password yourself."
  5745. " Postgres is normally not exposed outside the container network, making "
  5746. "it relatively secure, but still:"
  5747. msgstr ""
  5748. #: ../../../CHANGELOG.md:2172
  5749. msgid ""
  5750. "by tweaking the configuration, you may end up intentionally or "
  5751. "unintentionally exposing your Postgres server to the local network (or "
  5752. "even publicly), while still using the default default credentials "
  5753. "(`synapse` + `synapse-password`)"
  5754. msgstr ""
  5755. #: ../../../CHANGELOG.md:2173
  5756. msgid ""
  5757. "we can't be sure we trust all these services (bridges, etc). Some of them"
  5758. " may try to talk to or attack `matrix-postgres` using the default "
  5759. "credentials (`synapse` + `synapse-password`)"
  5760. msgstr ""
  5761. #: ../../../CHANGELOG.md:2174
  5762. msgid ""
  5763. "you may have other containers running on the same Docker network, which "
  5764. "may try to talk to or attack `matrix-postgres` using the default "
  5765. "credentials (`synapse` + `synapse-password`)"
  5766. msgstr ""
  5767. #: ../../../CHANGELOG.md:2175
  5768. msgid ""
  5769. "our Postgres usage **was overly-focused on Synapse** (default username of"
  5770. " `synapse` and default/main database of `homeserver`). Additional "
  5771. "homeserver options are likely coming in the future "
  5772. "([Dendrite](https://matrix.org/docs/projects/server/dendrite), "
  5773. "[Conduit](https://matrix.org/docs/projects/server/conduit), [The "
  5774. "Construct](https://matrix.org/docs/projects/server/construct)), so being "
  5775. "too focused on `matrix-synapse` is not great. From now on, Synapse is "
  5776. "just another component of this playbook, which happens to have an "
  5777. "*additional database* (called `synapse`) on the Postgres server."
  5778. msgstr ""
  5779. #: ../../../CHANGELOG.md:2176
  5780. msgid ""
  5781. "we try to reorganize things a bit, to make the playbook even friendlier "
  5782. "to people running an [external Postgres server](docs/configuring-"
  5783. "playbook-external-postgres.md). Work on this will proceed in the future."
  5784. msgstr ""
  5785. #: ../../../CHANGELOG.md:2178
  5786. msgid ""
  5787. "So, this is some **effort to improve security** and to **prepare for a "
  5788. "brighter future of having more homeserver options** than just Synapse."
  5789. msgstr ""
  5790. #: ../../../CHANGELOG.md:2180
  5791. msgid "What has really changed?"
  5792. msgstr ""
  5793. #: ../../../CHANGELOG.md:2182
  5794. msgid ""
  5795. "the default superuser Postgres username is now `matrix` (used to be "
  5796. "`synapse`)"
  5797. msgstr ""
  5798. #: ../../../CHANGELOG.md:2183
  5799. msgid "the default Postgres database is now `matrix` (used to be `homeserver`)"
  5800. msgstr ""
  5801. #: ../../../CHANGELOG.md:2184
  5802. msgid ""
  5803. "Synapse's database is now `synapse` (used to be `homeserver`). This is "
  5804. "now just another \"additional database\" that the playbook manages for "
  5805. "you"
  5806. msgstr ""
  5807. #: ../../../CHANGELOG.md:2185
  5808. msgid ""
  5809. "Synapse's user called `synapse` is just a regular user that can only use "
  5810. "the `synapse` database (not a superuser anymore)"
  5811. msgstr ""
  5812. #: ../../../CHANGELOG.md:2187
  5813. msgid "What do I do if I'm using the integrated Postgres server (default)?"
  5814. msgstr ""
  5815. #: ../../../CHANGELOG.md:2189
  5816. msgid ""
  5817. "By default, the playbook runs an integrated Postgres server for you in a "
  5818. "container (`matrix-postgres`). Unless you've explicitly configured an "
  5819. "[external Postgres server](docs/configuring-playbook-external-"
  5820. "postgres.md), these steps are meant for you."
  5821. msgstr ""
  5822. #: ../../../CHANGELOG.md:2191
  5823. msgid ""
  5824. "To migrate to the new setup, expect a few minutes of downtime, while you "
  5825. "follow these steps:"
  5826. msgstr ""
  5827. #: ../../../CHANGELOG.md:2193
  5828. msgid ""
  5829. "We believe the steps below are safe and you won't encounter any data "
  5830. "loss, but consider [making a Postgres backup](docs/maintenance-"
  5831. "postgres.md#backing-up-postgresql) anyway. If you've never backed up "
  5832. "Postgres, now would be a good time to try it."
  5833. msgstr ""
  5834. #: ../../../CHANGELOG.md:2195
  5835. msgid ""
  5836. "Generate a strong password to be used for your superuser Postgres user "
  5837. "(called `matrix`). You can use `pwgen -s 64 1` to generate it, or some "
  5838. "other tool. The **maximum length** for a Postgres password is 100 bytes "
  5839. "(characters). Don't go crazy!"
  5840. msgstr ""
  5841. #: ../../../CHANGELOG.md:2197
  5842. msgid ""
  5843. "Update your playbook's `inventory/host_vars/matrix.example.com/vars.yml` "
  5844. "file, adding a line like this:"
  5845. msgstr ""
  5846. #: ../../../CHANGELOG.md:2202 ../../../CHANGELOG.md:2214
  5847. msgid ""
  5848. ".. where `YOUR_POSTGRES_PASSWORD_HERE` is to be replaced with the "
  5849. "password you generated during step #2."
  5850. msgstr ""
  5851. #: ../../../CHANGELOG.md:2204
  5852. msgid ""
  5853. "Stop all services: `ansible-playbook -i inventory/hosts setup.yml "
  5854. "--tags=stop`"
  5855. msgstr ""
  5856. #: ../../../CHANGELOG.md:2205
  5857. msgid "Log in to the server via SSH. The next commands will be performed there."
  5858. msgstr ""
  5859. #: ../../../CHANGELOG.md:2206
  5860. msgid "Start the Postgres database server: `systemctl start matrix-postgres`"
  5861. msgstr ""
  5862. #: ../../../CHANGELOG.md:2207
  5863. msgid "Open a Postgres shell: `/usr/local/bin/matrix-postgres-cli`"
  5864. msgstr ""
  5865. #: ../../../CHANGELOG.md:2208
  5866. msgid ""
  5867. "Execute the following query, while making sure to **change the password "
  5868. "inside** (**don't forget the ending `;`**):"
  5869. msgstr ""
  5870. #: ../../../CHANGELOG.md:2216
  5871. msgid ""
  5872. "Execute the following queries as you see them (no modifications "
  5873. "necessary, so you can just **paste them all at once**):"
  5874. msgstr ""
  5875. #: ../../../CHANGELOG.md:2234
  5876. msgid "You may need to press *Enter* after pasting the lines above."
  5877. msgstr ""
  5878. #: ../../../CHANGELOG.md:2236
  5879. msgid ""
  5880. "Re-run the playbook normally: `ansible-playbook -i inventory/hosts "
  5881. "setup.yml --tags=setup-all,start`"
  5882. msgstr ""
  5883. #: ../../../CHANGELOG.md:2238
  5884. msgid "What do I do if I'm using an external Postgres server?"
  5885. msgstr ""
  5886. #: ../../../CHANGELOG.md:2240
  5887. msgid ""
  5888. "If you've explicitly configured an [external Postgres server](docs"
  5889. "/configuring-playbook-external-postgres.md), there are **no changes** "
  5890. "that you need to do at this time."
  5891. msgstr ""
  5892. #: ../../../CHANGELOG.md:2242
  5893. msgid ""
  5894. "The fact that we've renamed Synapse's database from `homeserver` to "
  5895. "`synapse` (in our defaults) should not affect you, as you're already "
  5896. "explicitly defining `matrix_synapse_database_database` (if you've "
  5897. "followed our guide, that is). If you're not explicitly defining this "
  5898. "variable, you may wish to do so (`matrix_synapse_database_database: "
  5899. "homeserver`), to avoid the new `synapse` default and keep things as they "
  5900. "were."
  5901. msgstr ""
  5902. #: ../../../CHANGELOG.md:2245
  5903. msgid "2021-01-20"
  5904. msgstr ""
  5905. #: ../../../CHANGELOG.md:2247
  5906. msgid ""
  5907. "(Breaking Change) The mautrix-facebook bridge now requires a Postgres "
  5908. "database"
  5909. msgstr ""
  5910. #: ../../../CHANGELOG.md:2249
  5911. msgid ""
  5912. "**Update from 2021-11-15**: SQLite support has been re-added to the "
  5913. "mautrix-facebook bridge in "
  5914. "[v0.3.2](https://github.com/mautrix/facebook/releases/tag/v0.3.2). You "
  5915. "can ignore this changelog entry."
  5916. msgstr ""
  5917. #: ../../../CHANGELOG.md:2251
  5918. msgid ""
  5919. "A new version of the [mautrix-facebook](https://github.com/tulir/mautrix-"
  5920. "facebook) bridge has been released. It's a full rewrite of its backend "
  5921. "and the bridge now requires Postgres. New versions of the bridge can no "
  5922. "longer run on SQLite."
  5923. msgstr ""
  5924. #: ../../../CHANGELOG.md:2253
  5925. msgid ""
  5926. "**TLDR**: if you're NOT using an [external Postgres server](docs"
  5927. "/configuring-playbook-external-postgres.md) and have NOT forcefully kept "
  5928. "the bridge on SQLite during [The big move to all-on-Postgres (potentially"
  5929. " dangerous)](#the-big-move-to-all-on-postgres-potentially-dangerous), you"
  5930. " will be automatically upgraded without manual intervention. All you need"
  5931. " to do is send a `login` message to the Facebook bridge bot again."
  5932. msgstr ""
  5933. #: ../../../CHANGELOG.md:2255
  5934. msgid "Whether this change requires your intervention depends mostly on:"
  5935. msgstr ""
  5936. #: ../../../CHANGELOG.md:2256
  5937. msgid ""
  5938. "whether you're using an [external Postgres server](docs/configuring-"
  5939. "playbook-external-postgres.md). If yes, then [you need to do something"
  5940. "](#upgrade-path-for-people-running-an-external-postgres-server)."
  5941. msgstr ""
  5942. #: ../../../CHANGELOG.md:2257
  5943. msgid ""
  5944. "or whether you've force-changed the bridge's database engine to SQLite "
  5945. "(`matrix_mautrix_facebook_database_engine: 'sqlite'` in your `vars.yml`) "
  5946. "some time in the past (likely during [The big move to all-on-Postgres "
  5947. "(potentially dangerous)](#the-big-move-to-all-on-postgres-potentially-"
  5948. "dangerous))."
  5949. msgstr ""
  5950. #: ../../../CHANGELOG.md:2259
  5951. msgid ""
  5952. "As already mentioned above, you most likely don't need to do anything. If"
  5953. " you rerun the playbook and don't get an error, you've been automatically"
  5954. " upgraded. Just send a `login` message to the Facebook bridge bot again. "
  5955. "Otherwise, read below for a solution."
  5956. msgstr ""
  5957. #: ../../../CHANGELOG.md:2261
  5958. msgid ""
  5959. "Upgrade path for people NOT running an external Postgres server (default "
  5960. "for the playbook)"
  5961. msgstr ""
  5962. #: ../../../CHANGELOG.md:2263
  5963. msgid ""
  5964. "If you're **not running an external Postgres server**, then this bridge "
  5965. "either already works on Postgres for you, or you've intentionally kept it"
  5966. " back on SQLite with custom configuration "
  5967. "(`matrix_mautrix_facebook_database_engine: 'sqlite'` in your `vars.yml`) "
  5968. "."
  5969. msgstr ""
  5970. #: ../../../CHANGELOG.md:2265
  5971. msgid ""
  5972. "Simply remove that custom configuration from your `vars.yml` file (if "
  5973. "it's there) and re-run the playbook. It should upgrade you automatically."
  5974. " You'll need to send a `login` message to the Facebook bridge bot again."
  5975. msgstr ""
  5976. #: ../../../CHANGELOG.md:2267
  5977. msgid ""
  5978. "Alternatively, [you can stay on SQLite for a little longer](#staying-on-"
  5979. "sqlite-for-a-little-longer-temporary-solution)."
  5980. msgstr ""
  5981. #: ../../../CHANGELOG.md:2269
  5982. msgid "Upgrade path for people running an external Postgres server"
  5983. msgstr ""
  5984. #: ../../../CHANGELOG.md:2271
  5985. msgid ""
  5986. "For people using the internal Postgres server (the default for the "
  5987. "playbook):"
  5988. msgstr ""
  5989. #: ../../../CHANGELOG.md:2272
  5990. msgid ""
  5991. "we automatically create an additional `matrix_mautrix_facebook` Postgres "
  5992. "database and credentials to access it"
  5993. msgstr ""
  5994. #: ../../../CHANGELOG.md:2273
  5995. msgid ""
  5996. "we automatically adjust the bridge's `matrix_mautrix_facebook_database_*`"
  5997. " variables to point the bridge to that Postgres database"
  5998. msgstr ""
  5999. #: ../../../CHANGELOG.md:2274
  6000. msgid ""
  6001. "we use [pgloader](https://pgloader.io/) to automatically import the "
  6002. "existing SQLite data for the bridge into the `matrix_mautrix_facebook` "
  6003. "Postgres database"
  6004. msgstr ""
  6005. #: ../../../CHANGELOG.md:2276
  6006. msgid ""
  6007. "If you are using an [external Postgres server](docs/configuring-playbook-"
  6008. "external-postgres.md), unfortunately we currently can't do any of that "
  6009. "for you."
  6010. msgstr ""
  6011. #: ../../../CHANGELOG.md:2278
  6012. msgid "You have 3 ways to proceed:"
  6013. msgstr ""
  6014. #: ../../../CHANGELOG.md:2280
  6015. msgid "contribute to the playbook to make this possible (difficult)"
  6016. msgstr ""
  6017. #: ../../../CHANGELOG.md:2281
  6018. msgid "or, do the migration \"steps\" manually:"
  6019. msgstr ""
  6020. #: ../../../CHANGELOG.md:2282
  6021. msgid "stop the bridge (`systemctl stop matrix-mautrix-facebook`)"
  6022. msgstr ""
  6023. #: ../../../CHANGELOG.md:2283
  6024. msgid "create a new `matrix_mautrix_facebook` Postgres database for it"
  6025. msgstr ""
  6026. #: ../../../CHANGELOG.md:2284
  6027. msgid ""
  6028. "run [pgloader](https://pgloader.io/) manually (we import this bridge's "
  6029. "data using default settings and it works well)"
  6030. msgstr ""
  6031. #: ../../../CHANGELOG.md:2285
  6032. msgid ""
  6033. "define `matrix_mautrix_facebook_database_*` variables in your `vars.yml` "
  6034. "file (credentials, etc.) - you can find their defaults in `roles/custom"
  6035. "/matrix-mautrix-facebook/defaults/main.yml`"
  6036. msgstr ""
  6037. #: ../../../CHANGELOG.md:2286
  6038. msgid ""
  6039. "switch the bridge to Postgres (`matrix_mautrix_facebook_database_engine: "
  6040. "'postgres'` in your `vars.yml` file)"
  6041. msgstr ""
  6042. #: ../../../CHANGELOG.md:2287
  6043. msgid ""
  6044. "re-run the playbook (`--tags=setup-all,start`) and ensure the bridge "
  6045. "works (`systemctl status matrix-mautrix-facebook` and `journalctl -fu "
  6046. "matrix-mautrix-facebook`)"
  6047. msgstr ""
  6048. #: ../../../CHANGELOG.md:2288
  6049. msgid "send a `login` message to the Facebook bridge bot again"
  6050. msgstr ""
  6051. #: ../../../CHANGELOG.md:2289
  6052. msgid ""
  6053. "or, [stay on SQLite for a little longer (temporary solution)](#staying-"
  6054. "on-sqlite-for-a-little-longer-temporary-solution)"
  6055. msgstr ""
  6056. #: ../../../CHANGELOG.md:2291
  6057. msgid "Staying on SQLite for a little longer (temporary solution)"
  6058. msgstr ""
  6059. #: ../../../CHANGELOG.md:2293
  6060. msgid ""
  6061. "To keep using this bridge with SQLite for a little longer (**not "
  6062. "recommended**), use the following configuration in your `vars.yml` file:"
  6063. msgstr ""
  6064. #: ../../../CHANGELOG.md:2303
  6065. msgid ""
  6066. "If you do this, keep in mind that **you can't run this forever**. This "
  6067. "SQLite-supporting bridge version is not getting any updates and will "
  6068. "break sooner or later. The playbook will also drop support for SQLite at "
  6069. "some point in the future."
  6070. msgstr ""
  6071. #: ../../../CHANGELOG.md:2306
  6072. msgid "2021-01-17"
  6073. msgstr ""
  6074. #: ../../../CHANGELOG.md:2308
  6075. msgid "matrix-corporal goes 2.0"
  6076. msgstr ""
  6077. #: ../../../CHANGELOG.md:2310
  6078. msgid ""
  6079. "[matrix-corporal v2 has been released](https://github.com/devture/matrix-"
  6080. "corporal/releases/tag/2.0.0) and the playbook also supports it now."
  6081. msgstr ""
  6082. #: ../../../CHANGELOG.md:2312
  6083. msgid "No manual intervention is required in the common case."
  6084. msgstr ""
  6085. #: ../../../CHANGELOG.md:2314
  6086. msgid ""
  6087. "The new [matrix-corporal](https://github.com/devture/matrix-corporal) "
  6088. "version is also the first one to support Interactive Authentication. If "
  6089. "you wish to enable that (hint: you should), you'll need to set up the "
  6090. "[REST auth password provider](docs/configuring-playbook-rest-auth.md). "
  6091. "There's more information in [our matrix-corporal docs](docs/configuring-"
  6092. "playbook-matrix-corporal.md)."
  6093. msgstr ""
  6094. #: ../../../CHANGELOG.md:2317
  6095. msgid "2021-01-14"
  6096. msgstr ""
  6097. #: ../../../CHANGELOG.md:2319
  6098. msgid "Moving from cronjobs to systemd timers"
  6099. msgstr ""
  6100. #: ../../../CHANGELOG.md:2321
  6101. msgid ""
  6102. "We no longer use cronjobs for Let's Encrypt SSL renewal and `matrix-"
  6103. "nginx-proxy`/`matrix-coturn` reloading. Instead, we've switched to "
  6104. "systemd timers."
  6105. msgstr ""
  6106. #: ../../../CHANGELOG.md:2323
  6107. msgid ""
  6108. "The largest benefit of this is that we no longer require you to install a"
  6109. " cron daemon, thus simplifying our install procedure."
  6110. msgstr ""
  6111. #: ../../../CHANGELOG.md:2325
  6112. msgid ""
  6113. "The playbook will migrate you from cronjobs to systemd timers "
  6114. "automatically. This is just a heads up."
  6115. msgstr ""
  6116. #: ../../../CHANGELOG.md:2328
  6117. msgid "2021-01-08"
  6118. msgstr ""
  6119. #: ../../../CHANGELOG.md:2330
  6120. msgid "(Breaking Change) New SSL configuration"
  6121. msgstr ""
  6122. #: ../../../CHANGELOG.md:2332
  6123. msgid ""
  6124. "SSL configuration (protocols, ciphers) can now be more easily controlled "
  6125. "thanks to us making use of configuration presets."
  6126. msgstr ""
  6127. #: ../../../CHANGELOG.md:2334
  6128. msgid ""
  6129. "We define a few presets (old, intermediate, modern), following the "
  6130. "[Mozilla SSL Configuration Generator](https://ssl-"
  6131. "config.mozilla.org/#server=nginx)."
  6132. msgstr ""
  6133. #: ../../../CHANGELOG.md:2336
  6134. msgid ""
  6135. "A new variable `matrix_nginx_proxy_ssl_preset` controls which preset is "
  6136. "used (defaults to `\"intermediate\"`)."
  6137. msgstr ""
  6138. #: ../../../CHANGELOG.md:2338
  6139. msgid ""
  6140. "Compared to before, this changes nginx's `ssl_prefer_server_ciphers` to "
  6141. "`off` (used to default to `on`). It also add some more ciphers to the "
  6142. "list, giving better performance on mobile devices, and removes some weak "
  6143. "ciphers. More information in the [documentation](docs/configuring-"
  6144. "playbook-nginx.md)."
  6145. msgstr ""
  6146. #: ../../../CHANGELOG.md:2340
  6147. msgid "To revert to the old behaviour, set the following variables:"
  6148. msgstr ""
  6149. #: ../../../CHANGELOG.md:2347
  6150. msgid ""
  6151. "Just like before, you can still use your own custom protocols by "
  6152. "specifying them in `matrix_nginx_proxy_ssl_protocols`. Doing so overrides"
  6153. " the values coming from the preset."
  6154. msgstr ""
  6155. #: ../../../CHANGELOG.md:2350
  6156. msgid "2021-01-03"
  6157. msgstr ""
  6158. #: ../../../CHANGELOG.md:2352
  6159. msgid "Signal bridging support via mautrix-signal"
  6160. msgstr ""
  6161. #: ../../../CHANGELOG.md:2354
  6162. msgid ""
  6163. "Thanks to [laszabine](https://github.com/laszabine)'s efforts, the "
  6164. "playbook now supports bridging to [Signal](https://www.signal.org/) via "
  6165. "the [mautrix-signal](https://github.com/tulir/mautrix-signal) bridge. See"
  6166. " our [Setting up Mautrix Signal bridging](docs/configuring-playbook-"
  6167. "bridge-mautrix-signal.md) documentation page for getting started."
  6168. msgstr ""
  6169. #: ../../../CHANGELOG.md:2356
  6170. msgid ""
  6171. "If you had installed the mautrix-signal bridge while its Pull Request was"
  6172. " still work-in-progress, you can migrate your data to the new and final "
  6173. "setup by referring to [this comment](https://github.com/spantaleev"
  6174. "/matrix-docker-ansible-deploy/pull/686#issuecomment-753510789)."
  6175. msgstr ""
  6176. #: ../../../CHANGELOG.md:2359
  6177. msgid "2020-12-23"
  6178. msgstr ""
  6179. #: ../../../CHANGELOG.md:2361
  6180. msgid "The big move to all-on-Postgres (potentially dangerous)"
  6181. msgstr ""
  6182. #: ../../../CHANGELOG.md:2363
  6183. msgid ""
  6184. "**TLDR**: all your bridges (and other services) will likely be auto-"
  6185. "migrated from SQLite/nedb to Postgres, hopefully without trouble. You can"
  6186. " opt-out (see how below), if too worried about breakage."
  6187. msgstr ""
  6188. #: ../../../CHANGELOG.md:2365
  6189. msgid ""
  6190. "Until now, we've only used Postgres as a database for Synapse. All other "
  6191. "services (bridges, bots, etc.) were kept simple and used a file-based "
  6192. "database (SQLite or nedb)."
  6193. msgstr ""
  6194. #: ../../../CHANGELOG.md:2367
  6195. msgid ""
  6196. "Since [this huge pull request](https://github.com/spantaleev/matrix-"
  6197. "docker-ansible-deploy/pull/740), **all of our services now use Postgres "
  6198. "by default**. Thanks to [Johanna Dorothea "
  6199. "Reichmann](https://github.com/jdreichmann) for starting the work on it "
  6200. "and for providing great input!"
  6201. msgstr ""
  6202. #: ../../../CHANGELOG.md:2369
  6203. msgid "Moving all services to Postgres brings a few **benefits** to us:"
  6204. msgstr ""
  6205. #: ../../../CHANGELOG.md:2371
  6206. msgid "**improved performance**"
  6207. msgstr ""
  6208. #: ../../../CHANGELOG.md:2372
  6209. msgid ""
  6210. "**improved compatibility**. Most bridges are deprecating SQLite/nedb "
  6211. "support or offer less features when not on Postgres."
  6212. msgstr ""
  6213. #: ../../../CHANGELOG.md:2373
  6214. msgid ""
  6215. "**easier backups**. It's still some effort to take a proper backup "
  6216. "(Postgres dump + various files, keys), but a Postgres dump now takes you "
  6217. "much further."
  6218. msgstr ""
  6219. #: ../../../CHANGELOG.md:2374
  6220. msgid ""
  6221. "we're now **more prepared to introduce other services** that need a "
  6222. "Postgres database - [Dendrite](https://github.com/matrix-org/dendrite), "
  6223. "the [mautrix-signal](https://github.com/tulir/mautrix-signal) bridge "
  6224. "(existing [pull request](https://github.com/spantaleev/matrix-docker-"
  6225. "ansible-deploy/pull/686)), etc."
  6226. msgstr ""
  6227. #: ../../../CHANGELOG.md:2376
  6228. msgid "Key takeway"
  6229. msgstr ""
  6230. #: ../../../CHANGELOG.md:2378
  6231. msgid ""
  6232. "existing installations that use an [external "
  6233. "Postgres](https://github.com/spantaleev/matrix-docker-ansible-"
  6234. "deploy/blob/master/docs/configuring-playbook-external-postgres.md) server"
  6235. " should be unaffected (they remain on SQLite/nedb for all services, "
  6236. "except Synapse)"
  6237. msgstr ""
  6238. #: ../../../CHANGELOG.md:2380
  6239. msgid ""
  6240. "for existing installations which use our integrated Postgres database "
  6241. "server (`matrix-postgres`, which is the default), **we automatically "
  6242. "migrate data** from SQLite/nedb to Postgres and **archive the database "
  6243. "files** (`something.db` -> `something.db.backup`), so you can restore "
  6244. "them if you need to go back (see how below)."
  6245. msgstr ""
  6246. #: ../../../CHANGELOG.md:2382
  6247. msgid "Opting-out of the Postgres migration"
  6248. msgstr ""
  6249. #: ../../../CHANGELOG.md:2384
  6250. msgid ""
  6251. "This is a **very large and somewhat untested change** (potentially "
  6252. "dangerous), so **if you're not feeling confident/experimental, opt-out** "
  6253. "of it for now. Still, it's the new default and what we (and various "
  6254. "bridges) will focus on going forward, so don't stick to old ways for too "
  6255. "long."
  6256. msgstr ""
  6257. #: ../../../CHANGELOG.md:2386
  6258. msgid ""
  6259. "You can remain on SQLite/nedb (at least for now) by adding a variable "
  6260. "like this to your `vars.yml` file for each service you use: "
  6261. "`matrix_COMPONENT_database_engine: sqlite` (e.g. "
  6262. "`matrix_mautrix_facebook_database_engine: sqlite`)."
  6263. msgstr ""
  6264. #: ../../../CHANGELOG.md:2388
  6265. msgid ""
  6266. "Some services (like `appservice-irc` and `appservice-slack`) don't use "
  6267. "SQLite, so use `nedb`, instead of `sqlite` for them."
  6268. msgstr ""
  6269. #: ../../../CHANGELOG.md:2390
  6270. msgid "Going back to SQLite/nedb if things went wrong"
  6271. msgstr ""
  6272. #: ../../../CHANGELOG.md:2392
  6273. msgid ""
  6274. "If you went with the Postgres migration and it went badly for you (some "
  6275. "bridge not working as expected or not working at all), do this:"
  6276. msgstr ""
  6277. #: ../../../CHANGELOG.md:2394
  6278. msgid ""
  6279. "stop all services (`ansible-playbook -i inventory/hosts setup.yml "
  6280. "--tags=stop`)"
  6281. msgstr ""
  6282. #: ../../../CHANGELOG.md:2395
  6283. msgid ""
  6284. "SSH into the server and rename the old database files "
  6285. "(`something.db.backup` -> `something.db`). Example: `mv /matrix/mautrix-"
  6286. "facebook/data/mautrix-facebook.db.backup /matrix/mautrix-facebook/data"
  6287. "/mautrix-facebook.db`"
  6288. msgstr ""
  6289. #: ../../../CHANGELOG.md:2396
  6290. msgid ""
  6291. "switch the affected service back to SQLite (e.g. "
  6292. "`matrix_mautrix_facebook_database_engine: sqlite`). Some services (like "
  6293. "`appservice-irc` and `appservice-slack`) don't use SQLite, so use `nedb`,"
  6294. " instead of `sqlite` for them."
  6295. msgstr ""
  6296. #: ../../../CHANGELOG.md:2397
  6297. msgid ""
  6298. "re-run the playbook (`ansible-playbook -i inventory/hosts setup.yml "
  6299. "--tags=setup-all,start`)"
  6300. msgstr ""
  6301. #: ../../../CHANGELOG.md:2398
  6302. msgid "[get in touch](README.md#support) with us"
  6303. msgstr ""
  6304. #: ../../../CHANGELOG.md:2400
  6305. msgid "2020-12-11"
  6306. msgstr ""
  6307. #: ../../../CHANGELOG.md:2402
  6308. msgid "synapse-janitor support removed"
  6309. msgstr ""
  6310. #: ../../../CHANGELOG.md:2404
  6311. msgid ""
  6312. "We've removed support for the unmaintained [synapse-"
  6313. "janitor](https://github.com/xwiki-labs/synapse_scripts) script. There's "
  6314. "been past reports of it corrupting the Synapse database. Since there "
  6315. "hasn't been any new development on it and it doesn't seem too useful "
  6316. "nowadays, there's no point in including it in the playbook."
  6317. msgstr ""
  6318. #: ../../../CHANGELOG.md:2406
  6319. msgid ""
  6320. "If you need to clean up or compact your database, consider using the "
  6321. "Synapse Admin APIs directly. See our [Synapse maintenance](docs"
  6322. "/maintenance-synapse.md) and [Postgres maintenance](docs/maintenance-"
  6323. "postgres.md) documentation pages for more details."
  6324. msgstr ""
  6325. #: ../../../CHANGELOG.md:2408
  6326. msgid "Docker 20.10 is here"
  6327. msgstr ""
  6328. #: ../../../CHANGELOG.md:2410
  6329. msgid ""
  6330. "(No need to do anything special in relation to this. Just something to "
  6331. "keep in mind)"
  6332. msgstr ""
  6333. #: ../../../CHANGELOG.md:2412
  6334. msgid ""
  6335. "Docker 20.10 got released recently and your server will likely get it the"
  6336. " next time you update."
  6337. msgstr ""
  6338. #: ../../../CHANGELOG.md:2414
  6339. msgid ""
  6340. "This is the first major Docker update in a long time and it packs a lot "
  6341. "of changes. Some of them introduced some breakage for us initially (see "
  6342. "[here](https://github.com/spantaleev/matrix-docker-ansible-"
  6343. "deploy/commit/d08b27784f222effcbce2abf924bf07bbe0893be) and "
  6344. "[here](https://github.com/spantaleev/matrix-docker-ansible-"
  6345. "deploy/commit/7593d969e316cc0144bce378a5be58c76c2c37ee)), but it should "
  6346. "be all good now."
  6347. msgstr ""
  6348. #: ../../../CHANGELOG.md:2417
  6349. msgid "2020-12-08"
  6350. msgstr ""
  6351. #: ../../../CHANGELOG.md:2419
  6352. msgid ""
  6353. "openid APIs exposed by default on the federation port when federation "
  6354. "disabled"
  6355. msgstr ""
  6356. #: ../../../CHANGELOG.md:2421
  6357. msgid ""
  6358. "We've changed some defaults. People running with our default "
  6359. "configuration (federation enabled), are not affected at all."
  6360. msgstr ""
  6361. #: ../../../CHANGELOG.md:2423
  6362. msgid ""
  6363. "If you are running an unfederated server "
  6364. "(`matrix_synapse_federation_enabled: false`), this may be of interest to "
  6365. "you."
  6366. msgstr ""
  6367. #: ../../../CHANGELOG.md:2425
  6368. msgid ""
  6369. "When federation is disabled, but ma1sd or Dimension are enabled, we'll "
  6370. "now expose the `openid` APIs on the federation port. These APIs are "
  6371. "necessary for some ma1sd features to work. If you'd like to prevent this,"
  6372. " you can: `matrix_synapse_federation_port_openid_resource_required: "
  6373. "false`."
  6374. msgstr ""
  6375. #: ../../../CHANGELOG.md:2428
  6376. msgid "2020-11-27"
  6377. msgstr ""
  6378. #: ../../../CHANGELOG.md:2430
  6379. msgid "Recent Jitsi updates may require configuration changes"
  6380. msgstr ""
  6381. #: ../../../CHANGELOG.md:2432
  6382. msgid ""
  6383. "We've recently [updated from Jitsi build 4857 to build "
  6384. "5142](https://github.com/spantaleev/matrix-docker-ansible-"
  6385. "deploy/pull/719), which brings a lot of configuration changes."
  6386. msgstr ""
  6387. #: ../../../CHANGELOG.md:2434
  6388. msgid "**If you use our default Jitsi settings, you won't have to do anything.**"
  6389. msgstr ""
  6390. #: ../../../CHANGELOG.md:2436
  6391. msgid ""
  6392. "People who have [fine-tuned Jitsi](docs/configuring-playbook-jitsi.md"
  6393. "#optional-fine-tune-jitsi) may find that some options got renamed now, "
  6394. "others are gone and yet others still need to be defined in another way."
  6395. msgstr ""
  6396. #: ../../../CHANGELOG.md:2438
  6397. msgid ""
  6398. "The next time you run the playbook [installation](docs/installing.md) "
  6399. "command, our validation logic will tell you if you're using some "
  6400. "variables like that and will recommend a migration path for each one."
  6401. msgstr ""
  6402. #: ../../../CHANGELOG.md:2440
  6403. msgid ""
  6404. "Additionally, we've recently disabled transcriptions "
  6405. "(`jitsi_enable_transcriptions: false`) and recording "
  6406. "(`jitsi_enable_recording: false`) by default. These features did not work"
  6407. " anyway, because we don't install the required dependencies for them "
  6408. "(Jigasi and Jibri, respectively). If you've been somehow pointing your "
  6409. "Jitsi installation to some manually installed Jigasi/Jibri service, you "
  6410. "may need to toggle these flags back to enabled to have transcriptions and"
  6411. " recordings working."
  6412. msgstr ""
  6413. #: ../../../CHANGELOG.md:2443
  6414. msgid "2020-11-23"
  6415. msgstr ""
  6416. #: ../../../CHANGELOG.md:2445 ../../../CHANGELOG.md:2453
  6417. msgid "Breaking change matrix-sms-bridge"
  6418. msgstr ""
  6419. #: ../../../CHANGELOG.md:2447
  6420. msgid ""
  6421. "Because of many problems using gammu as SMS provider, matrix-sms-bridge "
  6422. "now uses (https://github.com/RebekkaMa/android-sms-gateway-server) by "
  6423. "default. See (the docs)[./docs/configuring-playbook-bridge-matrix-bridge-"
  6424. "sms.md] which new vars you need to add."
  6425. msgstr ""
  6426. #: ../../../CHANGELOG.md:2449
  6427. msgid ""
  6428. "If you are using this playbook to deploy matrix-sms-bridge and still "
  6429. "really want to use gammu as SMS provider, we could possibly add support "
  6430. "for both android-sms-gateway-server and gammu."
  6431. msgstr ""
  6432. #: ../../../CHANGELOG.md:2451
  6433. msgid "2020-11-13"
  6434. msgstr ""
  6435. #: ../../../CHANGELOG.md:2455
  6436. msgid ""
  6437. "The new version of [matrix-sms-bridge](https://github.com/benkuly/matrix-"
  6438. "sms-bridge) changed its database from neo4j to h2. You need to sync the "
  6439. "bridge at the first start. Note that this only will sync rooms where the "
  6440. "@smsbot:yourServer is member. For rooms without @smsbot:yourServer you "
  6441. "need to kick and invite the telephone number **or** invite "
  6442. "@smsbot:yourServer."
  6443. msgstr ""
  6444. #: ../../../CHANGELOG.md:2457
  6445. msgid ""
  6446. "Add the following to your `vars.yml` file: "
  6447. "`matrix_sms_bridge_container_extra_arguments=['--env "
  6448. "SPRING_PROFILES_ACTIVE=initialsync']`"
  6449. msgstr ""
  6450. #: ../../../CHANGELOG.md:2458
  6451. msgid ""
  6452. "Login to your host shell and remove old systemd file from your host: `rm "
  6453. "/etc/systemd/system/matrix-sms-bridge-database.service`"
  6454. msgstr ""
  6455. #: ../../../CHANGELOG.md:2459
  6456. msgid ""
  6457. "Run `ansible-playbook -i inventory/hosts setup.yml --tags=setup-matrix-"
  6458. "sms-bridge,start`"
  6459. msgstr ""
  6460. #: ../../../CHANGELOG.md:2460
  6461. msgid ""
  6462. "Login to your host shell and check the logs with `journalctl -u matrix-"
  6463. "sms-bridge` until the sync finished."
  6464. msgstr ""
  6465. #: ../../../CHANGELOG.md:2461
  6466. msgid "Remove the var from the first step."
  6467. msgstr ""
  6468. #: ../../../CHANGELOG.md:2462
  6469. msgid ""
  6470. "Run `ansible-playbook -i inventory/hosts setup.yml --tags=setup-"
  6471. "all,start`."
  6472. msgstr ""
  6473. #: ../../../CHANGELOG.md:2464
  6474. msgid "2020-11-10"
  6475. msgstr ""
  6476. #: ../../../CHANGELOG.md:2466
  6477. msgid "Dynamic DNS support"
  6478. msgstr ""
  6479. #: ../../../CHANGELOG.md:2468
  6480. msgid ""
  6481. "Thanks to [Scott Crossen](https://github.com/scottcrossen), the playbook "
  6482. "can now manage Dynamic DNS for you using "
  6483. "[ddclient](https://ddclient.net/)."
  6484. msgstr ""
  6485. #: ../../../CHANGELOG.md:2470
  6486. msgid ""
  6487. "To learn more, follow our [Dynamic DNS docs page](docs/configuring-"
  6488. "playbook-dynamic-dns.md)."
  6489. msgstr ""
  6490. #: ../../../CHANGELOG.md:2473
  6491. msgid "2020-10-28"
  6492. msgstr ""
  6493. #: ../../../CHANGELOG.md:2475
  6494. msgid ""
  6495. "(Compatibility Break) https://matrix.example.com/ now redirects to "
  6496. "https://element.example.com/"
  6497. msgstr ""
  6498. #: ../../../CHANGELOG.md:2477
  6499. msgid ""
  6500. "Until now, we used to serve a static page coming from Synapse at "
  6501. "`https://matrix.example.com/`. This page was not very useful to anyone."
  6502. msgstr ""
  6503. #: ../../../CHANGELOG.md:2479
  6504. msgid ""
  6505. "Since `matrix.example.com` may be accessed by regular users in certain "
  6506. "conditions, it's probably better to redirect them to a better place (e.g."
  6507. " to [Element Web](docs/configuring-playbook-client-element-web.md))."
  6508. msgstr ""
  6509. #: ../../../CHANGELOG.md:2481
  6510. msgid ""
  6511. "If Element Web is installed (`matrix_client_element_enabled: true`, which"
  6512. " it is by default), we now redirect people to it, instead of showing them"
  6513. " a Synapse static page."
  6514. msgstr ""
  6515. #: ../../../CHANGELOG.md:2483
  6516. msgid ""
  6517. "If you'd like to control where the redirect goes, use the "
  6518. "`matrix_nginx_proxy_proxy_matrix_client_redirect_root_uri_to_domain` "
  6519. "variable. To restore the old behavior of not redirecting anywhere and "
  6520. "serving the Synapse static page, set it to an empty value "
  6521. "(`matrix_nginx_proxy_proxy_matrix_client_redirect_root_uri_to_domain: "
  6522. "\"\"`)."
  6523. msgstr ""
  6524. #: ../../../CHANGELOG.md:2486
  6525. msgid "2020-10-26"
  6526. msgstr ""
  6527. #: ../../../CHANGELOG.md:2488
  6528. msgid ""
  6529. "(Compatibility Break) /_synapse/admin is no longer publicly exposed by "
  6530. "default"
  6531. msgstr ""
  6532. #: ../../../CHANGELOG.md:2490
  6533. msgid ""
  6534. "We used to expose the Synapse Admin APIs publicly (at "
  6535. "`https://matrix.example.com/_synapse/admin`). These APIs require "
  6536. "authentication with a valid access token, so it's not that big a deal to "
  6537. "expose them."
  6538. msgstr ""
  6539. #: ../../../CHANGELOG.md:2492
  6540. msgid ""
  6541. "However, following [official Synapse's reverse-proxying "
  6542. "recommendations](https://github.com/element-"
  6543. "hq/synapse/blob/master/docs/reverse_proxy.md#synapse-administration-"
  6544. "endpoints), we're no longer exposing `/_synapse/admin` by default."
  6545. msgstr ""
  6546. #: ../../../CHANGELOG.md:2494
  6547. msgid ""
  6548. "If you'd like to restore restore the old behavior and expose "
  6549. "`/_synapse/admin` publicly, you can use the following configuration (in "
  6550. "your `vars.yml`):"
  6551. msgstr ""
  6552. #: ../../../CHANGELOG.md:2501
  6553. msgid "2020-10-02"
  6554. msgstr ""
  6555. #: ../../../CHANGELOG.md:2503
  6556. msgid "Minimum Ansible version raised to v2.7.0"
  6557. msgstr ""
  6558. #: ../../../CHANGELOG.md:2505
  6559. msgid ""
  6560. "We were claiming to support [Ansible](https://www.ansible.com/) v2.5.2 "
  6561. "and higher, but issues like [#662](https://github.com/spantaleev/matrix-"
  6562. "docker-ansible-deploy/issues/662) demonstrate that we need at least "
  6563. "v2.7.0."
  6564. msgstr ""
  6565. #: ../../../CHANGELOG.md:2507
  6566. msgid ""
  6567. "If you've been using the playbook without getting any errors until now, "
  6568. "you're probably on a version higher than that already (or you're not "
  6569. "using the `matrix-ma1sd` and `matrix-client-element` roles)."
  6570. msgstr ""
  6571. #: ../../../CHANGELOG.md:2509
  6572. msgid ""
  6573. "Our [Ansible docs page](docs/ansible.md) contains information on how to "
  6574. "run a more up-to-date version of Ansible."
  6575. msgstr ""
  6576. #: ../../../CHANGELOG.md:2512
  6577. msgid "2020-10-01"
  6578. msgstr ""
  6579. #: ../../../CHANGELOG.md:2514
  6580. msgid "Postgres 13 support"
  6581. msgstr ""
  6582. #: ../../../CHANGELOG.md:2516
  6583. msgid ""
  6584. "The playbook now installs [Postgres "
  6585. "13](https://www.postgresql.org/about/news/postgresql-13-released-2077/) "
  6586. "by default."
  6587. msgstr ""
  6588. #: ../../../CHANGELOG.md:2518
  6589. msgid ""
  6590. "If you have have an existing setup, it's likely running on an older "
  6591. "Postgres version (9.x, 10.x, 11.x or 12.x). You can easily upgrade by "
  6592. "following the [upgrading PostgreSQL guide](docs/maintenance-postgres.md"
  6593. "#upgrading-postgresql)."
  6594. msgstr ""
  6595. #: ../../../CHANGELOG.md:2520
  6596. msgid "2020-09-01"
  6597. msgstr ""
  6598. #: ../../../CHANGELOG.md:2522
  6599. msgid "matrix-registration support"
  6600. msgstr ""
  6601. #: ../../../CHANGELOG.md:2524
  6602. msgid ""
  6603. "The playbook can now help you set up [matrix-"
  6604. "registration](https://github.com/ZerataX/matrix-registration) - an "
  6605. "application that lets you keep your Matrix server's registration private,"
  6606. " but still allow certain users (those having a unique registration link) "
  6607. "to register by themselves."
  6608. msgstr ""
  6609. #: ../../../CHANGELOG.md:2526
  6610. msgid ""
  6611. "See our [Setting up matrix-registration](docs/configuring-playbook-"
  6612. "matrix-registration.md) documentation page to get started."
  6613. msgstr ""
  6614. #: ../../../CHANGELOG.md:2529
  6615. msgid "2020-08-21"
  6616. msgstr ""
  6617. #: ../../../CHANGELOG.md:2531
  6618. msgid "rust-synapse-compress-state support"
  6619. msgstr ""
  6620. #: ../../../CHANGELOG.md:2533
  6621. msgid ""
  6622. "The playbook can now help you use [rust-synapse-compress-"
  6623. "state](https://github.com/matrix-org/rust-synapse-compress-state) to "
  6624. "compress the state groups in your Synapse database."
  6625. msgstr ""
  6626. #: ../../../CHANGELOG.md:2535
  6627. msgid ""
  6628. "See our [Compressing state with rust-synapse-compress-state](docs"
  6629. "/maintenance-synapse.md#compressing-state-with-rust-synapse-compress-"
  6630. "state) documentation page to get started."
  6631. msgstr ""
  6632. #: ../../../CHANGELOG.md:2538
  6633. msgid "2020-07-22"
  6634. msgstr ""
  6635. #: ../../../CHANGELOG.md:2540
  6636. msgid "Synapse Admin support"
  6637. msgstr ""
  6638. #: ../../../CHANGELOG.md:2542
  6639. msgid ""
  6640. "The playbook can now help you set up [synapse-admin](https://github.com"
  6641. "/Awesome-Technologies/synapse-admin)."
  6642. msgstr ""
  6643. #: ../../../CHANGELOG.md:2544
  6644. msgid ""
  6645. "See our [Setting up Synapse Admin](docs/configuring-playbook-synapse-"
  6646. "admin.md) documentation to get started."
  6647. msgstr ""
  6648. #: ../../../CHANGELOG.md:2547
  6649. msgid "2020-07-20"
  6650. msgstr ""
  6651. #: ../../../CHANGELOG.md:2549
  6652. msgid "matrix-reminder-bot support"
  6653. msgstr ""
  6654. #: ../../../CHANGELOG.md:2551
  6655. msgid ""
  6656. "The playbook can now help you set up [matrix-reminder-"
  6657. "bot](https://github.com/anoadragon453/matrix-reminder-bot)."
  6658. msgstr ""
  6659. #: ../../../CHANGELOG.md:2553
  6660. msgid ""
  6661. "See our [Setting up matrix-reminder-bot](docs/configuring-playbook-bot-"
  6662. "matrix-reminder-bot.md) documentation to get started."
  6663. msgstr ""
  6664. #: ../../../CHANGELOG.md:2556
  6665. msgid "2020-07-17"
  6666. msgstr ""
  6667. #: ../../../CHANGELOG.md:2558
  6668. msgid "(Compatibility Break) Riot is now Element"
  6669. msgstr ""
  6670. #: ../../../CHANGELOG.md:2560
  6671. msgid ""
  6672. "As per the official announcement, [Riot has been rebraned to "
  6673. "Element](https://element.io/blog/welcome-to-element/)."
  6674. msgstr ""
  6675. #: ../../../CHANGELOG.md:2562
  6676. msgid ""
  6677. "The playbook follows suit. Existing installations have a few options for "
  6678. "how to handle this."
  6679. msgstr ""
  6680. #: ../../../CHANGELOG.md:2564
  6681. msgid ""
  6682. "See our [Migrating to Element Web](docs/configuring-playbook-riot-web.md"
  6683. "#migrating-to-element) documentation page for more details."
  6684. msgstr ""
  6685. #: ../../../CHANGELOG.md:2567
  6686. msgid "2020-07-03"
  6687. msgstr ""
  6688. #: ../../../CHANGELOG.md:2569
  6689. msgid "Steam bridging support via mx-puppet-steam"
  6690. msgstr ""
  6691. #: ../../../CHANGELOG.md:2571
  6692. msgid ""
  6693. "Thanks to [Hugues Morisset](https://github.com/izissise)'s efforts, the "
  6694. "playbook now supports bridging to [Steam](https://steamapp.com/) via the "
  6695. "[mx-puppet-steam](https://github.com/icewind1991/mx-puppet-steam) bridge."
  6696. " See our [Setting up MX Puppet Steam bridging](docs/configuring-playbook-"
  6697. "bridge-mx-puppet-steam.md) documentation page for getting started."
  6698. msgstr ""
  6699. #: ../../../CHANGELOG.md:2574
  6700. msgid "2020-07-01"
  6701. msgstr ""
  6702. #: ../../../CHANGELOG.md:2576
  6703. msgid "Discord bridging support via mx-puppet-discord"
  6704. msgstr ""
  6705. #: ../../../CHANGELOG.md:2578
  6706. msgid ""
  6707. "Thanks to [Hugues Morisset](https://github.com/izissise)'s efforts, the "
  6708. "playbook now supports bridging to [Discord](https://discordapp.com/) via "
  6709. "the [mx-puppet-discord](https://github.com/Sorunome/mx-puppet-discord) "
  6710. "bridge. See our [Setting up MX Puppet Discord bridging](docs/configuring-"
  6711. "playbook-bridge-mx-puppet-discord.md) documentation page for getting "
  6712. "started."
  6713. msgstr ""
  6714. #: ../../../CHANGELOG.md:2580
  6715. msgid ""
  6716. "**Note**: this is a new Discord bridge. The playbook still retains "
  6717. "Discord bridging via [matrix-appservice-discord](docs/configuring-"
  6718. "playbook-bridge-appservice-discord.md). You're free too use the bridge "
  6719. "that serves you better, or even both (for different users and use-cases)."
  6720. msgstr ""
  6721. #: ../../../CHANGELOG.md:2583
  6722. msgid "2020-06-30"
  6723. msgstr ""
  6724. #: ../../../CHANGELOG.md:2585
  6725. msgid "Instagram and Twitter bridging support"
  6726. msgstr ""
  6727. #: ../../../CHANGELOG.md:2587
  6728. msgid ""
  6729. "Thanks to [Johanna Dorothea Reichmann](https://github.com/jdreichmann)'s "
  6730. "efforts, the playbook now supports bridging to "
  6731. "[Instagram](https://www.instagram.com/) via the [mx-puppet-"
  6732. "instagram](https://github.com/Sorunome/mx-puppet-instagram) bridge. See "
  6733. "our [Setting up MX Puppet Instagram bridging](docs/configuring-playbook-"
  6734. "bridge-mx-puppet-instagram.md) documentation page for getting started."
  6735. msgstr ""
  6736. #: ../../../CHANGELOG.md:2589
  6737. msgid ""
  6738. "Thanks to [Tulir Asokan](https://github.com/tulir)'s efforts, the "
  6739. "playbook now supports bridging to [Twitter](https://twitter.com/) via the"
  6740. " [mx-puppet-twitter](https://github.com/Sorunome/mx-puppet-twitter) "
  6741. "bridge. See our [Setting up MX Puppet Twitter bridging](docs/configuring-"
  6742. "playbook-bridge-mx-puppet-twitter.md) documentation page for getting "
  6743. "started."
  6744. msgstr ""
  6745. #: ../../../CHANGELOG.md:2592
  6746. msgid "2020-06-28"
  6747. msgstr ""
  6748. #: ../../../CHANGELOG.md:2594
  6749. msgid ""
  6750. "(Post Mortem / fixed Security Issue) Re-enabling User Directory search "
  6751. "powered by the ma1sd Identity Server"
  6752. msgstr ""
  6753. #: ../../../CHANGELOG.md:2596 ../../../CHANGELOG.md:2625
  6754. msgid ""
  6755. "User Directory search requests used to go to the ma1sd identity server by"
  6756. " default, which queried its own stores and the Synapse database."
  6757. msgstr ""
  6758. #: ../../../CHANGELOG.md:2598
  6759. msgid ""
  6760. "ma1sd's [security issue](https://github.com/ma1uta/ma1sd/issues/44) has "
  6761. "been fixed in version `2.4.0`, with [this "
  6762. "commit](ma1uta/ma1sd@2bb5a734d11662b06471113cf3d6b4cee5e33a85). `ma1sd "
  6763. "2.4.0` is now the default version for this playbook. For more information"
  6764. " on what happened, please check the mentioned issue."
  6765. msgstr ""
  6766. #: ../../../CHANGELOG.md:2600
  6767. msgid ""
  6768. "We are re-enabling user directory search with this update. Those who "
  6769. "would like to keep it disabled can use this configuration: "
  6770. "`matrix_nginx_proxy_proxy_matrix_user_directory_search_enabled: false`"
  6771. msgstr ""
  6772. #: ../../../CHANGELOG.md:2602
  6773. msgid "As always, re-running the playbook is enough to get the updated bits."
  6774. msgstr ""
  6775. #: ../../../CHANGELOG.md:2604
  6776. msgid "2020-06-11"
  6777. msgstr ""
  6778. #: ../../../CHANGELOG.md:2606
  6779. msgid "SMS bridging requires db reset"
  6780. msgstr ""
  6781. #: ../../../CHANGELOG.md:2608
  6782. msgid ""
  6783. "The current version of [matrix-sms-bridge](https://github.com/benkuly"
  6784. "/matrix-sms-bridge) needs you to delete the database to work as expected."
  6785. " Just remove `/matrix/matrix-sms-bridge/database/*`. It also adds a new "
  6786. "requried var `matrix_sms_bridge_default_region`."
  6787. msgstr ""
  6788. #: ../../../CHANGELOG.md:2610
  6789. msgid ""
  6790. "To reuse your existing rooms, invite `@smsbot:yourServer` to the room or "
  6791. "write a message. You are also able to use automated room creation with "
  6792. "telephonenumers by writing `sms send -t 01749292923 \"Hello World\"` in a"
  6793. " room with `@smsbot:yourServer`. See [the "
  6794. "docs](https://github.com/benkuly/matrix-sms-bridge) for more information."
  6795. msgstr ""
  6796. #: ../../../CHANGELOG.md:2612
  6797. msgid "2020-06-05"
  6798. msgstr ""
  6799. #: ../../../CHANGELOG.md:2614
  6800. msgid "SMS bridging support"
  6801. msgstr ""
  6802. #: ../../../CHANGELOG.md:2616
  6803. msgid ""
  6804. "Thanks to [benkuly](https://github.com/benkuly)'s efforts, the playbook "
  6805. "now supports bridging to SMS (with one telephone number only) via "
  6806. "[matrix-sms-bridge](https://github.com/benkuly/matrix-sms-bridge)."
  6807. msgstr ""
  6808. #: ../../../CHANGELOG.md:2618
  6809. msgid ""
  6810. "See our [Setting up Matrix SMS bridging](docs/configuring-playbook-"
  6811. "bridge-matrix-bridge-sms.md) documentation page for getting started."
  6812. msgstr ""
  6813. #: ../../../CHANGELOG.md:2621
  6814. msgid "2020-05-19"
  6815. msgstr ""
  6816. #: ../../../CHANGELOG.md:2623
  6817. msgid ""
  6818. "(Compatibility Break / Security Issue) Disabling User Directory search "
  6819. "powered by the ma1sd Identity Server"
  6820. msgstr ""
  6821. #: ../../../CHANGELOG.md:2627
  6822. msgid ""
  6823. "ma1sd current has [a security "
  6824. "issue](https://github.com/ma1uta/ma1sd/issues/44), which made it leak "
  6825. "information about all users - including users created by bridges, etc."
  6826. msgstr ""
  6827. #: ../../../CHANGELOG.md:2629
  6828. msgid ""
  6829. "Until the issue gets fixed, we're making User Directory search not go to "
  6830. "ma1sd by default. You **need to re-run the playbook and restart services "
  6831. "to apply this workaround**."
  6832. msgstr ""
  6833. #: ../../../CHANGELOG.md:2631
  6834. msgid ""
  6835. "*If you insist on restoring the old behavior* (**which has a security "
  6836. "issue!**), you *might* use this configuration: "
  6837. "`matrix_nginx_proxy_proxy_matrix_user_directory_search_enabled: \"{{ "
  6838. "matrix_ma1sd_enabled }}\"`"
  6839. msgstr ""
  6840. #: ../../../CHANGELOG.md:2634
  6841. msgid "2020-04-28"
  6842. msgstr ""
  6843. #: ../../../CHANGELOG.md:2636
  6844. msgid "Newer IRC bridge (with potential breaking change)"
  6845. msgstr ""
  6846. #: ../../../CHANGELOG.md:2638
  6847. msgid ""
  6848. "This upgrades matrix-appservice-irc from 0.14.1 to 0.16.0. Upstream made"
  6849. " a change to how you define manual mappings. If you added a `mapping` to"
  6850. " your configuration, you will need to update it accoring to the [upstream"
  6851. " instructions](https://github.com/matrix-org/matrix-appservice-"
  6852. "irc/blob/master/CHANGELOG.md#0150-2020-02-05). If you did not include "
  6853. "`mappings` in your configuration for IRC, no change is necessary. "
  6854. "`mappings` is not part of the default configuration."
  6855. msgstr ""
  6856. #: ../../../CHANGELOG.md:2647
  6857. msgid "2020-04-23"
  6858. msgstr ""
  6859. #: ../../../CHANGELOG.md:2649 ../../../CHANGELOG.md:2880
  6860. msgid "Slack bridging support"
  6861. msgstr ""
  6862. #: ../../../CHANGELOG.md:2651
  6863. msgid ""
  6864. "Thanks to [Rodrigo Belem](https://github.com/rbelem)'s efforts, the "
  6865. "playbook now supports bridging to [Slack](https://slack.com) via the [mx-"
  6866. "puppet-slack](https://github.com/Sorunome/mx-puppet-slack) bridge."
  6867. msgstr ""
  6868. #: ../../../CHANGELOG.md:2653
  6869. msgid ""
  6870. "See our [Setting up MX Puppet Slack bridging](docs/configuring-playbook-"
  6871. "bridge-mx-puppet-slack.md) documentation page for getting started."
  6872. msgstr ""
  6873. #: ../../../CHANGELOG.md:2656
  6874. msgid "2020-04-09"
  6875. msgstr ""
  6876. #: ../../../CHANGELOG.md:2658
  6877. msgid "Skype bridging support"
  6878. msgstr ""
  6879. #: ../../../CHANGELOG.md:2660
  6880. msgid ""
  6881. "Thanks to [Rodrigo Belem](https://github.com/rbelem)'s efforts, the "
  6882. "playbook now supports bridging to [Skype](https://www.skype.com) via the "
  6883. "[mx-puppet-skype](https://github.com/Sorunome/mx-puppet-skype) bridge."
  6884. msgstr ""
  6885. #: ../../../CHANGELOG.md:2662
  6886. msgid ""
  6887. "See our [Setting up MX Puppet Skype bridging](docs/configuring-playbook-"
  6888. "bridge-mx-puppet-skype.md) documentation page for getting started."
  6889. msgstr ""
  6890. #: ../../../CHANGELOG.md:2665
  6891. msgid "2020-04-05"
  6892. msgstr ""
  6893. #: ../../../CHANGELOG.md:2667
  6894. msgid "Private Jitsi support"
  6895. msgstr ""
  6896. #: ../../../CHANGELOG.md:2669
  6897. msgid ""
  6898. "The [Jitsi support](#jitsi-support) we had landed a few weeks ago was "
  6899. "working well, but it was always open to the whole world."
  6900. msgstr ""
  6901. #: ../../../CHANGELOG.md:2671
  6902. msgid ""
  6903. "Running such an open instance is not desirable to most people, so "
  6904. "[teutat3s](https://github.com/teutat3s) has contributed support for "
  6905. "making Jitsi use authentication."
  6906. msgstr ""
  6907. #: ../../../CHANGELOG.md:2673
  6908. msgid ""
  6909. "To make your Jitsi server more private, see the [configure internal Jitsi"
  6910. " authentication and guests mode](docs/configuring-playbook-jitsi.md"
  6911. "#optional-configure-internal-jitsi-authentication-and-guests-mode) "
  6912. "section in our Jitsi documentation."
  6913. msgstr ""
  6914. #: ../../../CHANGELOG.md:2676
  6915. msgid "2020-04-03"
  6916. msgstr ""
  6917. #: ../../../CHANGELOG.md:2678
  6918. msgid "(Potential Backward Compatibility Break) ma1sd replaces mxisd"
  6919. msgstr ""
  6920. #: ../../../CHANGELOG.md:2680
  6921. msgid ""
  6922. "Thanks to [Marcel Partap](https://github.com/eMPee584)'s efforts, the "
  6923. "[mxisd](https://github.com/kamax-io/mxisd) identity server, which has "
  6924. "been deprecated for a long time, has finally been replaced by "
  6925. "[ma1sd](https://github.com/ma1uta/ma1sd), a compatible fork."
  6926. msgstr ""
  6927. #: ../../../CHANGELOG.md:2682
  6928. msgid ""
  6929. "**If you're using the default playbook configuration**, you don't need to"
  6930. " do anything -- your mxisd installation will be replaced with ma1sd and "
  6931. "all existing data will be migrated automatically the next time you run "
  6932. "the playbook."
  6933. msgstr ""
  6934. #: ../../../CHANGELOG.md:2684
  6935. msgid ""
  6936. "**If you're doing something more special** (defining custom "
  6937. "`matrix_mxisd_*` variables), the playbook will ask you to rename them to "
  6938. "`matrix_ma1sd_*`. You're also encouraged to test that ma1sd works well "
  6939. "for such a more custom setup."
  6940. msgstr ""
  6941. #: ../../../CHANGELOG.md:2687
  6942. msgid "2020-03-29"
  6943. msgstr ""
  6944. #: ../../../CHANGELOG.md:2689
  6945. msgid "Archlinux support"
  6946. msgstr ""
  6947. #: ../../../CHANGELOG.md:2691
  6948. msgid ""
  6949. "Thanks to [Christian Lupus](https://github.com/christianlupus)'s efforts,"
  6950. " the playbook now supports installing to an "
  6951. "[Archlinux](https://www.archlinux.org/) server."
  6952. msgstr ""
  6953. #: ../../../CHANGELOG.md:2694
  6954. msgid "2020-03-24"
  6955. msgstr ""
  6956. #: ../../../CHANGELOG.md:2696
  6957. msgid "Jitsi support"
  6958. msgstr ""
  6959. #: ../../../CHANGELOG.md:2698
  6960. msgid ""
  6961. "The playbook can now (optionally) install the [Jitsi](https://jitsi.org/)"
  6962. " video-conferencing platform and integrate it with [Riot](docs"
  6963. "/configuring-playbook-riot-web.md)."
  6964. msgstr ""
  6965. #: ../../../CHANGELOG.md:2700
  6966. msgid ""
  6967. "See our [Jitsi documentation page](docs/configuring-playbook-jitsi.md) to"
  6968. " get started."
  6969. msgstr ""
  6970. #: ../../../CHANGELOG.md:2703
  6971. msgid "2020-03-15"
  6972. msgstr ""
  6973. #: ../../../CHANGELOG.md:2705
  6974. msgid "Raspberry Pi support"
  6975. msgstr ""
  6976. #: ../../../CHANGELOG.md:2707
  6977. msgid ""
  6978. "Thanks to [Gergely Horváth](https://github.com/hooger)'s effort, the "
  6979. "playbook supports installing to a Raspberry Pi server, for at least some "
  6980. "of the services."
  6981. msgstr ""
  6982. #: ../../../CHANGELOG.md:2709
  6983. msgid ""
  6984. "Since most ready-made container images do not support that architecture, "
  6985. "we achieve this by building images locally on the device itself. See our "
  6986. "[Self-building documentation page](docs/self-building.md) for how to get "
  6987. "started."
  6988. msgstr ""
  6989. #: ../../../CHANGELOG.md:2712
  6990. msgid "2020-02-26"
  6991. msgstr ""
  6992. #: ../../../CHANGELOG.md:2714
  6993. msgid "Riot-web themes are here"
  6994. msgstr ""
  6995. #: ../../../CHANGELOG.md:2716
  6996. msgid "The playbook now makes it easy to install custom riot-web themes."
  6997. msgstr ""
  6998. #: ../../../CHANGELOG.md:2718
  6999. msgid ""
  7000. "To learn more, take a look at our [riot-web documentation on Themes](docs"
  7001. "/configuring-playbook-riot-web.md#themes)."
  7002. msgstr ""
  7003. #: ../../../CHANGELOG.md:2721
  7004. msgid "2020-02-24"
  7005. msgstr ""
  7006. #: ../../../CHANGELOG.md:2723
  7007. msgid "Customize the server name in Riot's login page"
  7008. msgstr ""
  7009. #: ../../../CHANGELOG.md:2725
  7010. msgid ""
  7011. "You can now customize the server name string that Riot-web displays in "
  7012. "its login page."
  7013. msgstr ""
  7014. #: ../../../CHANGELOG.md:2727
  7015. msgid "These playbook variables, with these default values, have been added:"
  7016. msgstr ""
  7017. #: ../../../CHANGELOG.md:2733
  7018. msgid ""
  7019. "The login page previously said \"Sign in to your Matrix account on "
  7020. "matrix.example.org\" (the homeserver's domain name). It will now say "
  7021. "\"Sign in … on example.org\" (the server name) by default, or \"Sign in …"
  7022. " on Our Server\" if you set the variable to \"Our Server\"."
  7023. msgstr ""
  7024. #: ../../../CHANGELOG.md:2735
  7025. msgid ""
  7026. "To support this, the config.json template is changed to use the "
  7027. "configuration key `default_server_config` for setting the default HS/IS, "
  7028. "and the new configuration key `server_name` is added in there."
  7029. msgstr ""
  7030. #: ../../../CHANGELOG.md:2738
  7031. msgid "2020-01-30"
  7032. msgstr ""
  7033. #: ../../../CHANGELOG.md:2740
  7034. msgid "Disabling TLSv1.1"
  7035. msgstr ""
  7036. #: ../../../CHANGELOG.md:2742
  7037. msgid ""
  7038. "To improve security, we've removed TLSv1.1 support from our default "
  7039. "matrix-nginx-proxy configuration."
  7040. msgstr ""
  7041. #: ../../../CHANGELOG.md:2744
  7042. msgid ""
  7043. "If you need to support old clients, you can re-enable it with the "
  7044. "following configuration: `matrix_nginx_proxy_ssl_protocols: \"TLSv1.1 "
  7045. "TLSv1.2 TLSv1.3\"`"
  7046. msgstr ""
  7047. #: ../../../CHANGELOG.md:2747
  7048. msgid "2020-01-21"
  7049. msgstr ""
  7050. #: ../../../CHANGELOG.md:2749
  7051. msgid "Postgres collation changes (action required!)"
  7052. msgstr ""
  7053. #: ../../../CHANGELOG.md:2751
  7054. msgid ""
  7055. "By default, we've been using a UTF-8 collation for Postgres. This is "
  7056. "known to cause Synapse some troubles (see the [relevant "
  7057. "issue](https://github.com/matrix-org/synapse/issues/6722)) on systems "
  7058. "that use [glibc](https://www.gnu.org/software/libc/). We run Postgres in "
  7059. "an [Alpine Linux](https://alpinelinux.org/) container (which uses "
  7060. "[musl](https://www.musl-libc.org/), and not glibc), so our users are "
  7061. "likely not affected by the index corruption problem observed by others."
  7062. msgstr ""
  7063. #: ../../../CHANGELOG.md:2753
  7064. msgid ""
  7065. "Still, we might become affected in the future. In any case, it's imminent"
  7066. " that Synapse will complain about databases which do not use a C "
  7067. "collation."
  7068. msgstr ""
  7069. #: ../../../CHANGELOG.md:2755
  7070. msgid "To avoid future problems, we recommend that you run the following command:"
  7071. msgstr ""
  7072. #: ../../../CHANGELOG.md:2761
  7073. msgid ""
  7074. "It forces a [Postgres database upgrade](docs/maintenance-postgres.md"
  7075. "#upgrading-postgresql), which would recreate your Postgres database using"
  7076. " the proper (`C`) collation. If you are low on disk space, or run into "
  7077. "trouble, refer to the Postgres database upgrade documentation page."
  7078. msgstr ""
  7079. #: ../../../CHANGELOG.md:2764
  7080. msgid "2020-01-14"
  7081. msgstr ""
  7082. #: ../../../CHANGELOG.md:2766
  7083. msgid "Added support for Appservice Webhooks"
  7084. msgstr ""
  7085. #: ../../../CHANGELOG.md:2768
  7086. msgid ""
  7087. "Thanks to a contribution from [Björn "
  7088. "Marten](https://github.com/tripleawwy) from "
  7089. "[netresearch](https://www.netresearch.de/), the playbook can now install "
  7090. "and configure [matrix-appservice-webhooks](https://github.com/turt2live"
  7091. "/matrix-appservice-webhooks) for you. This bridge provides support for "
  7092. "Slack-compatible webhooks."
  7093. msgstr ""
  7094. #: ../../../CHANGELOG.md:2770
  7095. msgid ""
  7096. "Learn more in [Setting up Appservice Webhooks bridging](docs/configuring-"
  7097. "playbook-bridge-appservice-webhooks.md)."
  7098. msgstr ""
  7099. #: ../../../CHANGELOG.md:2773
  7100. msgid "2020-01-12"
  7101. msgstr ""
  7102. #: ../../../CHANGELOG.md:2775
  7103. msgid "Added support for automatic Double Puppeting for all Mautrix bridges"
  7104. msgstr ""
  7105. #: ../../../CHANGELOG.md:2777
  7106. msgid ""
  7107. "Double Puppeting can now be easily enabled for all Mautrix bridges "
  7108. "supported by the playbook (Facebook, Hangouts, Whatsapp, Telegram)."
  7109. msgstr ""
  7110. #: ../../../CHANGELOG.md:2779
  7111. msgid ""
  7112. "This is possible due to those bridges' integration with [matrix-synapse-"
  7113. "shared-secret-auth](https://github.com/devture/matrix-synapse-shared-"
  7114. "secret-auth) - yet another component that this playbook can install for "
  7115. "you."
  7116. msgstr ""
  7117. #: ../../../CHANGELOG.md:2781
  7118. msgid ""
  7119. "To get started, following the playbook's documentation for the bridge "
  7120. "you'd like to configure."
  7121. msgstr ""
  7122. #: ../../../CHANGELOG.md:2784
  7123. msgid "2019-12-06"
  7124. msgstr ""
  7125. #: ../../../CHANGELOG.md:2786
  7126. msgid "Added support for an alternative method for using another webserver"
  7127. msgstr ""
  7128. #: ../../../CHANGELOG.md:2788
  7129. msgid ""
  7130. "We have added support for making `matrix-nginx-proxy` not being so "
  7131. "invasive, so that it would be easier to [use your own webserver](docs"
  7132. "/configuring-playbook-own-webserver.md)."
  7133. msgstr ""
  7134. #: ../../../CHANGELOG.md:2790
  7135. msgid ""
  7136. "The documentation has been updated with a **Method 2**, which might make "
  7137. "\"own webserver\" setup easier in some cases (such as [reverse-proxying "
  7138. "using Traefik](https://github.com/spantaleev/matrix-docker-ansible-"
  7139. "deploy/issues/296))."
  7140. msgstr ""
  7141. #: ../../../CHANGELOG.md:2792
  7142. msgid ""
  7143. "**Existing users** are not affected by this and **don't need to change "
  7144. "anything**. The defaults are still the same (`matrix-nginx-proxy` "
  7145. "obtaining SSL certificates and doing everything for you automatically)."
  7146. msgstr ""
  7147. #: ../../../CHANGELOG.md:2795
  7148. msgid "2019-11-10"
  7149. msgstr ""
  7150. #: ../../../CHANGELOG.md:2797
  7151. msgid "Tightened security around room directory publishing"
  7152. msgstr ""
  7153. #: ../../../CHANGELOG.md:2799
  7154. msgid ""
  7155. "As per this [advisory blog post](https://matrix.org/blog/2019/11/09"
  7156. "/avoiding-unwelcome-visitors-on-private-matrix-servers), we've decided to"
  7157. " change the default publishing rules for the Matrix room directory."
  7158. msgstr ""
  7159. #: ../../../CHANGELOG.md:2801
  7160. msgid ""
  7161. "Our general goal is to favor privacy and security when running personal "
  7162. "(family & friends) and corporate homeservers. Both of these likely "
  7163. "benefit from having a more secure default of **not showing the room "
  7164. "directory without authentication** and **not publishing the room "
  7165. "directory over federation**."
  7166. msgstr ""
  7167. #: ../../../CHANGELOG.md:2803
  7168. msgid ""
  7169. "As with anything else, these new defaults can be overriden by changing "
  7170. "the `matrix_synapse_allow_public_rooms_without_auth` and "
  7171. "`matrix_synapse_allow_public_rooms_over_federation` variables, "
  7172. "respectively."
  7173. msgstr ""
  7174. #: ../../../CHANGELOG.md:2806
  7175. msgid "2019-10-05"
  7176. msgstr ""
  7177. #: ../../../CHANGELOG.md:2808
  7178. msgid "Improved Postgres upgrading/importing"
  7179. msgstr ""
  7180. #: ../../../CHANGELOG.md:2810
  7181. msgid ""
  7182. "Postgres [upgrading](docs/maintenance-postgres.md#upgrading-postgresql) "
  7183. "and [importing](docs/importing-postgres.md) have been improved to add "
  7184. "support for multiple databases and roles."
  7185. msgstr ""
  7186. #: ../../../CHANGELOG.md:2812
  7187. msgid ""
  7188. "Previously, the playbook would only take care of the `homeserver` "
  7189. "database and `synapse` user. We now back up and restore all databases and"
  7190. " users on the Postgres server."
  7191. msgstr ""
  7192. #: ../../../CHANGELOG.md:2814
  7193. msgid ""
  7194. "For now, the playbook only uses that one database (`homeserver`) and that"
  7195. " one single user (`synapse`), so it's all the same. However, in the "
  7196. "future, additional components besides Synapse may also make use the "
  7197. "Postgres database server. One such example is the [matrix-appservice-"
  7198. "slack](https://github.com/matrix-org/matrix-appservice-slack) bridge, "
  7199. "which strongly encourages use of Postgres in its v1.0 release. We are yet"
  7200. " to upgrade to it."
  7201. msgstr ""
  7202. #: ../../../CHANGELOG.md:2816
  7203. msgid ""
  7204. "Additionally, Postgres [upgrading](docs/maintenance-postgres.md"
  7205. "#upgrading-postgresql) now uses gzipped dump files by default, to "
  7206. "minimize disk space usage."
  7207. msgstr ""
  7208. #: ../../../CHANGELOG.md:2819
  7209. msgid "2019-10-04"
  7210. msgstr ""
  7211. #: ../../../CHANGELOG.md:2821
  7212. msgid "Postgres 12 support"
  7213. msgstr ""
  7214. #: ../../../CHANGELOG.md:2823
  7215. msgid ""
  7216. "The playbook now installs [Postgres "
  7217. "12](https://www.postgresql.org/about/news/1976/) by default."
  7218. msgstr ""
  7219. #: ../../../CHANGELOG.md:2825
  7220. msgid ""
  7221. "If you have have an existing setup, it's likely running on an older "
  7222. "Postgres version (9.x, 10.x or 11.x). You can easily upgrade by following"
  7223. " the [upgrading PostgreSQL guide](docs/maintenance-postgres.md#upgrading-"
  7224. "postgresql)."
  7225. msgstr ""
  7226. #: ../../../CHANGELOG.md:2828
  7227. msgid "2019-10-03"
  7228. msgstr ""
  7229. #: ../../../CHANGELOG.md:2830
  7230. msgid "Synapse 1.4.0"
  7231. msgstr ""
  7232. #: ../../../CHANGELOG.md:2832
  7233. msgid ""
  7234. "Synapse 1.4.0 [is "
  7235. "out](https://matrix.org/blog/2019/10/03/synapse-1-4-0-released) with lots"
  7236. " of changes related to privacy."
  7237. msgstr ""
  7238. #: ../../../CHANGELOG.md:2834
  7239. msgid ""
  7240. "Its new defaults (which we adopt as well) mean that certain old data will"
  7241. " automatically get purged after a certain number of days. 1.4.0 "
  7242. "automatically garbage collects redacted messages (defaults to 7 days) and"
  7243. " removes unused IP and user agent information stored in the user_ips "
  7244. "table (defaults to 30 days). If you'd like to preserve this data, we "
  7245. "encourage you to look at the `redaction_retention_period` and "
  7246. "`user_ips_max_age` options (controllable by the "
  7247. "`matrix_synapse_redaction_retention_period` and "
  7248. "`matrix_synapse_user_ips_max_age` playbook variables, respectively) "
  7249. "before doing the upgrade. If you'd like to keep data indefinitely, set "
  7250. "these variables to `null` (e.g. "
  7251. "`matrix_synapse_redaction_retention_period: ~`)."
  7252. msgstr ""
  7253. #: ../../../CHANGELOG.md:2836
  7254. msgid ""
  7255. "From now on the `trusted_key_servers` setting for Synapse is "
  7256. "configurable. It still defaults to `matrix.org` just like it always has, "
  7257. "but in a more explicit way now. If you'd like to use another trusted key "
  7258. "server, adjust the `matrix_synapse_trusted_key_servers` playbook "
  7259. "variable."
  7260. msgstr ""
  7261. #: ../../../CHANGELOG.md:2838
  7262. msgid ""
  7263. "Synapse 1.4.0 also changes lots of things related to identity server "
  7264. "integration. Because Synapse will now by default be responsible for "
  7265. "validating email addresses for user accounts, running without an identity"
  7266. " server looks more feasible. We still [have "
  7267. "concerns](https://github.com/spantaleev/matrix-docker-ansible-"
  7268. "deploy/pull/275/files#r331104117) over disabling the identity server by "
  7269. "default, so for now it remains enabled."
  7270. msgstr ""
  7271. #: ../../../CHANGELOG.md:2841
  7272. msgid "2019-09-09"
  7273. msgstr ""
  7274. #: ../../../CHANGELOG.md:2843
  7275. msgid "Synapse Simple Antispam support"
  7276. msgstr ""
  7277. #: ../../../CHANGELOG.md:2845
  7278. msgid ""
  7279. "There have been lots of invite-spam attacks lately and "
  7280. "[Travis](https://github.com/t2bot) has created a Synapse module "
  7281. "([synapse-simple-antispam](https://github.com/t2bot/synapse-simple-"
  7282. "antispam)) to let people protect themselves."
  7283. msgstr ""
  7284. #: ../../../CHANGELOG.md:2847
  7285. msgid ""
  7286. "From now on, you can easily install and configure this spam checker "
  7287. "module through the playbook."
  7288. msgstr ""
  7289. #: ../../../CHANGELOG.md:2849
  7290. msgid ""
  7291. "Learn more in [Setting up Synapse Simple Antispam](docs/configuring-"
  7292. "playbook-synapse-simple-antispam.md)."
  7293. msgstr ""
  7294. #: ../../../CHANGELOG.md:2852
  7295. msgid "2019-08-25"
  7296. msgstr ""
  7297. #: ../../../CHANGELOG.md:2854
  7298. msgid "Extensible Riot-web configuration"
  7299. msgstr ""
  7300. #: ../../../CHANGELOG.md:2856
  7301. msgid ""
  7302. "Similarly to [Extensible Synapse configuration](#extensible-synapse-"
  7303. "configuration) (below), Riot-web configuration is also extensible now."
  7304. msgstr ""
  7305. #: ../../../CHANGELOG.md:2858
  7306. msgid ""
  7307. "From now on, you can extend/override Riot-web's configuration by making "
  7308. "use of the `matrix_riot_web_configuration_extension_json` variable. This "
  7309. "should be enough for most customization needs."
  7310. msgstr ""
  7311. #: ../../../CHANGELOG.md:2860
  7312. msgid ""
  7313. "If you need even more power, you can now also take full control and "
  7314. "override `matrix_riot_web_configuration_default` (or "
  7315. "`matrix_riot_web_configuration`) directly."
  7316. msgstr ""
  7317. #: ../../../CHANGELOG.md:2862
  7318. msgid ""
  7319. "Learn more in [Configuring Riot-web](docs/configuring-playbook-riot-"
  7320. "web.md)."
  7321. msgstr ""
  7322. #: ../../../CHANGELOG.md:2865
  7323. msgid "2019-08-22"
  7324. msgstr ""
  7325. #: ../../../CHANGELOG.md:2867
  7326. msgid "Extensible Synapse configuration"
  7327. msgstr ""
  7328. #: ../../../CHANGELOG.md:2869
  7329. msgid ""
  7330. "Previously, we had to create custom Ansible variables for each and every "
  7331. "Synapse setting. This lead to too much effort (and configuration "
  7332. "ugliness) to all of Synapse's settings, so naturally, not all features of"
  7333. " Synapse could be controlled through the playbook."
  7334. msgstr ""
  7335. #: ../../../CHANGELOG.md:2871
  7336. msgid ""
  7337. "From now on, you can extend/override the Synapse server's configuration "
  7338. "by making use of the `matrix_synapse_configuration_extension_yaml` "
  7339. "variable. This should be enough for most customization needs."
  7340. msgstr ""
  7341. #: ../../../CHANGELOG.md:2873
  7342. msgid ""
  7343. "If you need even more power, you can now also take full control and "
  7344. "override `matrix_synapse_configuration` (or "
  7345. "`matrix_synapse_configuration_yaml`) directly."
  7346. msgstr ""
  7347. #: ../../../CHANGELOG.md:2875
  7348. msgid ""
  7349. "Learn more here in [Configuring Synapse](docs/configuring-playbook-"
  7350. "synapse.md)."
  7351. msgstr ""
  7352. #: ../../../CHANGELOG.md:2878
  7353. msgid "2019-08-21"
  7354. msgstr ""
  7355. #: ../../../CHANGELOG.md:2882
  7356. msgid ""
  7357. "Thanks to the [great work](https://github.com/spantaleev/matrix-docker-"
  7358. "ansible-deploy/pull/205) of "
  7359. "[kingoftheconnors](https://github.com/kingoftheconnors) and [Stuart "
  7360. "Mumford (Cadair)](https://github.com/Cadair), the playbook now supports "
  7361. "bridging to [Slack](https://slack.com) via the [appservice-"
  7362. "slack](https://github.com/matrix-org/matrix-appservice-slack) bridge."
  7363. msgstr ""
  7364. #: ../../../CHANGELOG.md:2884
  7365. msgid ""
  7366. "Additional details are available in [Setting up Appservice Slack "
  7367. "bridging](docs/configuring-playbook-bridge-appservice-slack.md)."
  7368. msgstr ""
  7369. #: ../../../CHANGELOG.md:2886
  7370. msgid "Google Hangouts bridging support"
  7371. msgstr ""
  7372. #: ../../../CHANGELOG.md:2888
  7373. msgid ""
  7374. "Thanks to the [great work](https://github.com/spantaleev/matrix-docker-"
  7375. "ansible-deploy/pull/251) of [Eduardo Beltrame "
  7376. "(Munfred)](https://github.com/Munfred) and [Robbie D "
  7377. "(microchipster)](https://github.com/microchipster), the playbook now "
  7378. "supports bridging to [Google Hangouts](https://hangouts.google.com/) via "
  7379. "the [mautrix-hangouts](https://mau.dev/tulir/mautrix-hangouts) bridge."
  7380. msgstr ""
  7381. #: ../../../CHANGELOG.md:2890
  7382. msgid ""
  7383. "Additional details are available in [Setting up Mautrix Hangouts "
  7384. "bridging](docs/configuring-playbook-bridge-mautrix-hangouts.md)."
  7385. msgstr ""
  7386. #: ../../../CHANGELOG.md:2893
  7387. msgid "2019-08-05"
  7388. msgstr ""
  7389. #: ../../../CHANGELOG.md:2895
  7390. msgid "Email2Matrix support"
  7391. msgstr ""
  7392. #: ../../../CHANGELOG.md:2897
  7393. msgid ""
  7394. "Support for [Email2Matrix](https://github.com/devture/email2matrix) has "
  7395. "been added."
  7396. msgstr ""
  7397. #: ../../../CHANGELOG.md:2899
  7398. msgid "It's an optional feature that you can enable via the playbook."
  7399. msgstr ""
  7400. #: ../../../CHANGELOG.md:2901
  7401. msgid ""
  7402. "To learn more, see the [playbook's documentation on Email2Matrix](./docs"
  7403. "/configuring-playbook-email2matrix.md)."
  7404. msgstr ""
  7405. #: ../../../CHANGELOG.md:2904
  7406. msgid "2019-08-03"
  7407. msgstr ""
  7408. #: ../../../CHANGELOG.md:2906
  7409. msgid "Synapse logging level has been reduced to WARNING"
  7410. msgstr ""
  7411. #: ../../../CHANGELOG.md:2908
  7412. msgid ""
  7413. "After [some discussion in our support "
  7414. "room](https://matrix.to/#/!PukFFdIcHgtaaHZflT:devture.com/$156476852524179TBeKy:matrix.org?via=devture.com&via=matrix.org&via=librem.one),"
  7415. " we've decided to change the default logging level for Synapse from "
  7416. "`INFO` to `WARNING`."
  7417. msgstr ""
  7418. #: ../../../CHANGELOG.md:2910
  7419. msgid ""
  7420. "This greatly reduces the number of log messages that are being logged, "
  7421. "leading to:"
  7422. msgstr ""
  7423. #: ../../../CHANGELOG.md:2912
  7424. msgid "much less disk space dedicated to Synapse and thus, logs kept for longer"
  7425. msgstr ""
  7426. #: ../../../CHANGELOG.md:2913
  7427. msgid ""
  7428. "easier to find some important `WARNING`, `ERROR` and `CRITICAL` messages,"
  7429. " as they're not longer buried in thousands of non-important `INFO` "
  7430. "messages"
  7431. msgstr ""
  7432. #: ../../../CHANGELOG.md:2915
  7433. msgid ""
  7434. "If you'd like to track down an issue, you [can always increase the "
  7435. "logging level as described here](./docs/maintenance-and-"
  7436. "troubleshooting.md#increasing-synapse-logging)."
  7437. msgstr ""
  7438. #: ../../../CHANGELOG.md:2918
  7439. msgid "2019-07-08"
  7440. msgstr ""
  7441. #: ../../../CHANGELOG.md:2920
  7442. msgid "Synapse Maintenance docs and synapse-janitor support are available"
  7443. msgstr ""
  7444. #: ../../../CHANGELOG.md:2922
  7445. msgid "The playbook can now help you with Synapse's maintenance."
  7446. msgstr ""
  7447. #: ../../../CHANGELOG.md:2924
  7448. msgid ""
  7449. "There's a new documentation page about [Synapse maintenance](./docs"
  7450. "/maintenance-synapse.md) and another section on [Postgres "
  7451. "vacuuming](./docs/maintenance-postgres.md#vacuuming-postgresql)."
  7452. msgstr ""
  7453. #: ../../../CHANGELOG.md:2926
  7454. msgid ""
  7455. "Among other things, if your Postgres database has grown significantly "
  7456. "over time, you may wish to [ask the playbook to purge unused data with "
  7457. "synapse-janitor](./docs/maintenance-synapse.md#purging-unused-data-with-"
  7458. "synapse-janitor) for you."
  7459. msgstr ""
  7460. #: ../../../CHANGELOG.md:2928
  7461. msgid "(BC Break) Rename run control variables"
  7462. msgstr ""
  7463. #: ../../../CHANGELOG.md:2930
  7464. msgid "Some internal playbook control variables have been renamed."
  7465. msgstr ""
  7466. #: ../../../CHANGELOG.md:2932
  7467. msgid ""
  7468. "This change **only affects people who run this playbook's roles from "
  7469. "another playbook**. If you're using this playbook as-is, you're not "
  7470. "affected and don't need to do anything."
  7471. msgstr ""
  7472. #: ../../../CHANGELOG.md:2934
  7473. msgid "The following variables have been renamed:"
  7474. msgstr ""
  7475. #: ../../../CHANGELOG.md:2936
  7476. msgid "from `run_import_postgres` to `run_postgres_import`"
  7477. msgstr ""
  7478. #: ../../../CHANGELOG.md:2937
  7479. msgid "from `run_import_sqlite_db` to `run_postgres_import_sqlite_db`"
  7480. msgstr ""
  7481. #: ../../../CHANGELOG.md:2938
  7482. msgid "from `run_upgrade_postgres` to `run_postgres_upgrade`"
  7483. msgstr ""
  7484. #: ../../../CHANGELOG.md:2939
  7485. msgid "from `run_import_media_store` to `run_synapse_import_media_store`"
  7486. msgstr ""
  7487. #: ../../../CHANGELOG.md:2940
  7488. msgid "from `run_register_user` to `run_synapse_register_user`"
  7489. msgstr ""
  7490. #: ../../../CHANGELOG.md:2941
  7491. msgid "from `run_update_user_password` to `run_synapse_update_user_password`"
  7492. msgstr ""
  7493. #: ../../../CHANGELOG.md:2944
  7494. msgid "2019-07-04"
  7495. msgstr ""
  7496. #: ../../../CHANGELOG.md:2946
  7497. msgid "Synapse no longer logs to text files"
  7498. msgstr ""
  7499. #: ../../../CHANGELOG.md:2948
  7500. msgid ""
  7501. "Following what the official Synapse Docker image is doing "
  7502. "([#5565](https://github.com/matrix-org/synapse/pull/5565)) and what we've"
  7503. " been doing for mostly everything installed by this playbook, **Synapse "
  7504. "no longer logs to text files** (`/matrix/synapse/run/homeserver.log*`)."
  7505. msgstr ""
  7506. #: ../../../CHANGELOG.md:2950
  7507. msgid ""
  7508. "From now on, Synapse would only log to console, which goes to systemd's "
  7509. "journald. To see Synapse's logs, execute: `journalctl -fu matrix-synapse`"
  7510. msgstr ""
  7511. #: ../../../CHANGELOG.md:2952
  7512. msgid ""
  7513. "Because of this, the following variables have become obsolete and were "
  7514. "removed:"
  7515. msgstr ""
  7516. #: ../../../CHANGELOG.md:2954
  7517. msgid "`matrix_synapse_max_log_file_size_mb`"
  7518. msgstr ""
  7519. #: ../../../CHANGELOG.md:2955
  7520. msgid "`matrix_synapse_max_log_files_count`"
  7521. msgstr ""
  7522. #: ../../../CHANGELOG.md:2957
  7523. msgid ""
  7524. "To prevent confusion, it'd be better if you delete all old files manually"
  7525. " after you've upgraded (`rm -f /matrix/synapse/run/homeserver.log*`)."
  7526. msgstr ""
  7527. #: ../../../CHANGELOG.md:2959
  7528. msgid ""
  7529. "Because Synapse is incredibly chatty when it comes to logging (here's "
  7530. "[one such issue](https://github.com/matrix-org/synapse/issues/4751) "
  7531. "describing the problem), if you're running an ancient distribution (like "
  7532. "CentOS 7.0), be advised that systemd's journald default logging "
  7533. "restrictions may not be high enough to capture all log messages generated"
  7534. " by Synapse. This is especially true if you've got a busy (Synapse) "
  7535. "server. We advise that you manually add `RateLimitInterval=0` and "
  7536. "`RateLimitBurst=0` under `[Storage]` in the `/etc/systemd/journald.conf` "
  7537. "file, followed by restarting the logging service (`systemctl restart "
  7538. "systemd-journald`)."
  7539. msgstr ""
  7540. #: ../../../CHANGELOG.md:2962
  7541. msgid "2019-06-27"
  7542. msgstr ""
  7543. #: ../../../CHANGELOG.md:2964
  7544. msgid ""
  7545. "(BC Break) Discord bridge configuration is now entirely managed by the "
  7546. "playbook"
  7547. msgstr ""
  7548. #: ../../../CHANGELOG.md:2966
  7549. msgid ""
  7550. "Until now, the `config.yaml` file for the [Discord bridge](docs"
  7551. "/configuring-playbook-bridge-appservice-discord.md) was managed by the "
  7552. "playbook, but the `registration.yaml` file was not."
  7553. msgstr ""
  7554. #: ../../../CHANGELOG.md:2968
  7555. msgid "From now on, the playbook will keep both configuration files sync for you."
  7556. msgstr ""
  7557. #: ../../../CHANGELOG.md:2970
  7558. msgid ""
  7559. "This means that if you were making manual changes to the `/matrix"
  7560. "/appservice-discord/discord-registration.yaml` configuration file, those "
  7561. "would be lost the next time you run the playbook."
  7562. msgstr ""
  7563. #: ../../../CHANGELOG.md:2972
  7564. msgid ""
  7565. "The bridge now stores configuration in a subdirectory (`/matrix"
  7566. "/appservice-discord/config`)."
  7567. msgstr ""
  7568. #: ../../../CHANGELOG.md:2974
  7569. msgid ""
  7570. "Likewise, data is now also stored in a subdirectory (`/matrix/appservice-"
  7571. "discord/data`). When you run the playbook with an existing database file "
  7572. "(`/matrix/appservice-discord/discord.db`), the playbook will stop the "
  7573. "bridge and relocate the database file to the `./data` directory. There's "
  7574. "no data-loss involved. You'll need to restart the bridge manually though "
  7575. "(`--tags=start`)."
  7576. msgstr ""
  7577. #: ../../../CHANGELOG.md:2976
  7578. msgid ""
  7579. "The main directory (`/matrix/appservice-discord`) may contain some "
  7580. "leftover files (`user-store.db`, `room-store.db`, `config.yaml`, "
  7581. "`discord-registration.yaml`, `invite_link`). These are no longer "
  7582. "necessary and can be deleted manually."
  7583. msgstr ""
  7584. #: ../../../CHANGELOG.md:2978
  7585. msgid ""
  7586. "We're now following the default sample configuration for the Discord "
  7587. "bridge. If you need to override some values, define them in "
  7588. "`matrix_appservice_discord_configuration_extension_yaml`."
  7589. msgstr ""
  7590. #: ../../../CHANGELOG.md:2981
  7591. msgid "2019-06-24"
  7592. msgstr ""
  7593. #: ../../../CHANGELOG.md:2983
  7594. msgid ""
  7595. "(BC Break) WhatsApp bridge configuration is now entirely managed by the "
  7596. "playbook"
  7597. msgstr ""
  7598. #: ../../../CHANGELOG.md:2985
  7599. msgid ""
  7600. "Until now, configuration files for the [WhatsApp bridge](docs"
  7601. "/configuring-playbook-bridge-mautrix-whatsapp.md) were created by the "
  7602. "playbook initially, but never modified later on."
  7603. msgstr ""
  7604. #: ../../../CHANGELOG.md:2987 ../../../CHANGELOG.md:3004
  7605. #: ../../../CHANGELOG.md:3023 ../../../CHANGELOG.md:3062
  7606. msgid "From now on, the playbook will keep the configuration in sync for you."
  7607. msgstr ""
  7608. #: ../../../CHANGELOG.md:2989
  7609. msgid ""
  7610. "This means that if you were making manual changes to the `/matrix"
  7611. "/mautrix-whatsapp/config.yaml` or `/matrix/mautrix-"
  7612. "whatsapp/registration.yaml` configuration files, those would be lost the "
  7613. "next time you run the playbook."
  7614. msgstr ""
  7615. #: ../../../CHANGELOG.md:2991
  7616. msgid ""
  7617. "The bridge now stores configuration in a subdirectory (`/matrix/mautrix-"
  7618. "whatsapp/config`), so your old configuration remains in the base "
  7619. "directory (`/matrix/mautrix-whatsapp`). You need to migrate any manual "
  7620. "changes over to the new "
  7621. "`matrix_mautrix_whatsapp_configuration_extension_yaml` variable, so that "
  7622. "the playbook would apply them for you."
  7623. msgstr ""
  7624. #: ../../../CHANGELOG.md:2993
  7625. msgid ""
  7626. "Likewise, data is now also stored in a subdirectory (`/matrix/mautrix-"
  7627. "whatsapp/data`). When you run the playbook with an existing database file"
  7628. " (`/matrix/mautrix-whatsapp/mautrix-whatsapp.db`), the playbook will stop"
  7629. " the bridge and relocate the database file to the `./data` directory. "
  7630. "There's no data-loss involved. You'll need to restart the bridge manually"
  7631. " though (`--tags=start`)."
  7632. msgstr ""
  7633. #: ../../../CHANGELOG.md:2995
  7634. msgid "We're now following the default configuration for the WhatsApp bridge."
  7635. msgstr ""
  7636. #: ../../../CHANGELOG.md:2998
  7637. msgid "2019-06-20"
  7638. msgstr ""
  7639. #: ../../../CHANGELOG.md:3000
  7640. msgid ""
  7641. "(BC Break) IRC bridge configuration is now entirely managed by the "
  7642. "playbook"
  7643. msgstr ""
  7644. #: ../../../CHANGELOG.md:3002
  7645. msgid ""
  7646. "Until now, configuration files for the [IRC bridge](docs/configuring-"
  7647. "playbook-bridge-appservice-irc.md) were created by the playbook "
  7648. "initially, but never modified later on."
  7649. msgstr ""
  7650. #: ../../../CHANGELOG.md:3006
  7651. msgid ""
  7652. "This means that if you were making manual changes to the `/matrix"
  7653. "/appservice-irc/config.yaml` or `/matrix/appservice-"
  7654. "irc/registration.yaml` configuration files, those would be lost the next "
  7655. "time you run the playbook."
  7656. msgstr ""
  7657. #: ../../../CHANGELOG.md:3008
  7658. msgid ""
  7659. "The bridge now stores configuration in a subdirectory (`/matrix"
  7660. "/appservice-irc/config`), so your old configuration remains in the base "
  7661. "directory (`/matrix/appservice-irc`)."
  7662. msgstr ""
  7663. #: ../../../CHANGELOG.md:3010
  7664. msgid ""
  7665. "Previously, we asked people to configure bridged IRC servers by extending"
  7666. " the bridge configuration "
  7667. "(`matrix_appservice_irc_configuration_extension_yaml`). While this is "
  7668. "still possible and will continue working forever, **we now recommend "
  7669. "defining IRC servers in the easier to use "
  7670. "`matrix_appservice_irc_ircService_servers` variable**. See [our IRC "
  7671. "bridge documentation page](docs/configuring-playbook-bridge-appservice-"
  7672. "irc.md) for an example."
  7673. msgstr ""
  7674. #: ../../../CHANGELOG.md:3012
  7675. msgid ""
  7676. "If you decide to continue using "
  7677. "`matrix_appservice_irc_configuration_extension_yaml`, you might be "
  7678. "interested to know that `ircService.databaseUri` and a few other keys now"
  7679. " have default values in the base configuration "
  7680. "(`matrix_appservice_irc_configuration_yaml`). You may wish to stop "
  7681. "redefining those keys, unless you really intend to override them. You "
  7682. "most likely only need to override `ircService.servers`."
  7683. msgstr ""
  7684. #: ../../../CHANGELOG.md:3014
  7685. msgid ""
  7686. "Bridge data (`passkey.pem` and database files) is now also stored in a "
  7687. "subdirectory (`/matrix/appservice-irc/data`). When you run the playbook "
  7688. "with an existing `/matrix/appservice-irc/passkey.pem` file, the playbook "
  7689. "will stop the bridge and relocate the passkey and database files "
  7690. "(`rooms.db` and `users.db`) to the `./data` directory. There's no data-"
  7691. "loss involved. You'll need to restart the bridge manually though "
  7692. "(`--tags=start`)."
  7693. msgstr ""
  7694. #: ../../../CHANGELOG.md:3017
  7695. msgid "2019-06-15"
  7696. msgstr ""
  7697. #: ../../../CHANGELOG.md:3019
  7698. msgid ""
  7699. "(BC Break) Telegram bridge configuration is now entirely managed by the "
  7700. "playbook"
  7701. msgstr ""
  7702. #: ../../../CHANGELOG.md:3021
  7703. msgid ""
  7704. "Until now, configuration files for the [Telegram bridge](docs"
  7705. "/configuring-playbook-bridge-mautrix-telegram.md) were created by the "
  7706. "playbook initially, but never modified later on."
  7707. msgstr ""
  7708. #: ../../../CHANGELOG.md:3025
  7709. msgid ""
  7710. "This means that if you were making manual changes to the `/matrix"
  7711. "/mautrix-telegram/config.yaml` or `/matrix/mautrix-"
  7712. "telegram/registration.yaml` configuration files, those would be lost the "
  7713. "next time you run the playbook."
  7714. msgstr ""
  7715. #: ../../../CHANGELOG.md:3027
  7716. msgid ""
  7717. "The bridge now stores configuration in a subdirectory (`/matrix/mautrix-"
  7718. "telegram/config`), so your old configuration remains in the base "
  7719. "directory (`/matrix/mautrix-telegram`). You need to migrate any manual "
  7720. "changes over to the new "
  7721. "`matrix_mautrix_telegram_configuration_extension_yaml` variable, so that "
  7722. "the playbook would apply them for you."
  7723. msgstr ""
  7724. #: ../../../CHANGELOG.md:3029
  7725. msgid ""
  7726. "Likewise, data is now also stored in a subdirectory (`/matrix/mautrix-"
  7727. "telegram/data`). When you run the playbook with an existing database file"
  7728. " (`/matrix/mautrix-telegram/mautrix-telegram.db`), the playbook will stop"
  7729. " the bridge and relocate the database file to the `./data` directory. "
  7730. "There's no data-loss involved. You'll need to restart the bridge manually"
  7731. " though (`--tags=start`)."
  7732. msgstr ""
  7733. #: ../../../CHANGELOG.md:3031
  7734. msgid ""
  7735. "Also, we're now following the default configuration for the Telegram "
  7736. "bridge, so some default configuration values are different:"
  7737. msgstr ""
  7738. #: ../../../CHANGELOG.md:3033
  7739. msgid ""
  7740. "`edits_as_replies` (used to be `false`, now `true`) - previously replies "
  7741. "were not sent over to Matrix at all; ow they are sent over as a reply to "
  7742. "the original message"
  7743. msgstr ""
  7744. #: ../../../CHANGELOG.md:3034
  7745. msgid ""
  7746. "`inline_images` (used to be `true`, now `false`) - this has to do with "
  7747. "captioned images. Inline-image (included caption) are said to exhibit "
  7748. "troubles on Riot iOS. When `false`, the caption arrives on the Matrix "
  7749. "side as a separate message."
  7750. msgstr ""
  7751. #: ../../../CHANGELOG.md:3035
  7752. msgid ""
  7753. "`authless_portals` (used to be `false`, now `true`) - creating portals "
  7754. "from the Telegram side is now possible"
  7755. msgstr ""
  7756. #: ../../../CHANGELOG.md:3036
  7757. msgid ""
  7758. "`whitelist_group_admins` (used to be `false`, now `true`) - allows "
  7759. "Telegram group admins to use the bot commands"
  7760. msgstr ""
  7761. #: ../../../CHANGELOG.md:3038
  7762. msgid ""
  7763. "If the new values are not to your liking, use "
  7764. "`matrix_mautrix_telegram_configuration_extension_yaml` to specify an "
  7765. "override (refer to `matrix_mautrix_telegram_configuration_yaml` to figure"
  7766. " out which variable goes where)."
  7767. msgstr ""
  7768. #: ../../../CHANGELOG.md:3041
  7769. msgid "2019-06-12"
  7770. msgstr ""
  7771. #: ../../../CHANGELOG.md:3043
  7772. msgid "Synapse v1.0"
  7773. msgstr ""
  7774. #: ../../../CHANGELOG.md:3045
  7775. msgid ""
  7776. "With [Synapse v1.0 now available](https://matrix.org/blog/2019/06/11"
  7777. "/introducing-matrix-1-0-and-the-matrix-org-foundation) and most people "
  7778. "being on at least Synapse v0.99, it's time to remove the `_matrix._tcp` "
  7779. "DNS SRV record that we've been keeping for compatibility with old Synapse"
  7780. " versions (<= 0.34)."
  7781. msgstr ""
  7782. #: ../../../CHANGELOG.md:3047
  7783. msgid ""
  7784. "According to the [Server Discovery "
  7785. "specification](https://matrix.org/docs/spec/server_server/r0.1.2.html"
  7786. "#server-discovery), it's no harm to keep the DNS SRV record. But since "
  7787. "it's not necessary for federating with the larger Matrix network anymore,"
  7788. " you should be safe to get rid of it."
  7789. msgstr ""
  7790. #: ../../../CHANGELOG.md:3049
  7791. msgid ""
  7792. "**Note**: don't confuse the `_matrix._tcp` and `_matrix-identity._tcp` "
  7793. "DNS SRV records. The latter, **must not** be removed."
  7794. msgstr ""
  7795. #: ../../../CHANGELOG.md:3051
  7796. msgid ""
  7797. "For completeness, we must say that using a `_matrix._tcp` [SRV record for"
  7798. " Server Delegation](docs/howto-server-delegation.md#server-delegation-"
  7799. "via-a-dns-srv-record-advanced) is still valid and useful for certain "
  7800. "deployments. It's just that our guide recommends the [`/.well-"
  7801. "known/matrix/server` Server Delegation method](docs/howto-server-"
  7802. "delegation.md#server-delegation-via-a-well-known-file), due to its easier"
  7803. " implementation when using this playbook."
  7804. msgstr ""
  7805. #: ../../../CHANGELOG.md:3053
  7806. msgid ""
  7807. "Besides this optional/non-urgent DNS change, assuming you're already on "
  7808. "Synapse v0.99, upgrading to Synapse v1.0 should be as simple as [re-"
  7809. "running the playbook](docs/maintenance-upgrading-services.md)."
  7810. msgstr ""
  7811. #: ../../../CHANGELOG.md:3056
  7812. msgid "2019-06-07"
  7813. msgstr ""
  7814. #: ../../../CHANGELOG.md:3058
  7815. msgid ""
  7816. "(BC Break) Facebook bridge configuration is now entirely managed by the "
  7817. "playbook"
  7818. msgstr ""
  7819. #: ../../../CHANGELOG.md:3060
  7820. msgid ""
  7821. "Until now, configuration files for the [Facebook bridge](docs"
  7822. "/configuring-playbook-bridge-mautrix-facebook.md) were created by the "
  7823. "playbook initially, but never modified later on."
  7824. msgstr ""
  7825. #: ../../../CHANGELOG.md:3064
  7826. msgid ""
  7827. "This means that if you were making manual changes to the `/matrix"
  7828. "/mautrix-facebook/config.yaml` or `/matrix/mautrix-"
  7829. "facebook/registration.yaml` configuration files, those would be lost the "
  7830. "next time you run the playbook."
  7831. msgstr ""
  7832. #: ../../../CHANGELOG.md:3066
  7833. msgid ""
  7834. "The bridge now stores configuration in a subdirectory (`/matrix/mautrix-"
  7835. "facebook/config`), so your old configuration remains in the base "
  7836. "directory (`/matrix/mautrix-facebook`). You need to migrate any manual "
  7837. "changes over to the new "
  7838. "`matrix_mautrix_facebook_configuration_extension_yaml` variable, so that "
  7839. "the playbook would apply them for you."
  7840. msgstr ""
  7841. #: ../../../CHANGELOG.md:3068
  7842. msgid ""
  7843. "Likewise, data is now also stored in a subdirectory (`/matrix/mautrix-"
  7844. "facebook/data`). When you run the playbook with an existing database file"
  7845. " (`/matrix/mautrix-facebook/mautrix-facebook.db`), the playbook will stop"
  7846. " the bridge and relocate the database file to the `./data` directory. "
  7847. "There's no data-loss involved. You'll need to restart the bridge manually"
  7848. " though (`--tags=start`)."
  7849. msgstr ""
  7850. #: ../../../CHANGELOG.md:3071
  7851. msgid "2019-05-25"
  7852. msgstr ""
  7853. #: ../../../CHANGELOG.md:3073
  7854. msgid "Support for exposing container ports publicly (not just to the host)"
  7855. msgstr ""
  7856. #: ../../../CHANGELOG.md:3075
  7857. msgid ""
  7858. "Until now, various roles supported a `matrix_*_expose_port` variable, "
  7859. "which would expose their container's port to the host. This was mostly "
  7860. "useful for reverse-proxying manually (in case `matrix-nginx-proxy` was "
  7861. "disabled). It could also be used for installing some playbook services "
  7862. "(e.g. bridges, etc.) and wiring them to a separate (manual) Matrix setup."
  7863. msgstr ""
  7864. #: ../../../CHANGELOG.md:3077
  7865. msgid ""
  7866. "`matrix_*_expose_port` variables were not granular enough - sometimes "
  7867. "they would expose one port, other times multiple. They also didn't "
  7868. "provide control over **where** to expose (to which port number and to "
  7869. "which network interface), because they would usually hardcode something "
  7870. "like `127.0.0.1:8080`."
  7871. msgstr ""
  7872. #: ../../../CHANGELOG.md:3079
  7873. msgid ""
  7874. "All such variables have been superseded by a better (more flexible) way "
  7875. "to do it."
  7876. msgstr ""
  7877. #: ../../../CHANGELOG.md:3081
  7878. msgid ""
  7879. "**Most** people (including those not using `matrix-nginx-proxy`), **don't"
  7880. " need** to bother with this."
  7881. msgstr ""
  7882. #: ../../../CHANGELOG.md:3083
  7883. msgid "Porting examples follow for people having more customized setups:"
  7884. msgstr ""
  7885. #: ../../../CHANGELOG.md:3085
  7886. msgid ""
  7887. "**from** `matrix_synapse_container_expose_client_api_port: true` **to** "
  7888. "`matrix_synapse_container_client_api_host_bind_port: '127.0.0.1:8008'`"
  7889. msgstr ""
  7890. #: ../../../CHANGELOG.md:3087
  7891. msgid ""
  7892. "**from** `matrix_synapse_container_expose_federation_api_port: true` "
  7893. "**to** `matrix_synapse_container_federation_api_plain_host_bind_port: "
  7894. "'127.0.0.1:8048'` and possibly "
  7895. "`matrix_synapse_container_federation_api_tls_host_bind_port: '8448'`"
  7896. msgstr ""
  7897. #: ../../../CHANGELOG.md:3089
  7898. msgid ""
  7899. "**from** `matrix_synapse_container_expose_metrics_port: true` **to** "
  7900. "`matrix_synapse_container_metrics_api_host_bind_port: '127.0.0.1:9100'`"
  7901. msgstr ""
  7902. #: ../../../CHANGELOG.md:3091
  7903. msgid ""
  7904. "**from** `matrix_riot_web_container_expose_port: true` **to** "
  7905. "`matrix_riot_web_container_http_host_bind_port: '127.0.0.1:8765'`"
  7906. msgstr ""
  7907. #: ../../../CHANGELOG.md:3093
  7908. msgid ""
  7909. "**from** `matrix_mxisd_container_expose_port: true` **to** "
  7910. "`matrix_mxisd_container_http_host_bind_port: '127.0.0.1:8090'`"
  7911. msgstr ""
  7912. #: ../../../CHANGELOG.md:3095
  7913. msgid ""
  7914. "**from** `matrix_dimension_container_expose_port: true` **to** "
  7915. "`matrix_dimension_container_http_host_bind_port: '127.0.0.1:8184'`"
  7916. msgstr ""
  7917. #: ../../../CHANGELOG.md:3097
  7918. msgid ""
  7919. "**from** `matrix_corporal_container_expose_ports: true` **to** "
  7920. "`matrix_corporal_container_http_gateway_host_bind_port: "
  7921. "'127.0.0.1:41080'` and possibly "
  7922. "`matrix_corporal_container_http_api_host_bind_port: '127.0.0.1:41081'`"
  7923. msgstr ""
  7924. #: ../../../CHANGELOG.md:3099
  7925. msgid ""
  7926. "**from** `matrix_appservice_irc_container_expose_client_server_api_port: "
  7927. "true` **to** `matrix_appservice_irc_container_http_host_bind_port: "
  7928. "'127.0.0.1:9999'`"
  7929. msgstr ""
  7930. #: ../../../CHANGELOG.md:3101
  7931. msgid ""
  7932. "**from** "
  7933. "`matrix_appservice_discord_container_expose_client_server_api_port: true`"
  7934. " **to** `matrix_appservice_discord_container_http_host_bind_port: "
  7935. "'127.0.0.1:9005'`"
  7936. msgstr ""
  7937. #: ../../../CHANGELOG.md:3103
  7938. msgid ""
  7939. "As always, if you forget to remove usage of some outdated variable, the "
  7940. "playbook will warn you."
  7941. msgstr ""
  7942. #: ../../../CHANGELOG.md:3106
  7943. msgid "2019-05-23"
  7944. msgstr ""
  7945. #: ../../../CHANGELOG.md:3108
  7946. msgid "(BC Break) Ansible 2.8 compatibility"
  7947. msgstr ""
  7948. #: ../../../CHANGELOG.md:3110
  7949. msgid ""
  7950. "Thanks to [@danbob](https://github.com/danbob), the playbook now "
  7951. "[supports the new Ansible 2.8](https://github.com/spantaleev/matrix-"
  7952. "docker-ansible-deploy/pull/187)."
  7953. msgstr ""
  7954. #: ../../../CHANGELOG.md:3112
  7955. msgid ""
  7956. "A manual change is required to the `inventory/hosts` file, changing the "
  7957. "group name from `matrix-servers` to `matrix_servers` (dash to "
  7958. "underscore)."
  7959. msgstr ""
  7960. #: ../../../CHANGELOG.md:3114
  7961. msgid "To avoid doing it manually, run this:"
  7962. msgstr ""
  7963. #: ../../../CHANGELOG.md:3115
  7964. msgid "Linux: `sed -i 's/matrix-servers/matrix_servers/g' inventory/hosts`"
  7965. msgstr ""
  7966. #: ../../../CHANGELOG.md:3116
  7967. msgid "Mac: `sed -i '' 's/matrix-servers/matrix_servers/g' inventory/hosts`"
  7968. msgstr ""
  7969. #: ../../../CHANGELOG.md:3119
  7970. msgid "2019-05-21"
  7971. msgstr ""
  7972. #: ../../../CHANGELOG.md:3121
  7973. msgid "Synapse no longer required"
  7974. msgstr ""
  7975. #: ../../../CHANGELOG.md:3123
  7976. msgid ""
  7977. "The playbook no longer insists on installing [Synapse](https://github.com"
  7978. "/element-hq/synapse) via the `matrix-synapse` role."
  7979. msgstr ""
  7980. #: ../../../CHANGELOG.md:3125
  7981. msgid ""
  7982. "If you would prefer to install Synapse another way and just use the "
  7983. "playbook to install other services, it should be possible "
  7984. "(`matrix_synapse_enabled: false`)."
  7985. msgstr ""
  7986. #: ../../../CHANGELOG.md:3127
  7987. msgid ""
  7988. "Note that it won't necessarily be the best experience, since the playbook"
  7989. " wires things to Synapse by default. If you're using your own Synapse "
  7990. "instance (especially one not running in a container), you may have to "
  7991. "override many variables to point them to the correct place."
  7992. msgstr ""
  7993. #: ../../../CHANGELOG.md:3129
  7994. msgid ""
  7995. "Having Synapse not be a required component potentially opens the door for"
  7996. " installing alternative Matrix homeservers."
  7997. msgstr ""
  7998. #: ../../../CHANGELOG.md:3131
  7999. msgid "Bridges are now separate from the Synapse role"
  8000. msgstr ""
  8001. #: ../../../CHANGELOG.md:3133
  8002. msgid ""
  8003. "Bridges are no longer part of the `matrix-synapse` role. Each bridge now "
  8004. "lives in its own separate role (`roles/custom/matrix-bridge-*`)."
  8005. msgstr ""
  8006. #: ../../../CHANGELOG.md:3135
  8007. msgid ""
  8008. "These bridge roles are independent of the `matrix-synapse` role, so it "
  8009. "should be possible to use them with a Synapse instance installed another "
  8010. "way (not through the playbook)."
  8011. msgstr ""
  8012. #: ../../../CHANGELOG.md:3137
  8013. msgid "Renaming inconsistently-named Synapse variables"
  8014. msgstr ""
  8015. #: ../../../CHANGELOG.md:3139
  8016. msgid "For better consistency, the following variables have been renamed:"
  8017. msgstr ""
  8018. #: ../../../CHANGELOG.md:3141
  8019. msgid ""
  8020. "`matrix_enable_room_list_search` was renamed to "
  8021. "`matrix_synapse_enable_room_list_search`"
  8022. msgstr ""
  8023. #: ../../../CHANGELOG.md:3142
  8024. msgid ""
  8025. "`matrix_alias_creation_rules` was renamed to "
  8026. "`matrix_synapse_alias_creation_rules`"
  8027. msgstr ""
  8028. #: ../../../CHANGELOG.md:3143
  8029. msgid ""
  8030. "`matrix_nginx_proxy_matrix_room_list_publication_rulesdata_path` was "
  8031. "renamed to `matrix_synapse_room_list_publication_rules`"
  8032. msgstr ""
  8033. #: ../../../CHANGELOG.md:3146
  8034. msgid "2019-05-09"
  8035. msgstr ""
  8036. #: ../../../CHANGELOG.md:3148
  8037. msgid ""
  8038. "Besides a myriad of bug fixes and minor improvements, here are the more "
  8039. "notable (bigger) features we can announce today."
  8040. msgstr ""
  8041. #: ../../../CHANGELOG.md:3150
  8042. msgid "Mautrix Facebook/Messenger bridging support"
  8043. msgstr ""
  8044. #: ../../../CHANGELOG.md:3152
  8045. msgid ""
  8046. "The playbook now supports bridging with "
  8047. "[Facebook](https://www.facebook.com/) by installing the [mautrix-"
  8048. "facebook](https://github.com/tulir/mautrix-facebook) bridge. This "
  8049. "playbook functionality is available thanks to "
  8050. "[@izissise](https://github.com/izissise)."
  8051. msgstr ""
  8052. #: ../../../CHANGELOG.md:3154
  8053. msgid ""
  8054. "Additional details are available in [Setting up Mautrix Facebook "
  8055. "bridging](docs/configuring-playbook-bridge-mautrix-facebook.md)."
  8056. msgstr ""
  8057. #: ../../../CHANGELOG.md:3156
  8058. msgid "mxisd Registration feature integration"
  8059. msgstr ""
  8060. #: ../../../CHANGELOG.md:3158
  8061. msgid ""
  8062. "The playbook can now help you integrate with mxisd's "
  8063. "[Registration](https://github.com/kamax-"
  8064. "matrix/mxisd/blob/master/docs/features/registration.md) feature."
  8065. msgstr ""
  8066. #: ../../../CHANGELOG.md:3160
  8067. msgid ""
  8068. "Learn more in [mxisd-controlled Registration](docs/configuring-playbook-"
  8069. "mxisd.md#mxisd-controlled-registration)."
  8070. msgstr ""
  8071. #: ../../../CHANGELOG.md:3163
  8072. msgid "2019-04-16"
  8073. msgstr ""
  8074. #: ../../../CHANGELOG.md:3165
  8075. msgid "Caddy webserver examples"
  8076. msgstr ""
  8077. #: ../../../CHANGELOG.md:3167
  8078. msgid ""
  8079. "If you prefer using the [Caddy](https://caddyserver.com/) webserver "
  8080. "instead of our own integrated nginx, we now have examples for it in the "
  8081. "[`examples/caddy`](examples/caddy) directory"
  8082. msgstr ""
  8083. #: ../../../CHANGELOG.md:3169
  8084. msgid "2019-04-10"
  8085. msgstr ""
  8086. #: ../../../CHANGELOG.md:3171
  8087. msgid "Goofys support for other S3-compatible object stores"
  8088. msgstr ""
  8089. #: ../../../CHANGELOG.md:3173
  8090. msgid ""
  8091. "Until now, you could optionally host Synapse's media repository on Amazon"
  8092. " S3, but we now also support [using other S3-compatible object "
  8093. "stores](docs/configuring-playbook-s3.md),"
  8094. msgstr ""
  8095. #: ../../../CHANGELOG.md:3176
  8096. msgid "2019-04-03"
  8097. msgstr ""
  8098. #: ../../../CHANGELOG.md:3178
  8099. msgid "Ansible >= 2.5 is required"
  8100. msgstr ""
  8101. #: ../../../CHANGELOG.md:3180
  8102. msgid ""
  8103. "Due to recent playbook improvements and the fact that the world keeps "
  8104. "turning, we're bumping the [version requirement for "
  8105. "Ansible](docs/ansible.md#supported-ansible-versions) (2.4 -> 2.5)."
  8106. msgstr ""
  8107. #: ../../../CHANGELOG.md:3182
  8108. msgid ""
  8109. "We've also started building our own Docker image of Ansible "
  8110. "([devture/ansible](https://hub.docker.com/r/devture/ansible/)), which is "
  8111. "useful for people who can't upgrade their local Ansible installation (see"
  8112. " [Using Ansible via Docker](docs/ansible.md#using-ansible-via-docker))."
  8113. msgstr ""
  8114. #: ../../../CHANGELOG.md:3185
  8115. msgid "2019-03-19"
  8116. msgstr ""
  8117. #: ../../../CHANGELOG.md:3187
  8118. msgid "TLS support for Coturn"
  8119. msgstr ""
  8120. #: ../../../CHANGELOG.md:3189
  8121. msgid ""
  8122. "We've added TLS support to the Coturn TURN server installed by the "
  8123. "playbook by default. The certificates from the Matrix domain will be used"
  8124. " for the Coturn server."
  8125. msgstr ""
  8126. #: ../../../CHANGELOG.md:3191
  8127. msgid ""
  8128. "This feature is enabled by default for new installations. To make use of "
  8129. "TLS support for your existing Matrix server's Coturn, make sure to "
  8130. "rebuild both Coturn and Synapse:"
  8131. msgstr ""
  8132. #: ../../../CHANGELOG.md:3197
  8133. msgid ""
  8134. "People who have an extra firewall (besides the iptables firewall, which "
  8135. "Docker manages automatically), will need to open these additional "
  8136. "firewall ports: `5349/tcp` (TURN over TCP) and `5349/udp` (TURN over "
  8137. "UDP)."
  8138. msgstr ""
  8139. #: ../../../CHANGELOG.md:3199
  8140. msgid ""
  8141. "People who build their own custom playbook from our roles should be aware"
  8142. " that:"
  8143. msgstr ""
  8144. #: ../../../CHANGELOG.md:3201
  8145. msgid ""
  8146. "the `matrix-coturn` role and actually starting Coturn (e.g. "
  8147. "`--tags=start`), requires that certificates are already put in place. For"
  8148. " this reason, it's usually a good idea to have the `matrix-coturn` role "
  8149. "execute after `matrix-nginx-proxy` (which retrieves the certificates)."
  8150. msgstr ""
  8151. #: ../../../CHANGELOG.md:3203
  8152. msgid ""
  8153. "there are a few variables that can help you enable TLS support for "
  8154. "Coturn. See the `matrix-coturn` section in [group_vars/matrix-"
  8155. "servers](./group_vars/matrix-servers)."
  8156. msgstr ""
  8157. #: ../../../CHANGELOG.md:3206
  8158. msgid "2019-03-12"
  8159. msgstr ""
  8160. #: ../../../CHANGELOG.md:3208
  8161. msgid "matrix-nginx-proxy support for serving the base domain"
  8162. msgstr ""
  8163. #: ../../../CHANGELOG.md:3210
  8164. msgid ""
  8165. "If you don't have a dedicated server for your base domain and want to set"
  8166. " up [Server Delegation via a well-known file](docs/howto-server-"
  8167. "delegation.md#server-delegation-via-a-well-known-file), the playbook has "
  8168. "got you covered now."
  8169. msgstr ""
  8170. #: ../../../CHANGELOG.md:3212
  8171. msgid ""
  8172. "It's now possible for the playbook to obtain an SSL certificate and serve"
  8173. " the necessary files for Matrix Server Delegation on your base domain. "
  8174. "Take a look at the new [Serving the base domain](docs/configuring-"
  8175. "playbook-base-domain-serving.md) documentation page."
  8176. msgstr ""
  8177. #: ../../../CHANGELOG.md:3214
  8178. msgid "(BC break) matrix-nginx-proxy data variable renamed"
  8179. msgstr ""
  8180. #: ../../../CHANGELOG.md:3216
  8181. msgid ""
  8182. "`matrix_nginx_proxy_data_path` was renamed to "
  8183. "`matrix_nginx_proxy_base_path`."
  8184. msgstr ""
  8185. #: ../../../CHANGELOG.md:3218
  8186. msgid ""
  8187. "There's a new `matrix_nginx_proxy_data_path` variable, which has a "
  8188. "different use-purpose now (it's a subdirectory of "
  8189. "`matrix_nginx_proxy_base_path` and is meant for storing various data "
  8190. "files)."
  8191. msgstr ""
  8192. #: ../../../CHANGELOG.md:3221
  8193. msgid "2019-03-10"
  8194. msgstr ""
  8195. #: ../../../CHANGELOG.md:3223
  8196. msgid "Dimension integration manager support"
  8197. msgstr ""
  8198. #: ../../../CHANGELOG.md:3225
  8199. msgid ""
  8200. "Thanks to [NullIsNot0](https://github.com/NullIsNot0), the playbook can "
  8201. "now (optionally) install the [Dimension](https://dimension.t2bot.io/) "
  8202. "integration manager. To learn more, see the [Setting up Dimension](docs"
  8203. "/configuring-playbook-dimension.md) documentation page."
  8204. msgstr ""
  8205. #: ../../../CHANGELOG.md:3228
  8206. msgid "2019-03-07"
  8207. msgstr ""
  8208. #: ../../../CHANGELOG.md:3230
  8209. msgid "Ability to customize mxisd's email templates"
  8210. msgstr ""
  8211. #: ../../../CHANGELOG.md:3232
  8212. msgid ""
  8213. "Thanks to [Sylvia van Os](https://github.com/TheLastProject), mxisd's "
  8214. "email templates can now be customized easily. To learn more, see the "
  8215. "[Customizing email templates](docs/configuring-playbook-mxisd.md"
  8216. "#customizing-email-templates) documentation page."
  8217. msgstr ""
  8218. #: ../../../CHANGELOG.md:3235
  8219. msgid "2019-03-05"
  8220. msgstr ""
  8221. #: ../../../CHANGELOG.md:3237
  8222. msgid "Discord bridging support"
  8223. msgstr ""
  8224. #: ../../../CHANGELOG.md:3239
  8225. msgid ""
  8226. "[@Lionstiger](https://github.com/Lionstiger) has done some great work "
  8227. "adding Discord bridging support via [matrix-appservice-"
  8228. "discord](https://github.com/matrix-org/matrix-appservice-discord). To "
  8229. "learn more, see the [Setting up Appservice Discord bridging](docs"
  8230. "/configuring-playbook-bridge-appservice-discord.md) documentation page."
  8231. msgstr ""
  8232. #: ../../../CHANGELOG.md:3242
  8233. msgid "2019-02-19"
  8234. msgstr ""
  8235. #: ../../../CHANGELOG.md:3244
  8236. msgid "Renaming variables"
  8237. msgstr ""
  8238. #: ../../../CHANGELOG.md:3246 ../../../CHANGELOG.md:3563
  8239. #: ../../../CHANGELOG.md:3648 ../../../CHANGELOG.md:3768
  8240. msgid "The following playbook variables were renamed:"
  8241. msgstr ""
  8242. #: ../../../CHANGELOG.md:3248
  8243. msgid "from `host_specific_hostname_identity` to `matrix_domain`"
  8244. msgstr ""
  8245. #: ../../../CHANGELOG.md:3249
  8246. msgid "from `hostname_identity` to `matrix_domain`"
  8247. msgstr ""
  8248. #: ../../../CHANGELOG.md:3250
  8249. msgid "from `hostname_matrix` to `matrix_server_fqn_matrix`"
  8250. msgstr ""
  8251. #: ../../../CHANGELOG.md:3251
  8252. msgid "from `hostname_riot` to `matrix_server_fqn_riot`"
  8253. msgstr ""
  8254. #: ../../../CHANGELOG.md:3252
  8255. msgid ""
  8256. "from `host_specific_matrix_ssl_lets_encrypt_support_email` to "
  8257. "`matrix_ssl_lets_encrypt_support_email`"
  8258. msgstr ""
  8259. #: ../../../CHANGELOG.md:3254
  8260. msgid ""
  8261. "Doing that, we've simplified things, made names less confusing "
  8262. "(hopefully) and moved all variable names under the `matrix_` prefix."
  8263. msgstr ""
  8264. #: ../../../CHANGELOG.md:3257
  8265. msgid "2019-02-16"
  8266. msgstr ""
  8267. #: ../../../CHANGELOG.md:3259
  8268. msgid "Riot v1.0.1 support"
  8269. msgstr ""
  8270. #: ../../../CHANGELOG.md:3261
  8271. msgid "You can now use the brand new and redesigned Riot."
  8272. msgstr ""
  8273. #: ../../../CHANGELOG.md:3263
  8274. msgid ""
  8275. "The new version no longer has a homepage by default, so we've also "
  8276. "removed the custom homepage that we've been installing."
  8277. msgstr ""
  8278. #: ../../../CHANGELOG.md:3265
  8279. msgid ""
  8280. "However, we still provide you with hooks to install your own `home.html` "
  8281. "file by specifying the `matrix_riot_web_embedded_pages_home_path` "
  8282. "variable (used to be called `matrix_riot_web_homepage_template` before)."
  8283. msgstr ""
  8284. #: ../../../CHANGELOG.md:3268
  8285. msgid "2019-02-14"
  8286. msgstr ""
  8287. #: ../../../CHANGELOG.md:3270
  8288. msgid "Synapse v0.99.1"
  8289. msgstr ""
  8290. #: ../../../CHANGELOG.md:3272
  8291. msgid ""
  8292. "As we're moving toward Synapse v1.0, things are beginning to stabilize. "
  8293. "Upgrading from v0.99.0 to v0.99.1 should be painless."
  8294. msgstr ""
  8295. #: ../../../CHANGELOG.md:3274
  8296. msgid ""
  8297. "If you've been overriding the default configuration so that you can "
  8298. "terminate TLS at the Synapse side (`matrix_synapse_no_tls: false`), "
  8299. "you'll now have to replace this custom configuration with "
  8300. "`matrix_synapse_tls_federation_listener_enabled: true`. The "
  8301. "`matrix_synapse_no_tls` variable is no more."
  8302. msgstr ""
  8303. #: ../../../CHANGELOG.md:3277
  8304. msgid "2019-02-06"
  8305. msgstr ""
  8306. #: ../../../CHANGELOG.md:3279
  8307. msgid "Synapse v0.99 support and preparation for Synapse v1.0"
  8308. msgstr ""
  8309. #: ../../../CHANGELOG.md:3281
  8310. msgid ""
  8311. "Matrix is undergoing a lot of changes as it matures towards Synapse v1.0."
  8312. " The first step is the Synapse v0.99 transitional release, which this "
  8313. "playbook now supports."
  8314. msgstr ""
  8315. #: ../../../CHANGELOG.md:3283
  8316. msgid ""
  8317. "If you've been using this playbook successfully until now, you'd be aware"
  8318. " that we've been doing [Server Delegation](docs/howto-server-"
  8319. "delegation.md) using a `_matrix._tcp` DNS SRV record (as per [Configuring"
  8320. " DNS](docs/configuring-dns.md))."
  8321. msgstr ""
  8322. #: ../../../CHANGELOG.md:3285
  8323. msgid ""
  8324. "Due to changes related to certificate file requirements that will affect "
  8325. "us at Synapse v1.0, we'll have to stop using a **`_matrix._tcp` DNS SRV "
  8326. "record in the future** (when Synapse goes to v1.0 - around 5th of March "
  8327. "2019). We **still need to keep the SRV record for now**, for backward "
  8328. "compatibility with older Synapse versions (lower than v0.99)."
  8329. msgstr ""
  8330. #: ../../../CHANGELOG.md:3287
  8331. msgid ""
  8332. "**What you need to do now** is make use of this transitional Synapse "
  8333. "v0.99 release to **prepare your federation settings for the future**. You"
  8334. " have 2 choices to prepare yourself for compatibility with the future "
  8335. "Synapse v1.0:"
  8336. msgstr ""
  8337. #: ../../../CHANGELOG.md:3289
  8338. msgid ""
  8339. "(recommended) set up [Server Delegation via a well-known file](docs"
  8340. "/howto-server-delegation.md#server-delegation-via-a-well-known-file), "
  8341. "unless you are affected by the [Downsides of well-known-based Server "
  8342. "Delegation](docs/howto-server-delegation.md#downsides-of-well-known-"
  8343. "based-server-delegation). If you had previously set up the well-known "
  8344. "`client` file, depending on how you've done it, it may be that there is "
  8345. "nothing new required of you (besides [upgrading](docs/maintenance-"
  8346. "upgrading-services.md)). After upgrading, you can [run a self-check](docs"
  8347. "/maintenance-checking-services.md), which will tell you if you need to do"
  8348. " anything extra with regard to setting up [Server Delegation via a well-"
  8349. "known file](docs/howto-server-delegation.md#server-delegation-via-a-well-"
  8350. "known-file). After some time, when most people have upgraded to Synapse "
  8351. "v0.99 and older releases have disappeared, be prepared to drop your "
  8352. "`_matrix._tcp` SRV record."
  8353. msgstr ""
  8354. #: ../../../CHANGELOG.md:3291
  8355. msgid ""
  8356. "(more advanced) if the [Downsides of well-known-based Server "
  8357. "Delegation](docs/howto-server-delegation.md#downsides-of-well-known-"
  8358. "based-server-delegation) are not to your liking, **as an alternative**, "
  8359. "you can set up [Server Delegation via a DNS SRV record](docs/howto-"
  8360. "server-delegation.md#server-delegation-via-a-dns-srv-record-advanced). In"
  8361. " such a case, you get to keep using your existing `_matrix._tcp` DNS SRV "
  8362. "record forever and need to NOT set up a `/.well-known/matrix/server` "
  8363. "file. Don't forget that you need to do certificate changes though. Follow"
  8364. " the guide at [Server Delegation via a DNS SRV record](docs/howto-server-"
  8365. "delegation.md#server-delegation-via-a-dns-srv-record-advanced)."
  8366. msgstr ""
  8367. #: ../../../CHANGELOG.md:3294
  8368. msgid "2019-02-01"
  8369. msgstr ""
  8370. #: ../../../CHANGELOG.md:3296
  8371. msgid "TLS v1.3 support"
  8372. msgstr ""
  8373. #: ../../../CHANGELOG.md:3298
  8374. msgid ""
  8375. "Now that the [nginx Docker image](https://hub.docker.com/_/nginx) has "
  8376. "[added support for TLS v1.3](https://github.com/nginxinc/docker-"
  8377. "nginx/issues/190), we have enabled that protocol by default."
  8378. msgstr ""
  8379. #: ../../../CHANGELOG.md:3300
  8380. msgid "When using:"
  8381. msgstr ""
  8382. #: ../../../CHANGELOG.md:3302
  8383. msgid ""
  8384. "the **integrated nginx server**: TLS v1.3 support might not kick in "
  8385. "immediately, because the nginx version hasn't been bumped and you may "
  8386. "have an older build of the nginx Docker image (currently "
  8387. "`nginx:1.15.8-alpine`). Typically, we do not re-pull images that you "
  8388. "already have. When the nginx version gets bumped in the future, everyone "
  8389. "will get the update. Until then, you could manually force-pull the "
  8390. "rebuilt Docker image by running this on the server: `docker pull "
  8391. "nginx:1.15.8-alpine`."
  8392. msgstr ""
  8393. #: ../../../CHANGELOG.md:3304
  8394. msgid ""
  8395. "**your own external nginx server**: if your external nginx server is too "
  8396. "old, the new configuration we generate for you in `/matrix/nginx-"
  8397. "proxy/conf.d/` might not work anymore, because it mentions `TLSv1.3` and "
  8398. "your nginx version might not support that. You can adjust the SSL "
  8399. "protocol list by overriding the `matrix_nginx_proxy_ssl_protocols` "
  8400. "variable. Learn more in the documentation page for [Using your own "
  8401. "webserver, instead of this playbook's nginx proxy](docs/configuring-"
  8402. "playbook-own-webserver.md)"
  8403. msgstr ""
  8404. #: ../../../CHANGELOG.md:3306
  8405. msgid ""
  8406. "**another web server**: you don't need to do anything to accommodate this"
  8407. " change"
  8408. msgstr ""
  8409. #: ../../../CHANGELOG.md:3309
  8410. msgid "2019-01-31"
  8411. msgstr ""
  8412. #: ../../../CHANGELOG.md:3311
  8413. msgid "IRC bridging support"
  8414. msgstr ""
  8415. #: ../../../CHANGELOG.md:3313
  8416. msgid ""
  8417. "[Devon Maloney (@Plailect)](https://github.com/Plailect) has done some "
  8418. "great work bringing IRC bridging support via [matrix-appservice-"
  8419. "irc](https://github.com/TeDomum/matrix-appservice-irc). To learn more, "
  8420. "see the [Setting up Appservice IRC bridging](docs/configuring-playbook-"
  8421. "bridge-appservice-irc.md) documentation page."
  8422. msgstr ""
  8423. #: ../../../CHANGELOG.md:3316
  8424. msgid "2019-01-29"
  8425. msgstr ""
  8426. #: ../../../CHANGELOG.md:3318
  8427. msgid ""
  8428. "Running container processes as non-root, without capabilities and read-"
  8429. "only"
  8430. msgstr ""
  8431. #: ../../../CHANGELOG.md:3320
  8432. msgid ""
  8433. "To improve security, this playbook no longer starts container processes "
  8434. "as the `root` user. Most containers were dropping privileges anyway, but "
  8435. "we were trusting them with `root` privileges until they would do that. "
  8436. "Not anymore -- container processes now start as a non-root user (usually "
  8437. "`matrix`) from the get-go."
  8438. msgstr ""
  8439. #: ../../../CHANGELOG.md:3322
  8440. msgid ""
  8441. "For additional security, various capabilities are also dropped (see [why "
  8442. "it's important](https://github.com/projectatomic/atomic-site/issues/203))"
  8443. " for all containers."
  8444. msgstr ""
  8445. #: ../../../CHANGELOG.md:3324
  8446. msgid ""
  8447. "Additionally, most containers now use a read-only filesystem (see [why "
  8448. "it's important](https://www.projectatomic.io/blog/2015/12/making-docker-"
  8449. "images-write-only-in-production/)). Containers are given write access "
  8450. "only to the directories they need to write to."
  8451. msgstr ""
  8452. #: ../../../CHANGELOG.md:3326
  8453. msgid ""
  8454. "A minor breaking change is the "
  8455. "`matrix_nginx_proxy_proxy_matrix_client_api_client_max_body_size` "
  8456. "variable having being renamed to "
  8457. "`matrix_nginx_proxy_proxy_matrix_client_api_client_max_body_size_mb` "
  8458. "(note the `_mb` suffix). The new variable expects a number value (e.g. "
  8459. "`25M` -> `25`). If you weren't customizing this variable, this wouldn't "
  8460. "affect you."
  8461. msgstr ""
  8462. #: ../../../CHANGELOG.md:3328
  8463. msgid "matrix-mailer is now based on Exim, not Postfix"
  8464. msgstr ""
  8465. #: ../../../CHANGELOG.md:3330
  8466. msgid ""
  8467. "While we would have preferred to stay with "
  8468. "[Postfix](http://www.postfix.org/), we found out that it cannot run as a "
  8469. "non-root user. We've had to replace it with [Exim](https://www.exim.org/)"
  8470. " (via the [devture/exim-relay](https://hub.docker.com/r/devture/exim-"
  8471. "relay) container image)."
  8472. msgstr ""
  8473. #: ../../../CHANGELOG.md:3332
  8474. msgid ""
  8475. "The internal `matrix-mailer` service (running in a container) now listens"
  8476. " on port `8025` (used to be `587` before). The playbook will update your "
  8477. "Synapse and mxisd email settings to match (`matrix-mailer:587` -> "
  8478. "`matrix-mailer:8025`)."
  8479. msgstr ""
  8480. #: ../../../CHANGELOG.md:3334
  8481. msgid ""
  8482. "Using the [devture/exim-relay](https://hub.docker.com/r/devture/exim-"
  8483. "relay) container image instead of "
  8484. "[panubo/postfix](https://hub.docker.com/r/panubo/postfix/) also gives us "
  8485. "a nice disk usage reduction (~200MB -> 8MB)."
  8486. msgstr ""
  8487. #: ../../../CHANGELOG.md:3337
  8488. msgid "2019-01-17"
  8489. msgstr ""
  8490. #: ../../../CHANGELOG.md:3339
  8491. msgid "(BC Break) Making the playbook's roles more independent of one another"
  8492. msgstr ""
  8493. #: ../../../CHANGELOG.md:3341
  8494. msgid ""
  8495. "The following change **affects people running a more non-standard setup**"
  8496. " - external Postgres or using our roles in their own other playbook. "
  8497. "**Most users don't need to do anything**, besides becoming aware of the "
  8498. "new glue variables file [`group_vars/matrix-servers`](group_vars/matrix-"
  8499. "servers)."
  8500. msgstr ""
  8501. #: ../../../CHANGELOG.md:3344
  8502. msgid ""
  8503. "Because people like using the playbook's components independently "
  8504. "(outside of this playbook) and because it's much better for "
  8505. "maintainability, we've continued working on separating them. Still, we'd "
  8506. "like to offer a turnkey solution for running a fully-featured Matrix "
  8507. "server, so this playbook remains important for wiring up the various "
  8508. "components."
  8509. msgstr ""
  8510. #: ../../../CHANGELOG.md:3346
  8511. msgid ""
  8512. "With the new changes, **all roles are now only dependent on the minimal "
  8513. "`matrix-base` role**. They are no longer dependent among themselves."
  8514. msgstr ""
  8515. #: ../../../CHANGELOG.md:3348
  8516. msgid ""
  8517. "In addition, the following components can now be completely disabled (for"
  8518. " those who want/need to):"
  8519. msgstr ""
  8520. #: ../../../CHANGELOG.md:3349
  8521. msgid "`matrix-coturn` by using `matrix_coturn_enabled: false`"
  8522. msgstr ""
  8523. #: ../../../CHANGELOG.md:3350
  8524. msgid "`matrix-mailer` by using `matrix_mailer_enabled: false`"
  8525. msgstr ""
  8526. #: ../../../CHANGELOG.md:3351
  8527. msgid "`matrix-postgres` by using `matrix_postgres_enabled: false`"
  8528. msgstr ""
  8529. #: ../../../CHANGELOG.md:3353
  8530. msgid "The following changes had to be done:"
  8531. msgstr ""
  8532. #: ../../../CHANGELOG.md:3355
  8533. msgid ""
  8534. "glue variables had to be introduced to the playbook, so it can wire "
  8535. "together the various components. Those glue vars are stored in the "
  8536. "[`group_vars/matrix-servers`](group_vars/matrix-servers) file. When "
  8537. "overriding variables for a given component (role), you need to be aware "
  8538. "of both the role defaults (`role/ROLE/defaults/main.yml`) and the role's "
  8539. "corresponding section in the [`group_vars/matrix-servers`](group_vars"
  8540. "/matrix-servers) file."
  8541. msgstr ""
  8542. #: ../../../CHANGELOG.md:3357
  8543. msgid ""
  8544. "`matrix_postgres_use_external` has been superceeded by the more "
  8545. "consistently named `matrix_postgres_enabled` variable and a few other "
  8546. "`matrix_synapse_database_` variables. See the [Using an external "
  8547. "PostgreSQL server (optional)](docs/configuring-playbook-external-"
  8548. "postgres.md) documentation page for an up-to-date replacement."
  8549. msgstr ""
  8550. #: ../../../CHANGELOG.md:3359
  8551. msgid ""
  8552. "Postgres tools (`matrix-postgres-cli` and `matrix-make-user-admin`) are "
  8553. "no longer installed if you're not enabling the `matrix-postgres` role "
  8554. "(`matrix_postgres_enabled: false`)"
  8555. msgstr ""
  8556. #: ../../../CHANGELOG.md:3361
  8557. msgid ""
  8558. "roles, being more independent now, are more minimal and do not do so much"
  8559. " magic for you. People that are building their own playbook using our "
  8560. "roles will definitely need to take a look at the [`group_vars/matrix-"
  8561. "servers`](group_vars/matrix-servers) file and adapt their playbooks with "
  8562. "the same (or similar) wiring logic."
  8563. msgstr ""
  8564. #: ../../../CHANGELOG.md:3364
  8565. msgid "2019-01-16"
  8566. msgstr ""
  8567. #: ../../../CHANGELOG.md:3366
  8568. msgid "Splitting the playbook into multiple roles"
  8569. msgstr ""
  8570. #: ../../../CHANGELOG.md:3368
  8571. msgid ""
  8572. "For better maintainability, the playbook logic (which all used to reside "
  8573. "in a single `matrix-server` role) has been split out into a number of "
  8574. "different roles: `matrix-synapse`, `matrix-postgres`, `matrix-riot-web`, "
  8575. "`matrix-mxisd`, etc. (see the `roles/` directory)."
  8576. msgstr ""
  8577. #: ../../../CHANGELOG.md:3371
  8578. msgid ""
  8579. "To keep the filesystem more consistent with this separation, the "
  8580. "**Postgres data had to be relocated**."
  8581. msgstr ""
  8582. #: ../../../CHANGELOG.md:3373
  8583. msgid ""
  8584. "The default value of `matrix_postgres_data_path` was changed from "
  8585. "`/matrix/postgres` to `/matrix/postgres/data`. The `/matrix/postgres` "
  8586. "directory is what we consider a base path now (new variable "
  8587. "`matrix_postgres_base_path`). **Your Postgres data files will "
  8588. "automatically be relocated by the playbook** (`/matrix/postgres/*` -> "
  8589. "`/matrix/postgres/data/`) when you run with `--tags=setup-all` (or "
  8590. "`--tags=setup-postgres`). While this shouldn't cause data-loss, **it's "
  8591. "better if you do a Postgres backup just in case**. You'd need to restart "
  8592. "all services after this migration (`--tags=start`)."
  8593. msgstr ""
  8594. #: ../../../CHANGELOG.md:3376
  8595. msgid "2019-01-11"
  8596. msgstr ""
  8597. #: ../../../CHANGELOG.md:3378
  8598. msgid "(BC Break) mxisd configuration changes"
  8599. msgstr ""
  8600. #: ../../../CHANGELOG.md:3380
  8601. msgid ""
  8602. "To be more flexible and to support the upcoming "
  8603. "[mxisd](https://github.com/kamax-io/mxisd) 1.3.0 (when it gets released),"
  8604. " we've had to redo how mxisd gets configured."
  8605. msgstr ""
  8606. #: ../../../CHANGELOG.md:3383
  8607. msgid "The following variables are no longer supported by this playbook:"
  8608. msgstr ""
  8609. #: ../../../CHANGELOG.md:3385
  8610. msgid "`matrix_mxisd_ldap_enabled`"
  8611. msgstr ""
  8612. #: ../../../CHANGELOG.md:3386
  8613. msgid "`matrix_mxisd_ldap_connection_host`"
  8614. msgstr ""
  8615. #: ../../../CHANGELOG.md:3387
  8616. msgid "`matrix_mxisd_ldap_connection_tls`"
  8617. msgstr ""
  8618. #: ../../../CHANGELOG.md:3388
  8619. msgid "`matrix_mxisd_ldap_connection_port`"
  8620. msgstr ""
  8621. #: ../../../CHANGELOG.md:3389
  8622. msgid "`matrix_mxisd_ldap_connection_baseDn`"
  8623. msgstr ""
  8624. #: ../../../CHANGELOG.md:3390
  8625. msgid "`matrix_mxisd_ldap_connection_baseDns`"
  8626. msgstr ""
  8627. #: ../../../CHANGELOG.md:3391 ../../../CHANGELOG.md:3392
  8628. msgid "`matrix_mxisd_ldap_connection_bindDn`"
  8629. msgstr ""
  8630. #: ../../../CHANGELOG.md:3393 ../../../CHANGELOG.md:3397
  8631. msgid "`matrix_mxisd_ldap_connection_bindPassword`"
  8632. msgstr ""
  8633. #: ../../../CHANGELOG.md:3394
  8634. msgid "`matrix_mxisd_ldap_filter`"
  8635. msgstr ""
  8636. #: ../../../CHANGELOG.md:3395
  8637. msgid "`matrix_mxisd_ldap_attribute_uid_type`"
  8638. msgstr ""
  8639. #: ../../../CHANGELOG.md:3396
  8640. msgid "`matrix_mxisd_ldap_attribute_uid_value`"
  8641. msgstr ""
  8642. #: ../../../CHANGELOG.md:3398
  8643. msgid "`matrix_mxisd_ldap_attribute_name`"
  8644. msgstr ""
  8645. #: ../../../CHANGELOG.md:3399
  8646. msgid "`matrix_mxisd_ldap_attribute_threepid_email`"
  8647. msgstr ""
  8648. #: ../../../CHANGELOG.md:3400
  8649. msgid "`matrix_mxisd_ldap_attribute_threepid_msisdn`"
  8650. msgstr ""
  8651. #: ../../../CHANGELOG.md:3401
  8652. msgid "`matrix_mxisd_ldap_identity_filter`"
  8653. msgstr ""
  8654. #: ../../../CHANGELOG.md:3402
  8655. msgid "`matrix_mxisd_ldap_identity_medium`"
  8656. msgstr ""
  8657. #: ../../../CHANGELOG.md:3403
  8658. msgid "`matrix_mxisd_ldap_auth_filter`"
  8659. msgstr ""
  8660. #: ../../../CHANGELOG.md:3404
  8661. msgid "`matrix_mxisd_ldap_directory_filter`"
  8662. msgstr ""
  8663. #: ../../../CHANGELOG.md:3405
  8664. msgid "`matrix_mxisd_template_config`"
  8665. msgstr ""
  8666. #: ../../../CHANGELOG.md:3407
  8667. msgid ""
  8668. "You are encouraged to use the `matrix_mxisd_configuration_extension_yaml`"
  8669. " variable to define your own mxisd configuration additions and overrides."
  8670. " Refer to the [default variables file](roles/custom/matrix-"
  8671. "mxisd/defaults/main.yml) for more information."
  8672. msgstr ""
  8673. #: ../../../CHANGELOG.md:3409
  8674. msgid "This new way of configuring mxisd is beneficial because:"
  8675. msgstr ""
  8676. #: ../../../CHANGELOG.md:3411
  8677. msgid ""
  8678. "it lets us support all mxisd configuration options, as the playbook "
  8679. "simply forwards them to mxisd without needing to care or understand them"
  8680. msgstr ""
  8681. #: ../../../CHANGELOG.md:3412
  8682. msgid ""
  8683. "it lets you upgrade to newer mxisd versions and make use of their "
  8684. "features, without us having to add support for them explicitly"
  8685. msgstr ""
  8686. #: ../../../CHANGELOG.md:3415
  8687. msgid "2019-01-08"
  8688. msgstr ""
  8689. #: ../../../CHANGELOG.md:3417
  8690. msgid "(BC Break) Cronjob schedule no longer configurable"
  8691. msgstr ""
  8692. #: ../../../CHANGELOG.md:3419
  8693. msgid ""
  8694. "Due to the way we manage cronjobs now, you can no longer configure the "
  8695. "schedule they're invoked at."
  8696. msgstr ""
  8697. #: ../../../CHANGELOG.md:3421
  8698. msgid ""
  8699. "If you were previously using "
  8700. "`matrix_ssl_lets_encrypt_renew_cron_time_definition` or "
  8701. "`matrix_nginx_proxy_reload_cron_time_definition` to set a custom "
  8702. "schedule, you should note that these variables don't affect anything "
  8703. "anymore."
  8704. msgstr ""
  8705. #: ../../../CHANGELOG.md:3424
  8706. msgid ""
  8707. "If you miss this functionality, please [open an "
  8708. "Issue](https://github.com/spantaleev/matrix-docker-ansible-"
  8709. "deploy/issues/new) and let us know about your use case!"
  8710. msgstr ""
  8711. #: ../../../CHANGELOG.md:3427
  8712. msgid "2018-12-23"
  8713. msgstr ""
  8714. #: ../../../CHANGELOG.md:3429
  8715. msgid "(BC Break) More SSL certificate retrieval methods"
  8716. msgstr ""
  8717. #: ../../../CHANGELOG.md:3431
  8718. msgid ""
  8719. "The playbook now lets you decide between 3 different SSL certificate "
  8720. "retrieval methods:"
  8721. msgstr ""
  8722. #: ../../../CHANGELOG.md:3432
  8723. msgid "(default) obtaining free SSL certificates from Let's Encrypt"
  8724. msgstr ""
  8725. #: ../../../CHANGELOG.md:3433
  8726. msgid "generating self-signed SSL certificates"
  8727. msgstr ""
  8728. #: ../../../CHANGELOG.md:3434
  8729. msgid "managing SSL certificates manually"
  8730. msgstr ""
  8731. #: ../../../CHANGELOG.md:3436
  8732. msgid ""
  8733. "Learn more in [Adjusting SSL certificate retrieval](docs/configuring-"
  8734. "playbook-ssl-certificates.md)."
  8735. msgstr ""
  8736. #: ../../../CHANGELOG.md:3438
  8737. msgid ""
  8738. "For people who use Let's Encrypt (mostly everyone, since it's the "
  8739. "default), you'll also have to rename a variable in your configuration:"
  8740. msgstr ""
  8741. #: ../../../CHANGELOG.md:3440
  8742. msgid "before: `host_specific_matrix_ssl_support_email`"
  8743. msgstr ""
  8744. #: ../../../CHANGELOG.md:3441
  8745. msgid "after: `host_specific_matrix_ssl_lets_encrypt_support_email`"
  8746. msgstr ""
  8747. #: ../../../CHANGELOG.md:3443
  8748. msgid "(BC Break) mxisd upgrade with multiple base DN support"
  8749. msgstr ""
  8750. #: ../../../CHANGELOG.md:3445
  8751. msgid ""
  8752. "mxisd has bee upgraded to [version 1.2.2](https://github.com/kamax-"
  8753. "matrix/mxisd/releases/tag/v1.2.2), which supports [multiple base "
  8754. "DNs](https://github.com/kamax-"
  8755. "matrix/mxisd/blob/v1.2.2/docs/stores/ldap.md#base)."
  8756. msgstr ""
  8757. #: ../../../CHANGELOG.md:3447
  8758. msgid ""
  8759. "If you were configuring this playbook's "
  8760. "`matrix_mxisd_ldap_connection_baseDn` variable until now (a string "
  8761. "containing a single base DN), you'll need to change to configuring the "
  8762. "`matrix_mxisd_ldap_connection_baseDns` variable (an array containing "
  8763. "multiple base DNs)."
  8764. msgstr ""
  8765. #: ../../../CHANGELOG.md:3449
  8766. msgid "Example change:"
  8767. msgstr ""
  8768. #: ../../../CHANGELOG.md:3451
  8769. msgid "before: `matrix_mxisd_ldap_connection_baseDn: OU=Users,DC=example,DC=org`"
  8770. msgstr ""
  8771. #: ../../../CHANGELOG.md:3452
  8772. msgid ""
  8773. "after: `matrix_mxisd_ldap_connection_baseDns: "
  8774. "['OU=Users,DC=example,DC=org']`"
  8775. msgstr ""
  8776. #: ../../../CHANGELOG.md:3455
  8777. msgid "2018-12-21"
  8778. msgstr ""
  8779. #: ../../../CHANGELOG.md:3457
  8780. msgid "Synapse 0.34.0 and Python 3"
  8781. msgstr ""
  8782. #: ../../../CHANGELOG.md:3459
  8783. msgid ""
  8784. "Synapse has been upgraded to 0.34.0 and now uses Python 3. Based on "
  8785. "feedback from others, running Synapse on Python 3 is supposed to decrease"
  8786. " memory usage significantly (~2x)."
  8787. msgstr ""
  8788. #: ../../../CHANGELOG.md:3462
  8789. msgid "2018-12-12"
  8790. msgstr ""
  8791. #: ../../../CHANGELOG.md:3464
  8792. msgid "Riot homepage customization"
  8793. msgstr ""
  8794. #: ../../../CHANGELOG.md:3466
  8795. msgid ""
  8796. "You can now customize some parts of the Riot homepage (or even completely"
  8797. " replace it with your own custom page). See the "
  8798. "`matrix_riot_web_homepage_` variables in `roles/custom/matrix-riot-"
  8799. "web/defaults/main.yml`."
  8800. msgstr ""
  8801. #: ../../../CHANGELOG.md:3469
  8802. msgid "2018-12-04"
  8803. msgstr ""
  8804. #: ../../../CHANGELOG.md:3471
  8805. msgid "mxisd extensibility"
  8806. msgstr ""
  8807. #: ../../../CHANGELOG.md:3473
  8808. msgid ""
  8809. "The [LDAP identity store for mxisd](https://github.com/kamax-"
  8810. "matrix/mxisd/blob/master/docs/stores/ldap.md) can now be configured "
  8811. "easily using playbook variables (see the `matrix_mxisd_ldap_` variables "
  8812. "in `roles/custom/matrix-server/defaults/main.yml`)."
  8813. msgstr ""
  8814. #: ../../../CHANGELOG.md:3476
  8815. msgid "2018-11-28"
  8816. msgstr ""
  8817. #: ../../../CHANGELOG.md:3478
  8818. msgid "More scripts"
  8819. msgstr ""
  8820. #: ../../../CHANGELOG.md:3480
  8821. msgid "matrix-remove-all allows to uninstall everything with a single command"
  8822. msgstr ""
  8823. #: ../../../CHANGELOG.md:3481
  8824. msgid "matrix-make-user-admin allows to upgrade a user's privileges"
  8825. msgstr ""
  8826. #: ../../../CHANGELOG.md:3483
  8827. msgid "LDAP auth support via matrix-synapse-ldap3"
  8828. msgstr ""
  8829. #: ../../../CHANGELOG.md:3485
  8830. msgid ""
  8831. "The playbook can now install and configure [LDAP auth "
  8832. "support](https://github.com/matrix-org/matrix-synapse-ldap3) for you."
  8833. msgstr ""
  8834. #: ../../../CHANGELOG.md:3487
  8835. msgid ""
  8836. "Additional details are available in [Setting up the LDAP authentication "
  8837. "password provider module](docs/configuring-playbook-ldap-auth.md)."
  8838. msgstr ""
  8839. #: ../../../CHANGELOG.md:3490
  8840. msgid "2018-11-23"
  8841. msgstr ""
  8842. #: ../../../CHANGELOG.md:3492
  8843. msgid "Support for controlling public registration and room auto-join"
  8844. msgstr ""
  8845. #: ../../../CHANGELOG.md:3494
  8846. msgid ""
  8847. "The playbook now lets you enable public registration for users "
  8848. "(controlled via `matrix_synapse_enable_registration`). By default, public"
  8849. " registration is forbidden."
  8850. msgstr ""
  8851. #: ../../../CHANGELOG.md:3496
  8852. msgid ""
  8853. "You can also make people automatically get auto-joined to rooms "
  8854. "(controlled via `matrix_synapse_auto_join_rooms`)."
  8855. msgstr ""
  8856. #: ../../../CHANGELOG.md:3498
  8857. msgid "Support for changing the welcome user ID (welcome bot)"
  8858. msgstr ""
  8859. #: ../../../CHANGELOG.md:3500
  8860. msgid ""
  8861. "By default, `@riot-bot:matrix.org` is used to welcome newly registered "
  8862. "users. This can be changed to something else (or disabled) via the new "
  8863. "`matrix_riot_web_welcome_user_id` variable."
  8864. msgstr ""
  8865. #: ../../../CHANGELOG.md:3503
  8866. msgid "2018-11-14"
  8867. msgstr ""
  8868. #: ../../../CHANGELOG.md:3505
  8869. msgid "Ability to set Synapse log levels"
  8870. msgstr ""
  8871. #: ../../../CHANGELOG.md:3507
  8872. msgid ""
  8873. "The playbook now allows you to set the log levels used by Synapse. The "
  8874. "default logging levels remain the same."
  8875. msgstr ""
  8876. #: ../../../CHANGELOG.md:3509
  8877. msgid ""
  8878. "You can now override following variables with any of the supported log "
  8879. "levels listed here: https://docs.python.org/3/library/logging.html"
  8880. "#logging-levels"
  8881. msgstr ""
  8882. #: ../../../CHANGELOG.md:3518
  8883. msgid "2018-11-03"
  8884. msgstr ""
  8885. #: ../../../CHANGELOG.md:3520
  8886. msgid "Customize parts of Riot's config"
  8887. msgstr ""
  8888. #: ../../../CHANGELOG.md:3522
  8889. msgid ""
  8890. "You can now customize some parts of Riot's `config.json`. These playbook "
  8891. "variables, with these default values, have been added:"
  8892. msgstr ""
  8893. #: ../../../CHANGELOG.md:3533
  8894. msgid ""
  8895. "This now allows you use a custom integration manager like "
  8896. "[Dimension](https://dimension.t2bot.io). For example, if you wish to use "
  8897. "the Dimension instance hosted at dimension.t2bot.io, you can set the "
  8898. "following in your vars.yml file:"
  8899. msgstr ""
  8900. #: ../../../CHANGELOG.md:3542
  8901. msgid "SSL protocols used to serve Riot and Synapse"
  8902. msgstr ""
  8903. #: ../../../CHANGELOG.md:3544
  8904. msgid ""
  8905. "There's now a new `matrix_nginx_proxy_ssl_protocols` playbook variable, "
  8906. "which controls the SSL protocols used to serve Riot and Synapse. Its "
  8907. "default value is `TLSv1.1 TLSv1.2`. This playbook previously used `TLSv1 "
  8908. "TLSv1.1 TLSv1.2` to serve Riot and Synapse."
  8909. msgstr ""
  8910. #: ../../../CHANGELOG.md:3546
  8911. msgid ""
  8912. "You may wish to reenable TLSv1 if you need to access Riot in older "
  8913. "browsers."
  8914. msgstr ""
  8915. #: ../../../CHANGELOG.md:3548
  8916. msgid ""
  8917. "Note: Currently the dockerized nginx doesn't support TLSv1.3. See "
  8918. "https://github.com/nginxinc/docker-nginx/issues/190 for more details."
  8919. msgstr ""
  8920. #: ../../../CHANGELOG.md:3551
  8921. msgid "2018-11-01"
  8922. msgstr ""
  8923. #: ../../../CHANGELOG.md:3553
  8924. msgid "Postgres 11 support"
  8925. msgstr ""
  8926. #: ../../../CHANGELOG.md:3555
  8927. msgid ""
  8928. "The playbook now installs [Postgres "
  8929. "11](https://www.postgresql.org/about/news/1894/) by default."
  8930. msgstr ""
  8931. #: ../../../CHANGELOG.md:3557
  8932. msgid ""
  8933. "If you have have an existing setup, it's likely running on an older "
  8934. "Postgres version (9.x or 10.x). You can easily upgrade by following the "
  8935. "[upgrading PostgreSQL guide](docs/maintenance-postgres.md#upgrading-"
  8936. "postgresql)."
  8937. msgstr ""
  8938. #: ../../../CHANGELOG.md:3559 ../../../CHANGELOG.md:3646
  8939. #: ../../../CHANGELOG.md:3766
  8940. msgid "(BC Break) Renaming playbook variables"
  8941. msgstr ""
  8942. #: ../../../CHANGELOG.md:3561
  8943. msgid ""
  8944. "Due to the large amount of features added to this playbook lately, to "
  8945. "keep things manageable we've had to reorganize its configuration "
  8946. "variables a bit."
  8947. msgstr ""
  8948. #: ../../../CHANGELOG.md:3565
  8949. msgid "from `matrix_docker_image_mxisd` to `matrix_mxisd_docker_image`"
  8950. msgstr ""
  8951. #: ../../../CHANGELOG.md:3566
  8952. msgid ""
  8953. "from `matrix_docker_image_mautrix_telegram` to "
  8954. "`matrix_mautrix_telegram_docker_image`"
  8955. msgstr ""
  8956. #: ../../../CHANGELOG.md:3567
  8957. msgid ""
  8958. "from `matrix_docker_image_mautrix_whatsapp` to "
  8959. "`matrix_mautrix_whatsapp_docker_image`"
  8960. msgstr ""
  8961. #: ../../../CHANGELOG.md:3568
  8962. msgid "from `matrix_docker_image_mailer` to `matrix_mailer_docker_image`"
  8963. msgstr ""
  8964. #: ../../../CHANGELOG.md:3569
  8965. msgid "from `matrix_docker_image_coturn` to `matrix_coturn_docker_image`"
  8966. msgstr ""
  8967. #: ../../../CHANGELOG.md:3570
  8968. msgid "from `matrix_docker_image_goofys` to `matrix_s3_goofys_docker_image`"
  8969. msgstr ""
  8970. #: ../../../CHANGELOG.md:3571
  8971. msgid "from `matrix_docker_image_riot` to `matrix_riot_web_docker_image`"
  8972. msgstr ""
  8973. #: ../../../CHANGELOG.md:3572
  8974. msgid "from `matrix_docker_image_nginx` to `matrix_nginx_proxy_docker_image`"
  8975. msgstr ""
  8976. #: ../../../CHANGELOG.md:3573
  8977. msgid "from `matrix_docker_image_synapse` to `matrix_synapse_docker_image`"
  8978. msgstr ""
  8979. #: ../../../CHANGELOG.md:3574
  8980. msgid ""
  8981. "from `matrix_docker_image_postgres_v9` to "
  8982. "`matrix_postgres_docker_image_v9`"
  8983. msgstr ""
  8984. #: ../../../CHANGELOG.md:3575
  8985. msgid ""
  8986. "from `matrix_docker_image_postgres_v10` to "
  8987. "`matrix_postgres_docker_image_v10`"
  8988. msgstr ""
  8989. #: ../../../CHANGELOG.md:3576
  8990. msgid ""
  8991. "from `matrix_docker_image_postgres_latest` to "
  8992. "`matrix_postgres_docker_image_latest`"
  8993. msgstr ""
  8994. #: ../../../CHANGELOG.md:3579
  8995. msgid "2018-10-26"
  8996. msgstr ""
  8997. #: ../../../CHANGELOG.md:3581
  8998. msgid "Mautrix Whatsapp bridging support"
  8999. msgstr ""
  9000. #: ../../../CHANGELOG.md:3583
  9001. msgid ""
  9002. "The playbook now supports bridging with "
  9003. "[Whatsapp](https://www.whatsapp.com/) by installing the [mautrix-"
  9004. "whatsapp](https://github.com/tulir/mautrix-whatsapp) bridge. This "
  9005. "playbook functionality is available thanks to "
  9006. "[@izissise](https://github.com/izissise)."
  9007. msgstr ""
  9008. #: ../../../CHANGELOG.md:3585
  9009. msgid ""
  9010. "Additional details are available in [Setting up Mautrix Whatsapp "
  9011. "bridging](docs/configuring-playbook-bridge-mautrix-whatsapp.md)."
  9012. msgstr ""
  9013. #: ../../../CHANGELOG.md:3588
  9014. msgid "2018-10-25"
  9015. msgstr ""
  9016. #: ../../../CHANGELOG.md:3590
  9017. msgid "Support for controlling Matrix federation"
  9018. msgstr ""
  9019. #: ../../../CHANGELOG.md:3592
  9020. msgid ""
  9021. "The playbook can now help you with [Controlling Matrix federation](docs"
  9022. "/configuring-playbook-federation), should you wish to run a more private "
  9023. "(isolated) server."
  9024. msgstr ""
  9025. #: ../../../CHANGELOG.md:3595
  9026. msgid "2018-10-24"
  9027. msgstr ""
  9028. #: ../../../CHANGELOG.md:3597
  9029. msgid "Disabling riot-web guests"
  9030. msgstr ""
  9031. #: ../../../CHANGELOG.md:3599
  9032. msgid ""
  9033. "From now on, Riot's configuration setting `disable_guests` would be set "
  9034. "to `true`. The homeserver was rejecting guests anyway, so this is just a "
  9035. "cosmetic change affecting Riot's UI."
  9036. msgstr ""
  9037. #: ../../../CHANGELOG.md:3602
  9038. msgid "2018-10-21"
  9039. msgstr ""
  9040. #: ../../../CHANGELOG.md:3604
  9041. msgid "Self-check maintenance command"
  9042. msgstr ""
  9043. #: ../../../CHANGELOG.md:3606
  9044. msgid ""
  9045. "The playbook can now [check if services are configured correctly](docs"
  9046. "/maintenance-checking-services.md)."
  9047. msgstr ""
  9048. #: ../../../CHANGELOG.md:3609
  9049. msgid "2018-10-05"
  9050. msgstr ""
  9051. #: ../../../CHANGELOG.md:3611
  9052. msgid "Presence tracking made configurable"
  9053. msgstr ""
  9054. #: ../../../CHANGELOG.md:3613
  9055. msgid ""
  9056. "The playbook can now enable/disable user presence-status tracking in "
  9057. "Synapse, through the playbook's `matrix_synapse_use_presence` variable "
  9058. "(having a default value of `true` - enabled)."
  9059. msgstr ""
  9060. #: ../../../CHANGELOG.md:3615
  9061. msgid ""
  9062. "If users participate in large rooms with many other servers, disabling "
  9063. "presence will decrease server load significantly."
  9064. msgstr ""
  9065. #: ../../../CHANGELOG.md:3618
  9066. msgid "2018-09-27"
  9067. msgstr ""
  9068. #: ../../../CHANGELOG.md:3620
  9069. msgid "Synapse Cache Factor made configurable"
  9070. msgstr ""
  9071. #: ../../../CHANGELOG.md:3622
  9072. msgid ""
  9073. "The playbook now makes the Synapse cache factor configurable, through the"
  9074. " playbook's `matrix_synapse_cache_factor` variable (having a default "
  9075. "value of `0.5`)."
  9076. msgstr ""
  9077. #: ../../../CHANGELOG.md:3624
  9078. msgid ""
  9079. "Changing that value allows you to potentially decrease RAM usage or to "
  9080. "increase performance by caching more stuff. Some information on it is "
  9081. "available here: https://github.com/element-hq/synapse#help-synapse-eats-"
  9082. "all-my-ram"
  9083. msgstr ""
  9084. #: ../../../CHANGELOG.md:3627
  9085. msgid "2018-09-26"
  9086. msgstr ""
  9087. #: ../../../CHANGELOG.md:3629
  9088. msgid "Disabling Docker container logging"
  9089. msgstr ""
  9090. #: ../../../CHANGELOG.md:3631
  9091. msgid "`--log-driver=none` is used for all Docker containers now."
  9092. msgstr ""
  9093. #: ../../../CHANGELOG.md:3633
  9094. msgid ""
  9095. "All these containers are started through systemd anyway and get logged in"
  9096. " journald, so there's no need for Docker to be logging the same thing "
  9097. "using the default `json-file` driver. Doing that was growing "
  9098. "`/var/lib/docker/containers/..` infinitely until service/container "
  9099. "restart."
  9100. msgstr ""
  9101. #: ../../../CHANGELOG.md:3635
  9102. msgid ""
  9103. "As a result of this, things like `docker logs matrix-synapse` won't work "
  9104. "anymore. `journalctl -u matrix-synapse` is how one can see the logs."
  9105. msgstr ""
  9106. #: ../../../CHANGELOG.md:3638
  9107. msgid "2018-09-17"
  9108. msgstr ""
  9109. #: ../../../CHANGELOG.md:3640
  9110. msgid "Service discovery support"
  9111. msgstr ""
  9112. #: ../../../CHANGELOG.md:3642
  9113. msgid ""
  9114. "The playbook now helps you set up [service "
  9115. "discovery](https://matrix.org/docs/spec/client_server/r0.4.0.html#server-"
  9116. "discovery) using a `/.well-known/matrix/client` file."
  9117. msgstr ""
  9118. #: ../../../CHANGELOG.md:3644
  9119. msgid ""
  9120. "Additional details are available in [Configuring service discovery via "
  9121. ".well-known](docs/configuring-well-known.md)."
  9122. msgstr ""
  9123. #: ../../../CHANGELOG.md:3650
  9124. msgid "from `matrix_nginx_riot_web_data_path` to `matrix_riot_web_data_path`"
  9125. msgstr ""
  9126. #: ../../../CHANGELOG.md:3651
  9127. msgid ""
  9128. "from `matrix_riot_web_default_identity_server_url` to "
  9129. "`matrix_identity_server_url`"
  9130. msgstr ""
  9131. #: ../../../CHANGELOG.md:3654
  9132. msgid "2018-09-07"
  9133. msgstr ""
  9134. #: ../../../CHANGELOG.md:3656
  9135. msgid "Mautrix Telegram bridging support"
  9136. msgstr ""
  9137. #: ../../../CHANGELOG.md:3658
  9138. msgid ""
  9139. "The playbook now supports bridging with [Telegram](https://telegram.org/)"
  9140. " by installing the [mautrix-telegram](https://github.com/tulir/mautrix-"
  9141. "telegram) bridge. This playbook functionality is available thanks to "
  9142. "[@izissise](https://github.com/izissise)."
  9143. msgstr ""
  9144. #: ../../../CHANGELOG.md:3660
  9145. msgid ""
  9146. "Additional details are available in [Setting up Mautrix Telegram "
  9147. "bridging](docs/configuring-playbook-bridge-mautrix-telegram.md)."
  9148. msgstr ""
  9149. #: ../../../CHANGELOG.md:3662
  9150. msgid "Events cache size increase and configurability for Matrix Synapse"
  9151. msgstr ""
  9152. #: ../../../CHANGELOG.md:3664
  9153. msgid ""
  9154. "The playbook now lets you configure Matrix Synapse's `event_cache_size` "
  9155. "configuration via the `matrix_synapse_event_cache_size` playbook "
  9156. "variable."
  9157. msgstr ""
  9158. #: ../../../CHANGELOG.md:3666
  9159. msgid ""
  9160. "Previously, this value was hardcoded to `\"10K\"`. From now on, a more "
  9161. "reasonable default of `\"100K\"` is used."
  9162. msgstr ""
  9163. #: ../../../CHANGELOG.md:3668
  9164. msgid "Password-peppering support for Matrix Synapse"
  9165. msgstr ""
  9166. #: ../../../CHANGELOG.md:3670
  9167. msgid ""
  9168. "The playbook now supports enabling password-peppering for increased "
  9169. "security in Matrix Synapse via the "
  9170. "`matrix_synapse_password_config_pepper` playbook variable. Using a "
  9171. "password pepper is disabled by default (just like it used to be before "
  9172. "this playbook variable got introduced) and is not to be enabled/disabled "
  9173. "after initial setup, as that would invalidate all existing passwords."
  9174. msgstr ""
  9175. #: ../../../CHANGELOG.md:3672
  9176. msgid "Statistics-reporting support for Matrix Synapse"
  9177. msgstr ""
  9178. #: ../../../CHANGELOG.md:3674
  9179. msgid ""
  9180. "There's now a new `matrix_synapse_report_stats` playbook variable, which "
  9181. "controls the `report_stats` configuration option for Matrix Synapse. It "
  9182. "defaults to `false`, so no change is required to retain your privacy."
  9183. msgstr ""
  9184. #: ../../../CHANGELOG.md:3676
  9185. msgid ""
  9186. "If you'd like to start reporting statistics about your homeserver (things"
  9187. " like number of users, number of messages sent, uptime, load, etc.) to "
  9188. "matrix.org, you can turn on stats reporting."
  9189. msgstr ""
  9190. #: ../../../CHANGELOG.md:3679
  9191. msgid "2018-08-29"
  9192. msgstr ""
  9193. #: ../../../CHANGELOG.md:3681
  9194. msgid "Changing the way SSL certificates are retrieved"
  9195. msgstr ""
  9196. #: ../../../CHANGELOG.md:3683
  9197. msgid ""
  9198. "We've been using [acmetool](https://github.com/hlandau/acme) (with the "
  9199. "[willwill/acme-docker](https://hub.docker.com/r/willwill/acme-docker/) "
  9200. "Docker image) until now."
  9201. msgstr ""
  9202. #: ../../../CHANGELOG.md:3685
  9203. msgid ""
  9204. "Due to the Docker image being deprecated, and things looking bleak for "
  9205. "acmetool's support of the newer ACME v2 API endpoint, we've switched to "
  9206. "using [certbot](https://certbot.eff.org/) (with the "
  9207. "[certbot/certbot](https://hub.docker.com/r/certbot/certbot/) Docker "
  9208. "image)."
  9209. msgstr ""
  9210. #: ../../../CHANGELOG.md:3687
  9211. msgid ""
  9212. "Simply re-running the playbook will retrieve new certificates (via "
  9213. "certbot) for you. To ensure you don't leave any old files behind, though,"
  9214. " you'd better do this:"
  9215. msgstr ""
  9216. #: ../../../CHANGELOG.md:3689
  9217. msgid "`systemctl stop 'matrix*'`"
  9218. msgstr ""
  9219. #: ../../../CHANGELOG.md:3690
  9220. msgid ""
  9221. "stop your custom webserver, if you're running one (only affects you if "
  9222. "you've installed with `matrix_nginx_proxy_enabled: false`)"
  9223. msgstr ""
  9224. #: ../../../CHANGELOG.md:3691
  9225. msgid "`mv /matrix/ssl /matrix/ssl-acmetool-delete-later`"
  9226. msgstr ""
  9227. #: ../../../CHANGELOG.md:3692
  9228. msgid "re-run the playbook's [installation](docs/installing.md)"
  9229. msgstr ""
  9230. #: ../../../CHANGELOG.md:3693
  9231. msgid "possibly delete `/matrix/ssl-acmetool-delete-later`"
  9232. msgstr ""
  9233. #: ../../../CHANGELOG.md:3696
  9234. msgid "2018-08-21"
  9235. msgstr ""
  9236. #: ../../../CHANGELOG.md:3698
  9237. msgid "Matrix Corporal support"
  9238. msgstr ""
  9239. #: ../../../CHANGELOG.md:3700
  9240. msgid ""
  9241. "The playbook can now install and configure [matrix-"
  9242. "corporal](https://github.com/devture/matrix-corporal) for you."
  9243. msgstr ""
  9244. #: ../../../CHANGELOG.md:3702
  9245. msgid ""
  9246. "Additional details are available in [Setting up Matrix Corporal](docs"
  9247. "/configuring-playbook-matrix-corporal.md)."
  9248. msgstr ""
  9249. #: ../../../CHANGELOG.md:3705
  9250. msgid "2018-08-20"
  9251. msgstr ""
  9252. #: ../../../CHANGELOG.md:3707
  9253. msgid "Matrix Synapse rate limit control variables"
  9254. msgstr ""
  9255. #: ../../../CHANGELOG.md:3709
  9256. msgid ""
  9257. "The following new variables can now be configured to control Matrix "
  9258. "Synapse's rate-limiting (default values are shown below)."
  9259. msgstr ""
  9260. #: ../../../CHANGELOG.md:3716
  9261. msgid "Shared Secret Auth support via matrix-synapse-shared-secret-auth"
  9262. msgstr ""
  9263. #: ../../../CHANGELOG.md:3718
  9264. msgid ""
  9265. "The playbook can now install and configure [matrix-synapse-shared-secret-"
  9266. "auth](https://github.com/devture/matrix-synapse-shared-secret-auth) for "
  9267. "you."
  9268. msgstr ""
  9269. #: ../../../CHANGELOG.md:3720
  9270. msgid ""
  9271. "Additional details are available in [Setting up the Shared Secret Auth "
  9272. "password provider module](docs/configuring-playbook-shared-secret-"
  9273. "auth.md)."
  9274. msgstr ""
  9275. #: ../../../CHANGELOG.md:3723
  9276. msgid "2018-08-17"
  9277. msgstr ""
  9278. #: ../../../CHANGELOG.md:3725
  9279. msgid "REST auth support via matrix-synapse-rest-auth"
  9280. msgstr ""
  9281. #: ../../../CHANGELOG.md:3727
  9282. msgid ""
  9283. "The playbook can now install and configure [matrix-synapse-rest-"
  9284. "auth](https://github.com/kamax-io/matrix-synapse-rest-auth) for you."
  9285. msgstr ""
  9286. #: ../../../CHANGELOG.md:3729
  9287. msgid ""
  9288. "Additional details are available in [Setting up the REST authentication "
  9289. "password provider module](docs/configuring-playbook-rest-auth.md)."
  9290. msgstr ""
  9291. #: ../../../CHANGELOG.md:3731
  9292. msgid "Compression improvements"
  9293. msgstr ""
  9294. #: ../../../CHANGELOG.md:3733
  9295. msgid ""
  9296. "Shifted Matrix Synapse compression from happening in the Matrix Synapse, "
  9297. "to happening in the nginx proxy that's in front of it."
  9298. msgstr ""
  9299. #: ../../../CHANGELOG.md:3736
  9300. msgid ""
  9301. "Additionally, `riot-web` also gets compressed now (in the nginx proxy), "
  9302. "which drops the initial page load's size from 5.31MB to 1.86MB."
  9303. msgstr ""
  9304. #: ../../../CHANGELOG.md:3739
  9305. msgid "Disabling some unnecessary Synapse services"
  9306. msgstr ""
  9307. #: ../../../CHANGELOG.md:3741
  9308. msgid "The following services are not necessary, so they have been disabled:"
  9309. msgstr ""
  9310. #: ../../../CHANGELOG.md:3742
  9311. msgid "on the federation port (8448): the `client` service"
  9312. msgstr ""
  9313. #: ../../../CHANGELOG.md:3743
  9314. msgid ""
  9315. "on the http port (8008, exposed over 443): the old Angular `webclient` "
  9316. "and the `federation` service"
  9317. msgstr ""
  9318. #: ../../../CHANGELOG.md:3745
  9319. msgid ""
  9320. "Federation runs only on the federation port (8448) now. The Client APIs "
  9321. "run only on the http port (8008) now."
  9322. msgstr ""
  9323. #: ../../../CHANGELOG.md:3748
  9324. msgid "2018-08-15"
  9325. msgstr ""
  9326. #: ../../../CHANGELOG.md:3750
  9327. msgid "mxisd Identity Server support"
  9328. msgstr ""
  9329. #: ../../../CHANGELOG.md:3752
  9330. msgid ""
  9331. "The playbook now sets up an [mxisd](https://github.com/kamax-io/mxisd) "
  9332. "Identity Server for you by default. Additional details are available in "
  9333. "[Setting up ma1sd Identity Server](docs/configuring-playbook-mxisd.md)."
  9334. msgstr ""
  9335. #: ../../../CHANGELOG.md:3755
  9336. msgid "2018-08-14"
  9337. msgstr ""
  9338. #: ../../../CHANGELOG.md:3757
  9339. msgid "Email-sending support"
  9340. msgstr ""
  9341. #: ../../../CHANGELOG.md:3759
  9342. msgid ""
  9343. "The playbook now configures an email-sending service (postfix) by "
  9344. "default. Additional details are available in [Adjusting email-sending "
  9345. "settings](docs/configuring-playbook-email.md)."
  9346. msgstr ""
  9347. #: ../../../CHANGELOG.md:3761
  9348. msgid ""
  9349. "With this, Matrix Synapse is able to send email notifications for missed "
  9350. "messages, etc."
  9351. msgstr ""
  9352. #: ../../../CHANGELOG.md:3764
  9353. msgid "2018-08-08"
  9354. msgstr ""
  9355. #: ../../../CHANGELOG.md:3770
  9356. msgid "from `matrix_max_upload_size_mb` to `matrix_synapse_max_upload_size_mb`"
  9357. msgstr ""
  9358. #: ../../../CHANGELOG.md:3771
  9359. msgid ""
  9360. "from `matrix_max_log_file_size_mb` to "
  9361. "`matrix_synapse_max_log_file_size_mb`"
  9362. msgstr ""
  9363. #: ../../../CHANGELOG.md:3772
  9364. msgid "from `matrix_max_log_files_count` to `matrix_synapse_max_log_files_count`"
  9365. msgstr ""
  9366. #: ../../../CHANGELOG.md:3773
  9367. msgid "from `docker_matrix_image` to `matrix_docker_image_synapse`"
  9368. msgstr ""
  9369. #: ../../../CHANGELOG.md:3774
  9370. msgid "from `docker_nginx_image` to `matrix_docker_image_nginx`"
  9371. msgstr ""
  9372. #: ../../../CHANGELOG.md:3775
  9373. msgid "from `docker_riot_image` to `matrix_docker_image_riot`"
  9374. msgstr ""
  9375. #: ../../../CHANGELOG.md:3776
  9376. msgid "from `docker_goofys_image` to `matrix_docker_image_goofys`"
  9377. msgstr ""
  9378. #: ../../../CHANGELOG.md:3777
  9379. msgid "from `docker_coturn_image` to `matrix_docker_image_coturn`"
  9380. msgstr ""
  9381. #: ../../../CHANGELOG.md:3779
  9382. msgid ""
  9383. "If you're overriding any of them in your `vars.yml` file, you'd need to "
  9384. "change to the new names."
  9385. msgstr ""
  9386. #: ../../../CHANGELOG.md:3781
  9387. msgid "Renaming Ansible playbook tag"
  9388. msgstr ""
  9389. #: ../../../CHANGELOG.md:3783
  9390. msgid ""
  9391. "The command for executing the whole playbook has changed. The `setup-"
  9392. "main` tag got renamed to `setup-all`."
  9393. msgstr ""
  9394. #: ../../../CHANGELOG.md:3785
  9395. msgid "Docker container linking"
  9396. msgstr ""
  9397. #: ../../../CHANGELOG.md:3787
  9398. msgid ""
  9399. "Changed the way the Docker containers are linked together. The ones that "
  9400. "need to communicate with others operate in a `matrix` network now and not"
  9401. " in the default bridge network."
  9402. msgstr ""