mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-29 04:17:17 +01:00
d4f8d0918a
Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
11137 lines
363 KiB
Plaintext
11137 lines
363 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community
|
|
# members
|
|
# This file is distributed under the same license as the
|
|
# matrix-docker-ansible-deploy package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: matrix-docker-ansible-deploy \n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2024-12-16 12:05+0900\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language: jp\n"
|
|
"Language-Team: jp <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=utf-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
"Generated-By: Babel 2.16.0\n"
|
|
|
|
#: ../../../CHANGELOG.md:1
|
|
msgid "2024-11-26"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3
|
|
msgid ""
|
|
"(Backward Compatibility Break) Synapse now defaults to enabling "
|
|
"authenticated media"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:5
|
|
msgid ""
|
|
"**TLDR**: with this update, your Synapse homeserver will start requiring "
|
|
"authentication for newly-uploaded media files. While the majority of the "
|
|
"ecosystem (clients, bots, etc.) should support this, certain software may"
|
|
" lack support for it (and you may wish to turn it off, if it's causing "
|
|
"issues)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:7
|
|
msgid ""
|
|
"The default configuration for the Synapse homeserver now [enforces "
|
|
"Authenticated media by default](https://element-"
|
|
"hq.github.io/synapse/v1.120/upgrade.html#authenticated-media-is-now-"
|
|
"enforced-by-default)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:9
|
|
msgid ""
|
|
"Servers like `matrix.org` have already [sunset unauthenticated "
|
|
"media](https://matrix.org/blog/2024/06/26/sunsetting-unauthenticated-"
|
|
"media/) months ago."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:11
|
|
msgid ""
|
|
"Now that **various clients, bots, bridges and extra services have caught "
|
|
"up with authenticated media support**, Synapse developers seem confident "
|
|
"that it's time to enable authenticated media by default."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:13
|
|
msgid ""
|
|
"We're changing the playbook configuration for authenticated media to keep"
|
|
" up with upstream defaults changing."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:15
|
|
msgid ""
|
|
"Old and unmaintained bridges (like all mx-puppet bridges, etc.) do not "
|
|
"support authenticated media. Other software may be similarly affected. If"
|
|
" you experience issues with some Matrix-related software, you may wish to"
|
|
" disable authenticated media and contact the software maintainers to let "
|
|
"them know."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:17
|
|
msgid ""
|
|
"You can disable authenticated media at any time by setting "
|
|
"`matrix_synapse_enable_authenticated_media: false` in your `vars.yml` "
|
|
"configuration file and re-running the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:20
|
|
msgid "2024-11-23"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:22
|
|
msgid ""
|
|
"(Backward Compatibility Break) The playbook now defaults to Valkey, "
|
|
"instead of KeyDB"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:24
|
|
msgid ""
|
|
"**TLDR**: if the playbook installed KeyDB (or Redis) as a dependency for "
|
|
"you before, it will now replace it with [Valkey](https://valkey.io/) (a "
|
|
"drop-in alternative). We [previously switched from Redis to KeyDB"
|
|
"](#backward-compatibility-break-the-playbook-now-defaults-to-keydb-"
|
|
"instead-of-redis), but Valkey is a better alternative, so we're switching"
|
|
" again."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:26
|
|
msgid ""
|
|
"The playbook used to install Redis or KeyDB if services have a need for a"
|
|
" Redis-compatible implementation ([enabling worker support for "
|
|
"Synapse](docs/configuring-playbook-synapse.md#load-balancing-with-"
|
|
"workers), [enabling Hookshot encryption](docs/configuring-playbook-"
|
|
"bridge-hookshot.md#end-to-bridge-encryption), etc.)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:28
|
|
msgid ""
|
|
"Earlier this year, we switched from Redis to KeyDB - see [(Backward "
|
|
"Compatibility Break) The playbook now defaults to KeyDB, instead of Redis"
|
|
"](#backward-compatibility-break-the-playbook-now-defaults-to-keydb-"
|
|
"instead-of-redis)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:30
|
|
msgid ""
|
|
"Because Valkey seems to be a better successor to Redis (than KeyDB) and "
|
|
"likely doesn't suffer from [issues like this "
|
|
"one](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/issues/3544), we now replace KeyDB with Valkey."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:32
|
|
msgid ""
|
|
"Valkey (like KeyDB and Redis in the past) is an implicitly enabled "
|
|
"dependency - you don't need custom configuration in `vars.yml` to enable "
|
|
"it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:34
|
|
msgid ""
|
|
"Next time your run the playbook (via the `setup-all` tag), **KeyDB will "
|
|
"be automatically uninstalled and replaced with Valkey**. Some Synapse "
|
|
"downtime may occur while the switch happens."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:36
|
|
msgid ""
|
|
"Users on `arm32` should be aware that there's **neither a prebuilt "
|
|
"`arm32` container image for Valkey**, nor the Valkey role supports self-"
|
|
"building yet. Users on this architecture likely don't run Synapse with "
|
|
"workers, etc., so they're likely in no need of Valkey (or Redis/KeyDB). "
|
|
"If Redis is necessary in an `arm32` deployment, disabling Valkey and "
|
|
"making the playbook fall back to Redis is possible (see below)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:38 ../../../CHANGELOG.md:378
|
|
msgid ""
|
|
"**The playbook still supports Redis** and you can keep using Redis (for "
|
|
"now) if you'd like, by adding this additional configuration to your "
|
|
"`vars.yml` file:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:49
|
|
msgid ""
|
|
"**The playbook still supports KeyDB** and you can keep using KeyDB (for "
|
|
"now) if you'd like, by adding this additional configuration to your "
|
|
"`vars.yml` file:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:59
|
|
msgid ""
|
|
"At some point in time in the future, we'll remove both KeyDB and Redis "
|
|
"from the playbook, so we recommend that you migrate to Valkey earlier "
|
|
"anyway."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:62
|
|
msgid "2024-11-14"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:64
|
|
msgid "HTTP-compression support for Traefik-based setups"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:66
|
|
msgid ""
|
|
"The playbook now **automatically enables HTTP-compression support** for "
|
|
"major services powered by the playbook, like [Cinny](./docs/configuring-"
|
|
"playbook-client-cinny.md), [Element Web](./docs/configuring-playbook-"
|
|
"client-element-web.md), [Hydrogen](./docs/configuring-playbook-client-"
|
|
"hydrogen.md), as well as for Matrix Client-Server and Federation APIs "
|
|
"(`matrix.example.com`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:68
|
|
msgid ""
|
|
"Other services installed by the playbook are currently not compression-"
|
|
"enabled, but may become so over time. This change is rolled out on a per-"
|
|
"service basis (as opposed to doing it globally, at the Traefik entrypoint"
|
|
" level) to allow certain services or route endpoints which do not behave "
|
|
"well when compressed (e.g. [issue 3749](https://github.com/spantaleev"
|
|
"/matrix-docker-ansible-deploy/issues/3749)) to be excluded from "
|
|
"compression."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:70
|
|
msgid ""
|
|
"A long time ago, various services were operating with `gzip`-compression "
|
|
"enabled at the nginx level. Since the switch to Traefik (see [Goodbye, "
|
|
"`matrix-nginx-proxy` 🪦](https://github.com/spantaleev/matrix-docker-"
|
|
"ansible-deploy/blob/57c5271d9d6265a34a9d9cceb93365f685074f96/CHANGELOG.md"
|
|
"#goodbye-matrix-nginx-proxy-)), all services (with the exception of "
|
|
"Matrix APIs for Synapse worker-enabled setups which are powered by "
|
|
"`nginx` via `synapse-reverse-proxy-companion`) have been operating "
|
|
"without HTTP-compression support."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:72
|
|
msgid ""
|
|
"HTTP-compression is now done via Traefik's "
|
|
"[compress](https://doc.traefik.io/traefik/middlewares/http/compress/) "
|
|
"middleware. We use the default configuration for this middleware, which "
|
|
"enables `zstd`, `br` and `gzip` support (in this order). This "
|
|
"middleware's configuration can be configured via variables in the Traefik"
|
|
" role (see "
|
|
"`traefik_config_http_middlewares_compression_middleware_options`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:74
|
|
msgid ""
|
|
"If you're using your own Traefik reverse-proxy server ([Traefik managed "
|
|
"by you](./docs/configuring-playbook-own-webserver.md#traefik-managed-by-"
|
|
"you)) instead of the playbook's integrated Traefik service, you can "
|
|
"benefit from the same by:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:76
|
|
msgid ""
|
|
"defining a "
|
|
"[compress](https://doc.traefik.io/traefik/middlewares/http/compress/) "
|
|
"middleware (via the "
|
|
"[file](https://doc.traefik.io/traefik/providers/file/) or "
|
|
"[Docker](https://doc.traefik.io/traefik/providers/docker/) providers)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:77
|
|
msgid ""
|
|
"setting "
|
|
"`matrix_playbook_reverse_proxy_traefik_middleware_compression_enabled` to"
|
|
" `true`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:78
|
|
msgid ""
|
|
"specifying the middleware's name in "
|
|
"`matrix_playbook_reverse_proxy_traefik_middleware_compression_name` (e.g."
|
|
" `matrix_playbook_reverse_proxy_traefik_middleware_compression_name: my-"
|
|
"compression-middleware@file`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:80
|
|
msgid "Timeout adjustments for Traefik-based setups"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:82
|
|
msgid ""
|
|
"The playbook now supports configuring various "
|
|
"[transport.respondingTimeouts](https://doc.traefik.io/traefik/routing/entrypoints/#respondingtimeouts)"
|
|
" timeout values (`readTimeout`, `writeTimeout`, `idleTimeout`) for the "
|
|
"`web`, `web-secure` and `matrix-federation` entrypoints."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:84
|
|
msgid ""
|
|
"If you're using your own Traefik reverse-proxy server ([Traefik managed "
|
|
"by you](./docs/configuring-playbook-own-webserver.md#traefik-managed-by-"
|
|
"you)) instead of the playbook's integrated Traefik service, you may wish "
|
|
"to do similar configuration changes to your setup manually."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:86
|
|
msgid ""
|
|
"The most interesting of these is the `readTimeout` configuration value "
|
|
"(the maximum duration for reading the entire request, including the "
|
|
"body), which used to default to `60s`. For large and slowly progressing "
|
|
"file uploads, `60s` would often not be enough for the transfer to finish "
|
|
"and uploads would end up being interrupted. The playbook now raises the "
|
|
"`readTimeout` value to 5 minutes (`300s`) to improve this use-case."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:88
|
|
msgid ""
|
|
"The `traefik_config_entrypoint_web_transport_respondingTimeouts_*` "
|
|
"variables (for the `web` entrypoint) cascade to affecting the timeout "
|
|
"values for the `web-secure` and `matrix-federation` entrypoints, so you "
|
|
"can easily adjust all timeout values using them."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:90
|
|
msgid "Example of the default timeout values used by the playbook:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:101
|
|
msgid ""
|
|
"Alternatively, you may adjust the timeout values for specific entrypoints"
|
|
" (like `web-secure` and `matrix-federation`) using dedicated variables "
|
|
"(like "
|
|
"`traefik_config_entrypoint_web_secure_transport_respondingTimeouts_readTimeout`"
|
|
" and "
|
|
"`matrix_playbook_public_matrix_federation_api_traefik_entrypoint_config_transport_respondingTimeouts_readTimeout`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:104
|
|
msgid "2024-11-08"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:106
|
|
msgid ""
|
|
"Support for synapse-admin auto-configuration via /.well-"
|
|
"known/matrix/client"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:108
|
|
msgid ""
|
|
"You can administrate your Synapse-powered homeserver using synapse-admin "
|
|
"hosted externally (e.g. [admin.etke.cc](https://admin.etke.cc/)) and the "
|
|
"synapse-admin instance would still auto-configure itself correctly for "
|
|
"your server by [reading its `/.well-known/matrix/client` "
|
|
"file](https://github.com/etkecc/synapse-admin/pull/126)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:110
|
|
msgid ""
|
|
"The playbook now configures the `/.well-known/matrix/client` file for "
|
|
"this by default, injecting into it a `cc.etke.synapse-admin` section that"
|
|
" contains the full synapse-admin configuration. This is done even if you "
|
|
"don't enable the synapse-admin service in your configuration. The reason "
|
|
"for always doing it is to allow users to skip the (small) overhead of "
|
|
"self-hosting the non-core synapse-admin service, yet still be able to use"
|
|
" it from elsewhere when needed."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:112
|
|
msgid ""
|
|
"If you don't ever plan on using synapse-admin from other servers (besides"
|
|
" your own due to [self-hosting synapse-admin](./docs/configuring-"
|
|
"playbook-synapse-admin.md)), you **can disable this** `/.well-"
|
|
"known/matrix/client` configuration via "
|
|
"`matrix_static_files_file_matrix_client_property_cc_etke_synapse_admin_enabled:"
|
|
" false`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:115
|
|
msgid "2024-10-28"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:117
|
|
msgid "(BC Break) Postmoogle's variable names need adjustments"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:119
|
|
msgid ""
|
|
"Due to the recategorization of [Postmoogle](./docs/configuring-playbook-"
|
|
"bridge-postmoogle.md) from the bot to the bridge, its variables were "
|
|
"renamed (`matrix_bot_postmoogle_` -> `matrix_postmoogle_`). You need to "
|
|
"adjust your `vars.yml` configuration accordingly."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:121
|
|
msgid "2024-10-19"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:123
|
|
msgid "Support for Matrix Authentication Service"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:125
|
|
msgid ""
|
|
"The playbook now supports installing and configuring [Matrix "
|
|
"Authentication Service](./docs/configuring-playbook-matrix-"
|
|
"authentication-service.md) (MAS)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:127
|
|
msgid ""
|
|
"Huge thanks to [Quentin Gliech](https://github.com/sandhose) from the "
|
|
"[Element](https://element.io/) / [Matrix Authentication "
|
|
"Service](https://github.com/element-hq/matrix-authentication-service) "
|
|
"team for answering our numerous questions about MAS."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:129
|
|
msgid ""
|
|
"This is an **experimental service** and there are **still certain issues "
|
|
"with it** (see [Expectations](./docs/configuring-playbook-matrix-"
|
|
"authentication-service.md#expectations)). Matrix server administrators "
|
|
"should only consider switching if they identify with one or more [reasons"
|
|
" to use Matrix Authentication Service](./docs/configuring-playbook-"
|
|
"matrix-authentication-service.md#reasons-to-use-matrix-authentication-"
|
|
"service). As MAS adoption improves and more services are adjusted to "
|
|
"support it, we expect that using MAS will become the norm."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:131
|
|
msgid ""
|
|
"Our [Setting up Matrix Authentication Service](./docs/configuring-"
|
|
"playbook-matrix-authentication-service.md) documentation page has more "
|
|
"details about this new service, what you might expect from the switch and"
|
|
" how you can migrate your existing (Synapse) homeserver setup to MAS."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:134
|
|
msgid "2024-09-27"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:136
|
|
msgid ""
|
|
"(BC Break) Postgres & Traefik roles have been relocated and variable "
|
|
"names need adjustments"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:138
|
|
msgid ""
|
|
"Various roles have been relocated from the "
|
|
"[devture](https://github.com/devture) organization to the [mother-of-all-"
|
|
"self-hosting](https://github.com/mother-of-all-self-hosting) "
|
|
"organization."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:140
|
|
msgid ""
|
|
"Along with the relocation, the `devture_` prefix was dropped from their "
|
|
"variable names, so you need to adjust your `vars.yml` configuration."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:142
|
|
msgid "You need to do the following replacements:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:144
|
|
msgid "`devture_postgres_` -> `postgres_`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:145
|
|
msgid "`devture_traefik_` -> `traefik_`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:147
|
|
msgid ""
|
|
"As always, the playbook would let you know about this and point out any "
|
|
"variables you may have missed."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:150
|
|
msgid "2024-09-12"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:152
|
|
msgid "Support for baibot"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:154
|
|
msgid ""
|
|
"The playbook now supports installing [baibot](./docs/configuring-"
|
|
"playbook-bot-baibot.md) (pronounced bye-bot) - a "
|
|
"[Matrix](https://matrix.org/) bot developed by "
|
|
"[etke.cc](https://etke.cc/) that exposes the power of "
|
|
"[AI](https://en.wikipedia.org/wiki/Artificial_intelligence) / [Large "
|
|
"Language Models](https://en.wikipedia.org/wiki/Large_language_model) to "
|
|
"you. 🤖"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:156
|
|
msgid ""
|
|
"It supports [OpenAI](https://openai.com/)'s "
|
|
"[ChatGPT](https://openai.com/blog/chatgpt/) models, as well as many other"
|
|
" [☁️ "
|
|
"providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:158
|
|
msgid ""
|
|
"It's designed as a more private and [✨ "
|
|
"featureful](https://github.com/etkecc/baibot/?tab=readme-ov-"
|
|
"file#-features) alternative to the now-unmaintained [matrix-chatgpt-"
|
|
"bot](./docs/configuring-playbook-bot-chatgpt.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:160
|
|
msgid ""
|
|
"To get started, see the [Setting up baibot](./docs/configuring-playbook-"
|
|
"bot-baibot.md) documentation page."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:162
|
|
msgid "Switching synapse-admin to etke.cc's fork"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:164
|
|
msgid ""
|
|
"The playbook now installs [etke.cc](https://etke.cc/)'s "
|
|
"[fork](https://github.com/etkecc/synapse-admin) of [synapse-"
|
|
"admin](https://github.com/Awesome-Technologies/synapse-admin) (originally"
|
|
" developed by [Awesome-Technologies](https://github.com/Awesome-"
|
|
"Technologies)). This fork is a drop-in replacement for the original "
|
|
"software."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:166
|
|
msgid ""
|
|
"The creation of the fork has been provoked by users frequently "
|
|
"encountering issues with the original synapse-admin software, such as "
|
|
"unintentionally deleting their one-and-only admin user account (fixed "
|
|
"[here](https://github.com/etkecc/synapse-admin/pull/1) and also "
|
|
"contributed upstream [here](https://github.com/Awesome-Technologies"
|
|
"/synapse-admin/pull/608) - to no avail for now). Since its inception, [a "
|
|
"bunch of other quality-of-life improvements](https://github.com/etkecc"
|
|
"/synapse-admin?tab=readme-ov-file#changes) have been made to the fork."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:168
|
|
msgid ""
|
|
"If upstream synapse-admin picks up the pace and improves, the etke.cc "
|
|
"fork may disappear and the playbook may switch to the original software "
|
|
"again. Until that time comes, we believe that etke.cc's fork is the "
|
|
"better software to use right now."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:170
|
|
msgid ""
|
|
"If you'd like to switch back to the original synapse-admin software, you "
|
|
"can do so by adding the following configuration to your `vars.yml` file:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:183
|
|
msgid "2024-08-17"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:185
|
|
msgid "New appservice-double-puppet service for better double-puppeting"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:187
|
|
msgid ""
|
|
"Mautrix bridges are undergoing large changes as announced in the [August "
|
|
"2024 releases & progress](https://mau.fi/blog/2024-08-mautrix-release/) "
|
|
"blog post."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:189
|
|
msgid ""
|
|
"The playbook has already upgraded to the rewritten mautrix-slack "
|
|
"([v0.1.0](https://github.com/mautrix/slack/releases/tag/v0.1.0)) and "
|
|
"mautrix-signal "
|
|
"([v0.7.0](https://github.com/mautrix/signal/releases/tag/v0.7.0)) "
|
|
"bridges."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:191
|
|
msgid ""
|
|
"The newly rewritten bridges do not support double-puppeting via [Shared "
|
|
"Secret Auth](./docs/configuring-playbook-shared-secret-auth.md) anymore, "
|
|
"which has prompted us to switch to the new & better [appservice "
|
|
"method](https://docs.mau.fi/bridges/general/double-puppeting.html"
|
|
"#appservice-method-new) for double-puppeting. The playbook automates this"
|
|
" double-puppeting setup for you if you enable the new [Appservice Double "
|
|
"Puppet](./docs/configuring-playbook-appservice-double-puppet.md) service."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:193
|
|
msgid ""
|
|
"All non-deprecated mautrix bridges in the playbook have been reworked to "
|
|
"support double-puppeting via an Appservice. Most bridges still support "
|
|
"double-puppeting via [Shared Secret Auth](./docs/configuring-playbook-"
|
|
"shared-secret-auth.md), so the playbook supports it too. If only Shared "
|
|
"Secret Auth is enabled, double-puppeting will be configured using that "
|
|
"method (for the bridges that support it). That said, **Shared Secret Auth"
|
|
" double-puppeting is being phased out and we recommend replacing it with "
|
|
"the new Appservice method**."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:195
|
|
msgid ""
|
|
"We recommend **enabling double-puppeting via the new Appservice method** "
|
|
"by adding the following configuration to your `vars.yml` file:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:201
|
|
msgid ""
|
|
"You can still **keep** [Shared Secret Auth](./docs/configuring-playbook-"
|
|
"shared-secret-auth.md) enabled. Non-mautrix bridges and other services "
|
|
"(e.g. [matrix-corporal](./docs/configuring-playbook-matrix-corporal.md)) "
|
|
"may still require it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:203
|
|
msgid ""
|
|
"When both double-puppeting methods are enabled, the playbook will "
|
|
"automatically choose the new and better Appservice method for bridges "
|
|
"that support it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:206
|
|
msgid "2024-08-15"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:208
|
|
msgid "matrix-media-repo now configured for Authenticated Media"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:210
|
|
msgid ""
|
|
"Thanks to [Michael Hollister](https://github.com/Michael-Hollister) from "
|
|
"[FUTO](https://www.futo.org/), our matrix-media-repo implementation now "
|
|
"automatically [sets up signing keys](https://docs.t2bot.io/matrix-media-"
|
|
"repo/v1.3.5/installation/signing-key/) for Authenticated Media (as per "
|
|
"[MSC3916](https://github.com/matrix-org/matrix-spec-"
|
|
"proposals/pull/3916))."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:212
|
|
msgid ""
|
|
"If you had never heard of Authenticated Media before, the [Sunsetting "
|
|
"unauthenticated media](https://matrix.org/blog/2024/06/26/sunsetting-"
|
|
"unauthenticated-media/) article on [matrix.org](https://matrix.org/) is a"
|
|
" good introduction."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:214
|
|
msgid ""
|
|
"This feature is enabled for matrix-media-repo installations by default "
|
|
"and will append an additional (matrix-media-repo-generated signing key) "
|
|
"to your homeserver's (Synapse or Dendrite) signing key. See the [Signing "
|
|
"keys](./docs/configuring-playbook-matrix-media-repo.md#signing-keys) and "
|
|
"[Key backup and revoking](./docs/configuring-playbook-matrix-media-"
|
|
"repo.md#key-backup-and-revoking) sections of the matrix-media-repo "
|
|
"documentation for more details."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:216
|
|
msgid ""
|
|
"If you'd like to avoid this new feature, you can disable it by setting "
|
|
"`matrix_media_repo_generate_signing_key: false` in your `vars.yml` "
|
|
"configuration file."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:219
|
|
msgid "2024-08-08"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:221
|
|
msgid "(Backward Compatibility Break) matrix-corporal has been upgraded to v3"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:223
|
|
msgid ""
|
|
"The playbook now installs [matrix-corporal](https://github.com/devture"
|
|
"/matrix-corporal) v3.0.0, which brings support for **power-level "
|
|
"management** (thanks to [this PR](https://github.com/devture/matrix-"
|
|
"corporal/pull/32))."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:225
|
|
msgid ""
|
|
"This upgrade necessitates configuration policy changes as described in "
|
|
"[matrix-corporal's changelog entry](https://github.com/devture/matrix-"
|
|
"corporal/blob/5287cb81c82cd3b951c2a099b4697c3e0b384559/CHANGELOG.md#version-300-2024-08-08)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:227
|
|
msgid ""
|
|
"If you'd like to remain on the old (v2) version of matrix-corporal, you "
|
|
"can do so by adding the following configuration to your `vars.yml` file:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:233
|
|
msgid "2024-07-25"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:235
|
|
msgid "synapse-usage-exporter support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:237
|
|
msgid ""
|
|
"Thanks to [Michael Hollister](https://github.com/Michael-Hollister) from "
|
|
"[FUTO](https://www.futo.org/), the creators of the [Circles "
|
|
"app](https://circu.li/), the playbook can now set up [synapse-usage-"
|
|
"exporter](https://github.com/loelkes/synapse-usage-exporter) - a small "
|
|
"[Flask](https://flask.palletsprojects.com)-based webservice which can "
|
|
"capture usage statistics from Synapse (via HTTP `PUT`) and then make them"
|
|
" available for Prometheus to scrape."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:239
|
|
msgid ""
|
|
"To learn more see our [Enabling synapse-usage-exporter for Synapse usage "
|
|
"statistics](docs/configuring-playbook-synapse-usage-exporter.md) "
|
|
"documentation page."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:242
|
|
msgid "2024-07-06"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:244
|
|
msgid "matrix-alertmanager-receiver support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:246
|
|
msgid ""
|
|
"For those wishing to more easily integrate "
|
|
"[Prometheus](https://prometheus.io/)' alerting service "
|
|
"([Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/))"
|
|
" with Matrix, the playbook can now set up [matrix-alertmanager-"
|
|
"receiver](https://github.com/metio/matrix-alertmanager-receiver)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:248
|
|
msgid ""
|
|
"See [Setting up Prometheus Alertmanager integration via matrix-"
|
|
"alertmanager-receiver](./docs/configuring-playbook-alertmanager-"
|
|
"receiver.md) for more details."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:250
|
|
msgid "Traefik v3 and HTTP/3 are here now"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:252
|
|
msgid ""
|
|
"**TLDR**: Traefik was migrated from v2 to v3. Minor changes were done to "
|
|
"the playbook. Mostly everything else worked out of the box. Most people "
|
|
"will not have to do any tweaks to their configuration. In addition, "
|
|
"[HTTP/3](https://en.wikipedia.org/wiki/HTTP/3) support is now auto-"
|
|
"enabled for the `web-secure` (port 443) and `matrix-federation` (port "
|
|
"`8448`) entrypoints. If you have a firewall in front of your server and "
|
|
"you wish to benefit from `HTTP3`, you will need to open the `443` and "
|
|
"`8448` UDP ports in it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:254
|
|
msgid "Traefik v3"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:256
|
|
msgid ""
|
|
"The reverse-proxy that the playbook uses by default (Traefik) has "
|
|
"recently been upgraded to v3 (see [this blog "
|
|
"post](https://traefik.io/blog/announcing-traefik-proxy-v3-rc/) to learn "
|
|
"about its new features). Version 3 includes some small breaking "
|
|
"configuration changes requiring a "
|
|
"[migration](https://doc.traefik.io/traefik/migration/v2-to-v3/)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:258
|
|
msgid ""
|
|
"We have **updated the playbook to Traefik v3** (make sure to run `just "
|
|
"roles` / `make roles` to get it)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:260
|
|
msgid ""
|
|
"There were **only minor playbook changes required** to adapt to Traefik "
|
|
"v3, and only to the Ansible role for [matrix-media-repo](./docs"
|
|
"/configuring-playbook-matrix-media-repo.md) where we changed a few "
|
|
"[`PathPrefix` instances to "
|
|
"`PathRegexp`](https://doc.traefik.io/traefik/routing/routers/#path-"
|
|
"pathprefix-and-pathregexp), because these instances were using a regular "
|
|
"expression instead of a fixed path. For fixed-path values, `PathPrefix` "
|
|
"is still the preferred matcher function to use."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:262
|
|
msgid "**Most people using the playbook should not have to do any changes**."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:264
|
|
msgid ""
|
|
"If you're using the playbook's Traefik instance to reverse-proxy to some "
|
|
"other services of your own (not managed by the playbook), you may wish to"
|
|
" review their Traefik labels and make sure they're in line with the "
|
|
"[Traefik v2 to v3 migration "
|
|
"guide](https://doc.traefik.io/traefik/migration/v2-to-v3/)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:266
|
|
msgid ""
|
|
"If you've tweaked any of this playbook's `_path_prefix` variables and "
|
|
"made them use a regular expression, you will now need to make additional "
|
|
"adjustments. The playbook makes extensive use of `PathPrefix()` matchers "
|
|
"in Traefik rules and `PathPrefix` does not support regular expressions "
|
|
"anymore. To work around it, you may now need to override a whole "
|
|
"`_traefik_rule` variable and switch it from [`PathPrefix` to "
|
|
"`PathRegexp`](https://doc.traefik.io/traefik/routing/routers/#path-"
|
|
"pathprefix-and-pathregexp)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:268
|
|
msgid ""
|
|
"If you're not using [matrix-media-repo](./docs/configuring-playbook-"
|
|
"matrix-media-repo.md) (the only role we had to tweak to adapt it to "
|
|
"Traefik v3), you **may potentially downgrade to Traefik v2** (if "
|
|
"necessary) by adding `traefik_verison: v2.11.4` to your configuration. "
|
|
"People using `matrix-media-repo` cannot downgrade this way, because "
|
|
"`matrix-media-repo` has been adjusted to use `PathRegexp` - a [routing "
|
|
"matcher](https://doc.traefik.io/traefik/v2.11/routing/routers/#rule) that"
|
|
" Traefik v2 does not understand."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:270
|
|
msgid "HTTP/3 is enabled by default"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:272
|
|
msgid ""
|
|
"In Traefik v3, [HTTP/3](https://en.wikipedia.org/wiki/HTTP/3) support is "
|
|
"no longer considered experimental now. Due to this, **the playbook auto-"
|
|
"enables HTTP3** for the `web-secure` (port 443) and `matrix-federation` "
|
|
"(port `8448`) entrypoints."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:274
|
|
msgid ""
|
|
"HTTP3 uses the UDP protocol and **the playbook (together with Docker) "
|
|
"will make sure that the appropriate ports** (`443` over UDP & `8448` over"
|
|
" UDP) **are exposed and whitelisted in your server's firewall**. However,"
|
|
" **if you have another firewall in front of your server** (as is the case"
|
|
" for many cloud providers), **you will need to manually open these UDP "
|
|
"ports**."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:276
|
|
msgid ""
|
|
"If you do not open the UDP ports correctly or there is some other issue, "
|
|
"clients (browsers, mostly) will fall-back to "
|
|
"[HTTP/2](https://en.wikipedia.org/wiki/HTTP/2) or even "
|
|
"[HTTP/1.1](https://en.wikipedia.org/wiki/HTTP)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:278
|
|
msgid ""
|
|
"Still, if HTTP/3 cannot function correctly in your setup, it's best to "
|
|
"disable advertising support for it (and misleading clients into trying to"
|
|
" use HTTP/3)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:280
|
|
msgid "To **disable HTTP/3**, you can use the following configuration:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:294
|
|
msgid ""
|
|
"If you are using [your own webserver](./docs/configuring-playbook-own-"
|
|
"webserver.md) (in front of Traefik), port binding on UDP port `8448` by "
|
|
"default due to HTTP/3 is either unnecessary or [may get in the "
|
|
"way](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/issues/3402). If it does, you can disable it:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:307
|
|
msgid "2024-07-01"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:309
|
|
msgid "synapse-admin is now restricted to your homeserver's URL by default"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:311
|
|
msgid ""
|
|
"A new feature introduced in synapse-admin [v0.10.0](https://github.com"
|
|
"/Awesome-Technologies/synapse-admin/releases/tag/0.10.0) (released and "
|
|
"supported by the playbook since a a few months ago) provides the ability "
|
|
"to [restrict its usage to a specific homeserver](https://github.com"
|
|
"/Awesome-Technologies/synapse-"
|
|
"admin/blob/e21e44362c879ac41f47c580b04210842b6ff3d7/README.md"
|
|
"#restricting-available-homeserver) (or multiple homeservers)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:313
|
|
msgid ""
|
|
"The playbook has just started making use of this feature. **From now on, "
|
|
"your synapse-admin instance will be restricted to the homeserver you're "
|
|
"managing via the playbook**. When configured like this, the *Homeserver "
|
|
"URL* field in synapse-admin's web UI changes from a text field to a "
|
|
"dropdown having a single value (the URL of your homeserver). This makes "
|
|
"usage simpler for most people, as they won't need to manually enter a "
|
|
"*Homeserver URL* anymore."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:315
|
|
msgid ""
|
|
"If you'd like **to go back to the old unrestricted behavior**, use the "
|
|
"following configuration:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:323
|
|
msgid "2024-06-25"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:325
|
|
msgid "The URL-prefix for Hookshot generic webhooks has changed"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:327
|
|
msgid ""
|
|
"Until now, generic Hookshot webhook URLs looked like this: "
|
|
"`https://matrix.example.com/hookshot/webhooks/:hookId`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:329
|
|
msgid ""
|
|
"The `/hookshot/webhooks` common prefix gets stripped by Traefik "
|
|
"automatically, so Hookshot only sees the part that comes after "
|
|
"(`/:hookId`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:331
|
|
msgid ""
|
|
"[A few years ago](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/issues/1681), Hookshot started to prefer to handle webhooks at a "
|
|
"`/webhook/:hookId` path (instead of directly at `/:hookId`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:333
|
|
msgid ""
|
|
"To avoid future problems, we've "
|
|
"[reconfigured](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/commit/4704a60718946fd469aeee7fc3ae8127c633bb6b) our Hookshot "
|
|
"configuration to use webhook URLs that include `/webhook` in the URL "
|
|
"suffix (e.g. `/hookshot/webhooks/webhook/:hookId`, instead of "
|
|
"`/hookshot/webhooks/:hookId`). This means that when we strip the common "
|
|
"prefi (`/hookshot/webhooks`), we'll end up sending `/webhook/:hookId` to "
|
|
"Hookshot, just like recommended."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:335
|
|
msgid ""
|
|
"When generating new webhooks, you should start seeing the new URLs being "
|
|
"used."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:337
|
|
msgid ""
|
|
"**For now**, **both** old URLs (`/hookshot/webhooks/:hookId`) and new "
|
|
"URLs (`/hookshot/webhooks/webhook/:hookId`) **continue to work**, so your"
|
|
" webhooks will not break just yet."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:339
|
|
msgid ""
|
|
"However, **we recommend that you update all your old webhook URLs** "
|
|
"(configured in other systems) to include the new `/webhook` path "
|
|
"component, so that future Hookshot changes (whenever they come) will not "
|
|
"break your webhooks. You don't need to do anything on the Hookshot side -"
|
|
" you merely need to reconfigure the remote systems that use your webhook "
|
|
"URLs."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:342
|
|
msgid "2024-06-22"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:344
|
|
msgid "The maubot user is now managed by the playbook"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:346
|
|
msgid ""
|
|
"To make things easier and to be consistent with other roles, the "
|
|
"[maubot](./docs/configuring-playbook-bot-maubot.md) user (`bot.maubot` by"
|
|
" default) is [now](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/pull/3376) automatically created be the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:348
|
|
msgid ""
|
|
"If you have an existing maubot installation, you will need to specify "
|
|
"`matrix_bot_maubot_initial_password` in your `vars.yml` file to make the "
|
|
"playbook not complain about it being undefined. Since the bot is already "
|
|
"registered in your installation, there's nothing for the playbook to do "
|
|
"anyway. In case you don't remember the password you've registered your "
|
|
"maubot user account with, you can specify any value for this variable."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:350
|
|
msgid ""
|
|
"If you've registered another username for the bot (other than the "
|
|
"recommended default of `bot.maubot`), consider adjusting the "
|
|
"`matrix_bot_maubot_login` variable (e.g. `matrix_bot_maubot_login: "
|
|
"my.maubot.username`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:353
|
|
msgid "2024-06-03"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:355
|
|
msgid "WeChat bridging support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:357
|
|
msgid ""
|
|
"Thanks to [Tobias Diez](https://github.com/tobiasdiez)'s "
|
|
"[efforts](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/pull/3241), the playbook now supports bridging to "
|
|
"[WeChat](https://www.wechat.com/) via the [matrix-"
|
|
"wechat](https://github.com/duo/matrix-wechat) bridge."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:359
|
|
msgid ""
|
|
"See our [Setting up WeChat bridging](docs/configuring-playbook-bridge-"
|
|
"wechat.md) documentation page for getting started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:362
|
|
msgid "2024-03-26"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:364
|
|
msgid ""
|
|
"(Backward Compatibility Break) The playbook now defaults to KeyDB, "
|
|
"instead of Redis"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:366
|
|
msgid ""
|
|
"**TLDR**: if the playbook used installed Redis as a dependency for you "
|
|
"before, it will now replace it with [KeyDB](https://docs.keydb.dev/) (a "
|
|
"drop-in alternative) due to [Redis having changed its "
|
|
"license](https://redis.com/blog/redis-adopts-dual-source-available-"
|
|
"licensing/)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:368
|
|
msgid ""
|
|
"Thanks to [Aine](https://gitlab.com/etke.cc) of "
|
|
"[etke.cc](https://etke.cc/), the playbook now uses "
|
|
"[KeyDB](https://docs.keydb.dev/) (a drop-in alternative for Redis), "
|
|
"instead of [Redis](https://redis.io/)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:370
|
|
msgid ""
|
|
"The playbook used to install Redis (and now installs KeyDB in its place) "
|
|
"if services have a need for it ([enabling worker support for "
|
|
"Synapse](docs/configuring-playbook-synapse.md#load-balancing-with-"
|
|
"workers), [enabling Hookshot encryption](docs/configuring-playbook-"
|
|
"bridge-hookshot.md#end-to-bridge-encryption), etc.) or if you explicitly "
|
|
"enabled the service (`redis_enabled: true` or `keydb_enabled: true`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:372
|
|
msgid ""
|
|
"This change is provoked by the fact that [Redis is now \"source "
|
|
"available\"](https://redis.com/blog/redis-adopts-dual-source-available-"
|
|
"licensing/). According to the Limitations of [the new "
|
|
"license](https://redis.com/legal/rsalv2-agreement/) (as best as we "
|
|
"understand them, given that we're not lawyers), using Redis in the "
|
|
"playbook (even in a commercial FOSS service like "
|
|
"[etke.cc](https://etke.cc/)) does not violate the new Redis license. That"
|
|
" said, we'd rather neither risk it, nor endorse shady licenses and "
|
|
"products that pretend to be free-software. Another high-quality "
|
|
"alternative to Redis seems to be "
|
|
"[Dragonfly](https://www.dragonflydb.io/), but the [Dragonfly "
|
|
"license](https://github.com/dragonflydb/dragonfly?tab=License-1-ov-"
|
|
"file#readme) is no better than Redis's."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:374
|
|
msgid ""
|
|
"Next time your run the playbook (via the `setup-all` tag), **Redis will "
|
|
"be automatically uninstalled and replaced with KeyDB**. Some Synapse "
|
|
"downtime may occur while the switch happens."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:376
|
|
msgid ""
|
|
"Users on `arm32` should be aware that there's **neither a prebuilt "
|
|
"`arm32` container image for KeyDB**, nor the KeyDB role supports self-"
|
|
"building yet. Users on this architecture likely don't run Synapse with "
|
|
"workers, etc., so they're likely in no need of KeyDB (or Redis). If Redis"
|
|
" is necessary in an `arm32` deployment, disabling KeyDB and making the "
|
|
"playbook fall back to Redis is possible (see below)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:387
|
|
msgid "2024-03-24"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:389
|
|
msgid "Initial work on IPv6 support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:391
|
|
msgid ""
|
|
"Thanks to [Tilo Spannagel](https://github.com/tilosp), the playbook can "
|
|
"now enable IPv6 for container networks for various components (roles) via"
|
|
" [the `devture_systemd_docker_base_ipv6_enabled` "
|
|
"variable](https://github.com/devture/com.devture.ansible.role.systemd_docker_base/blob/c11a526bb8e318b42eb52055056377bb31154f13/defaults/main.yml#L14-L31)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:393
|
|
msgid "It should be noted that:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:395
|
|
msgid ""
|
|
"Matrix roles (`roles/custom/matrix-*`) respect this variable, but "
|
|
"external roles (those defined in `requirements.yml` and installed via "
|
|
"`just roles`) do not respect it yet. Additional work is necessary"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:396
|
|
msgid ""
|
|
"changing the variable subsequently may not change existing container "
|
|
"networks. Refer to [these "
|
|
"instructions](https://github.com/devture/com.devture.ansible.role.systemd_docker_base/blob/c11a526bb8e318b42eb52055056377bb31154f13/defaults/main.yml#L26-L30)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:397
|
|
msgid "this is all very new and untested"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:399
|
|
msgid "Pantalaimon support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:401
|
|
msgid ""
|
|
"Thanks to [Julian Foad](https://matrix.to/#/@julian:foad.me.uk), the "
|
|
"playbook can now install the [Pantalaimon](https://github.com/matrix-"
|
|
"org/pantalaimon) E2EE aware proxy daemon for you. It's already possible "
|
|
"to integrate it with [Draupnir](docs/configuring-playbook-bot-"
|
|
"draupnir.md) to allow it to work in E2EE rooms - see our Draupnir docs "
|
|
"for details."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:403
|
|
msgid ""
|
|
"See our [Setting up Pantalaimon](docs/configuring-playbook-"
|
|
"pantalaimon.md) documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:406
|
|
msgid "2024-03-05"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:408
|
|
msgid "Support for Draupnir-for-all"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:410
|
|
msgid ""
|
|
"Thanks to [FSG-Cat](https://github.com/FSG-Cat), the playbook can now "
|
|
"install [Draupnir for all](./docs/configuring-playbook-appservice-"
|
|
"draupnir-for-all.md) (aka multi-instance Draupnir running in appservice "
|
|
"mode)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:412
|
|
msgid ""
|
|
"This is an alternative to [running Draupnir in bot mode](./docs"
|
|
"/configuring-playbook-bot-draupnir.md), which is still supported by the "
|
|
"playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:414
|
|
msgid ""
|
|
"The documentation page for [Draupnir for all](./docs/configuring-"
|
|
"playbook-appservice-draupnir-for-all.md) contains more information on how"
|
|
" to install it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:417
|
|
msgid "2024-02-19"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:419
|
|
msgid "Support for bridging to Facebook/Messenger via the new mautrix-meta bridge"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:421
|
|
msgid ""
|
|
"The [mautrix-facebook](./docs/configuring-playbook-bridge-mautrix-"
|
|
"facebook.md) and [mautrix-instagram](./docs/configuring-playbook-bridge-"
|
|
"mautrix-instagram.md) bridges are being [superseded by a new "
|
|
"bridge](https://github.com/mautrix/facebook/issues/332) - the [mautrix-"
|
|
"meta](https://github.com/mautrix/meta) bridge."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:423
|
|
msgid ""
|
|
"The playbook now supports the new mautrix-meta bridge - a single bridge, "
|
|
"which can run in different modes and bridge to Messenger (via "
|
|
"[Facebook](https://facebook.com/), Facebook over "
|
|
"[Tor](https://www.torproject.org/) or via "
|
|
"[Messenger](https://messenger.com/)) and "
|
|
"[Instagram](https://instagram.com/). The playbook makes this bridge "
|
|
"available via 2 separate Ansible roles, allowing you to easily run 2 "
|
|
"instances of mautrix-meta, for bridging to both services at the same "
|
|
"time."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:425
|
|
msgid ""
|
|
"If you're using mautrix-facebook or mautrix-instagram right now, **you "
|
|
"can still continue using the old bridges, but may wish to change to the "
|
|
"new bridge implementations**. See:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:427
|
|
msgid ""
|
|
"[Setting up Instagram bridging via Mautrix Meta](docs/configuring-"
|
|
"playbook-bridge-mautrix-meta-instagram.md)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:429
|
|
msgid ""
|
|
"[Setting up Messenger bridging via Mautrix Meta](docs/configuring-"
|
|
"playbook-bridge-mautrix-meta-messenger.md)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:431
|
|
msgid "The documentation pages contain more information on how to migrate."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:434
|
|
msgid "2024-02-14"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:436
|
|
msgid "Much larger Synapse caches and cache auto-tuning enabled by default"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:438
|
|
msgid ""
|
|
"Thanks to [FSG-Cat](https://github.com/FSG-Cat), the playbook now uses "
|
|
"much larger caches and enables Synapse's [cache auto-tuning "
|
|
"functionality](https://matrix-"
|
|
"org.github.io/synapse/latest/usage/configuration/config_documentation.html"
|
|
"#caches-and-associated-values). This work and the default values used by "
|
|
"the playbook are inspired by [Tom Foster](https://github.com/tcpipuk)'s "
|
|
"[Synapse homeserver "
|
|
"guide](https://tcpipuk.github.io/synapse/deployment/synapse.html)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:440
|
|
msgid ""
|
|
"The playbook has always used a very conservative cache factor "
|
|
"(`matrix_synapse_caches_global_factor`) value of `0.5`, which may be OK "
|
|
"for small and underactive deployments, but is not ideal for larger "
|
|
"servers. Paradoxically, a small global cache factor value [does not "
|
|
"necessarily decrease RAM usage as a whole](https://github.com/matrix-"
|
|
"org/synapse/issues/3939)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:442
|
|
msgid ""
|
|
"The playbook now uses **a 20x larger cache factor** (currently `10`), "
|
|
"adjusts a few other cache-related variables, and **enables cache auto-"
|
|
"tuning** via the following variables:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:444
|
|
msgid ""
|
|
"`matrix_synapse_cache_autotuning_max_cache_memory_usage` - defaults to "
|
|
"1/8 of total RAM with a cap of 2GB; values are specified in bytes"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:445
|
|
msgid ""
|
|
"`matrix_synapse_cache_autotuning_target_cache_memory_usage` - defaults to"
|
|
" 1/16 of total RAM with a cap of 1GB; values are specified in bytes"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:446
|
|
msgid "`matrix_synapse_cache_autotuning_min_cache_ttl` - defaults to `30s`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:448
|
|
msgid ""
|
|
"These values should be good defaults for most servers, but may change "
|
|
"over time as we experiment further."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:450
|
|
msgid ""
|
|
"Refer to our new [Tuning caches and cache autotuning](docs/maintenance-"
|
|
"synapse.md#tuning-caches-and-cache-autotuning) documentation section for "
|
|
"more details."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:453
|
|
msgid "2024-01-31"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:455
|
|
msgid ""
|
|
"(Backward-compatibility break) Minor changes necessary for some people "
|
|
"serving a static website at the base domain"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:457
|
|
msgid ""
|
|
"This only affects people who are [Serving a static website at the base "
|
|
"domain](./docs/configuring-playbook-base-domain-serving.md#serving-a"
|
|
"-static-website-at-the-base-domain), but not managing its `index.html` "
|
|
"through the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:459
|
|
msgid ""
|
|
"That is, for people who have "
|
|
"`matrix_static_files_file_index_html_enabled: false` in their `vars.yml` "
|
|
"configuration, the playbook has a new default behavior. Since the "
|
|
"playbook is not managing the `index.html` file, it will default to a more"
|
|
" sensible way of handling the base domain - redirecting "
|
|
"`https://example.com/` to `https://matrix.example.com/`, instead of "
|
|
"serving a 404 page."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:461
|
|
msgid ""
|
|
"If you are managing your static website by yourself (by dropping files "
|
|
"into `/matrix/static-files/public` somehow), then you probably don't wish"
|
|
" for such redirection to happen. You can disable it by adding "
|
|
"`matrix_static_files_container_labels_base_domain_root_path_redirection_enabled:"
|
|
" false` to your `vars.yml` configuration file."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:464
|
|
msgid "2024-01-20"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:466
|
|
msgid "Support for more efficient (specialized) Synapse workers"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:468
|
|
msgid ""
|
|
"Thanks to [Charles Wright](https://github.com/cvwright) from "
|
|
"[FUTO](https://www.futo.org/), the creators of the [Circles "
|
|
"app](https://circu.li/), the playbook has [received "
|
|
"support](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/pull/3100) for load-balancing the Synapse workload via "
|
|
"[specialized workers](./docs/configuring-playbook-synapse.md#specialized-"
|
|
"workers) which are supposed to work better than our old [generic "
|
|
"workers](./docs/configuring-playbook-synapse.md#generic-workers) "
|
|
"implementation."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:470
|
|
msgid ""
|
|
"For now, playbook defaults remain unchanged and the `one-of-each` "
|
|
"[workers preset](./docs/configuring-playbook-synapse.md#worker-presets) "
|
|
"continues being the default. However, the default may change in the "
|
|
"future. If you'd like to remain on this preset even if/when the defaults "
|
|
"change, consider explicitly adding `matrix_synapse_workers_preset: one-"
|
|
"of-each` to your `vars.yml` configuration."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:472
|
|
msgid ""
|
|
"Our specialized workers setup is based on recommendations found in [Tom "
|
|
"Foster](https://github.com/tcpipuk)'s [Synapse homeserver "
|
|
"guide](https://tcpipuk.github.io/synapse/index.html). What's special "
|
|
"about our new setup is that we try to parse information out of the "
|
|
"request (who the user is; which room is being operated on) and try to "
|
|
"forward similar requests to the same worker. As an example, this means "
|
|
"that once a worker caches some room information, subsequent requests for "
|
|
"the same room will be routed to the same worker (which supposedly still "
|
|
"has the room's state cached)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:474
|
|
msgid ""
|
|
"To get started, refer to our [Specialized workers](./docs/configuring-"
|
|
"playbook-synapse.md#specialized-workers) documentation section."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:477
|
|
msgid "2024-01-17"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:479
|
|
msgid "Switching to Element's AGPLv3-licensed Synapse release"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:481
|
|
msgid ""
|
|
"A few months ago, the [Element](https://element.io/) company has "
|
|
"[announced](https://element.io/blog/element-to-adopt-agplv3/) that their "
|
|
"work on the Synapse homeserver would no longer be available under the "
|
|
"permissive [Apache-2.0 "
|
|
"license](https://www.apache.org/licenses/LICENSE-2.0), but only under:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:483
|
|
msgid ""
|
|
"the [AGPLv3](https://www.gnu.org/licenses/agpl-3.0.en.html) free-software"
|
|
" license - the same license that this Ansible playbook has always used"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:484
|
|
msgid ""
|
|
"a proprietary license, for those wishing for Element to [sell them an "
|
|
"exception](https://gnu.org/philosophy/selling-exceptions.html) to the "
|
|
"AGPLv3 license"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:486
|
|
msgid ""
|
|
"You can also learn more in [this post](https://matrix.org/blog/2023/11/06"
|
|
"/future-of-synapse-dendrite/) by the Matrix Foundation."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:488
|
|
msgid ""
|
|
"The change has [already happened](https://element.io/blog/synapse-now-"
|
|
"lives-at-github-com-element-hq-synapse/) and the first Synapse release "
|
|
"under the new license is here: [v1.99.0](https://github.com/element-"
|
|
"hq/synapse/releases/tag/v1.99.0)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:490
|
|
msgid ""
|
|
"There is no up-to-date alternative Synapse fork right now and this free-"
|
|
"software (AGPLv3-licensed) playbook is definitely not against free-"
|
|
"software licenses, so we are now switching to the Element-maintained "
|
|
"Synapse release."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:492
|
|
msgid "**What does this mean to you?**"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:494
|
|
msgid ""
|
|
"For most home users, it doesn't mean anything. Your installation will "
|
|
"continue working as it should and you don't need to do anything."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:496
|
|
msgid ""
|
|
"For people building commercial products on top of Synapse, they may have "
|
|
"to either buy a license exception from Element (from what we hear, the "
|
|
"fee depends on the number of monthly-active users on your instance) or "
|
|
"they may need to release all related code as free-software (which is what"
|
|
" we've been doing at [etke.cc](https://etke.cc/) "
|
|
"([here](https://gitlab.com/etke.cc)) all along)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:498
|
|
msgid ""
|
|
"We're no lawyers and this changelog entry does not aim to give you the "
|
|
"best legal advice, so please research on your own!"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:500
|
|
msgid ""
|
|
"If you'd like to continue using the old Apache-2.0-licensed Synapse (for "
|
|
"a while longer anyway), the playbook makes it possible by intruducing a "
|
|
"new Ansible variable. You can do it like this:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:512
|
|
msgid "Notes:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:514
|
|
msgid ""
|
|
"if you had already upgraded Synapse to `v1.99.0` by running this "
|
|
"playbook, you will still be able to downgrade to `v1.98.0`, because both "
|
|
"releases use the same database schema version (`SCHEMA_COMPAT_VERSION = "
|
|
"83` - see [here for v1.98.0](https://github.com/element-"
|
|
"hq/synapse/blob/v1.98.0/synapse/storage/schema/__init__.py#L131-L134) and"
|
|
" [here for v1.99.0](https://github.com/element-"
|
|
"hq/synapse/blob/v1.99.0/synapse/storage/schema/__init__.py#L137-L140)). "
|
|
"More details on Synapse's database schema are available [here](https"
|
|
"://element-"
|
|
"hq.github.io/synapse/develop/development/database_schema.html). It "
|
|
"appears that there are no new database migrations introduced in "
|
|
"`v1.99.0`, so going back to the older release is possible. This is not "
|
|
"guaranteed to hold true for future Synapse releases, so if you're seeing "
|
|
"this early-enough, consider pinning the version and organization before "
|
|
"re-running the playbook and getting upgraded to the latest version"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:516
|
|
msgid ""
|
|
"running an outdated homeserver exposes you to security issues and "
|
|
"incompatibilities. Only consider doing this as a short-term solution."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:518
|
|
msgid "2024-01-16"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:520
|
|
msgid "`Draupnir` has been relicensed to AFL-3.0"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:522
|
|
msgid ""
|
|
"As of [#204](https://github.com/the-draupnir-project/Draupnir/pull/204) "
|
|
"Draupnir changed its licence to AFL-3.0 from the CSL licence. This change"
|
|
" affects playbook users who could not run Draupnir under the old license "
|
|
"restrictions. The new license is considerably less restrictive and is OSI"
|
|
" approved. Draupnir version v1.86.0 and later are covered by this license"
|
|
" change."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:524
|
|
msgid "2024-01-15"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:526
|
|
msgid "Goodbye, `matrix-nginx-proxy` 🪦"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:528
|
|
msgid ""
|
|
"**TLDR**: All traces of the `matrix-nginx-proxy` reverse-proxy component "
|
|
"are now gone. This brought about many other internal changes (and "
|
|
"security improvements), so setups may need minor adjustments or suffer "
|
|
"some (temporary) breakage. People who have been on the Traefik-native "
|
|
"setup may upgrade without much issues. Those running their own Traefik "
|
|
"instance may need minor changes. People who have been postponing the "
|
|
"migration away from `matrix-nginx-proxy` (for more than a year already!) "
|
|
"will now finally need to do something about it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:530
|
|
msgid "Backstory on `matrix-nginx-proxy`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:532
|
|
msgid ""
|
|
"We gather here today to celebrate the loss of a once-beloved component in"
|
|
" our stack - `matrix-nginx-proxy`. It's been our "
|
|
"[nginx](https://nginx.org/)-based reverse-proxy of choice since the "
|
|
"[first commit](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/tree/87f5883f2455fb115457b65f267f17de305c053c) of this playbook, 7"
|
|
" years ago."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:534
|
|
msgid ""
|
|
"For 6 years, `matrix-nginx-proxy` has been the front-most reverse-proxy "
|
|
"in our setup (doing SSL termination, etc.). After [transitioning to "
|
|
"Traefik last year](#traefik-is-the-default-reverse-proxy-now), `matrix-"
|
|
"nginx-proxy` took a step back. Nevertheless, since it was so ingrained "
|
|
"into the playbook, it still remained in use - even if only internally. "
|
|
"Despite our warnings of its imminent death, many of you have indubitably "
|
|
"continued to use it instead of Traefik. Its suffering continued for too "
|
|
"long, because it served many different purposes and massive effort was "
|
|
"required to transition them to others."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:536
|
|
msgid "To us, `matrix-nginx-proxy` was:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:538
|
|
msgid "an [nginx](https://nginx.org/)-based reverse-proxy"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:539
|
|
msgid ""
|
|
"an Ansible role organizing the work of "
|
|
"[certbot](https://certbot.eff.org/) - retrieving free [Let's "
|
|
"Encrypt](https://letsencrypt.org/) SSL certificates for `matrix-nginx-"
|
|
"proxy` and for the [Coturn TURN server](./docs/configuring-playbook-"
|
|
"turn.md)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:540
|
|
msgid ""
|
|
"a central component for reverse-proxying to the [long list of "
|
|
"services](./docs/configuring-playbook.md) supported by the playbook. As "
|
|
"such, it became a dependency that all these services had to inject "
|
|
"themselves into during runtime"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:541
|
|
msgid ""
|
|
"an intermediary through which addons (bridges, bots) communicated with "
|
|
"the homeserver. Going through an intermediary (instead of directly "
|
|
"talking to the homeserver) is useful when certain components (like "
|
|
"[matrix-media-repo](./docs/configuring-playbook-matrix-media-repo.md) or "
|
|
"[matrix-corporal](./docs/configuring-playbook-matrix-corporal.md)) are "
|
|
"enabled, because it lets these services \"steal routes\" from the "
|
|
"homeserver"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:542
|
|
msgid ""
|
|
"a webserver for serving the `/.well-known/matrix` static files (generated"
|
|
" by the `matrix-base` role until now)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:543
|
|
msgid ""
|
|
"a webserver [serving your base domain](./docs/configuring-playbook-base-"
|
|
"domain-serving.md) (and also generating the `index.html` page for it)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:544
|
|
msgid ""
|
|
"a central component providing global [HTTP Basic "
|
|
"Auth](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) "
|
|
"password-protection for all `/metrics` endpoints when metrics were "
|
|
"exposed publicly for consumption from a remote Prometheus server"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:546
|
|
msgid ""
|
|
"Talk about a jack of all trades! The [UNIX "
|
|
"philosophy](https://en.wikipedia.org/wiki/Unix_philosophy) (and Docker "
|
|
"container philosophy) of \"do one thing and do it well\" had been "
|
|
"severely violated for too long."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:548
|
|
msgid ""
|
|
"On a related note, we also had a large chain of reverse-proxies in the "
|
|
"mix. In the worst case, it was something like this: (Traefik -> `matrix-"
|
|
"nginx-proxy:8080` -> `matrix-nginx-proxy:12080` -> `matrix-synapse-"
|
|
"reverse-proxy-companion:8008` -> `matrix-synapse:8008`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:550
|
|
msgid ""
|
|
"Due to complexity and the playbook's flexibility (trying to accommodate a"
|
|
" mix of tens of components), many layers of indirection were necessary. "
|
|
"We do like reverse-proxies, but.. not quite enough to enjoy going through"
|
|
" a chain of ~4 of them before reaching the target service."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:552
|
|
msgid ""
|
|
"After **a ton of work** in the last weeks (200+ commits, which changed "
|
|
"467 files - 8684 insertions and 8913 deletions), **we're finally saying "
|
|
"goodbye** to `matrix-nginx-proxy`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:554
|
|
msgid "Going Traefik-native and cutting out all middlemen"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:556
|
|
msgid "In our new setup, you'll see the bare minimum number of reverse-proxies."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:558
|
|
msgid ""
|
|
"In most cases, there's only Traefik and all services being registered "
|
|
"directly with it. When [Synapse workers](./docs/configuring-playbook-"
|
|
"synapse.md#load-balancing-with-workers) are enabled, `matrix-synapse-"
|
|
"reverse-proxy-companion` remains as an extra reverse-proxy that requests "
|
|
"go through (for load-balancing to the correct Synapse worker), but in all"
|
|
" other cases services are exposed directly."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:560
|
|
msgid ""
|
|
"This reduces \"network\" hops (improving performance) and also decreases "
|
|
"the number of components (containers). Each Ansible role in our setup is "
|
|
"now independent and doesn't need to interact with other roles during "
|
|
"runtime."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:562
|
|
msgid "Traefik now has an extra job"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:564
|
|
msgid ""
|
|
"Previously, **Traefik had a single purpose** - being the main reverse-"
|
|
"proxy. It was either front-most (terminating SSL, etc.) or you were "
|
|
"[fronting Traefik with your own other reverse-proxy](./docs/configuring-"
|
|
"playbook-own-webserver.md#fronting-the-integrated-reverse-proxy-"
|
|
"webserver-with-another-reverse-proxy). In any case - it had this central "
|
|
"(yet decentralized) job."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:566
|
|
msgid ""
|
|
"Now, **Traefik has one more role** - it serves as an intermediary which "
|
|
"allows addon services (bridges, bots, etc.) to communicate with the "
|
|
"homeserver. As mentioned above, such an intermediary service is not "
|
|
"strictly necessary in all kinds of setups, but more complex setups "
|
|
"(including [matrix-media-repo](./docs/configuring-playbook-matrix-media-"
|
|
"repo.md) or [matrix-corporal](./docs/configuring-playbook-matrix-"
|
|
"corporal.md)) benefit from it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:568
|
|
msgid ""
|
|
"To perform this new role, Traefik now has a new internal "
|
|
"[entrypoint](https://doc.traefik.io/traefik/routing/entrypoints/) called "
|
|
"`matrix-internal-matrix-client-api`. All homeservers (Conduit, Dendrite, "
|
|
"Synapse and even `matrix-synapse-reverse-proxy-companion`) and "
|
|
"homeserver-related core services ([matrix-media-repo](./docs/configuring-"
|
|
"playbook-matrix-media-repo.md), [matrix-corporal](./docs/configuring-"
|
|
"playbook-matrix-corporal.md) and potentially others) register their "
|
|
"routes (using [container labels](https://docs.docker.com/config/labels-"
|
|
"custom-metadata/)) not only on the public entrypoints (`web-secure`, "
|
|
"`matrix-federation`), but also on this new internal entrypoint."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:570
|
|
msgid ""
|
|
"Doing so, services can contact Traefik on this entrypoint's dedicated "
|
|
"port (the URL defaults to `http://matrix-traefik:8008`) and reach the "
|
|
"homeserver Client-Server API as they expect. Internally, Traefik takes "
|
|
"care of the routing to the correct service."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:572
|
|
msgid ""
|
|
"We've also considered keeping it simple and having services talk to the "
|
|
"homeserver over the public internet (e.g. `https://matrix.example.com`) "
|
|
"thus reusing all existing Traefik routing labels. In this scenario, "
|
|
"performance was incredibly poor (e.g. 70 rps, instead of 1400 rps) due to"
|
|
" TLS and networking overhead. The need for fast internal communication "
|
|
"(via the new internal non-TLS-enabled Traefik entrypoint) is definitely "
|
|
"there. In our benchmarks, Traefik even proved more efficient than nginx "
|
|
"at doing this: ~1200 rps for Traefik compared to ~900 rps for nginx (out "
|
|
"of ~1400 rps when talking to the Synapse homeserver directly)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:574
|
|
msgid "Traefik serving this second purpose has a few downsides:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:576
|
|
msgid ""
|
|
"Traefik becomes a runtime dependency for all homeserver-dependant "
|
|
"container services"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:577
|
|
msgid ""
|
|
"all homeserver-dependant services now need to be connected to the "
|
|
"`traefik` container network, even if they don't need public internet "
|
|
"exposure"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:579
|
|
msgid ""
|
|
"Despite these downsides (which the playbook manages automatically), we "
|
|
"believe it's still a good compromise given the amount of complexity it "
|
|
"eliminates and the performance benefits it yields. One alternative we've "
|
|
"[considered](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/pull/3045#issuecomment-1867327001) was adding a new intermediary "
|
|
"service (e.g. `matrix-homeserver-proxy` powered by nginx), but this both "
|
|
"had much higher complexity (one more component in the mix; duplication of"
|
|
" effort to produce nginx-compatible route definitions for it) and "
|
|
"slightly worse performance (see above)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:581
|
|
msgid ""
|
|
"People running the default Traefik setup do not need to do anything to "
|
|
"make Traefik take on this extra job. Your Traefik configuration will be "
|
|
"updated automatically."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:583
|
|
msgid ""
|
|
"**People runnning their own Traefik reverse-proxy need to do [minor "
|
|
"adjustments](#people-managing-their-own-traefik-instance-need-to-do-"
|
|
"minor-changes)**, as described in the section below."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:585
|
|
msgid ""
|
|
"You may disable Traefik acting as an intermediary by explicitly setting "
|
|
"`matrix_playbook_public_matrix_federation_api_traefik_entrypoint_enabled`"
|
|
" to `false`. Services would then be configured to talk to the homeserver "
|
|
"directly, giving you a slight performance boost and a \"simpler\" Traefik"
|
|
" setup. However, such a configuration is less tested and will cause "
|
|
"troubles, especially if you enable more services (like `matrix-media-"
|
|
"repo`, etc.) in the future. As such, it's not recommended."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:587
|
|
msgid "People managing their own Traefik instance need to do minor changes"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:589
|
|
msgid ""
|
|
"This section is for people [managing their own Traefik instance on the "
|
|
"Matrix server](./docs/configuring-playbook-own-webserver.md#traefik-"
|
|
"managed-by-you). Those [using Traefik managed by the playbook](./docs"
|
|
"/configuring-playbook-own-webserver.md#traefik-managed-by-the-playbook) "
|
|
"don't need to do any changes."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:591
|
|
msgid ""
|
|
"Because [Traefik has an extra job now](#traefik-now-has-an-extra-job), "
|
|
"you need to adapt your configuration to add the additional `matrix-"
|
|
"internal-matrix-client-api` entrypoint and potentially configure the "
|
|
"`matrix_playbook_reverse_proxy_container_network` variable. See the "
|
|
"[Traefik managed by you](./docs/configuring-playbook-own-webserver.md"
|
|
"#traefik-managed-by-you) documentation section for more details."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:593
|
|
msgid ""
|
|
"People fronting Traefik with another reverse proxy need to do minor "
|
|
"changes"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:595
|
|
msgid ""
|
|
"We've already previously mentioned that you need to do some minor "
|
|
"[configuration changes related to `traefik_additional_entrypoints_auto"
|
|
"`](#backward-compatibility-configuration-changes-required-for-people-"
|
|
"fronting-the-integrated-reverse-proxy-webserver-with-another-reverse-"
|
|
"proxy)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:597
|
|
msgid ""
|
|
"If you don't do these changes (switching from "
|
|
"`traefik_additional_entrypoints_auto` to multiple other variables), your "
|
|
"Traefik setup will not automatically receive the new `matrix-internal-"
|
|
"matrix-client-api` Traefik entrypoint and Traefik would not be able to "
|
|
"perform [its new duty of connecting addons with the homeserver](#traefik-"
|
|
"now-has-an-extra-job)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:599
|
|
msgid "Supported reverse proxy types are now fewer"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:601
|
|
msgid ""
|
|
"This section is for people using a more custom reverse-proxy setup - "
|
|
"those having `matrix_playbook_reverse_proxy_type` set to a value "
|
|
"different than the default (`playbook-managed-traefik`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:603
|
|
msgid ""
|
|
"Previously, we allowed you to set `matrix_playbook_reverse_proxy_type` to"
|
|
" 7 different values to accommodate various reverse-proxy setups."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:605
|
|
msgid "The complexity of this is too high, so we only support 3 values right now:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:607
|
|
msgid ""
|
|
"(the default) `playbook-managed-traefik`, when you're [using Traefik "
|
|
"managed by the playbook](./docs/configuring-playbook-own-webserver.md"
|
|
"#traefik-managed-by-the-playbook)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:608
|
|
msgid ""
|
|
"`other-traefik-container`, when you're [managing your own Traefik "
|
|
"instance on the Matrix server](./docs/configuring-playbook-own-"
|
|
"webserver.md#traefik-managed-by-you)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:609
|
|
msgid ""
|
|
"`none`, when you wish for [no reverse-proxy integration to be done at "
|
|
"all](./docs/configuring-playbook-own-webserver.md#using-no-reverse-proxy-"
|
|
"on-the-matrix-side-at-all)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:611
|
|
msgid ""
|
|
"The `none` value is not recommended and may not work adequately, due to "
|
|
"lack of testing and [Traefik's new responsibilities](#traefik-now-has-an-"
|
|
"extra-job) in our setup."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:613
|
|
msgid ""
|
|
"**Previous values that are now gone** (and the playbook would report them"
|
|
" as such) are: `playbook-managed-nginx`, `other-nginx-non-container`, "
|
|
"`other-on-same-host` and `other-on-another-host`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:615
|
|
msgid ""
|
|
"If you were using these values as a way to stay away from Traefik, you "
|
|
"now have 2 options:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:617
|
|
msgid ""
|
|
"(recommended) [Fronting Traefik with another reverse-proxy](./docs"
|
|
"/configuring-playbook-own-webserver.md#fronting-the-integrated-reverse-"
|
|
"proxy-webserver-with-another-reverse-proxy)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:618
|
|
msgid ""
|
|
"(not recommended) [Using no reverse-proxy on the Matrix side at "
|
|
"all](./docs/configuring-playbook-own-webserver.md#using-no-reverse-proxy-"
|
|
"on-the-matrix-side-at-all) and reverse-proxying to each and every service"
|
|
" manually"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:620
|
|
msgid "Container networking changes"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:622
|
|
msgid ""
|
|
"Now that `matrix-nginx-proxy` is not in the mix, it became easier to "
|
|
"clear out some other long-overdue technical debt."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:624
|
|
msgid ""
|
|
"Since the very beginning of this playbook, all playbook services were "
|
|
"connected to a single (shared) `matrix` container network. Later on, some"
|
|
" additional container networks appeared, but most services (database, "
|
|
"etc.) still remained in the `matrix` container network. This meant that "
|
|
"any random container in this network could try to talk (or attack) the "
|
|
"Postgres database operating in the same `matrix` network."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:626
|
|
msgid ""
|
|
"Moving components (especially the database) into other container networks"
|
|
" was difficult - it required changes to many other components to ensure "
|
|
"correct connectivity."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:628
|
|
msgid ""
|
|
"All the hard work has been done now. We've added much more isolation "
|
|
"between services by splitting them up into separate networks (`matrix-"
|
|
"homeserver`, `matrix-addons`, `matrix-monitoring`, `matrix-exim-relay`, "
|
|
"etc). Components are only joined to the networks they need and should "
|
|
"(for the most part) not be able to access unrelated things."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:630
|
|
msgid ""
|
|
"Carrying out these container networking changes necessitated modifying "
|
|
"many components, so **we're hoping not too many bugs were introduced in "
|
|
"the process**."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:632
|
|
msgid ""
|
|
"We've refrained from creating too many container networks (e.g. one for "
|
|
"each component), to avoid exhausting Docker's default network pool and "
|
|
"contaminating the container networks list too much."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:634
|
|
msgid "Metrics exposure changes"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:636
|
|
msgid ""
|
|
"This section is for people who are exposing monitoring metrics publicly, "
|
|
"to be consumed by an external Prometheus server."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:638
|
|
msgid ""
|
|
"Previously, `matrix-nginx-proxy` was potentially password-protecting all "
|
|
"`/metrics/*` endpoints with the same username and password (specified as "
|
|
"plain-text in your `vars.yml` configuration file)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:640
|
|
msgid ""
|
|
"From now on, there are new variables for doing roughly the same - "
|
|
"`matrix_metrics_exposure_enabled`, "
|
|
"`matrix_metrics_exposure_http_basic_auth_enabled` and "
|
|
"`matrix_metrics_exposure_http_basic_auth_users`. See the [Prometheus & "
|
|
"Grafana](./docs/configuring-playbook-prometheus-grafana.md) docs page for"
|
|
" details."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:642
|
|
msgid ""
|
|
"`matrix-nginx-proxy` is not acting as a \"global guardian\" anymore. Now,"
|
|
" each role provides its own metrics exposure and protection by "
|
|
"registering with Traefik. Nevertheless, all roles are wired (via playbook"
|
|
" configuration in `group_vars/matrix_servers`) to obey these new "
|
|
"`matrix_metrics_exposure_*` variables. We've eliminated the "
|
|
"centralization, but have kept the ease of use. Now, you can also do per-"
|
|
"service password-protection (with different credentials), should you need"
|
|
" to do that for some reason."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:644
|
|
msgid ""
|
|
"The playbook will tell you about all variables that you need to migrate "
|
|
"during runtime, so rest assured - you shouldn't be able to miss anything!"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:646
|
|
msgid "Matrix static files"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:648
|
|
msgid ""
|
|
"As mentioned above, static files like `/.well-known/matrix/*` or your "
|
|
"base domain's `index.html` file (when [serving the base domain via the "
|
|
"Matrix server](./docs/configuring-playbook-base-domain-serving.md) was "
|
|
"enabled) were generated by the `matrix-base` or `matrix-nginx-proxy` "
|
|
"roles and put into a `/matrix/static-files` directory on the server. Then"
|
|
" `matrix-nginx-proxy` was serving all these static files."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:650
|
|
msgid ""
|
|
"All of this has been extracted into a new `matrix-static-files` Ansible "
|
|
"role that's part of the playbook. The static files generated by this new "
|
|
"role still live at roughly the same place (`/matrix/static-files/public` "
|
|
"directory, instead of `/matrix/static-files`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:652
|
|
msgid ""
|
|
"The playbook will migrate and update the `/.well-known/matrix/*` files "
|
|
"automatically but not your own files in `nginx-proxy/data/matrix-domain/`"
|
|
" you will need to back these up yourself otherwise they will be lost. It "
|
|
"will also warn you about usage of old variable names, so you can adapt to"
|
|
" the new names."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:654
|
|
msgid "A note on performance"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:656
|
|
msgid ""
|
|
"Some of you have been voicing their concerns (for a long time) about "
|
|
"Traefik being too slow and nginx being better."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:658
|
|
msgid ""
|
|
"Some online benchmarks support this by demonstrating slightly higher SSL-"
|
|
"termination performance in favor of nginx. The upcoming Traefik v3 "
|
|
"release is [said to](https://medium.com/beyn-technology/is-nginx-dead-is-"
|
|
"traefik-v3-20-faster-than-traefik-v2-f28ffb7eed3e) improve Traefik's SSL "
|
|
"performance by some 20%, but that still ends up being somewhat slower "
|
|
"than nginx."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:660
|
|
msgid ""
|
|
"We believe that using Traefik provides way too many benefits to worry "
|
|
"about this minor performance impairment."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:662
|
|
msgid ""
|
|
"The heaviest part of running a Matrix homeserver is all the slow and "
|
|
"potentially inefficient things the homeserver (e.g. Synapse) is doing. "
|
|
"These things affect performance much more than whatever reverse-proxy is "
|
|
"in front. Your server will die the same way by joining the famously large"
|
|
" **Matrix HQ** room, no matter which reverse-proxy you put in front."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:664
|
|
msgid ""
|
|
"Even our previously mentioned benchmarks (yielding ~1300 rps) are "
|
|
"synthetic - hitting a useless `/_matrix/client/versions` endpoint. Real-"
|
|
"use does much more than this."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:666
|
|
msgid ""
|
|
"If this is still not convincing enough for you and you want the best "
|
|
"possible performance, consider [Fronting Traefik with another reverse-"
|
|
"proxy](./docs/configuring-playbook-own-webserver.md#fronting-the-"
|
|
"integrated-reverse-proxy-webserver-with-another-reverse-proxy) (thus "
|
|
"having the slowest part - SSL termination - happen elsewhere) or [Using "
|
|
"no reverse-proxy on the Matrix side at all](./docs/configuring-playbook-"
|
|
"own-webserver.md#using-no-reverse-proxy-on-the-matrix-side-at-all). The "
|
|
"playbook will not get in your way of doing that, but these options may "
|
|
"make your life much harder. Performance comes at a cost, after all."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:668
|
|
msgid "Migration procedure"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:670
|
|
msgid ""
|
|
"The updated playbook will automatically perform some migration tasks for "
|
|
"you:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:672
|
|
msgid ""
|
|
"It will stop and remove the `matrix-nginx-proxy` systemd service and "
|
|
"container for you. This behavior cannot be disabled. It's essential that "
|
|
"this service gets stopped, because it remaining running (and having "
|
|
"container labels) may confuse Traefik as to where to route HTTP requests."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:674
|
|
msgid ""
|
|
"It will delete the `/matrix/nginx-proxy` directory and all files within "
|
|
"it. You can disable this behavior by adding "
|
|
"`matrix_playbook_migration_matrix_nginx_proxy_uninstallation_enabled: "
|
|
"false` to your `vars.yml` configuration file. Doing so will leave its "
|
|
"data around."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:676
|
|
msgid ""
|
|
"It will delete the `/matrix/ssl` directory and all files within it. You "
|
|
"can disable this behavior by adding "
|
|
"`matrix_playbook_migration_matrix_ssl_uninstallation_enabled: false` to "
|
|
"your `vars.yml` configuration file. If you have some important "
|
|
"certificates there for some reason, take them out or temporarily disable "
|
|
"removal of these files until you do."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:678
|
|
msgid ""
|
|
"It will tell you about all variables (`matrix_nginx_proxy_*` and many "
|
|
"others - even from other roles) that have changed during this large "
|
|
"nginx-elimination upgrade. You can disable this behavior by adding "
|
|
"`matrix_playbook_migration_matrix_nginx_proxy_elimination_variable_transition_checks_enabled:"
|
|
" false` to your `vars.yml` configuration file."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:680
|
|
msgid ""
|
|
"It will tell you about any leftover `matrix_nginx_proxy_*` variables in "
|
|
"your `vars.yml` file. You can disable this behavior by adding "
|
|
"`matrix_playbook_migration_matrix_nginx_proxy_leftover_variable_validation_checks_enabled:"
|
|
" false` to your `vars.yml` configuration file."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:682
|
|
msgid ""
|
|
"It will tell you about any leftover `matrix_ssl_*` variables in your "
|
|
"`vars.yml` file. You can disable this behavior by adding "
|
|
"`matrix_playbook_migration_matrix_ssl_leftover_variable_checks_enabled: "
|
|
"false` to your `vars.yml` configuration file."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:684
|
|
msgid ""
|
|
"We don't recommend changing these variables and suppressing warnings, "
|
|
"unless you know what you're doing."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:686
|
|
msgid ""
|
|
"**Most people should just upgrade as per-normal**, bearing in mind that a"
|
|
" lot has changed and some issues may arise. The playbook would guide you "
|
|
"through renamed variables automatically."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:688
|
|
msgid "Conclusion"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:690
|
|
msgid ""
|
|
"Thousands of lines of code were changed across hundreds of files. All "
|
|
"addons (bridges, bots) were rewired in terms of container networking and "
|
|
"in terms of how they reach the homeserver."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:692
|
|
msgid ""
|
|
"I don't actively use all the ~100 components offered by the playbook (no "
|
|
"one does), nor do I operate servers exercising all edge-cases. As such, "
|
|
"issues may arise. Please have patience and report (or try to fix) these "
|
|
"issues!"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:695
|
|
msgid "2024-01-14"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:697
|
|
msgid ""
|
|
"(Backward Compatibility) Configuration changes required for people "
|
|
"fronting the integrated reverse-proxy webserver with another reverse-"
|
|
"proxy"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:699
|
|
msgid ""
|
|
"If you're on the default setup (using the Traefik reverse-proxy as "
|
|
"installed by the playbook), you don't need to do anything."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:701
|
|
msgid ""
|
|
"People who are [Fronting the integrated Traefik reverse-proxy webserver "
|
|
"with another reverse-proxy](./docs/configuring-playbook-own-webserver.md"
|
|
"#fronting-the-integrated-reverse-proxy-webserver-with-another-reverse-"
|
|
"proxy), as per our previous instructions are redefining "
|
|
"`traefik_additional_entrypoints_auto` in their `vars.yml` configuration."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:703
|
|
msgid ""
|
|
"Such a full variable redefinion is intrustive, because it prevents the "
|
|
"playbook from injecting additional entrypoints into the Traefik "
|
|
"webserver. In the future, the playbook may have a need to do so."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:705
|
|
msgid ""
|
|
"For this reason, we no longer recommend completely redefining "
|
|
"`traefik_additional_entrypoints_auto`. The playbook now defines [various "
|
|
"`matrix_playbook_public_matrix_federation_api_traefik_entrypoint_*` "
|
|
"variables in the `defaults/main.yml` file](https://github.com/spantaleev"
|
|
"/matrix-docker-ansible-deploy/blob/master/roles/custom/matrix-"
|
|
"base/defaults/main.yml) of the `matrix-base` role which can be used as a "
|
|
"safer alternative to `traefik_additional_entrypoints_auto`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:707
|
|
msgid "Adapt your configuration as seen below:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:740
|
|
msgid ""
|
|
"Also, feel free to read the [Fronting the integrated Traefik reverse-"
|
|
"proxy webserver with another reverse-proxy](./docs/configuring-playbook-"
|
|
"own-webserver.md#fronting-the-integrated-reverse-proxy-webserver-with-"
|
|
"another-reverse-proxy) documentation section again for additional "
|
|
"details."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:743
|
|
msgid "2024-01-13"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:745
|
|
msgid ""
|
|
"matrix-reminder-bot update with more secure (backward-incompatible) "
|
|
"default settings"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:747
|
|
msgid ""
|
|
"**TLDR**: your updated (to [v0.3.0](https://github.com/anoadragon453"
|
|
"/matrix-reminder-bot/releases/tag/v0.3.0)) [matrix-reminder-bot](./docs"
|
|
"/configuring-playbook-bot-matrix-reminder-bot.md) is now more secure. By "
|
|
"default, like other bridges/bots managed by the playbook, it will only "
|
|
"provide its services to users of your own server (not to anyone, even "
|
|
"across the Matrix Federation). If that's fine, there's nothing you need "
|
|
"to do."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:749
|
|
msgid ""
|
|
"Maintenance of [matrix-reminder-bot](./docs/configuring-playbook-bot-"
|
|
"matrix-reminder-bot.md) has been picked up by [Kim "
|
|
"Brose](https://github.com/HarHarLinks) and "
|
|
"[@svierne](https://github.com/svierne)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:751
|
|
msgid ""
|
|
"Thanks to them, a new [v0.3.0](https://github.com/anoadragon453/matrix-"
|
|
"reminder-bot/releases/tag/v0.3.0) release is out. The new version is now "
|
|
"available for the ARM64 architecture, so playbook users on this "
|
|
"architecture will no longer need to wait for [self-building](./docs/self-"
|
|
"building.md) to happen."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:753
|
|
msgid ""
|
|
"The new version also comes with new `allowlist` and `blocklist` settings,"
|
|
" which make it possible to restrict who can use the bot. Previously "
|
|
"anyone, even across the Matrix Federation could talk to it and schedule "
|
|
"reminders."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:755
|
|
msgid ""
|
|
"The playbook defaults all bridges and bots (where possible) to only be "
|
|
"exposed to users of the current homeserver, not users across federation. "
|
|
"Thanks to the new version of this bot making such a restriction possible,"
|
|
" we're now making use of it. The playbook (via its "
|
|
"`group_vars/matrix_servers` file) automatically enables the `allowlist` "
|
|
"(`matrix_bot_matrix_reminder_bot_allowlist_enabled: true`) and configures"
|
|
" it in such a way "
|
|
"(`matrix_bot_matrix_reminder_bot_allowlist_regexes_auto`) so as to "
|
|
"restrict the bot to your homeserver's users."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:757
|
|
msgid ""
|
|
"If you need **to undo or tweak these security improvements**, you can "
|
|
"change your `vars.yml` file to:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:759
|
|
msgid ""
|
|
"disable the allowlist (`matrix_bot_matrix_reminder_bot_allowlist_enabled:"
|
|
" false`), making the bot allow usage by anyone, anywhere"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:761
|
|
msgid ""
|
|
"inject additional allowed servers or users by adding **additional** (on "
|
|
"top of the default allowlist in "
|
|
"`matrix_bot_matrix_reminder_bot_allowlist_regexes_auto`) custom regexes "
|
|
"in the `matrix_bot_matrix_reminder_bot_allowlist_regexes_custom` list "
|
|
"variable (see the [syntax reference](https://github.com/anoadragon453"
|
|
"/matrix-reminder-"
|
|
"bot/blob/1e910c0aa3469d280d93ee7e6c6d577227a3460c/sample.config.yaml#L43-L49))"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:763
|
|
msgid ""
|
|
"override the default allowlist (in the `group_vars/matrix_servers` file) "
|
|
"by redefining `matrix_bot_matrix_reminder_bot_allowlist_regexes_auto`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:766
|
|
msgid "2024-01-05"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:768
|
|
msgid "matrix-mailer has been replaced by the exim-relay external role"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:770 ../../../CHANGELOG.md:1410
|
|
msgid ""
|
|
"We're continuing our effort to make [the playbook use external roles for "
|
|
"some things](#the-playbook-now-uses-external-roles-for-some-things), so "
|
|
"as to avoid doing everything ourselves and to facilitate code re-use."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:772
|
|
msgid ""
|
|
"The `matrix-mailer` role has been moved to its own repository ([ansible-"
|
|
"role-exim-relay](https://github.com/mother-of-all-self-hosting/ansible-"
|
|
"role-exim-relay)) that this playbook now includes."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:774
|
|
msgid "To migrate:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:776
|
|
msgid "pull the playbook changes, as usual"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:777
|
|
msgid "update your roles (run `just roles` or `make roles`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:778
|
|
msgid ""
|
|
"update your `vars.yml`, renaming `matrix_mailer`-prefixed variables to "
|
|
"`exim_relay`-prefixed ones (e.g. `matrix_mailer_sender_address` -> "
|
|
"`exim_relay_sender_address`). If you find none, it means you're using the"
|
|
" default configuration and your migraiton job is even simpler."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:779
|
|
msgid "re-run the playbook (`install-all` or `setup-all`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:781
|
|
msgid ""
|
|
"The playbook will take care of stopping the old `matrix-mailer` systemd "
|
|
"service, relocating its directory and restarting it under the new name "
|
|
"(`matrix-exim-relay.service`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:784
|
|
msgid "2024-01-02"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:786
|
|
msgid "mautrix-signal now powered by the new Go-based bridge"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:788
|
|
msgid ""
|
|
"The old Python-based [mautrix-signal](https://github.com/mautrix/signal) "
|
|
"bridge is no longer maintained upstream. It's also known to have issues "
|
|
"linking new devices."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:790
|
|
msgid ""
|
|
"It seems like the path forward is to switch to the new mautrix-signal "
|
|
"bridge written in Golang, which we did thanks to [PR "
|
|
"#3031](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/pull/3041) by [Pierre 'McFly' Marty](https://github.com/pm-McFly)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:792
|
|
msgid ""
|
|
"The playbook should **automatically migrate your mautrix-signal "
|
|
"installation to the new bridge code**. You will **need to relink all your"
|
|
" devices** to continue your bridged conversations."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:795
|
|
msgid "2023-10-23"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:797
|
|
msgid "Enabling `allow_public_rooms_over_federation` by default for Synapse"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:799
|
|
msgid ""
|
|
"**TDLR**: if your Matrix server is federating (which it mostly likely is,"
|
|
" unless you've [disabled federation](docs/configuring-playbook-"
|
|
"federation.md#disabling-federation)), your public rooms will not only be "
|
|
"joinable across federation (as they've always been), but from now on will"
|
|
" be discoverable (made available as a list across federation). We're "
|
|
"changing this by flipping the value for Synapse's "
|
|
"`allow_public_rooms_over_federation` setting to `true`, going against the"
|
|
" upstream default. Servers that disable federation are not affected. "
|
|
"Servers that have public rooms which are not published to the room "
|
|
"directory are also not affected."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:801
|
|
msgid ""
|
|
"We generally try to stick to the default configuration for Synapse (and "
|
|
"all other components), unless these defaults seem wrong or harmful. One "
|
|
"such previous case from a few months ago was us [Enabling "
|
|
"`forget_rooms_on_leave` by default for Synapse](#enabling-"
|
|
"forget_rooms_on_leave-by-default-for-synapse) - the default value was "
|
|
"making Synapse more wasteful of resources by default."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:803
|
|
msgid ""
|
|
"Today, we're going against upstream defaults again and flipping the "
|
|
"`allow_public_rooms_over_federation` configuration option to `true`. This"
|
|
" way, public rooms on your server will be made discoverable by others via"
|
|
" federation, using the [`GET /_matrix/federation/v1/publicRooms` of the "
|
|
"Server-Server API](https://spec.matrix.org/v1.8/server-server-"
|
|
"api/#get_matrixfederationv1publicrooms)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:805
|
|
msgid ""
|
|
"The upstream Synapse default is `false` (disabled), so that public rooms "
|
|
"are not exposed for other servers to discover (learn about their "
|
|
"existence). Nevertheless, even if these rooms are not exposed (listed) "
|
|
"for discovery, they are **still joinable** by anyone who knows their "
|
|
"address or is invited to the room by an existing member."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:807
|
|
msgid ""
|
|
"**We go against the upstream default** in an effort to make Matrix "
|
|
"federation more useful - a public room should be globally public - not "
|
|
"only joinable, but also discoverable across federation."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:809
|
|
msgid "The **historical reasoning** behind this change is as follows:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:811
|
|
msgid ""
|
|
"`allow_public_rooms_over_federation` seems to have been enabled by "
|
|
"default for Synapse until v1.7.0 (~2019), just like we believe it should "
|
|
"be for a globally-federating network - rooms should be joinable and "
|
|
"discoverable across federation."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:813
|
|
msgid ""
|
|
"In Synapse v1.7.0 (~2019), `allow_public_rooms_over_federation` [got "
|
|
"disabled](https://github.com/element-"
|
|
"hq/synapse/blob/e9069c9f919685606506f04527332e83fbfa44d9/docs/upgrade.md?plain=1#L1877-L1891)"
|
|
" by default in a [security-by-"
|
|
"obscurity](https://en.wikipedia.org/wiki/Security_through_obscurity) "
|
|
"workaround for misconfigured servers. See the [Avoiding unwelcome "
|
|
"visitors on private Matrix servers](https://matrix.org/blog/2019/11/09"
|
|
"/avoiding-unwelcome-visitors-on-private-matrix-servers/) `matrix.org` "
|
|
"blog article. We believe that people wishing for a truly private server, "
|
|
"should [disable federation](docs/configuring-playbook-federation.md"
|
|
"#disabling-federation), instead of having a fully-federating server and "
|
|
"trying to hide its public rooms. We also provide other workarounds below."
|
|
" We (and the Synapse team, obviously) believe that Matrix should federate"
|
|
" by default, so federating the public room list seems to make sense."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:815
|
|
#, python-format
|
|
msgid ""
|
|
"[etke.cc](https://etke.cc/) has been developing the free-software [Matrix"
|
|
" Rooms Search](https://github.com/etkecc/mrs) project for a while now. "
|
|
"One public (demo) instance of it is hosted at "
|
|
"[matrixrooms.info](https://matrixrooms.info/). This search engine tries "
|
|
"to go through the Matrix federation and discover & index public rooms to "
|
|
"allow people to find them. We believe it's vital for Matrix (and any chat"
|
|
" or social network for that matter) to be more discoverable, so that "
|
|
"people can find communities and others to talk to. Today (on 23rd of "
|
|
"October 2023), `matrixrooms.info` is indexing `23066` Matrix servers. Of "
|
|
"these, only `1567` servers (7%) are making their public rooms "
|
|
"discoverable. Who knows what wonderful communities and rooms are "
|
|
"available on these 93% other Matrix servers that are supposedly "
|
|
"federating, but are still gate-keeping their public room list. "
|
|
"Indubitably, many of these servers are hosted via matrix-docker-ansible-"
|
|
"deploy, so we feel partially responsible for making Matrix federation "
|
|
"less useful."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:817
|
|
msgid "Here are **actions you may wish to take** as a result of this change:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:819
|
|
msgid ""
|
|
"(recommended) embrace the new default. If your Matrix server is "
|
|
"federating, your public rooms have always been joinable across federation"
|
|
" anyway. Exposing the list of public rooms does no harm and more-so does "
|
|
"good by contributing to the usefulness of the Matrix network by "
|
|
"facilitating room discovery."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:821
|
|
msgid ""
|
|
"(switch to a better way of doings things on your semi-private server) The"
|
|
" problem that the Synapse team appears to have solved by flipping the "
|
|
"`allow_public_rooms_over_federation` default in Synapse v1.7.0 seems to "
|
|
"for \"mostly private\" servers, which federate and have a bunch of rooms "
|
|
"made public (and published in their room directory) in an effort to allow"
|
|
" people on the same homeserver to easily find and join them (self-"
|
|
"onboarding). With the introduction of Matrix Spaces, you can reorganize "
|
|
"your flow around spaces - you can auto-join your users to a Matrix Space "
|
|
"(via Synapse's `auto_join_rooms` setting - controlled by our "
|
|
"`matrix_synapse_auto_join_rooms` variable), then add a bunch of rooms to "
|
|
"the space and make them joinable by people belonging to the space. That "
|
|
"is to say, do not make rooms public and do not publish them to the room "
|
|
"directory unless they are really public. Instead, use other mechanisms "
|
|
"for semi-public rooms or private rooms. One alternative is to stick to "
|
|
"what you're doing (public rooms published to your rooms directory) but "
|
|
"having a `m.federate: true` flag set during creation (clients like "
|
|
"Element Web have a nice UI checkbox for this) to explicitly disable "
|
|
"federation for them."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:823
|
|
msgid ""
|
|
"(keeping the old behavior) if you wish to keep doing what you're doing "
|
|
"(keeping your Matrix server federating, but hiding its public rooms "
|
|
"list), add `matrix_synapse_allow_public_rooms_over_federation: false` to "
|
|
"your `vars.yml` configuration. This restores the old behavior. You may "
|
|
"also consider [disabling federation](docs/configuring-playbook-"
|
|
"federation.md#disabling-federation) completely instead of relying on "
|
|
"security-by-obscurity measures."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:826
|
|
msgid "2023-10-18"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:828
|
|
msgid "Postgres parameters are automatically tuned now"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:830
|
|
msgid ""
|
|
"The playbook has provided some hints about [Tuning PostgreSQL](docs"
|
|
"/maintenance-postgres.md#tuning-postgresql) for quite a while now."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:832
|
|
msgid ""
|
|
"From now on, the [Postgres Ansible role](https://github.com/mother-of-"
|
|
"all-self-hosting/ansible-role-postgres) automatically tunes your Postgres"
|
|
" configuration with the same [calculation "
|
|
"logic](https://github.com/le0pard/pgtune/blob/master/src/features/configuration/configurationSlice.js)"
|
|
" that powers https://pgtune.leopard.in.ua/."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:834
|
|
msgid ""
|
|
"Our [Tuning PostgreSQL](docs/maintenance-postgres.md#tuning-postgresql) "
|
|
"documentation page has details about how you can turn auto-tuning off or "
|
|
"adjust the automatically-determined Postgres configuration parameters "
|
|
"manually."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:836
|
|
msgid ""
|
|
"People who [enable load-balancing with Synapse workers](docs/configuring-"
|
|
"playbook-synapse.md#load-balancing-with-workers) no longer need to "
|
|
"increase the maximum number of Postgres connections manually (previously "
|
|
"done via `postgres_process_extra_arguments`). There's a new variable "
|
|
"(`postgres_max_connections`) for controlling this number and the playbook"
|
|
" automatically raises its value from `200` to `500` for setups which "
|
|
"enable workers."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:839
|
|
msgid "2023-08-31"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:841
|
|
msgid "SchildiChat Web support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:843
|
|
msgid ""
|
|
"Thanks to [Aine](https://gitlab.com/etke.cc) of "
|
|
"[etke.cc](https://etke.cc/), the playbook can now set up the [SchildiChat"
|
|
" Web](https://github.com/SchildiChat/schildichat-desktop) client."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:845
|
|
msgid ""
|
|
"See our [Configuring SchildiChat Web](docs/configuring-playbook-client-"
|
|
"schildichat-web.md) documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:848
|
|
msgid "2023-08-23"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:850
|
|
msgid "mautrix-wsproxy support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:852
|
|
msgid ""
|
|
"Thanks to [Johan Swetzén](https://github.com/jswetzen)'s efforts (who "
|
|
"finished what was started by [James Reilly](https://github.com/hanthor) "
|
|
"and [Shreyas Ajjarapu](https://github.com/shreyasajj)), the playbook now "
|
|
"supports bridging to Android SMS and Apple iMessage via the [mautrix-"
|
|
"wsproxy](https://github.com/mautrix/wsproxy) service (in combination with"
|
|
" a [mautrix-imessage](https://github.com/mautrix/imessage) bridge running"
|
|
" on your Mac or Android phone)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:854
|
|
msgid ""
|
|
"See our [Setting up Mautrix wsproxy for bridging Android SMS or Apple "
|
|
"iMessage](docs/configuring-playbook-bridge-mautrix-wsproxy.md) "
|
|
"documentation page for getting started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:857
|
|
msgid "2023-07-24"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:859
|
|
msgid "matrix-registration-bot usage changed"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:861
|
|
msgid ""
|
|
"[matrix-registration-bot](docs/configuring-playbook-bot-matrix-"
|
|
"registration-bot.md) got some updates and now supports password-only-"
|
|
"based login. Therefore the bot now doesn't need any manual configuration "
|
|
"except setting a password in your `vars.yml`. The bot will be registered "
|
|
"as admin and access tokens will be obtained automatically by the bot."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:863
|
|
msgid ""
|
|
"**For existing users** You need to set "
|
|
"`matrix_bot_matrix_registration_bot_bot_password` if you previously only "
|
|
"used `matrix_bot_matrix_registration_bot_bot_access_token`. Please also "
|
|
"remove the following deprecated settings"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:865
|
|
msgid "`matrix_bot_matrix_registration_bot_bot_access_token`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:866
|
|
msgid "`matrix_bot_matrix_registration_bot_api_token`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:869
|
|
msgid "2023-07-21"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:871
|
|
msgid "mautrix-gmessages support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:873
|
|
msgid ""
|
|
"Thanks to [Shreyas Ajjarapu](https://github.com/shreyasajj)'s efforts, "
|
|
"the playbook now supports bridging to [Google "
|
|
"Messages](https://messages.google.com/) via the [mautrix-"
|
|
"gmessages](https://github.com/mautrix/gmessages) bridge. See our [Setting"
|
|
" up Mautrix Google Messages bridging](docs/configuring-playbook-bridge-"
|
|
"mautrix-gmessages.md) documentation page for getting started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:876
|
|
msgid "2023-07-17"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:878
|
|
msgid "matrix-media-repo support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:880
|
|
msgid ""
|
|
"Thanks to [Michael Hollister](https://github.com/Michael-Hollister) from "
|
|
"[FUTO](https://www.futo.org/), the creators of the [Circles "
|
|
"app](https://circu.li/), the playbook can now set up [matrix-media-"
|
|
"repo](https://github.com/turt2live/matrix-media-repo) - an alternative "
|
|
"way to store homeserver media files, powered by a homeserver-independent "
|
|
"implementation which supports S3 storage, IPFS, deduplication and other "
|
|
"advanced features."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:882
|
|
msgid ""
|
|
"To learn more see our [Storing Matrix media files using matrix-media-"
|
|
"repo](docs/configuring-playbook-matrix-media-repo.md) documentation page."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:885
|
|
msgid "2023-05-25"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:887
|
|
msgid "Enabling `forget_rooms_on_leave` by default for Synapse"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:889
|
|
msgid ""
|
|
"With the [Synapse v1.84.0 update](https://github.com/spantaleev/matrix-"
|
|
"docker-ansible-deploy/pull/2698), we've also **changed the default "
|
|
"value** of the `forget_rooms_on_leave` setting of Synapse to a value of "
|
|
"`true`. This way, **when you leave a room, Synapse will now forget it "
|
|
"automatically**."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:891
|
|
msgid ""
|
|
"The upstream Synapse default is `false` (disabled), so that you must "
|
|
"forget rooms manually after leaving."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:893
|
|
msgid ""
|
|
"**We go against the upstream default** ([somewhat "
|
|
"controversially](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/pull/2700)) in an effort to make Synapse leaner and potentially do"
|
|
" what we believe most users would expect their homeserver to be doing."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:895
|
|
msgid ""
|
|
"If you'd like to go back to the old behavior, add the following to your "
|
|
"configuration: `matrix_synapse_forget_rooms_on_leave: false`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:898
|
|
msgid "2023-04-03"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:900
|
|
msgid "The matrix-jitsi role lives independently now"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:902
|
|
msgid ""
|
|
"**TLDR**: the `matrix-jitsi` role is now included from the [ansible-role-"
|
|
"jitsi](https://github.com/mother-of-all-self-hosting/ansible-role-jitsi) "
|
|
"repository, part of the [MASH playbook](https://github.com/mother-of-all-"
|
|
"self-hosting/mash-playbook). Some variables have been renamed. All "
|
|
"functionality remains intact."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:904
|
|
msgid ""
|
|
"The `matrix-jitsi` role has been relocated in its own repository, part of"
|
|
" the [MASH playbook](https://github.com/mother-of-all-self-hosting/mash-"
|
|
"playbook) project - an Ansible playbook for self-hosting [a growing list "
|
|
"of FOSS software](https://github.com/mother-of-all-self-hosting/mash-"
|
|
"playbook/blob/main/docs/supported-services.md). If hosting a Jitsi stack "
|
|
"on the Matrix server itself did not stand right with you or you always "
|
|
"wanted to host most stuff, you can now use this new playbook to do so."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:906
|
|
msgid ""
|
|
"As part of the extraction process of this role out of the Matrix "
|
|
"playbook, a few other things improved:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:908
|
|
msgid "**native Traefik support** has been added"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:909
|
|
msgid ""
|
|
"**support for hosting under a subpath** has been added, although it "
|
|
"suffers from a few minor issues listed [here](https://github.com/mother-"
|
|
"of-all-self-hosting/mash-playbook/blob/main/docs/services/jitsi.md#url)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:911
|
|
msgid ""
|
|
"You need to **update your roles** (`just roles` or `make roles`) "
|
|
"regardless of whether you're using Jitsi or not."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:913
|
|
msgid ""
|
|
"If you're making use of Jitsi via this playbook, you will need to update "
|
|
"variable references in your `vars.yml` file:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:915
|
|
msgid "`matrix_jitsi_*_docker_image_` -> `matrix_jitsi_*_container_image_`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:916
|
|
msgid "`matrix_jitsi_` -> `jitsi_`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:917 ../../../CHANGELOG.md:944
|
|
msgid ""
|
|
"some other internal variables have changed, but the playbook will tell "
|
|
"you about them"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:919
|
|
msgid "2023-03-22"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:921
|
|
msgid "ntfy Web App is disabled by default"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:923
|
|
msgid ""
|
|
"ntfy provides a web app, which is now disabled by default, because it may"
|
|
" be unknown to and unused by most users of this playbook. You can enable "
|
|
"it by setting `ntfy_web_root: \"app\"` (see [ntfy documentation](docs"
|
|
"/configuring-playbook-ntfy.md))."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:925
|
|
msgid ""
|
|
"This change was already applied a while before this entry, but as some "
|
|
"users were reporting the missing web app, this entry was added (see "
|
|
"[#2529](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/issues/2529))."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:928
|
|
msgid "2023-03-21"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:930
|
|
msgid "The matrix-prometheus role lives independently now"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:932
|
|
msgid ""
|
|
"**TLDR**: the `matrix-prometheus` role is now included from the [ansible-"
|
|
"role-prometheus](https://github.com/mother-of-all-self-hosting/ansible-"
|
|
"role-prometheus) repository, part of the [MASH "
|
|
"playbook](https://github.com/mother-of-all-self-hosting/mash-playbook). "
|
|
"Some variables have been renamed. All functionality remains intact."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:934
|
|
msgid ""
|
|
"The `matrix-prometheus` role has been relocated in its own repository, "
|
|
"part of the [MASH playbook](https://github.com/mother-of-all-self-hosting"
|
|
"/mash-playbook) project - an Ansible playbook for self-hosting [a growing"
|
|
" list of FOSS software](https://github.com/mother-of-all-self-hosting"
|
|
"/mash-playbook/blob/main/docs/supported-services.md). If hosting a "
|
|
"Prometheus stack on the Matrix server itself did not stand right with you"
|
|
" or you always wanted to host most stuff, you can now use this new "
|
|
"playbook to do so."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:936
|
|
msgid ""
|
|
"Extracting the Prometheus role out of this Matrix playbook required huge "
|
|
"internal refactoring to the way the Prometheus configuration (scraping "
|
|
"jobs) is generated. If you notice any breakage after upgrading, let us "
|
|
"know."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:938
|
|
msgid ""
|
|
"You need to **update your roles** (`just roles` or `make roles`) "
|
|
"regardless of whether you're using Prometheus or not."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:940
|
|
msgid ""
|
|
"If you're making use of Prometheus via this playbook, you will need to "
|
|
"update variable references in your `vars.yml` file:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:942
|
|
msgid "`matrix_prometheus_docker_image_` -> `matrix_prometheus_container_image_`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:943
|
|
msgid "`matrix_prometheus_` -> `prometheus_`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:947
|
|
msgid "2023-03-12"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:949
|
|
msgid "synapse-auto-compressor support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:951
|
|
msgid ""
|
|
"Thanks to [Aine](https://gitlab.com/etke.cc) of "
|
|
"[etke.cc](https://etke.cc/), the playbook can now set up [rust-synapse-"
|
|
"compress-state](https://github.com/matrix-org/rust-synapse-compress-"
|
|
"state)'s `synapse_auto_compressor` tool to run periodically."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:953
|
|
msgid ""
|
|
"If enabled, `synapse_auto_compressor` runs on a schedule and compresses "
|
|
"your Synapse database's `state_groups` table. It was possible to run "
|
|
"`rust-synapse-compress-state` manually via the playbook even before - see"
|
|
" [Compressing state with rust-synapse-compress-state](docs/maintenance-"
|
|
"synapse.md#compressing-state-with-rust-synapse-compress-state). However, "
|
|
"using `synapse_auto_compressor` is better, because:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:955
|
|
msgid "it runs on a more up-to-date version of `rust-synapse-compress-state`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:956
|
|
msgid ""
|
|
"it's a set-it-and-forget-it tool that you can enable and never have to "
|
|
"deal with manual compression anymore"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:958
|
|
msgid ""
|
|
"This tool needs to be enabled manually, for now. In the future, we're "
|
|
"considering enabling it by default for all Synapse installations."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:960
|
|
msgid ""
|
|
"See our [Setting up synapse-auto-compressor](docs/configuring-playbook-"
|
|
"synapse-auto-compressor.md) documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:963
|
|
msgid "2023-03-07"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:965
|
|
msgid "Sliding Sync proxy (Element X) support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:967
|
|
msgid ""
|
|
"Thanks to [Benjamin Kampmann](https://github.com/gnunicorn) for [getting "
|
|
"it started](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/pull/2515), [FSG-Cat](https://github.com/FSG-Cat) for fixing it up"
|
|
" and me ([Slavi](https://github.com/spantaleev)) for polishing it up, the"
|
|
" playbook can now install and configure the [sliding-sync "
|
|
"proxy](https://github.com/matrix-org/sliding-sync)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:969
|
|
msgid ""
|
|
"The upcoming Element X clients ([Element X iOS](https://github.com"
|
|
"/vector-im/element-x-ios) and [Element X Android](https://github.com"
|
|
"/vector-im/element-x-android)) require the `sliding-sync` proxy to do "
|
|
"their job. **These clients are still in beta** (especially Element X "
|
|
"Android, which requires manual compilation to get it working with a "
|
|
"non-`matrix.org` homeseserver). Playbook users can now easily give these "
|
|
"clients a try and help test them thanks to us having `sliding-sync` "
|
|
"support."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:971
|
|
msgid ""
|
|
"To get started, see our [Setting up the Sliding Sync proxy](docs"
|
|
"/configuring-playbook-sliding-sync-proxy.md) documentation page."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:974
|
|
msgid "2023-03-02"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:976
|
|
msgid "The matrix-etherpad role lives independently now"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:978
|
|
msgid ""
|
|
"**TLDR**: the `matrix-etherpad` role is now included from [another "
|
|
"repository](https://github.com/mother-of-all-self-hosting/ansible-role-"
|
|
"etherpad). Some variables have been renamed. All functionality remains "
|
|
"intact."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:980
|
|
msgid ""
|
|
"You need to **update your roles** (`just roles` or `make roles`) "
|
|
"regardless of whether you're using Etherpad or not."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:982
|
|
msgid ""
|
|
"If you're making use of Etherpad via this playbook, you will need to "
|
|
"update variable references in your `vars.yml` file:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:984
|
|
msgid "Rename `matrix_etherpad_public_endpoint` to `etherpad_path_prefix`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:986
|
|
msgid "Replace `matrix_etherpad_mode: dimension` with:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:987
|
|
msgid "for `matrix-nginx-proxy` users:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:988
|
|
msgid "`etherpad_nginx_proxy_dimension_integration_enabled: true`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:989
|
|
msgid "`etherpad_hostname: \"{{ matrix_server_fqn_dimension }}\"`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:990
|
|
msgid "for Traefik users:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:991
|
|
msgid ""
|
|
"define your own `etherpad_hostname` and `etherpad_path_prefix` as you see"
|
|
" fit"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:993
|
|
msgid "Rename all other variables:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:994
|
|
msgid "`matrix_etherpad_docker_image_` -> `matrix_etherpad_container_image_`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:995
|
|
msgid "`matrix_etherpad_` -> `etherpad_`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:997
|
|
msgid "Along with this relocation, the new role also:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:999
|
|
msgid ""
|
|
"supports [self-building](docs/self-building.md), so it should work on "
|
|
"`arm32` and `arm64` architectures"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1000
|
|
msgid ""
|
|
"has native Traefik reverse-proxy support (Etherpad requests no longer go "
|
|
"through `matrix-nginx-proxy` when using Traefik)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1003
|
|
msgid "2023-02-26"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1005
|
|
msgid "Traefik is the default reverse-proxy now"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1007
|
|
msgid ""
|
|
"**TLDR**: new installations will now default to Traefik as their reverse-"
|
|
"proxy. Existing users need to explicitly choose their reverse-proxy type."
|
|
" [Switching to Traefik](#how-do-i-switch-my-existing-setup-to-traefik) is"
|
|
" strongly encouraged. `matrix-nginx-proxy` may break over time and will "
|
|
"ultimately be removed."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1009
|
|
msgid ""
|
|
"As mentioned 2 weeks ago in [(Backward Compatibility) Reverse-proxy "
|
|
"configuration changes and initial Traefik support](#backward-"
|
|
"compatibility-reverse-proxy-configuration-changes-and-initial-traefik-"
|
|
"support), the playbook is moving to Traefik as its default SSL-"
|
|
"terminating reverse-proxy."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1011
|
|
msgid ""
|
|
"Until now, we've been doing the migration gradually and keeping full "
|
|
"backward compatibility. New installations were defaulting to `matrix-"
|
|
"nginx-proxy` (just like before), while existing installations were "
|
|
"allowed to remain on `matrix-nginx-proxy` as well. This makes things very"
|
|
" difficult for us, because we need to maintain and think about lots of "
|
|
"different setups:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1013
|
|
msgid "Traefik managed by the playbook"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1014
|
|
msgid "Traefik managed by the user in another way"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1015
|
|
msgid "another reverse-proxy on the same host (`127.0.0.1` port exposure)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1016
|
|
msgid "another reverse-proxy on another host (`0.0.0.0` port exposure)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1017
|
|
msgid "`matrix-nginx-proxy` - an `nginx` container managed by the playbook"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1018
|
|
msgid ""
|
|
"`nginx` webserver operated by the user, running without a container on "
|
|
"the same server"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1020
|
|
msgid ""
|
|
"Each change we do and each new feature that comes in needs to support all"
|
|
" these different ways of reverse-proxying. Because `matrix-nginx-proxy` "
|
|
"was the default and pretty much everyone was (and still is) using it, "
|
|
"means that new PRs also come with `matrix-nginx-proxy` as their main "
|
|
"focus and Traefik as an afterthought, which means we need to spend hours "
|
|
"fixing up Traefik support."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1022
|
|
msgid ""
|
|
"We can't spend all this time maintaining so many different configurations"
|
|
" anymore. Traefik support has been an option for 2 weeks and lots of "
|
|
"people have already migrated their server and have tested things out. "
|
|
"Traefik is what we use and preferentially test for."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1024
|
|
msgid ""
|
|
"It's time for the **next step in our migration process** to Traefik and "
|
|
"elimination of `matrix-nginx-proxy`:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1026
|
|
msgid "Traefik is now the default reverse-proxy for new installations"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1027
|
|
msgid ""
|
|
"All existing users need to explicitly choose their reverse-proxy type by "
|
|
"defining the `matrix_playbook_reverse_proxy_type` variable in their "
|
|
"`vars.yml` configuration file. We strongly encourage existing users to "
|
|
"[switch the Traefik](#how-to-switch-an-existing-setup-to-traefik), as the"
|
|
" nginx setup is bound to become more and more broken over time until it's"
|
|
" ultimately removed"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1029
|
|
msgid "How do I switch my existing setup to Traefik?"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1031
|
|
msgid ""
|
|
"**For users who are on `matrix-nginx-proxy`** (the default reverse-proxy "
|
|
"provided by the playbook), switching to Traefik can happen with a simple "
|
|
"configuration change. Follow this section from 2 weeks ago: [How do I "
|
|
"explicitly switch to Traefik right now?](#how-do-i-explicitly-switch-to-"
|
|
"traefik-right-now)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1033
|
|
msgid "If you experience trouble:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1035
|
|
msgid ""
|
|
"Follow [How do I remain on matrix-nginx-proxy?](#how-do-i-remain-on-"
|
|
"matrix-nginx-proxy) to bring your server back online using the old "
|
|
"reverse-proxy"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1036
|
|
msgid "Ask for help in our [support channels](README.md#support)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1037
|
|
msgid "Try switching to Traefik again later"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1039
|
|
msgid ""
|
|
"**For users with a more special reverse-proxying setup** (another nginx "
|
|
"server, Apache, Caddy, etc.), the migration may not be so smooth. Follow "
|
|
"the [Using your own webserver](docs/configuring-playbook-own-"
|
|
"webserver.md) guide. Ideally, your custom reverse-proxy will be "
|
|
"configured in such a way that it **fronts the Traefik reverse-proxy** "
|
|
"provided by the playbook. Other means of reverse-proxying are more "
|
|
"fragile and may be deprecated in the future."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1041
|
|
msgid "I already use my own Traefik server. How do I plug that in?"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1043
|
|
msgid ""
|
|
"See the [Traefik managed by the playbook](docs/configuring-playbook-own-"
|
|
"webserver.md#traefik-managed-by-the-playbook) section."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1045
|
|
msgid "Why is matrix-nginx-proxy used even after switching to Traefik?"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1047
|
|
msgid ""
|
|
"This playbook manages many different services. All these services were "
|
|
"initially integrated with `matrix-nginx-proxy`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1049
|
|
msgid ""
|
|
"While we migrate all these components to have native Traefik support, "
|
|
"some still go through nginx internally (Traefik -> local `matrix-nginx-"
|
|
"proxy` -> component). As time goes on, internal reliance on `matrix-"
|
|
"nginx-proxy` will gradually decrease until it's completely removed."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1051
|
|
msgid "How do I remain on matrix-nginx-proxy?"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1053
|
|
msgid ""
|
|
"Most new work and testing targets Traefik, so remaining on nginx is "
|
|
"**not** \"the good old stable\" option, but rather the \"still available,"
|
|
" but largely untested and likely to be broken very soon\" option."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1055
|
|
msgid ""
|
|
"To proceed regardless of this warning, add "
|
|
"`matrix_playbook_reverse_proxy_type: playbook-managed-nginx` to your "
|
|
"configuration."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1057
|
|
msgid ""
|
|
"At some point in the **near** future (days, or even weeks at most), we "
|
|
"hope to completely get rid of `matrix-nginx-proxy` (or break it enough to"
|
|
" make it unusable), so you **will soon be forced to migrate** anyway. "
|
|
"Plan your migration accordingly."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1059
|
|
msgid "How do I keep using my own other reverse-proxy?"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1061
|
|
msgid ""
|
|
"We recommend that you follow the guide for [Fronting the integrated "
|
|
"reverse-proxy webserver with another reverse-proxy](docs/configuring-"
|
|
"playbook-own-webserver.md#fronting-the-integrated-reverse-proxy-"
|
|
"webserver-with-another-reverse-proxy)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1064
|
|
msgid "2023-02-25"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1066
|
|
msgid "rageshake support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1068
|
|
msgid ""
|
|
"Thanks to [Benjamin Kampmann](https://github.com/gnunicorn), the playbook"
|
|
" can now install and configure the [rageshake](https://github.com/matrix-"
|
|
"org/rageshake) bug report server."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1070
|
|
msgid ""
|
|
"Additional details are available in [Setting up rageshake](docs"
|
|
"/configuring-playbook-rageshake.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1073
|
|
msgid "2023-02-17"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1075
|
|
msgid "Synapse templates customization support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1077
|
|
msgid "The playbook can now help you customize Synapse's templates."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1079
|
|
msgid ""
|
|
"Additional details are available in the [Customizing templates](docs"
|
|
"/configuring-playbook-synapse.md#customizing-templates) section of our "
|
|
"Synapse documentation."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1081
|
|
msgid "The matrix-redis role lives independently now"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1083
|
|
msgid ""
|
|
"**TLDR**: the `matrix-redis` role is now included from another "
|
|
"repository. Some variables have been renamed. All functionality remains "
|
|
"intact."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1085
|
|
msgid ""
|
|
"The `matrix-redis` role (which configures [Redis](https://redis.io/)) has"
|
|
" been extracted from the playbook and now lives in its [own "
|
|
"repository](https://github.com/mother-of-all-self-hosting/ansible-role-"
|
|
"redis). This makes it possible to easily use it in other Ansible "
|
|
"playbooks."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1087
|
|
msgid ""
|
|
"You need to **update your roles** (`just roles` or `make roles`) "
|
|
"regardless of whether you're enabling Ntfy or not. If you're making use "
|
|
"of Ntfy via this playbook, you will need to update variable references in"
|
|
" your `vars.yml` file (`matrix_redis_` -> `redis_`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1089
|
|
msgid "The matrix-ntfy role lives independently now"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1091
|
|
msgid ""
|
|
"**TLDR**: the `matrix-ntfy` role is now included from another repository."
|
|
" Some variables have been renamed. All functionality remains intact."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1093
|
|
msgid ""
|
|
"The `matrix-ntfy` role (which configures [Ntfy](https://ntfy.sh/)) has "
|
|
"been extracted from the playbook and now lives in its [own "
|
|
"repository](https://github.com/mother-of-all-self-hosting/ansible-role-"
|
|
"ntfy). This makes it possible to easily use it in other Ansible "
|
|
"playbooks."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1095
|
|
msgid ""
|
|
"You need to **update your roles** (`just roles` or `make roles`) "
|
|
"regardless of whether you're enabling Ntfy or not. If you're making use "
|
|
"of Ntfy via this playbook, you will need to update variable references in"
|
|
" your `vars.yml` file (`matrix_ntfy_` -> `ntfy_`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1098
|
|
msgid "2023-02-15"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1100
|
|
msgid "The matrix-grafana role lives independently now"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1102
|
|
msgid ""
|
|
"**TLDR**: the `matrix-grafana` role is now included from another "
|
|
"repository. Some variables have been renamed. All functionality remains "
|
|
"intact."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1104
|
|
msgid ""
|
|
"The `matrix-grafana` role (which configures [Grafana](docs/configuring-"
|
|
"playbook-prometheus-grafana.md)) has been extracted from the playbook and"
|
|
" now lives in its [own repository](https://github.com/mother-of-all-self-"
|
|
"hosting/ansible-role-grafana). This makes it possible to easily use it in"
|
|
" other Ansible playbooks."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1106
|
|
msgid ""
|
|
"You need to **update your roles** (`just roles` or `make roles`) "
|
|
"regardless of whether you're enabling Grafana or not. If you're making "
|
|
"use of Grafana via this playbook, you will need to update variable "
|
|
"references in your `vars.yml` file (`matrix_grafana_` -> `grafana_`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1109
|
|
msgid "2023-02-13"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1111
|
|
msgid "The matrix-backup-borg role lives independently now"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1113
|
|
msgid ""
|
|
"**TLDR**: the `matrix-backup-borg` role is now included from another "
|
|
"repository. Some variables have been renamed. All functionality remains "
|
|
"intact."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1115
|
|
msgid ""
|
|
"Thanks to [moan0s](https://github.com/moan0s), the `matrix-backup-borg` "
|
|
"role (which configures [BorgBackup](docs/configuring-playbook-backup-"
|
|
"borg.md)) has been extracted from the playbook and now lives in its [own "
|
|
"repository](https://github.com/mother-of-all-self-hosting/ansible-role-"
|
|
"backup_borg). This makes it possible to easily use it in other Ansible "
|
|
"playbooks and will become part of [nextcloud-docker-ansible-"
|
|
"deploy](https://github.com/spantaleev/nextcloud-docker-ansible-deploy) "
|
|
"soon."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1117
|
|
msgid ""
|
|
"You need to **update your roles** (`just roles` or `make roles`) "
|
|
"regardless of whether you're enabling Borg's backup functionality or not."
|
|
" If you're making use of BorgBackup via this playbook, you will need to "
|
|
"update variable references in your `vars.yml` file (`matrix_backup_borg_`"
|
|
" -> `backup_borg_`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1120
|
|
msgid "2023-02-12"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1122
|
|
msgid ""
|
|
"(Backward Compatibility) Reverse-proxy configuration changes and initial "
|
|
"Traefik support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1124
|
|
msgid "**TLDR**:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1126
|
|
msgid ""
|
|
"there's a new `matrix_playbook_reverse_proxy_type` variable (see "
|
|
"[roles/custom/matrix-base/defaults/main.yml](roles/custom/matrix-"
|
|
"base/defaults/main.yml)), which lets you tell the playbook what reverse-"
|
|
"proxy setup you'd like to have. This makes it easier for people who want "
|
|
"to do reverse-proxying in other ways."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1127
|
|
msgid ""
|
|
"the default reverse-proxy (`matrix_playbook_reverse_proxy_type`) is still"
|
|
" `playbook-managed-nginx` (via `matrix-nginx-proxy`), for now. **Existing"
|
|
" `matrix-nginx-proxy` users should not observe any changes** and can stay"
|
|
" on this for now."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1128
|
|
msgid ""
|
|
"**Users who use their [own other webserver](docs/configuring-playbook-"
|
|
"own-webserver.md) (e.g. Apache, etc.) need to change** "
|
|
"`matrix_playbook_reverse_proxy_type` to something like `other-on-same-"
|
|
"host`, `other-on-another-host` or `other-nginx-non-container`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1129
|
|
msgid ""
|
|
"we now have **optional [Traefik](https://traefik.io/) support**, so you "
|
|
"could easily host Matrix and other Traefik-native services in containers "
|
|
"on the same server. Traefik support is still experimental (albeit, good "
|
|
"enough) and will improve over time. It does work, but certain esoteric "
|
|
"features may not be there yet."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1130
|
|
msgid ""
|
|
"**Traefik will become the default reverse-proxy in the near future**. "
|
|
"`matrix-nginx-proxy` will either remain as an option, or be completely "
|
|
"removed to simplify the playbook"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1132
|
|
msgid "Motivation for redoing our reverse-proxy setup"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1134
|
|
msgid ""
|
|
"The playbook has supported various reverse-proxy setups for a long time. "
|
|
"We have various configuration variables (`matrix_nginx_proxy_enabled`, "
|
|
"various `_host_bind_port` variables, etc.) which allow the playbook to "
|
|
"adapt to these different setups. The whole situation was messy though - "
|
|
"hard to figure out and with lots of variables to toggle to make things "
|
|
"work as you'd expect - huge **operational complexity**."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1136
|
|
msgid ""
|
|
"We love containers, proven by the fact that **everything** that this "
|
|
"playbook manages runs in a container. Yet, we weren't allowing people to "
|
|
"easily host other web-exposed containers alongside Matrix services on the"
|
|
" same server. We were using `matrix-nginx-proxy` (our integrated "
|
|
"[nginx](https://nginx.org/) server), which was handling web-exposure and "
|
|
"SSL termination for our own services, but we **weren't helping you with "
|
|
"all your other containers**."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1138
|
|
msgid ""
|
|
"People who were **using `matrix-nginx-proxy`** were on the happy path on "
|
|
"which everything worked well by default (Matrix-wise), **but** could not "
|
|
"easily run other web-exposed services on their Matrix server because "
|
|
"`matrix-nginx-proxy` was occupying ports `80` and `443`. Other services "
|
|
"which wanted to get web exposure either had to be plugged into `matrix-"
|
|
"nginx-proxy` (somewhat difficult) or people had to forgo using `matrix-"
|
|
"nginx-proxy` in favor of something else."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1140
|
|
msgid ""
|
|
"Of those that decided to forgo `matrix-nginx-proxy`, many were **using "
|
|
"nginx** on the same server without a container. This was likely some "
|
|
"ancient nginx version, depending on your choice of distro. The Matrix "
|
|
"playbook was trying to be helpful and even with "
|
|
"`matrix_nginx_proxy_enabled: false` was still generating nginx "
|
|
"configuration in `/matrix/nginx-proxy/conf.d`. Those configuration files "
|
|
"were adapted for inclusion into an nginx server running locally. "
|
|
"Disabling the `matrix-nginx-proxy` role like this, yet still having it "
|
|
"produce files is a bit disgusting, but it's what we've had since the "
|
|
"early beginnings of this playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1142
|
|
msgid ""
|
|
"Others still, wanted to run Matrix locally (no SSL certificates), "
|
|
"regardless of which web server technology this relied on, and then "
|
|
"**reverse-proxy from another machine on the network** which was doing SSL"
|
|
" termination. These people were:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1144
|
|
msgid ""
|
|
"*either* relying on `matrix_nginx_proxy_enabled: false` as well, combined"
|
|
" with exposing services manually (setting `_bind_port` variables)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1145
|
|
msgid ""
|
|
"*or* better yet, they were keeping `matrix-nginx-proxy` enabled, but in "
|
|
"`http`-only mode (no SSL certificate retrieval)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1147
|
|
msgid ""
|
|
"Despite this operational complexity, things worked and were reasonably "
|
|
"flexible to adapt to all these situations."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1149
|
|
msgid ""
|
|
"When using `matrix-nginx-proxy` as is, we still had another problem - one"
|
|
" of **internal playbook complexity**. Too many services need to be web-"
|
|
"exposed (port 80/443, SSL certificates). Because of this, they all had to"
|
|
" integrate with the `matrix-nginx-proxy` role. Tens of different roles "
|
|
"explicitly integrating with `matrix-nginx-proxy` is not what we call "
|
|
"clean. The `matrix-nginx-proxy` role contains variables for many of these"
|
|
" roles (yikes). Other roles were more decoupled from it and were "
|
|
"injecting configuration into `matrix-nginx-proxy` at runtime - see all "
|
|
"the `inject_into_nginx_proxy.yml` task files in this playbook (more "
|
|
"decoupled, but still.. yikes)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1151
|
|
msgid ""
|
|
"The next problem is one of **efficiency, interoperability and cost-"
|
|
"saving**. We're working on other playbooks:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1153
|
|
msgid ""
|
|
"[vaultwarden-docker-ansible-deploy](https://github.com/spantaleev"
|
|
"/vaultwarden-docker-ansible-deploy) for hosting the "
|
|
"[Vaultwarden](https://github.com/dani-garcia/vaultwarden) server - an "
|
|
"alternative implementation of the [Bitwarden](https://bitwarden.com/) "
|
|
"password manager"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1154
|
|
msgid ""
|
|
"[gitea-docker-ansible-deploy](https://github.com/spantaleev/gitea-docker-"
|
|
"ansible-deploy) - for hosting the [Gitea](https://gitea.io/) git source "
|
|
"code hosting service"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1155
|
|
msgid ""
|
|
"[nextcloud-docker-ansible-deploy](https://github.com/spantaleev"
|
|
"/nextcloud-docker-ansible-deploy) - for hosting the "
|
|
"[Nextcloud](https://nextcloud.com/) groupware platform"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1157
|
|
msgid ""
|
|
"We'd love for users to be able to **seamlessly use all these playbooks "
|
|
"(and others, even) against a single server**. We don't want `matrix-"
|
|
"nginx-proxy` to have a monopoly on port `80`/`443` and make it hard for "
|
|
"other services to join in on the party. Such a thing forces people into "
|
|
"running multiple servers (one for each service), which does provide nice "
|
|
"security benefits, but is costly and ineffiecient. We'd like to make "
|
|
"self-hosting these services cheap and easy."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1159
|
|
msgid ""
|
|
"These other playbooks have been using [Traefik](https://traefik.io/) as "
|
|
"their default reverse-proxy for a long time. They can all coexist nicely "
|
|
"together (as an example, see the "
|
|
"[Interoperability](https://github.com/spantaleev/nextcloud-docker-"
|
|
"ansible-deploy/blob/master/docs/configuring-playbook-interoperability.md)"
|
|
" documentation for the [Nextcloud playbook](https://github.com/spantaleev"
|
|
"/nextcloud-docker-ansible-deploy)). Now that this playbook is gaining "
|
|
"Traefik support, it will be able to interoperate with them. If you're "
|
|
"going this way, make sure to have the Matrix playbook install Traefik and"
|
|
" have the others use `*_reverse_proxy_type: other-traefik-container`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1161
|
|
msgid ""
|
|
"Finally, at [etke.cc - a managed Matrix server hosting "
|
|
"service](https://etke.cc) (built on top of this playbook, and "
|
|
"coincidentally [turning 2 years old today](https://etke.cc/news"
|
|
"/upsyw4ykbtgmwhz8k7ukldx0zbbfq-fh0iqi3llixi0/) 🎉), we're allowing people "
|
|
"to host some additional services besides Matrix components. Exposing "
|
|
"these services to the web requires ugly hacks and configuration files "
|
|
"being dropped into `/matrix/nginx-proxy/conf.d`. We believe that "
|
|
"everything should run in independent containers and be exposed to the web"
|
|
" via a Traefik server, without a huge Ansible role like `matrix-nginx-"
|
|
"proxy` that everything else needs to integrate with."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1163
|
|
msgid "How do these changes fix all these problems?"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1165
|
|
msgid ""
|
|
"The new `matrix_playbook_reverse_proxy_type` lets you easily specify your"
|
|
" preferred reverse-proxy type, including `other-on-same-host`, `other-on-"
|
|
"another-host` and `none`, so people who'd like to reverse-proxy with "
|
|
"their own web server have more options now."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1167
|
|
msgid ""
|
|
"Using Traefik greatly simplifies things, so going forward we'll have a "
|
|
"simpler and easier to maintain playbook, which is also interoperable with"
|
|
" other services."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1169
|
|
msgid ""
|
|
"Traefik is a web server, which has been specifically **designed for "
|
|
"reverse-proxying to services running in containers**. It's ideal for "
|
|
"usage in an Ansible playbook which runs everything in containers."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1171
|
|
msgid ""
|
|
"**Traefik obtains SSL certificates automatically**, so there's no need "
|
|
"for plugging additional tools like [Certbot](https://certbot.eff.org/) "
|
|
"into your web server (like we were doing in the `matrix-nginx-proxy` "
|
|
"role). No more certificate renewal timers, web server reloading timers, "
|
|
"etc. It's just simpler."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1173
|
|
msgid ""
|
|
"Traefik is a **modern web server**. "
|
|
"[HTTP/3](https://doc.traefik.io/traefik/routing/entrypoints/#http3) is "
|
|
"supported already (experimentally) and will move to stable soon, in the "
|
|
"upcoming Traefik v3 release."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1175
|
|
msgid ""
|
|
"Traefik does not lock important functionality we'd like to use into [plus"
|
|
" packages like nginx does](https://www.nginx.com/products/nginx/), "
|
|
"leading us to resolve to configuration workarounds. The default Traefik "
|
|
"package is good enough as it is."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1177
|
|
msgid "Where we're at right now?"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1179
|
|
msgid ""
|
|
"`matrix_playbook_reverse_proxy_type` still defaults to a value of "
|
|
"`playbook-managed-nginx`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1181
|
|
msgid ""
|
|
"Unless we have some regression, **existing `matrix-nginx-proxy` users "
|
|
"should be able to update their Matrix server and not observe any "
|
|
"changes**. Their setup should still remain on nginx and everything should"
|
|
" still work as expected."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1183
|
|
msgid ""
|
|
"**Users using [their own webservers](docs/configuring-playbook-own-"
|
|
"webserver.md) will need to change `matrix_playbook_reverse_proxy_type`** "
|
|
"to something like `other-on-same-host`, `other-on-another-host` or "
|
|
"`other-nginx-non-container`. Previously, they could toggle "
|
|
"`matrix_nginx_proxy_enabled` to `false`, and that made the playbook "
|
|
"automatically expose services locally. Currently, we only do this if you "
|
|
"change the reverse-proxy type to `other-on-same-host`, `other-on-another-"
|
|
"host` or `other-nginx-non-container`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1185
|
|
msgid "How do I explicitly switch to Traefik right now?"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1187
|
|
msgid ""
|
|
"**Users who wish to migrate to Traefik** today, can do so by **adding** "
|
|
"this to their configuration:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1195
|
|
msgid ""
|
|
"You may still need to keep certain old `matrix_nginx_proxy_*` variables "
|
|
"(like `matrix_nginx_proxy_base_domain_serving_enabled`), even when using "
|
|
"Traefik. For now, we recommend keeping all `matrix_nginx_proxy_*` "
|
|
"variables just in case. In the future, reliance on `matrix-nginx-proxy` "
|
|
"will be removed."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1197
|
|
msgid ""
|
|
"Switching to Traefik will obtain new SSL certificates from Let's Encrypt "
|
|
"(stored in `/matrix/traefik/ssl/acme.json`). **The switch is "
|
|
"reversible**. You can always go back to `playbook-managed-nginx` if "
|
|
"Traefik is causing you trouble."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1199
|
|
msgid ""
|
|
"**Note**: toggling `matrix_playbook_reverse_proxy_type` between Traefik "
|
|
"and nginx will uninstall the Traefik role and all of its data (under "
|
|
"`/matrix/traefik`), so you may run into a Let's Encrypt rate limit if you"
|
|
" do it often."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1201
|
|
msgid ""
|
|
"Treafik directly reverse-proxies to **some** services right now, but for "
|
|
"most other services it goes through `matrix-nginx-proxy` (e.g. Traefik ->"
|
|
" `matrix-nginx-proxy` -> [Ntfy](docs/configuring-playbook-ntfy.md)). So, "
|
|
"even if you opt into Traefik, you'll still see `matrix-nginx-proxy` being"
|
|
" installed in local-only mode. This will improve with time."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1203
|
|
msgid ""
|
|
"Some services (like [Coturn](docs/configuring-playbook-turn.md) and "
|
|
"[Postmoogle](docs/configuring-playbook-bridge-postmoogle.md)) cannot be "
|
|
"reverse-proxied to directly from Traefik, so they require direct access "
|
|
"to SSL certificate files extracted out of Traefik. The playbook does this"
|
|
" automatically thanks to a new "
|
|
"[com.devture.ansible.role.traefik_certs_dumper](https://github.com/devture/com.devture.ansible.role.traefik_certs_dumper)"
|
|
" role utilizing the [traefik-certs-dumper](https://github.com/ldez"
|
|
"/traefik-certs-dumper) tool."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1205
|
|
msgid ""
|
|
"Our Traefik setup mostly works, but certain esoteric features may not "
|
|
"work. If you have a default setup, we expect you to have a good "
|
|
"experience."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1207
|
|
msgid "Where we're going in the near future?"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1209
|
|
msgid ""
|
|
"The `matrix-nginx-proxy` role is quite messy. It manages both nginx and "
|
|
"Certbot and its certificate renewal scripts and timers. It generates "
|
|
"configuration even when the role is disabled (weird). Although it doesn't"
|
|
" directly reach into variables from other roles, it has explicit "
|
|
"awareness of various other services that it reverse-proxies to "
|
|
"(`roles/custom/matrix-nginx-proxy/templates/nginx/conf.d/matrix-"
|
|
"ntfy.conf.j2`, etc.). We'd like to clean this up. The only way is "
|
|
"probably to just get rid of the whole thing at some point."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1211
|
|
msgid "For now, `matrix-nginx-proxy` will stay around."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1213
|
|
msgid ""
|
|
"As mentioned above, Traefik still reverse-proxies to some (most) services"
|
|
" by going through a local-only `matrix-nginx-proxy` server. This has "
|
|
"allowed us to add Traefik support to the playbook early on (without "
|
|
"having to rework all services), but is not the final goal. We'll **work "
|
|
"on making each service support Traefik natively**, so that traffic will "
|
|
"not need to go through `matrix-nginx-proxy` anymore. In the end, choosing"
|
|
" Traefik should only give you a pure Traefik installation with no "
|
|
"`matrix-nginx-proxy` in sight."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1215
|
|
msgid ""
|
|
"As Traefik support becomes complete and proves to be stable for a while, "
|
|
"especially as a playbook default, we will **most likely remove `matrix-"
|
|
"nginx-proxy` completely**. It will likely be some months before this "
|
|
"happens though. Keeping support for both Traefik and nginx in the "
|
|
"playbook will be a burden, especially with most of us running Traefik in "
|
|
"the future. The Traefik role should do everything nginx does in a better "
|
|
"and cleaner way. Users who use their own `nginx` server on the Matrix "
|
|
"server will be inconvenienced, as nothing will generate ready-to-include "
|
|
"nginx configuration for them. Still, we hope it won't be too hard to "
|
|
"migrate their setup to another way of doing things, like:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1217
|
|
msgid ""
|
|
"not using nginx anymore. A common reason for using nginx until now was "
|
|
"that you were running other containers and you need your own nginx to "
|
|
"reverse-proxy to all of them. Just switch them to Traefik as well."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1218
|
|
msgid ""
|
|
"running Traefik in local-only mode "
|
|
"(`traefik_config_entrypoint_web_secure_enabled: false`) and using some "
|
|
"nginx configuration which reverse-proxies to Traefik (we should introduce"
|
|
" examples for this in `examples/nginx`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1220
|
|
msgid "How do I help?"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1222
|
|
msgid "You can help by:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1224
|
|
msgid ""
|
|
"**explicitly switching your server to Traefik** right now (see example "
|
|
"configuration in [How do I explicitly switch to Traefik right now?](#how-"
|
|
"do-i-explicitly-switch-to-traefik-right-now) above), testing, reporting "
|
|
"troubles"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1226
|
|
msgid ""
|
|
"**adding native Traefik support to a role** (requires adding Traefik "
|
|
"labels, etc.) - for inspiration, see these roles "
|
|
"([prometheus_node_exporter](https://github.com/mother-of-all-self-hosting"
|
|
"/ansible-role-prometheus-node-exporter), "
|
|
"[prometheus_postgres_exporter](https://github.com/mother-of-all-self-"
|
|
"hosting/ansible-role-prometheus-postgres-exporter)) and how they're "
|
|
"hooked into the playbook via "
|
|
"[group_vars/matrix_servers](group_vars/matrix_servers)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1228
|
|
msgid ""
|
|
"**adding reverse-proxying examples for nginx users** in `examples/nginx`."
|
|
" People who insist on using their own `nginx` server on the same Matrix "
|
|
"host, can run Traefik in local-only mode "
|
|
"(`traefik_config_entrypoint_web_secure_enabled: false`) and reverse-proxy"
|
|
" to the Traefik server"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1231
|
|
msgid "2023-02-10"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1233
|
|
msgid "Matrix Authentication Support for Jitsi"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1235
|
|
msgid ""
|
|
"Thanks to [Jakob S.](https://github.com/jakicoll) ([zakk "
|
|
"gGmbH](https://github.com/zakk-it)), Jitsi can now use Matrix for "
|
|
"authentication (via [Matrix User Verification Service](https://github.com"
|
|
"/matrix-org/matrix-user-verification-service))."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1237
|
|
msgid ""
|
|
"Additional details are available in the [Authenticate using Matrix OpenID"
|
|
" (Auth-Type 'matrix')](docs/configuring-playbook-jitsi.md#authenticate-"
|
|
"using-matrix-openid-auth-type-matrix)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1239
|
|
msgid "Draupnir moderation tool (bot) support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1241
|
|
msgid ""
|
|
"Thanks to [FSG-Cat](https://github.com/FSG-Cat), the playbook can now "
|
|
"install and configure the [Draupnir](https://github.com/the-draupnir-"
|
|
"project/Draupnir) moderation tool (bot). Draupnir is a fork of "
|
|
"[Mjolnir](docs/configuring-playbook-bot-mjolnir.md) (which the playbook "
|
|
"has supported for a long time) maintained by Mjolnir's former lead "
|
|
"developer."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1243
|
|
msgid ""
|
|
"Additional details are available in [Setting up Draupnir](docs"
|
|
"/configuring-playbook-bot-draupnir.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1246
|
|
msgid "2023-02-05"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1248
|
|
msgid "The matrix-prometheus-postgres-exporter role lives independently now"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1250
|
|
msgid ""
|
|
"**TLDR**: the `matrix-prometheus-postgres-exporter` role is now included "
|
|
"from another repository. Some variables have been renamed. All "
|
|
"functionality remains intact."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1252
|
|
msgid ""
|
|
"The `matrix-prometheus-postgres-exporter` role (which configures "
|
|
"[Prometheus Postgres Exporter](https://github.com/prometheus-"
|
|
"community/postgres_exporter)) has been extracted from the playbook and "
|
|
"now lives in its own repository at https://github.com/mother-of-all-self-"
|
|
"hosting/ansible-role-prometheus-postgres-exporter"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1254
|
|
msgid ""
|
|
"It's still part of the playbook, but is now installed via `ansible-"
|
|
"galaxy` (by running `just roles` / `make roles`). Some variables have "
|
|
"been renamed (`matrix_prometheus_postgres_exporter_` -> "
|
|
"`prometheus_postgres_exporter_`, etc.). The playbook will report all "
|
|
"variables that you need to rename to get upgraded. All functionality "
|
|
"remains intact."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1256
|
|
msgid ""
|
|
"The `matrix-prometheus-services-proxy-connect` role has bee adjusted to "
|
|
"help integrate the new `prometheus_postgres_exporter` role with our own "
|
|
"services (`matrix-nginx-proxy`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1258 ../../../CHANGELOG.md:1300
|
|
msgid ""
|
|
"Other roles which aren't strictly related to Matrix are likely to follow "
|
|
"this fate of moving to their own repositories. Extracting them out allows"
|
|
" other Ansible playbooks to make use of these roles easily."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1261
|
|
msgid "2023-01-26"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1263
|
|
msgid "Coturn can now use host-networking"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1265
|
|
msgid ""
|
|
"Large Coturn deployments (with a huge range of ports specified via "
|
|
"`matrix_coturn_turn_udp_min_port` and `matrix_coturn_turn_udp_max_port`) "
|
|
"experience a huge slowdown with how Docker publishes all these ports "
|
|
"(setting up firewall forwarding rules), which leads to a very slow Coturn"
|
|
" service startup and shutdown."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1267
|
|
msgid ""
|
|
"Such deployments don't need to run Coturn within a private container "
|
|
"network anymore. Coturn can now run with host-networking by using "
|
|
"configuration like this:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1273
|
|
msgid ""
|
|
"With such a configuration, **Docker no longer needs to configure "
|
|
"thousands of firewall forwarding rules** each time Coturn starts and "
|
|
"stops. This, however, means that **you will need to ensure these ports "
|
|
"are open** in your firewall yourself."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1275
|
|
msgid ""
|
|
"Thanks to us [tightening Coturn security](#backward-compatibility-"
|
|
"tightening-coturn-security-can-lead-to-connectivity-issues), running "
|
|
"Coturn with host-networking should be safe and not expose neither other "
|
|
"services running on the host, nor other services running on the local "
|
|
"network."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1277
|
|
msgid ""
|
|
"(Backward Compatibility) Tightening Coturn security can lead to "
|
|
"connectivity issues"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1279
|
|
msgid ""
|
|
"**TLDR**: users who run and access their Matrix server on a private "
|
|
"network (likely a small minority of users) may experience connectivity "
|
|
"issues with our new default Coturn blocklists. They may need to override "
|
|
"`matrix_coturn_denied_peer_ips` and remove some IP ranges from it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1281
|
|
msgid ""
|
|
"Inspired by [this security "
|
|
"article](https://www.rtcsec.com/article/cve-2020-26262-bypass-of-coturns-"
|
|
"access-control-protection/), we've decided to make use of Coturn's "
|
|
"`denied-peer-ip` functionality to prevent relaying network traffic to "
|
|
"certain private IP subnets. This ensures that your Coturn server won't "
|
|
"accidentally try to forward traffic to certain services running on your "
|
|
"local networks. We run Coturn in a container and in a private container "
|
|
"network by default, which should prevent such access anyway, but having "
|
|
"additional block layers in place is better."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1283
|
|
msgid ""
|
|
"If you access your Matrix server from a local network and need Coturn to "
|
|
"relay to private IP addresses, you may observe that relaying is now "
|
|
"blocked due to our new default `denied-peer-ip` lists (specified in "
|
|
"`matrix_coturn_denied_peer_ips`). If you experience such connectivity "
|
|
"problems, consider overriding this setting in your `vars.yml` file and "
|
|
"removing certain networks from it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1285
|
|
msgid ""
|
|
"We've also added `no-multicast-peers` to the default Coturn "
|
|
"configuration, but we don't expect this to cause trouble for most people."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1288
|
|
msgid "2023-01-21"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1290
|
|
msgid "The matrix-prometheus-node-exporter role lives independently now"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1292
|
|
msgid ""
|
|
"**TLDR**: the `matrix-prometheus-node-exporter` role is now included from"
|
|
" another repository. Some variables have been renamed. All functionality "
|
|
"remains intact."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1294
|
|
msgid ""
|
|
"The `matrix-prometheus-node-exporter` role (which configures [Prometheus "
|
|
"node exporter](https://github.com/prometheus/node_exporter)) has been "
|
|
"extracted from the playbook and now lives in its own repository at "
|
|
"https://github.com/mother-of-all-self-hosting/ansible-role-prometheus-"
|
|
"node-exporter"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1296
|
|
msgid ""
|
|
"It's still part of the playbook, but is now installed via `ansible-"
|
|
"galaxy` (by running `just roles` / `make roles`). Some variables have "
|
|
"been renamed (`matrix_prometheus_node_exporter_` -> "
|
|
"`prometheus_node_exporter_`, etc.). The playbook will report all "
|
|
"variables that you need to rename to get upgraded. All functionality "
|
|
"remains intact."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1298
|
|
msgid ""
|
|
"A new `matrix-prometheus-services-proxy-connect` role was added to the "
|
|
"playbook to help integrate the new `prometheus_node_exporter` role with "
|
|
"our own services (`matrix-nginx-proxy`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1303
|
|
msgid "2023-01-13"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1305
|
|
msgid "Support for running commands via just"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1307
|
|
msgid ""
|
|
"We've previously used [make](https://www.gnu.org/software/make/) for "
|
|
"easily running some playbook commands (e.g. `make roles` which triggers "
|
|
"`ansible-galaxy`, see [Makefile](Makefile)). Our `Makefile` is still "
|
|
"around and you can still run these commands."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1309
|
|
msgid ""
|
|
"In addition, we've added support for running commands via "
|
|
"[just](https://github.com/casey/just) - a more modern command-runner "
|
|
"alternative to `make`. Instead of `make roles`, you can now run `just "
|
|
"roles` to accomplish the same."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1311
|
|
msgid ""
|
|
"Our [justfile](justfile) already defines some additional helpful "
|
|
"**shortcut** commands that weren't part of our `Makefile`. Here are some "
|
|
"examples:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1313
|
|
msgid ""
|
|
"`just install-all` to trigger the much longer `ansible-playbook -i "
|
|
"inventory/hosts setup.yml --tags=install-all,ensure-matrix-users-"
|
|
"created,start` command"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1314
|
|
msgid ""
|
|
"`just install-all --ask-vault-pass` - commands also support additional "
|
|
"arguments (`--ask-vault-pass` will be appended to the above installation "
|
|
"command)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1315
|
|
msgid ""
|
|
"`just run-tags install-mautrix-slack,start` - to run specific playbook "
|
|
"tags"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1316
|
|
msgid "`just start-all` - (re-)starts all services"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1317
|
|
msgid "`just stop-group postgres` - to stop only the Postgres service"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1318
|
|
msgid ""
|
|
"`just register-user alice secret-password yes` - registers an `alice` "
|
|
"user with the `secret-password` password and admin access (admin = `yes`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1320
|
|
msgid "Additional helpful commands and shortcuts may be defined in the future."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1322
|
|
msgid ""
|
|
"This is all completely optional. If you find it difficult to [install "
|
|
"`just`](https://github.com/casey/just#installation) or don't find any of "
|
|
"this convenient, feel free to run all commands manually."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1325
|
|
msgid "2023-01-11"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1327
|
|
msgid "mautrix-slack support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1329
|
|
msgid ""
|
|
"Thanks to [Cody Neiman](https://github.com/xangelix)'s efforts, the "
|
|
"playbook now supports bridging to [Slack](https://slack.com/) via the "
|
|
"[mautrix-slack](https://mau.dev/mautrix/slack) bridge. See our [Setting "
|
|
"up Mautrix Slack bridging](docs/configuring-playbook-bridge-mautrix-"
|
|
"slack.md) documentation page for getting started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1331
|
|
msgid ""
|
|
"**Note**: this is a new Slack bridge. The playbook still retains Slack "
|
|
"bridging via [matrix-appservice-slack](docs/configuring-playbook-bridge-"
|
|
"appservice-slack.md) and [mx-puppet-slack](docs/configuring-playbook-"
|
|
"bridge-mx-puppet-slack.md). You're free to use the bridge that serves you"
|
|
" better, or even all three of them (for different users and use-cases)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1334
|
|
msgid "2023-01-10"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1336
|
|
msgid "ChatGPT support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1338
|
|
msgid ""
|
|
"Thanks to [@bertybuttface](https://github.com/bertybuttface), the "
|
|
"playbook can now help you set up [matrix-chatgpt-"
|
|
"bot](https://github.com/matrixgpt/matrix-chatgpt-bot) - a bot through "
|
|
"which you can talk to the [ChatGPT](https://openai.com/blog/chatgpt/) "
|
|
"model."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1340
|
|
msgid ""
|
|
"See our [Setting up matrix-bot-chatgpt](docs/configuring-playbook-bot-"
|
|
"chatgpt.md) documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1343
|
|
msgid "2022-11-30"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1345
|
|
msgid ""
|
|
"matrix-postgres-backup has been replaced by the ansible-role-postgres-"
|
|
"backup external role"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1347
|
|
msgid ""
|
|
"Just like we've [replaced Postgres with an external role](#matrix-"
|
|
"postgres-has-been-replaced-by-the-comdevtureansiblerolepostgres-external-"
|
|
"role) on 2022-11-28, we're now replacing `matrix-postgres-backup` with an"
|
|
" external role - "
|
|
"[com.devture.ansible.role.postgres_backup](https://github.com/mother-of-"
|
|
"all-self-hosting/ansible-role-postgres_backup)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1349
|
|
msgid ""
|
|
"You'll need to rename your `matrix_postgres_backup`-prefixed variables "
|
|
"such that they use a `postgres_backup` prefix."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1352
|
|
msgid "2022-11-28"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1354
|
|
msgid ""
|
|
"matrix-postgres has been replaced by the ansible-role-postgres external "
|
|
"role"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1356
|
|
msgid ""
|
|
"**TLDR**: the tasks that install the integrated Postgres server now live "
|
|
"in an external role - [ansible-role-postgres](https://github.com/mother-"
|
|
"of-all-self-hosting/ansible-role-postgres). You'll need to run `make "
|
|
"roles` to install it, and to also rename your `matrix_postgres`-prefixed "
|
|
"variables to use a `devture_postgres` prefix (e.g. "
|
|
"`matrix_postgres_connection_password` -> `postgres_connection_password`)."
|
|
" All your data will still be there! Some scripts have moved "
|
|
"(`/usr/local/bin/matrix-postgres-cli` -> `/matrix/postgres/bin/cli`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1358
|
|
msgid ""
|
|
"The `matrix-postgres` role that has been part of the playbook for a long "
|
|
"time has been replaced with the [ansible-role-"
|
|
"postgres](https://github.com/mother-of-all-self-hosting/ansible-role-"
|
|
"postgres) role. This was done as part of our work to [use external roles "
|
|
"for some things](#the-playbook-now-uses-external-roles-for-some-things) "
|
|
"for better code re-use and maintainability."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1360
|
|
msgid ""
|
|
"The new role is an upgraded version of the old `matrix-postgres` role "
|
|
"with these notable differences:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1362
|
|
msgid ""
|
|
"it uses different names for its variables (`matrix_postgres` -> "
|
|
"`devture_postgres`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1363
|
|
msgid ""
|
|
"when [Vacuuming PostgreSQL](docs/maintenance-postgres.md#vacuuming-"
|
|
"postgresql), it will vacuum all your databases, not just the Synapse one"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1365
|
|
msgid ""
|
|
"You'll need to run `make roles` to install the new role. You would also "
|
|
"need to rename your `matrix_postgres`-prefixed variables to use a "
|
|
"`devture_postgres` prefix."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1367
|
|
msgid ""
|
|
"Note: the systemd service still remains the same - `matrix-"
|
|
"postgres.service`. Your data will still be in `/matrix/postgres`, etc. "
|
|
"Postgres-related scripts will be moved to `/matrix/postgres/bin` "
|
|
"(`/usr/local/bin/matrix-postgres-cli` -> `/matrix/postgres/bin/cli`, "
|
|
"etc). Also see [The playbook no longer installs scripts in /usr/local/bin"
|
|
"](#the-playbook-no-longer-installs-scripts-in-usrlocalbin)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1369
|
|
msgid "The playbook no longer installs scripts to /usr/local/bin"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1371
|
|
msgid "The locations of various scripts installed by the playbook have changed."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1373
|
|
msgid ""
|
|
"The playbook no longer contaminates your `/usr/local/bin` directory. All "
|
|
"scripts installed by the playbook now live in `bin/` directories under "
|
|
"`/matrix`. Some examples are below:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1375
|
|
msgid "`/usr/local/bin/matrix-remove-all` -> `/matrix/bin/remove-all`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1376
|
|
msgid "`/usr/local/bin/matrix-postgres-cli` -> `/matrix/postgres/bin/cli`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1377
|
|
msgid ""
|
|
"`/usr/local/bin/matrix-ssl-lets-encrypt-certificates-renew` -> "
|
|
"`/matrix/ssl/bin/lets-encrypt-certificates-renew`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1378
|
|
msgid ""
|
|
"`/usr/local/bin/matrix-synapse-register-user` -> `/matrix/synapse/bin"
|
|
"/register-user`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1381
|
|
msgid "2022-11-25"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1383
|
|
msgid "2x-5x performance improvements in playbook runtime"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1385
|
|
msgid ""
|
|
"**TLDR**: the playbook is 2x faster for running `--tags=setup-all` (and "
|
|
"various other tags). It also has new `--tags=install-*` tags (like "
|
|
"`--tags=install-all`), which skip uninstallation tasks and bring an "
|
|
"additional 2.5x speedup. In total, the playbook can maintain your server "
|
|
"5 times faster."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1387
|
|
msgid ""
|
|
"Our [etke.cc managed Matrix hosting service](https://etke.cc) runs "
|
|
"maintenance against hundreds of servers, so the playbook being fast means"
|
|
" a lot. The [etke.cc Ansible playbook](https://github.com/etkecc/ansible)"
|
|
" (which is an extension of this one) is growing to support more and more "
|
|
"services (besides just Matrix), so the Matrix playbook being leaner "
|
|
"prevents runtimes from becoming too slow and improves the customer "
|
|
"experience."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1389
|
|
msgid ""
|
|
"Even when running `ansible-playbook` manually (as most of us here do), "
|
|
"it's beneficial not to waste time and CPU resources."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1391
|
|
msgid ""
|
|
"Recently, a few large optimizations have been done to this playbook and "
|
|
"its external roles (see [The playbook now uses external roles for some "
|
|
"things](#the-playbook-now-uses-external-roles-for-some-things) and don't "
|
|
"forget to run `make roles`):"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1393
|
|
msgid ""
|
|
"Replacing Ansible `import_tasks` calls with `include_tasks`, which "
|
|
"decreased runtime in half. Using `import_tasks` is slower and causes "
|
|
"Ansible to go through and skip way too many tasks (tasks which could have"
|
|
" been skipped altogether by not having Ansible include them in the first "
|
|
"place). On an experimental VM, **deployment time was decreased from ~530 "
|
|
"seconds to ~250 seconds**."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1395
|
|
msgid ""
|
|
"Introducing new `install-*` tags (`install-all` and `install-COMPONENT`, "
|
|
"e.g. `install-synapse`, `install-bot-mjolnir`), which only run Ansible "
|
|
"tasks pertaining to installation, while skipping uninstallation tasks. In"
|
|
" most cases, people are maintaining the same setup or they're *adding* "
|
|
"new components. Removing components is rare. Running thousands of "
|
|
"uninstallation tasks each time is wasteful. On an experimental VM, "
|
|
"**deployment time was decreased from ~250 seconds (`--tags=setup-all`) to"
|
|
" ~100 seconds (`--tags=install-all`)**."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1397
|
|
msgid ""
|
|
"You can still use `--tags=setup-all`. In fact, that's the best way to "
|
|
"ensure your server is reconciled with the `vars.yml` configuration."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1399
|
|
msgid ""
|
|
"If you know you haven't uninstalled any services since the last time you "
|
|
"ran the playbook, you could run `--tags=install-all` instead and benefit "
|
|
"from quicker runtimes. It should be noted that a service may become "
|
|
"\"eligible for uninstallation\" even if your `vars.yml` file remains the "
|
|
"same. In rare cases, we toggle services from being auto-installed to "
|
|
"being optional, like we did on the 17th of March 2022 when we made [ma1sd"
|
|
" not get installed by default](https://github.com/spantaleev/matrix-"
|
|
"docker-ansible-deploy/blob/master/CHANGELOG.md#compatibility-break-ma1sd-"
|
|
"identity-server-no-longer-installed-by-default). In such rare cases, "
|
|
"you'd also need to run `--tags=setup-all`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1402
|
|
msgid "2022-11-22"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1404
|
|
msgid "Automatic `matrix_architecture` determination"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1406
|
|
msgid ""
|
|
"From now on, the playbook automatically determines your server's "
|
|
"architecture and sets the `matrix_architecture` variable accordingly. You"
|
|
" no longer need to set this variable manually in your `vars.yml` file."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1408
|
|
msgid "Docker and the Docker SDK for Python are now installed via external roles"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1412
|
|
msgid ""
|
|
"Docker will now be installed on the server via the "
|
|
"[geerlingguy.docker](https://github.com/geerlingguy/ansible-role-docker) "
|
|
"Ansible role. If you'd like to manage the Docker installation yourself, "
|
|
"you can disable the playbook's installation of Docker by setting "
|
|
"`matrix_playbook_docker_installation_enabled: false`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1414
|
|
msgid ""
|
|
"The Docker SDK for Python (named `docker-python`, `python-docker`, etc. "
|
|
"on the different platforms) is now also installed by another role "
|
|
"([com.devture.ansible.role.docker_sdk_for_python](https://github.com/devture/com.devture.ansible.role.docker_sdk_for_python))."
|
|
" To disable this role and install the necessary tools yourself, use "
|
|
"`devture_docker_sdk_for_python_installation_enabled: false`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1416
|
|
msgid ""
|
|
"If you're hitting issues with Docker installation or Docker SDK for "
|
|
"Python installation, consider reporting bugs or contributing to these "
|
|
"other projects."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1418
|
|
msgid ""
|
|
"These additional roles are downloaded into the playbook directory (to "
|
|
"`roles/galaxy`) via an `ansible-galaxy ..` command. `make roles` is an "
|
|
"easy shortcut for invoking the `ansible-galaxy` command to download these"
|
|
" roles."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1421
|
|
msgid "2022-11-20"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1423
|
|
msgid ""
|
|
"(Backward Compatibility Break) Changing how reverse-proxying to Synapse "
|
|
"works - now via a `matrix-synapse-reverse-proxy-companion` service"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1425
|
|
msgid ""
|
|
"**TLDR**: There's now a `matrix-synapse-reverse-proxy-companion` nginx "
|
|
"service, which helps with reverse-proxying to Synapse and its various "
|
|
"worker processes (if workers are enabled), so that `matrix-nginx-proxy` "
|
|
"can be relieved of this role. `matrix-nginx-proxy` still remains as the "
|
|
"public SSL-terminating reverse-proxy in the playbook. `matrix-synapse-"
|
|
"reverse-proxy-companion` is just one more reverse-proxy thrown into the "
|
|
"mix for convenience. People with a more custom reverse-proxying "
|
|
"configuration may be affected - see [Webserver configuration](#webserver-"
|
|
"configuration) below."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1427
|
|
msgid "Background"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1429
|
|
msgid ""
|
|
"Previously, `matrix-nginx-proxy` forwarded requests to Synapse directly. "
|
|
"When Synapse is running in worker mode, the reverse-proxying "
|
|
"configuration is more complicated (different requests need to go to "
|
|
"different Synapse worker processes). `matrix-nginx-proxy` had "
|
|
"configuration for sending each URL endpoint to the correct Synapse worker"
|
|
" responsible for handling it. However, sometimes people like to disable "
|
|
"`matrix-nginx-proxy` (for whatever reason) as detailed in [Using your own"
|
|
" webserver, instead of this playbook's nginx proxy](docs/configuring-"
|
|
"playbook-own-webserver.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1431
|
|
msgid ""
|
|
"Because `matrix-nginx-proxy` was so central to request forwarding, when "
|
|
"it was disabled and Synapse was running with workers enabled, there was "
|
|
"nothing which could forward requests to the correct place anymore.. which"
|
|
" caused [problems such as this one affecting "
|
|
"Dimension](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/issues/2090)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1433
|
|
msgid "Solution"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1435
|
|
msgid ""
|
|
"From now on, `matrix-nginx-proxy` is relieved of its function of reverse-"
|
|
"proxying to Synapse and its various worker processes. This role is now "
|
|
"handled by the new `matrix-synapse-reverse-proxy-companion` nginx service"
|
|
" and works even if `matrix-nginx-proxy` is disabled. The purpose of the "
|
|
"new `matrix-synapse-reverse-proxy-companion` service is to:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1437
|
|
msgid ""
|
|
"serve as a companion to Synapse and know how to reverse-proxy to Synapse "
|
|
"correctly (no matter if workers are enabled or not)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1439
|
|
msgid ""
|
|
"provide a unified container address for reaching Synapse (no matter if "
|
|
"workers are enabled or not)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1440
|
|
msgid ""
|
|
"`matrix-synapse-reverse-proxy-companion:8008` for Synapse Client-Server "
|
|
"API traffic"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1441
|
|
msgid ""
|
|
"`matrix-synapse-reverse-proxy-companion:8048` for Synapse Server-Server "
|
|
"(Federation) API traffic"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1443
|
|
msgid ""
|
|
"simplify `matrix-nginx-proxy` configuration - it now only needs to send "
|
|
"requests to `matrix-synapse-reverse-proxy-companion` or `matrix-"
|
|
"dendrite`, etc., without having to worry about workers"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1445
|
|
msgid ""
|
|
"allow reverse-proxying to Synapse, even if `matrix-nginx-proxy` is "
|
|
"disabled"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1447
|
|
msgid ""
|
|
"`matrix-nginx-proxy` still remains as the public SSL-terminating reverse-"
|
|
"proxy in the playbook. All traffic goes through it before reaching any of"
|
|
" the services. It's just that now the Synapse traffic is routed through "
|
|
"`matrix-synapse-reverse-proxy-companion` like this:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1449
|
|
msgid ""
|
|
"(`matrix-nginx-proxy` -> `matrix-synapse-reverse-proxy-companion` -> "
|
|
"(`matrix-synapse` or some Synapse worker))."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1451
|
|
msgid ""
|
|
"Various services (like Dimension, etc.) still talk to Synapse via "
|
|
"`matrix-nginx-proxy` (e.g. `http://matrix-nginx-proxy:12080`) "
|
|
"preferentially. They only talk to Synapse via the reverse-proxy companion"
|
|
" (e.g. `http://matrix-synapse-reverse-proxy-companion:8008`) if `matrix-"
|
|
"nginx-proxy` is disabled. Services should not be talking to Synapse (e.g."
|
|
" `https://matrix-synapse:8008` directly anymore), because when workers "
|
|
"are enabled, that's the Synapse `master` process and may not be serving "
|
|
"all URL endpoints needed by the service."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1453
|
|
msgid "Webserver configuration"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1455
|
|
msgid ""
|
|
"if you're using `matrix-nginx-proxy` (`matrix_nginx_proxy_enabled: true`,"
|
|
" which is the default for the playbook), you don't need to do anything"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1457
|
|
msgid ""
|
|
"if you're using your own `nginx` webserver running on the server, you "
|
|
"shouldn't be affected. The `/matrix/nginx/conf.d` configuration and "
|
|
"exposed ports that you're relying on will automatically be updated in a "
|
|
"way that should work"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1459
|
|
msgid ""
|
|
"if you're using another local webserver (e.g. Apache, etc.) and haven't "
|
|
"changed any ports (`matrix_*_host_bind_port` definitions), you shouldn't "
|
|
"be affected. You're likely sending Matrix traffic to `127.0.0.1:8008` and"
|
|
" `127.0.0.1:8048`. These ports (`8008` and `8048`) will still be exposed "
|
|
"on `127.0.0.1` by default - just not by the `matrix-synapse` container "
|
|
"from now on, but by the `matrix-synapse-reverse-proxy-companion` "
|
|
"container instead"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1461
|
|
msgid ""
|
|
"if you've been exposing `matrix-synapse` ports "
|
|
"(`matrix_synapse_container_client_api_host_bind_port`, etc.) manually, "
|
|
"you should consider exposing `matrix-synapse-reverse-proxy-companion` "
|
|
"ports instead"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1463
|
|
msgid ""
|
|
"if you're running Traefik and reverse-proxying directly to the `matrix-"
|
|
"synapse` container, you should start reverse-proxying to the `matrix-"
|
|
"synapse-reverse-proxy-companion` container instead. See [our updated "
|
|
"Traefik example configuration](docs/configuring-playbook-own-webserver.md"
|
|
"#sample-configuration-for-running-behind-traefik-20). Note: we now "
|
|
"recommend calling the federation entry point `federation` (instead of "
|
|
"`synapse`) and reverse-proxying the federation traffic via `matrix-nginx-"
|
|
"proxy`, instead of sending it directly to Synapse (or `matrix-synapse-"
|
|
"reverse-proxy-companion`). This makes the configuration simpler."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1466
|
|
msgid "2022-11-05"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1468
|
|
msgid "(Backward Compatibility Break) A new default standalone mode for Etherpad"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1470
|
|
msgid ""
|
|
"Until now, [Etherpad](https://etherpad.org/) (which [the playbook could "
|
|
"install for you](docs/configuring-playbook-etherpad.md)) required the "
|
|
"[Dimension integration manager](docs/configuring-playbook-dimension.md) "
|
|
"to also be installed, because Etherpad was hosted on the Dimension domain"
|
|
" (at `dimension.example.com/etherpad`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1472
|
|
msgid ""
|
|
"From now on, Etherpad can be installed in `standalone` mode on "
|
|
"`etherpad.example.com` and used even without Dimension. This is much more"
|
|
" versatile, so the playbook now defaults to this new mode "
|
|
"(`etherpad_mode: standalone`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1474
|
|
msgid "If you've already got both Etherpad and Dimension in use you could:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1476
|
|
msgid ""
|
|
"**either** keep hosting Etherpad under the Dimension domain by adding "
|
|
"`etherpad_mode: dimension` to your `vars.yml` file. All your existing "
|
|
"room widgets will continue working at the same URLs and no other changes "
|
|
"will be necessary."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1478
|
|
msgid ""
|
|
"**or**, you could change to hosting Etherpad separately on "
|
|
"`etherpad.example.com`. You will need to [configure a DNS record](docs"
|
|
"/configuring-dns.md) for this new domain. You will also need to "
|
|
"reconfigure Dimension to use the new pad URLs "
|
|
"(`https://etherpad.example.com/…`) going forward (refer to our "
|
|
"[configuring Etherpad documentation](docs/configuring-playbook-"
|
|
"etherpad.md)). All your existing room widgets (which still use "
|
|
"`https://dimension.example.com/etherpad/…`) will break as Etherpad is not"
|
|
" hosted there anymore. You will need to re-add them or to consider not "
|
|
"using `standalone` mode"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1481
|
|
msgid "2022-11-04"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1483
|
|
msgid "The playbook now uses external roles for some things"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1485
|
|
msgid ""
|
|
"**TLDR**: when updating the playbook and before running it, you'll need "
|
|
"to run `make roles` to make [ansible-"
|
|
"galaxy](https://docs.ansible.com/ansible/latest/cli/ansible-galaxy.html) "
|
|
"download dependency roles (see the [`requirements.yml` "
|
|
"file](requirements.yml)) to the `roles/galaxy` directory. Without this, "
|
|
"the playbook won't work."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1487
|
|
msgid ""
|
|
"We're in the process of trimming the playbook and making it reuse Ansible"
|
|
" roles."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1489
|
|
msgid "Starting now, the playbook is composed of 2 types of Ansible roles:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1491
|
|
msgid "those that live within the playbook itself (`roles/custom/*`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1493
|
|
msgid ""
|
|
"those downloaded from other sources (using [ansible-"
|
|
"galaxy](https://docs.ansible.com/ansible/latest/cli/ansible-galaxy.html) "
|
|
"to `roles/galaxy`, based on the [`requirements.yml` "
|
|
"file](requirements.yml)). These roles are maintained by us or by other "
|
|
"people from the Ansible community."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1495
|
|
msgid ""
|
|
"We're doing this for greater code-reuse (across Ansible playbooks, "
|
|
"including our own related playbooks [gitea-docker-ansible-"
|
|
"deploy](https://github.com/spantaleev/gitea-docker-ansible-deploy) and "
|
|
"[nextcloud-docker-ansible-deploy](https://github.com/spantaleev"
|
|
"/nextcloud-docker-ansible-deploy)) and decreased maintenance burden. "
|
|
"Until now, certain features were copy-pasted across playbooks or were "
|
|
"maintained separately in each one, with improvements often falling "
|
|
"behind. We've also tended to do too much by ourselves - installing Docker"
|
|
" on the server from our `matrix-base` role, etc. - something that we'd "
|
|
"rather not do anymore by switching to the "
|
|
"[geerlingguy.docker](https://galaxy.ansible.com/geerlingguy/docker) role."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1497
|
|
msgid ""
|
|
"Some variable names will change during the transition to having more and "
|
|
"more external (galaxy) roles. There's a new "
|
|
"`custom/matrix_playbook_migration` role added to the playbook which will "
|
|
"tell you about these changes each time you run the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1499
|
|
msgid ""
|
|
"**From now on**, every time you update the playbook (well, every time the"
|
|
" `requirements.yml` file changes), it's best to run `make roles` to "
|
|
"update the roles downloaded from other sources. `make roles` is a "
|
|
"shortcut (a `roles` target defined in [`Makefile`](Makefile) and executed"
|
|
" by the [`make`](https://www.gnu.org/software/make/) utility) which "
|
|
"ultimately runs [ansible-"
|
|
"galaxy](https://docs.ansible.com/ansible/latest/cli/ansible-galaxy.html) "
|
|
"to download Ansible roles. If you don't have `make`, you can also "
|
|
"manually run the commands seen in the `Makefile`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1502
|
|
msgid "2022-10-14"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1504
|
|
msgid "synapse-s3-storage-provider support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1506
|
|
msgid ""
|
|
"**`synapse-s3-storage-provider` support is very new and still relatively "
|
|
"untested. Using it may cause data loss.**"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1508
|
|
msgid ""
|
|
"You can now store your Synapse media repository files on Amazon S3 (or "
|
|
"another S3-compatible object store) using [synapse-s3-storage-"
|
|
"provider](https://github.com/matrix-org/synapse-s3-storage-provider) - a "
|
|
"media provider for Synapse (Python module), which should work faster and "
|
|
"more reliably than our previous [Goofys](docs/configuring-"
|
|
"playbook-s3-goofys.md) implementation (Goofys will continue to work)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1510
|
|
msgid ""
|
|
"This is not just for initial installations. Users with existing files "
|
|
"(stored in the local filesystem) can also migrate their files to "
|
|
"`synapse-s3-storage-provider`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1512
|
|
msgid ""
|
|
"To get started, see our [Storing Synapse media files on Amazon S3 with "
|
|
"synapse-s3-storage-provider](docs/configuring-playbook-synapse-s3"
|
|
"-storage-provider.md) documentation."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1514
|
|
msgid "Synapse container image customization support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1516
|
|
msgid ""
|
|
"We now support customizing the Synapse container image by adding "
|
|
"additional build steps to its "
|
|
"[`Dockerfile`](https://docs.docker.com/engine/reference/builder/)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1518
|
|
msgid ""
|
|
"Our [synapse-s3-storage-provider support](#synapse-s3-storage-provider-"
|
|
"support) is actually built on this. When `s3-storage-provider` is "
|
|
"enabled, we automatically add additional build steps to install its "
|
|
"Python module into the Synapse image."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1520
|
|
msgid ""
|
|
"Besides this kind of auto-added build steps (for components supported by "
|
|
"the playbook), we also let you inject your own custom build steps using "
|
|
"configuration like this:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1531
|
|
msgid ""
|
|
"People who have needed to customize Synapse previously had to fork the "
|
|
"git repository, make their changes to the `Dockerfile` there, point the "
|
|
"playbook to the new repository "
|
|
"(`matrix_synapse_container_image_self_build_repo`) and enable self-"
|
|
"building from scratch (`matrix_synapse_container_image_self_build: "
|
|
"true`). This is harder and slower."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1533
|
|
msgid ""
|
|
"With the new Synapse-customization feature in the playbook, we use the "
|
|
"original upstream (pre-built, if available) Synapse image and only build "
|
|
"on top of it, right on the Matrix server. This is much faster than "
|
|
"building all of Synapse from scratch."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1536
|
|
msgid "2022-10-02"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1538
|
|
msgid "matrix-ldap-registration-proxy support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1540
|
|
msgid ""
|
|
"Thanks to [@TheOneWithTheBraid](https://github.com/TheOneWithTheBraid), "
|
|
"we now support installing [matrix-ldap-registration-"
|
|
"proxy](https://gitlab.com/activism.international/matrix_ldap_registration_proxy)"
|
|
" - a proxy which handles Matrix registration requests and forwards them "
|
|
"to LDAP."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1542
|
|
msgid ""
|
|
"See our [Setting up matrix-ldap-registration-proxy](docs/configuring-"
|
|
"playbook-matrix-ldap-registration-proxy.md) documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1545
|
|
msgid "2022-09-15"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1547
|
|
msgid ""
|
|
"(Potential Backward Compatibility Break) Major improvements to Synapse "
|
|
"workers"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1549
|
|
msgid ""
|
|
"People who are interested in running a Synapse worker setup should know "
|
|
"that **our Synapse worker implementation is much more powerful now**:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1551
|
|
msgid "we've added support for [Stream writers](#stream-writers-support)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1552
|
|
msgid ""
|
|
"we've added support for [multiple federation sender workers](#multiple-"
|
|
"federation-sender-workers-support)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1553
|
|
msgid ""
|
|
"we've added support for [multiple pusher workers](#multiple-pusher-"
|
|
"workers-support)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1554
|
|
msgid ""
|
|
"we've added support for [running background tasks on a worker"
|
|
"](#background-tasks-can-run-on-a-worker)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1555
|
|
msgid ""
|
|
"we've restored support for [`appservice` workers](#appservice-worker-"
|
|
"support-is-back)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1556
|
|
msgid ""
|
|
"we've restored support for [`user_dir` workers](#user-directory-worker-"
|
|
"support-is-back)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1557
|
|
msgid ""
|
|
"we've made it possible to [reliably use more than 1 `media_repository` "
|
|
"worker](#using-more-than-1-media-repository-worker-is-now-more-reliable)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1558
|
|
msgid ""
|
|
"see the [Potential Backward Incompatibilities after these Synapse worker "
|
|
"changes](#potential-backward-incompatibilities-after-these-synapse-"
|
|
"worker-changes)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1560
|
|
msgid "Stream writers support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1562
|
|
msgid ""
|
|
"From now on, the playbook lets you easily set up various [stream writer "
|
|
"workers](https://matrix-org.github.io/synapse/latest/workers.html#stream-"
|
|
"writers) which can handle different streams (`events` stream; `typing` "
|
|
"URL endpoints, `to_device` URL endpoints, `account_data` URL endpoints, "
|
|
"`receipts` URL endpoints, `presence` URL endpoints). All of this work was"
|
|
" previously handled by the main Synapse process, but can now be offloaded"
|
|
" to stream writer worker processes."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1564
|
|
msgid ""
|
|
"If you're using `matrix_synapse_workers_preset: one-of-each`, you'll "
|
|
"automatically get 6 additional workers (one for each of the above stream "
|
|
"types). Our `little-federation-helper` preset (meant to be quite minimal "
|
|
"and focusing in improved federation performance) does not include stream "
|
|
"writer workers."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1566
|
|
msgid ""
|
|
"If you'd like to customize the number of workers we also make that "
|
|
"possible using these variables:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1579
|
|
msgid "Multiple federation sender workers support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1581
|
|
msgid ""
|
|
"Until now, we only supported a single `federation_sender` worker "
|
|
"(`matrix_synapse_workers_federation_sender_workers_count` could either be"
|
|
" `0` or `1`). From now on, you can have as many as you want to help with "
|
|
"your federation traffic."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1583
|
|
msgid "Multiple pusher workers support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1585
|
|
msgid ""
|
|
"Until now, we only supported a single `pusher` worker "
|
|
"(`matrix_synapse_workers_pusher_workers_count` could either be `0` or "
|
|
"`1`). From now on, you can have as many as you want to help with pushing "
|
|
"notifications out."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1587
|
|
msgid "Background tasks can run on a worker"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1589
|
|
msgid ""
|
|
"From now on, you can put [background task processing on a worker](https"
|
|
"://matrix-org.github.io/synapse/latest/workers.html#background-tasks)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1591
|
|
msgid ""
|
|
"With `matrix_synapse_workers_preset: one-of-each`, you'll get one "
|
|
"`background` worker automatically. You can also control the `background` "
|
|
"workers count with `matrix_synapse_workers_background_workers_count`. "
|
|
"Only `0` or `1` workers of this type are supported by Synapse."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1593
|
|
msgid "Appservice worker support is back"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1595
|
|
msgid ""
|
|
"We previously had an `appservice` worker type, which [Synapse deprecated "
|
|
"in v1.59.0](https://github.com/element-"
|
|
"hq/synapse/blob/v1.59.0/docs/upgrade.md#deprecation-of-the-"
|
|
"synapseappappservice-and-synapseappuser_dir-worker-application-types). So"
|
|
" did we, at the time."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1597
|
|
msgid ""
|
|
"The new way to implement such workers is by using a `generic_worker` and "
|
|
"dedicating it to the task of talking to Application Services. From now "
|
|
"on, we have support for this."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1599
|
|
msgid ""
|
|
"With `matrix_synapse_workers_preset: one-of-each`, you'll get one "
|
|
"`appservice` worker automatically. You can also control the `appservice` "
|
|
"workers count with `matrix_synapse_workers_appservice_workers_count`. "
|
|
"Only `0` or `1` workers of this type are supported by Synapse."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1601
|
|
msgid "User Directory worker support is back"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1603
|
|
msgid ""
|
|
"We previously had a `user_dir` worker type, which [Synapse deprecated in "
|
|
"v1.59.0](https://github.com/element-"
|
|
"hq/synapse/blob/v1.59.0/docs/upgrade.md#deprecation-of-the-"
|
|
"synapseappappservice-and-synapseappuser_dir-worker-application-types). So"
|
|
" did we, at the time."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1605
|
|
msgid ""
|
|
"The new way to implement such workers is by using a `generic_worker` and "
|
|
"dedicating it to the task of serving the user directory. From now on, we "
|
|
"have support for this."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1607
|
|
msgid ""
|
|
"With `matrix_synapse_workers_preset: one-of-each`, you'll get one "
|
|
"`user_dir` worker automatically. You can also control the `user_dir` "
|
|
"workers count with `matrix_synapse_workers_user_dir_workers_count`. Only"
|
|
" `0` or `1` workers of this type are supported by Synapse."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1609
|
|
msgid "Using more than 1 media repository worker is now more reliable"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1611
|
|
msgid ""
|
|
"With `matrix_synapse_workers_preset: one-of-each`, we only launch one "
|
|
"`media_repository` worker."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1613
|
|
msgid ""
|
|
"If you've been configuring "
|
|
"`matrix_synapse_workers_media_repository_workers_count` manually, you may"
|
|
" have increased that to more workers. When multiple media repository "
|
|
"workers are in use, background tasks related to the media repository must"
|
|
" always be configured to run on a single `media_repository` worker via "
|
|
"`media_instance_running_background_jobs`. Until now, we weren't doing "
|
|
"this correctly, but we now are."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1615
|
|
msgid "Potential Backward Incompatibilities after these Synapse worker changes"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1617
|
|
msgid "Below we'll discuss **potential backward incompatibilities**."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1619
|
|
msgid ""
|
|
"**Worker names** (container names, systemd services, worker configuration"
|
|
" files) **have changed**. Workers are now labeled sequentially (e.g. "
|
|
"`matrix-synapse-worker_generic_worker-18111` -> `matrix-synapse-worker-"
|
|
"generic-0`). The playbook will handle these changes automatically."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1621
|
|
msgid ""
|
|
"Due to increased worker types support above, people who use "
|
|
"`matrix_synapse_workers_preset: one-of-each` should be aware that with "
|
|
"these changes, **the playbook will deploy 9 additional workers** (6 "
|
|
"stream writers, 1 `appservice` worker, 1 `user_dir` worker, 1 background "
|
|
"task worker). This **may increase RAM/CPU usage**, etc. If you find your "
|
|
"server struggling, consider disabling some workers with the appropriate "
|
|
"`matrix_synapse_workers_*_workers_count` variables."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1623
|
|
msgid ""
|
|
"**Metric endpoints have also changed** "
|
|
"(`/metrics/synapse/worker/generic_worker-18111` -> "
|
|
"`/metrics/synapse/worker/generic-worker-0`). If you're [collecting "
|
|
"metrics to an external Prometheus server](docs/configuring-playbook-"
|
|
"prometheus-grafana.md#collecting-metrics-to-an-external-prometheus-"
|
|
"server), consider revisiting our [Collecting Synapse worker metrics to an"
|
|
" external Prometheus server](docs/configuring-playbook-prometheus-"
|
|
"grafana.md#collecting-synapse-worker-metrics-to-an-external-prometheus-"
|
|
"server) docs and updating your Prometheus configuration. **If you're "
|
|
"collecting metrics to the integrated Prometheus server** (not enabled by "
|
|
"default), **your Prometheus configuration will be updated "
|
|
"automatically**. Old data (from before this change) may stick around "
|
|
"though."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1625
|
|
msgid ""
|
|
"**the format of `matrix_synapse_workers_enabled_list` has changed**. You "
|
|
"were never advised to use this variable for directly creating workers (we"
|
|
" advise people to control workers using `matrix_synapse_workers_preset` "
|
|
"or by tweaking `matrix_synapse_workers_*_workers_count` variables only), "
|
|
"but some people may have started using the "
|
|
"`matrix_synapse_workers_enabled_list` variable to gain more control over "
|
|
"workers. If you're one of them, you'll need to adjust its value. See "
|
|
"`roles/custom/matrix-synapse/defaults/main.yml` for more information on "
|
|
"the new format. The playbook will also do basic validation and complain "
|
|
"if you got something wrong."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1628
|
|
msgid "2022-09-09"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1630
|
|
msgid "Cactus Comments support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1632
|
|
msgid ""
|
|
"Thanks to [Julian-Samuel Gebühr (@moan0s)](https://github.com/moan0s), "
|
|
"the playbook can now set up [Cactus Comments](https://cactus.chat) - "
|
|
"federated comment system for the web based on Matrix."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1634
|
|
msgid ""
|
|
"See our [Setting up Cactus Comments](docs/configuring-playbook-cactus-"
|
|
"comments.md) documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1637
|
|
msgid "2022-08-23"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1639
|
|
msgid "Postmoogle email bridge support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1641
|
|
msgid ""
|
|
"Thanks to [Aine](https://gitlab.com/etke.cc) of "
|
|
"[etke.cc](https://etke.cc/), the playbook can now set up the new "
|
|
"[Postmoogle](https://github.com/etkecc/postmoogle) email bridge. "
|
|
"Postmoogle is like the [email2matrix "
|
|
"bridge](https://github.com/devture/email2matrix) (also [already supported"
|
|
" by the playbook](docs/configuring-playbook-email2matrix.md)), but more "
|
|
"capable and with the intention to soon support *sending* emails, not just"
|
|
" receiving."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1643
|
|
msgid ""
|
|
"See our [Setting up Postmoogle email bridging](docs/configuring-playbook-"
|
|
"bridge-postmoogle.md) documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1646
|
|
msgid "2022-08-10"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1648
|
|
msgid "mautrix-whatsapp default configuration changes"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1650
|
|
msgid ""
|
|
"In [Pull Request #2012](https://github.com/spantaleev/matrix-docker-"
|
|
"ansible-deploy/pull/2012), we've made some changes to the default "
|
|
"configuration used by the `mautrix-whatsapp` bridge."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1652
|
|
msgid ""
|
|
"If you're using this bridge, you should look into this PR and see if the "
|
|
"new configuration suits you. If not, you can always change individual "
|
|
"preferences in your `vars.yml` file."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1654
|
|
msgid ""
|
|
"Most notably, spaces support has been enabled by default. The bridge will"
|
|
" now group rooms into a Matrix space. **If you've already bridged to "
|
|
"Whatsapp** prior to this update, you will need to send `!wa sync space` "
|
|
"to the bridge bot to make it create the space and put your existing rooms"
|
|
" into it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1657
|
|
msgid "2022-08-09"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1659
|
|
msgid "Conduit support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1661
|
|
msgid ""
|
|
"Thanks to [Charles Wright](https://github.com/cvwright), we now have "
|
|
"optional experimental [Conduit](https://conduit.rs) homeserver support "
|
|
"for new installations. This comes as a follow-up to the playbook getting "
|
|
"[Dendrite support](#dendrite-support) earlier this year."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1663
|
|
msgid ""
|
|
"Existing Synapse or Dendrite installations do **not** need to be updated."
|
|
" **Synapse is still the default homeserver implementation** installed by "
|
|
"the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1665
|
|
msgid ""
|
|
"To try out Conduit, we recommend that you **use a new server** and the "
|
|
"following `vars.yml` configuration:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1671
|
|
msgid ""
|
|
"**The homeserver implementation of an existing server cannot be changed**"
|
|
" (e.g. from Synapse or Dendrite to Conduit) without data loss."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1674
|
|
msgid "2022-07-29"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1676
|
|
msgid "mautrix-discord support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1678
|
|
msgid ""
|
|
"Thanks to [MdotAmaan](https://github.com/MdotAmaan)'s efforts, the "
|
|
"playbook now supports bridging to [Discord](https://discordapp.com/) via "
|
|
"the [mautrix-discord](https://mau.dev/mautrix/discord) bridge. See our "
|
|
"[Setting up Mautrix Discord bridging](docs/configuring-playbook-bridge-"
|
|
"mautrix-discord.md) documentation page for getting started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1680
|
|
msgid ""
|
|
"**Note**: this is a new Discord bridge. The playbook still retains "
|
|
"Discord bridging via [matrix-appservice-discord](docs/configuring-"
|
|
"playbook-bridge-appservice-discord.md) and [mx-puppet-discord](docs"
|
|
"/configuring-playbook-bridge-mx-puppet-discord.md). You're free to use "
|
|
"the bridge that serves you better, or even all three of them (for "
|
|
"different users and use-cases)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1683
|
|
msgid "2022-07-27"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1685
|
|
msgid "matrix-appservice-kakaotalk support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1687
|
|
msgid ""
|
|
"The playbook now supports bridging to "
|
|
"[Kakaotalk](https://www.kakaocorp.com/page/service/service/KakaoTalk?lang=ENG)"
|
|
" via [matrix-appservice-kakaotalk](https://src.miscworks.net/fair/matrix-"
|
|
"appservice-kakaotalk) - a bridge based on [node-"
|
|
"kakao](https://github.com/storycraft/node-kakao) (now unmaintained) and "
|
|
"some [mautrix-facebook](https://github.com/mautrix/facebook) code. Thanks"
|
|
" to [hnarjis](https://github.com/hnarjis) for helping us add support for "
|
|
"this!"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1689
|
|
msgid ""
|
|
"See our [Setting up Appservice Kakaotalk bridging](docs/configuring-"
|
|
"playbook-bridge-appservice-kakaotalk.md) documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1692
|
|
msgid "2022-07-20"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1694
|
|
msgid "maubot support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1696
|
|
msgid ""
|
|
"Thanks to [Stuart Mumford (@Cadair)](https://github.com/cadair) for "
|
|
"starting ([PR #373](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/pull/373) and [PR #622](https://github.com/spantaleev/matrix-"
|
|
"docker-ansible-deploy/pull/622)) and to [Julian-Samuel Gebühr "
|
|
"(@moan0s)](https://github.com/moan0s) for finishing up (in [PR "
|
|
"#1894](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/pull/1894)), the playbook can now help you set up "
|
|
"[maubot](https://github.com/maubot/maubot) - a plugin-based Matrix bot "
|
|
"system."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1698
|
|
msgid ""
|
|
"See our [Setting up maubot](docs/configuring-playbook-bot-maubot.md) "
|
|
"documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1701
|
|
msgid "2022-07-14"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1703
|
|
msgid "mx-puppet-skype removal"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1705
|
|
msgid ""
|
|
"The playbook no longer includes the [mx-puppet-"
|
|
"skype](https://github.com/Sorunome/mx-puppet-skype) bridge, because it "
|
|
"has been broken and unmaintained for a long time. Users that have "
|
|
"`matrix_mx_puppet_skype_enabled` in their configuration files will "
|
|
"encounter an error when running the playbook until they remove references"
|
|
" to this bridge from their configuration."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1707
|
|
msgid ""
|
|
"To completely clean up your server from `mx-puppet-skype`'s presence on "
|
|
"it:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1709
|
|
msgid ""
|
|
"ensure your Ansible configuration (`vars.yml` file) no longer contains "
|
|
"`matrix_mx_puppet_skype_*` references"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1710
|
|
msgid ""
|
|
"stop and disable the systemd service (run `systemctl disable --now "
|
|
"matrix-mx-puppet-skype` on the server)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1711
|
|
msgid ""
|
|
"delete the systemd service (run `rm /etc/systemd/system/matrix-mx-puppet-"
|
|
"skype.service` on the server)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1712
|
|
msgid ""
|
|
"delete `/matrix/mx-puppet-skype` (run `rm -rf /matrix/mx-puppet-skype` on"
|
|
" the server)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1713
|
|
msgid ""
|
|
"drop the `matrix_mx_puppet_skype` database (run `/usr/local/bin/matrix-"
|
|
"postgres-cli` on the server, and execute the `DROP DATABASE "
|
|
"matrix_mx_puppet_skype;` query there)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1715
|
|
msgid ""
|
|
"If you still need bridging to [Skype](https://www.skype.com/), consider "
|
|
"switching to [go-skype-bridge](https://github.com/kelaresg/go-skype-"
|
|
"bridge) instead. See [Setting up Go Skype Bridge bridging](docs"
|
|
"/configuring-playbook-bridge-go-skype-bridge.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1717
|
|
msgid ""
|
|
"If you think this is a mistake and `mx-puppet-skype` works for you (or "
|
|
"you get it to work somehow), let us know and we may reconsider this "
|
|
"removal."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1719
|
|
msgid "signald (0.19.0+) upgrade requires data migration"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1721
|
|
msgid ""
|
|
"In [Pull Request #1921](https://github.com/spantaleev/matrix-docker-"
|
|
"ansible-deploy/pull/1921) we upgraded [signald](https://signald.org/) "
|
|
"(used by the mautrix-signal bridge) from `v0.18.5` to `v0.20.0`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1723
|
|
msgid ""
|
|
"Back in the [`v0.19.0` released of "
|
|
"signald](https://gitlab.com/signald/signald/-/blob/main/releases/0.19.0.md)"
|
|
" (which we skipped and migrated straight to `v0.20.0`), a new `--migrate-"
|
|
"data` command had been added that migrates avatars, group images, "
|
|
"attachments, etc., into the database (those were previously stored in the"
|
|
" filesystem)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1725
|
|
msgid ""
|
|
"If you've been using the mautrix-signal bridge for a while, you may have "
|
|
"files stored in the local filesystem, which will need to be upgraded."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1727
|
|
msgid ""
|
|
"We attempt to do this data migration automatically every time Signald "
|
|
"starts (`matrix-mautrix-signal-daemon.service`) using a `ExecStartPre` "
|
|
"systemd unit definition."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1729
|
|
msgid ""
|
|
"Keep an eye on your Signal bridge and let us know (in our [support "
|
|
"room](README.md#support) or in [Pull Request "
|
|
"#1921](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/pull/1921)) if you experience any trouble!"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1732
|
|
msgid "2022-07-05"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1734
|
|
msgid "Ntfy push notifications support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1736
|
|
msgid ""
|
|
"Thanks to [Julian Foad](https://matrix.to/#/@julian:foad.me.uk), the "
|
|
"playbook can now install a [ntfy](https://ntfy.sh/) push notifications "
|
|
"server for you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1738
|
|
msgid ""
|
|
"See our [Setting up the ntfy push notifications server](docs/configuring-"
|
|
"playbook-ntfy.md) documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1741
|
|
msgid "2022-06-23"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1743
|
|
msgid "(Potential Backward Compatibility Break) Changes around metrics collection"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1745
|
|
msgid ""
|
|
"**TLDR**: we've made extensive **changes to metrics exposure/collection, "
|
|
"which concern people using an external Prometheus server**. If you don't "
|
|
"know what that is, you don't need to read below."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1747
|
|
msgid ""
|
|
"**Why do major changes to metrics**? Because various services were "
|
|
"exposing metrics in different, hacky, ways. Synapse was exposing metrics "
|
|
"at `/_synapse/metrics` and `/_synapse-worker-…/metrics` on the "
|
|
"`matrix.example.com`. The Hookshot role was **repurposing** the Granana "
|
|
"web UI domain (`stats.example.com`) for exposing its metrics on "
|
|
"`stats.example.com/hookshot/metrics`, while protecting these routes using"
|
|
" Basic Authentication **normally used for Synapse** "
|
|
"(`/_synapse/metrics`). Node-exporter and Postgres-exporter roles were "
|
|
"advising for more `stats.example.com` usage in manual ways. Each role was"
|
|
" doing things differently and mixing variables from other roles. Each "
|
|
"metrics endpoint was ending up in a different place, protected by who "
|
|
"knows what Basic Authentication credentials (if protected at all)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1749
|
|
msgid ""
|
|
"**The solution**: a completely revamped way to expose metrics to an "
|
|
"external Prometheus server. We are **introducing new "
|
|
"`https://matrix.example.com/metrics/*` endpoints**, where various "
|
|
"services *can* expose their metrics, for collection by external "
|
|
"Prometheus servers. To enable the `/metrics/*` endpoints, use "
|
|
"`matrix_nginx_proxy_proxy_matrix_metrics_enabled: true`. There's also a "
|
|
"way to protect access using [Basic "
|
|
"Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication)."
|
|
" See the `matrix-nginx-proxy` role or our [Collecting metrics to an "
|
|
"external Prometheus server](docs/configuring-playbook-prometheus-"
|
|
"grafana.md#collecting-metrics-to-an-external-prometheus-server) "
|
|
"documentation for additional variables around "
|
|
"`matrix_nginx_proxy_proxy_matrix_metrics_enabled`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1751
|
|
msgid ""
|
|
"**If you are using the [Hookshot bridge](docs/configuring-playbook-"
|
|
"bridge-hookshot.md)**, you may find that:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1752
|
|
msgid "**Metrics may not be enabled by default anymore**:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1753
|
|
msgid ""
|
|
"If Prometheus is enabled (`prometheus_enabled: true`), then Hookshot "
|
|
"metrics will be enabled automatically (`matrix_hookshot_metrics_enabled: "
|
|
"true`). These metrics will be collected from the local (in-container) "
|
|
"Prometheus over the container network."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1754
|
|
msgid ""
|
|
"**If Prometheus is not enabled** (you are either not using Prometheus or "
|
|
"are using an external one), **Hookshot metrics will not be enabled by "
|
|
"default anymore**. Feel free to enable them by setting "
|
|
"`matrix_hookshot_metrics_enabled: true`. Also, see below."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1755
|
|
msgid ""
|
|
"When metrics are meant to be **consumed by an external Prometheus "
|
|
"server**, `matrix_hookshot_metrics_proxying_enabled` needs to be set to "
|
|
"`true`, so that metrics would be exposed (proxied) \"publicly\" on "
|
|
"`https://matrix.example.com/metrics/hookshot`. To make use of this, "
|
|
"you'll also need to enable the new `https://matrix.example.com/metrics/*`"
|
|
" endpoints mentioned above, using "
|
|
"`matrix_nginx_proxy_proxy_matrix_metrics_enabled`. Learn more in our "
|
|
"[Collecting metrics to an external Prometheus server](docs/configuring-"
|
|
"playbook-prometheus-grafana.md#collecting-metrics-to-an-external-"
|
|
"prometheus-server) documentation."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1756
|
|
msgid ""
|
|
"**We've changed the URL we're exposing Hookshot metrics at** for external"
|
|
" Prometheus servers. Until now, you were advised to consume Hookshot "
|
|
"metrics from `https://stats.example.com/hookshot/metrics` (working in "
|
|
"conjunction with `matrix_nginx_proxy_proxy_synapse_metrics`). From now "
|
|
"on, **this no longer works**. As described above, you need to start "
|
|
"consuming metrics from `https://matrix.example.com/metrics/hookshot`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1758
|
|
msgid ""
|
|
"**If you're using node-exporter** "
|
|
"(`matrix_prometheus_node_exporter_enabled: true`) and would like to "
|
|
"collect its metrics from an external Prometheus server, see "
|
|
"`matrix_prometheus_node_exporter_metrics_proxying_enabled` described in "
|
|
"our [Collecting metrics to an external Prometheus server](docs"
|
|
"/configuring-playbook-prometheus-grafana.md#collecting-metrics-to-an-"
|
|
"external-prometheus-server) documentation. You will be able to collect "
|
|
"its metrics from `https://matrix.example.com/metrics/node-exporter`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1760
|
|
msgid ""
|
|
"**If you're using [postgres-exporter](docs/configuring-playbook-"
|
|
"prometheus-postgres.md)** (`prometheus_postgres_exporter_enabled: true`) "
|
|
"and would like to collect its metrics from an external Prometheus server,"
|
|
" see "
|
|
"`matrix_prometheus_services_proxy_connect_prometheus_postgres_exporter_metrics_proxying_enabled`"
|
|
" described in our [Collecting metrics to an external Prometheus "
|
|
"server](docs/configuring-playbook-prometheus-grafana.md#collecting-"
|
|
"metrics-to-an-external-prometheus-server) documentation. You will be able"
|
|
" to collect its metrics from `https://matrix.example.com/metrics"
|
|
"/postgres-exporter`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1762
|
|
msgid ""
|
|
"**If you're using Synapse** and would like to collect its metrics from an"
|
|
" external Prometheus server, you may find that:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1764
|
|
msgid ""
|
|
"Exposing metrics is now done using "
|
|
"`matrix_synapse_metrics_proxying_enabled`, not "
|
|
"`matrix_nginx_proxy_proxy_synapse_metrics: true`. You may still need to "
|
|
"enable metrics using `matrix_synapse_metrics_enabled: true` before "
|
|
"exposing them."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1765
|
|
msgid ""
|
|
"Protecting metrics endpoints using [Basic "
|
|
"Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication)"
|
|
" is now done in another way. See our [Collecting metrics to an external "
|
|
"Prometheus server](docs/configuring-playbook-prometheus-grafana.md"
|
|
"#collecting-metrics-to-an-external-prometheus-server) documentation"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1766
|
|
msgid ""
|
|
"If Synapse metrics are exposed, they will be made available at "
|
|
"`https://matrix.example.com/metrics/synapse/main-process` or "
|
|
"`https://matrix.example.com/metrics/synapse/worker/TYPE-ID` (when workers"
|
|
" are enabled), not at `https://matrix.example.com/_synapse/metrics` and "
|
|
"`https://matrix.example.com/_synapse-worker-…/metrics`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1767
|
|
msgid ""
|
|
"The playbook still generates an `external_prometheus.yml.example` sample "
|
|
"file for scraping Synapse from Prometheus as described in [Collecting "
|
|
"Synapse worker metrics to an external Prometheus server](docs"
|
|
"/configuring-playbook-prometheus-grafana.md#collecting-synapse-worker-"
|
|
"metrics-to-an-external-prometheus-server), but it's now saved under "
|
|
"`/matrix/synapse` (not `/matrix`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1769
|
|
msgid ""
|
|
"**If you where already using a external Prometheus server** before this "
|
|
"change, and you gave a hashed version of the password as a variable, the "
|
|
"playbook will now take care of hashing the password for you. Thus, you "
|
|
"need to provide the non-hashed version now."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1771
|
|
msgid "2022-06-13"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1773
|
|
msgid "go-skype-bridge bridging support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1775
|
|
msgid ""
|
|
"Thanks to [CyberShadow](https://github.com/CyberShadow), the playbook can"
|
|
" now install the [go-skype-bridge](https://github.com/kelaresg/go-skype-"
|
|
"bridge) bridge for bridging Matrix to [Skype](https://www.skype.com/)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1777
|
|
msgid ""
|
|
"See our [Setting up Go Skype Bridge bridging](docs/configuring-playbook-"
|
|
"bridge-go-skype-bridge.md) documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1779
|
|
msgid ""
|
|
"The playbook has supported [mx-puppet-skype](https://github.com/Sorunome"
|
|
"/mx-puppet-skype) bridging (see [Setting up MX Puppet Skype "
|
|
"bridging](docs/configuring-playbook-bridge-mx-puppet-skype.md)) since "
|
|
"[2020-04-09](#2020-04-09), but `mx-puppet-skype` is reportedly broken."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1782
|
|
msgid "2022-06-09"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1784
|
|
msgid "Running Ansible in a container can now happen on the Matrix server itself"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1786
|
|
msgid ""
|
|
"If you're tired of being on an old and problematic Ansible version, you "
|
|
"can now run [run Ansible in a container on the Matrix server "
|
|
"itself](docs/ansible.md#running-ansible-in-a-container-on-the-matrix-"
|
|
"server-itself)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1789
|
|
msgid "2022-05-31"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1791
|
|
msgid "Synapse v1.60 upgrade may cause trouble and require manual intervention"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1793
|
|
msgid ""
|
|
"Synapse v1.60 will try to add a new unique index to `state_group_edges` "
|
|
"upon startup and could fail if your database is corrupted."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1795
|
|
msgid ""
|
|
"We haven't observed this problem yet, but [the Synapse v1.60.0 upgrade "
|
|
"notes](https://github.com/element-"
|
|
"hq/synapse/blob/v1.60.0/docs/upgrade.md#adding-a-new-unique-index-to-"
|
|
"state_group_edges-could-fail-if-your-database-is-corrupted) mention it, "
|
|
"so we're giving you a heads up here in case you're unlucky."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1797
|
|
msgid ""
|
|
"**If Synapse fails to start** after your next playbook run, you'll need "
|
|
"to:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1799
|
|
msgid "SSH into the Matrix server"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1800
|
|
msgid "launch `/usr/local/bin/matrix-postgres-cli`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1801
|
|
msgid "switch to the `synapse` database: `\\c synapse`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1802
|
|
msgid "run the following SQL query:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1821
|
|
msgid ""
|
|
"You could then restart services: `ansible-playbook -i inventory/hosts "
|
|
"setup.yml --tags=start`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1824
|
|
msgid "2022-04-25"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1826
|
|
msgid "Buscarron bot support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1828
|
|
msgid ""
|
|
"Thanks to [Aine](https://gitlab.com/etke.cc) of "
|
|
"[etke.cc](https://etke.cc/), the playbook can now set up [the Buscarron "
|
|
"bot](https://github.com/etkecc/buscarron). It's a bot you can use to send"
|
|
" any form (HTTP POST, HTML) to a (encrypted) Matrix room"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1830
|
|
msgid ""
|
|
"See our [Setting up Buscarron](docs/configuring-playbook-bot-"
|
|
"buscarron.md) documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1833
|
|
msgid "2022-04-21"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1835
|
|
msgid "matrix-registration-bot support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1837
|
|
msgid ""
|
|
"Thanks to [Julian-Samuel Gebühr (@moan0s)](https://github.com/moan0s), "
|
|
"the playbook can now help you set up [matrix-registration-"
|
|
"bot](https://github.com/moan0s/matrix-registration-bot) - a bot that is "
|
|
"used to create and manage registration tokens for a Matrix server."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1839
|
|
msgid ""
|
|
"See our [Setting up matrix-registration-bot](docs/configuring-playbook-"
|
|
"bot-matrix-registration-bot.md) documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1842
|
|
msgid "2022-04-19"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1844
|
|
msgid "BorgBackup support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1846
|
|
msgid ""
|
|
"Thanks to [Aine](https://gitlab.com/etke.cc) of "
|
|
"[etke.cc](https://etke.cc/), the playbook can now set up "
|
|
"[Borg](https://www.borgbackup.org/) backups with "
|
|
"[borgmatic](https://torsion.org/borgmatic/) of your Matrix server."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1848
|
|
msgid ""
|
|
"See our [Setting up BorgBackup](docs/configuring-playbook-backup-borg.md)"
|
|
" documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1850
|
|
msgid ""
|
|
"(Compatibility Break) Upgrading to Synapse v1.57 on setups using workers "
|
|
"may require manual action"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1852
|
|
msgid ""
|
|
"If you're running a worker setup for Synapse "
|
|
"(`matrix_synapse_workers_enabled: true`), the [Synapse v1.57 upgrade "
|
|
"notes](https://github.com/element-"
|
|
"hq/synapse/blob/v1.57.0rc1/docs/upgrade.md#changes-to-database-schema-"
|
|
"for-application-services) say that you may need to take special care when"
|
|
" upgrading:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1854
|
|
msgid ""
|
|
"Synapse v1.57.0 includes a change to the way transaction IDs are managed "
|
|
"for application services. If your deployment uses a dedicated worker for "
|
|
"application service traffic, **it must be stopped** when the database is "
|
|
"upgraded (which normally happens when the main process is upgraded), to "
|
|
"ensure the change is made safely without any risk of reusing transaction "
|
|
"IDs."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1856
|
|
msgid ""
|
|
"If you're not running an `appservice` worker "
|
|
"(`matrix_synapse_workers_preset: little-federation-helper` or "
|
|
"`matrix_synapse_workers_appservice_workers_count: 0`), you are probably "
|
|
"safe to upgrade as per normal, without taking any special care."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1858
|
|
msgid ""
|
|
"If you are running a setup with an `appservice` worker, or otherwise want"
|
|
" to be on the safe side, we recommend the following upgrade path:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1860
|
|
msgid "Pull the latest playbook changes"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1861
|
|
msgid ""
|
|
"Stop all services (`ansible-playbook -i inventory/hosts setup.yml "
|
|
"--tags=stop`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1862
|
|
msgid ""
|
|
"Re-run the playbook (`ansible-playbook -i inventory/hosts setup.yml "
|
|
"--tags=setup-all`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1863
|
|
msgid "Start Postgres (`systemctl start matrix-postgres` on the server)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1864
|
|
msgid ""
|
|
"Start the main Synapse process (`systemctl start matrix-synapse` on the "
|
|
"server)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1865
|
|
msgid ""
|
|
"Wait a while so that Synapse can start and complete the database "
|
|
"migrations. You can use `journalctl -fu matrix-synapse` on the server to "
|
|
"get a clue. Waiting a few minutes should also be enough."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1866
|
|
msgid ""
|
|
"It should now be safe to start all other services. `ansible-playbook -i "
|
|
"inventory/hosts setup.yml --tags=start` will do it for you"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1869
|
|
msgid "2022-04-14"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1871
|
|
msgid ""
|
|
"(Compatibility Break) Changes to `docker-src` permissions necessitating "
|
|
"manual action"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1873
|
|
msgid ""
|
|
"Users who build container images from source will need to manually "
|
|
"correct file permissions of some directories on the server."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1875
|
|
msgid ""
|
|
"When self-building, the playbook used to `git clone` repositories (into "
|
|
"`/matrix/SERVICE/docker-src`) using the `root` user, but now uses "
|
|
"`matrix` instead to work around [the following issue with git "
|
|
"2.35.2](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/issues/1749)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1877
|
|
msgid ""
|
|
"If you're on a non-`amd64` architecture (that is, you're overriding "
|
|
"`matrix_architecture` in your `vars.yml` file) or you have enabled self-"
|
|
"building for some service (e.g. `matrix_*_self_build: true`), you're "
|
|
"certainly building some container images from source and have `docker-"
|
|
"src` directories with mixed permissions lying around in various "
|
|
"`/matrix/SERVICE` directories."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1879
|
|
msgid ""
|
|
"The playbook *could* correct these permissions automatically, but that "
|
|
"requires additional Ansible tasks in some ~45 different places - "
|
|
"something that takes considerable effort. So we ask users observing "
|
|
"errors related to `docker-src` directories to correct the problem "
|
|
"manually by **running this command on the Matrix server** (which deletes "
|
|
"all `/matrix/*/docker-src` directories): `find /matrix -maxdepth 2 -name "
|
|
"'docker-src' | xargs rm -rf`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1882
|
|
msgid "2022-03-17"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1884
|
|
msgid "(Compatibility Break) ma1sd identity server no longer installed by default"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1886
|
|
msgid ""
|
|
"The playbook no longer installs the "
|
|
"[ma1sd](https://github.com/ma1uta/ma1sd) identity server by default. The "
|
|
"next time you run the playbook, ma1sd will be uninstalled from your "
|
|
"server, unless you explicitly enable the ma1sd service (see how below)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1888
|
|
msgid ""
|
|
"The main reason we used to install ma1sd by default in the past was to "
|
|
"prevent Element clients from talking to the `matrix.org` / `vector.im` "
|
|
"identity servers, by forcing it to talk to our own self-hosted (but "
|
|
"otherwise useless) identity server instead, thus preventing contact list "
|
|
"leaks."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1890
|
|
msgid ""
|
|
"Since Element clients no longer default to using a public identity server"
|
|
" if another one is not provided, we can stop installing ma1sd."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1892
|
|
msgid ""
|
|
"If you need to install the ma1sd identity server for some reason, you can"
|
|
" explicitly enable it by adding this to your `vars.yml` file:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1899
|
|
msgid "2022-02-12"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1901
|
|
msgid "matrix_encryption_disabler support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1903
|
|
msgid ""
|
|
"We now support installing the "
|
|
"[matrix_encryption_disabler](https://github.com/digitalentity/matrix_encryption_disabler)"
|
|
" Synapse module, which lets you prevent End-to-End-Encryption from being "
|
|
"enabled by users on your homeserver. The popular opinion is that this is "
|
|
"dangerous and shouldn't be done, but there are valid use cases for "
|
|
"disabling encryption discussed [here](https://github.com/matrix-"
|
|
"org/synapse/issues/4401)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1905
|
|
msgid ""
|
|
"To enable this module (and prevent encryption from being used on your "
|
|
"homserver), add `matrix_synapse_ext_encryption_disabler_enabled: true` to"
|
|
" your configuration. This module provides further customization. Check "
|
|
"its other configuration settings (and defaults) in `roles/custom/matrix-"
|
|
"synapse/defaults/main.yml`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1908
|
|
msgid "2022-02-01"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1910
|
|
msgid "matrix-hookshot bridging support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1912
|
|
msgid ""
|
|
"Thanks to [HarHarLinks](https://github.com/HarHarLinks), the playbook can"
|
|
" now install the [matrix-hookshot](https://github.com/matrix-org/matrix-"
|
|
"hookshot) bridge for bridging Matrix to multiple project management "
|
|
"services, such as GitHub, GitLab and JIRA. See our [Setting up matrix-"
|
|
"hookshot](docs/configuring-playbook-bridge-hookshot.md) documentation to "
|
|
"get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1915
|
|
msgid "2022-01-31"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1917
|
|
msgid "ARM support for matrix-corporal"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1919
|
|
msgid ""
|
|
"[matrix-corporal](https://github.com/devture/matrix-corporal) (as of "
|
|
"version `2.2.3`) is now published to Docker Hub (see [devture/matrix-"
|
|
"corporal](https://hub.docker.com/r/devture/matrix-corporal)) as a multi-"
|
|
"arch container image with support for all these platforms: `linux/amd64`,"
|
|
" `linux/arm64/v8` and `linux/arm/v7`. The playbook no longer resorts to "
|
|
"self-building matrix-corporal on these ARM architectures."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1922
|
|
msgid "2022-01-07"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1924
|
|
msgid "Dendrite support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1926
|
|
msgid ""
|
|
"**TLDR**: We now have optional experimental [Dendrite](https://github.com"
|
|
"/matrix-org/dendrite) homeserver support for new installations. "
|
|
"**Existing (Synapse) installations need to be updated**, because some "
|
|
"internals changed. See [Adapting the configuration for existing Synapse "
|
|
"installations](#adapting-the-configuration-for-existing-synapse-"
|
|
"installations)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1928
|
|
msgid ""
|
|
"[Jip J. Dekker](https://github.com/Dekker1) did the [initial "
|
|
"work](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/pull/818) of adding [Dendrite](https://github.com/matrix-"
|
|
"org/dendrite) support to the playbook back in January 2021. Lots of work "
|
|
"(and time) later, Dendrite support is finally ready for testing."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1930
|
|
msgid "We believe that 2022 will be the year of the non-Synapse Matrix server!"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1932
|
|
msgid ""
|
|
"The playbook was previously quite [Synapse](https://github.com/element-"
|
|
"hq/synapse)-centric, but can now accommodate multiple homeserver "
|
|
"implementations. Only one homeserver implementation can be active "
|
|
"(installed) at a given time."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1934
|
|
msgid ""
|
|
"**Synapse is still the default homeserver implementation** installed by "
|
|
"the playbook. A new variable (`matrix_homeserver_implementation`) "
|
|
"controls which server implementation is enabled (`synapse` or `dendrite` "
|
|
"at the given moment)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1936
|
|
msgid "Adapting the configuration for existing Synapse installations"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1938
|
|
msgid ""
|
|
"Because the playbook is not so Synapse-centric anymore, a small "
|
|
"configuration change is necessary for existing installations to bring "
|
|
"them up to date."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1940
|
|
msgid ""
|
|
"The `vars.yml` file for **existing installations will need to be "
|
|
"updated** by adding this **additional configuration**:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1952
|
|
msgid "Trying out Dendrite"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1954
|
|
msgid ""
|
|
"Finally, **to try out Dendrite**, we recommend that you **use a new "
|
|
"server** and the following addition to your `vars.yml` configuration:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1960
|
|
msgid ""
|
|
"**The homeserver implementation of an existing server cannot be changed**"
|
|
" (e.g. from Synapse to Dendrite) without data loss."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1962
|
|
msgid ""
|
|
"We're excited to gain support for other homeserver implementations, like "
|
|
"[Conduit](https://conduit.rs/), etc!"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1964
|
|
msgid "Honoroit bot support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1966
|
|
msgid ""
|
|
"Thanks to [Aine](https://gitlab.com/etke.cc) of "
|
|
"[etke.cc](https://etke.cc/), the playbook can now help you set up "
|
|
"[Honoroit](https://github.com/etkecc/honoroit) - a helpdesk bot."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1968
|
|
msgid ""
|
|
"See our [Setting up Honoroit](docs/configuring-playbook-bot-honoroit.md) "
|
|
"documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1971
|
|
msgid "2022-01-06"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1973
|
|
msgid "Cinny support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1975
|
|
msgid ""
|
|
"Thanks to [Aine](https://gitlab.com/etke.cc) of "
|
|
"[etke.cc](https://etke.cc/), the playbook now supports "
|
|
"[Cinny](https://cinny.in/) - a new simple, elegant and secure Matrix "
|
|
"client."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1977
|
|
msgid ""
|
|
"By default, we still install Element Web. Still, people who'd like to try"
|
|
" Cinny out can now install it via the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1979
|
|
msgid ""
|
|
"Additional details are available in [Setting up Cinny](docs/configuring-"
|
|
"playbook-client-cinny.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1982
|
|
msgid "2021-12-22"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1984
|
|
msgid "Twitter bridging support via mautrix-twitter"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1986
|
|
msgid ""
|
|
"Thanks to [Matthew Cengia](https://github.com/mattcen) and [Shreyas "
|
|
"Ajjarapu](https://github.com/shreyasajj), besides [mx-puppet-"
|
|
"twitter](docs/configuring-playbook-bridge-mx-puppet-twitter.md), bridging"
|
|
" to [Twitter](https://twitter.com/) can now also happen with [mautrix-"
|
|
"twitter](docs/configuring-playbook-bridge-mautrix-twitter.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1989
|
|
msgid "2021-12-14"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1991
|
|
msgid ""
|
|
"(Security) Users of the Signal bridge may wish to upgrade it to work "
|
|
"around log4j vulnerability"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1993
|
|
msgid ""
|
|
"Recently, a security vulnerability affecting the Java logging package "
|
|
"`log4j` [has been discovered](https://www.huntress.com/blog/rapid-"
|
|
"response-critical-rce-vulnerability-is-affecting-java). Software that "
|
|
"uses this Java package is potentially vulnerable."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1995
|
|
msgid ""
|
|
"One such piece of software that is part of the playbook is the [mautrix-"
|
|
"signal bridge](./docs/configuring-playbook-bridge-mautrix-signal.md), "
|
|
"which [has been patched already](https://github.com/spantaleev/matrix-"
|
|
"docker-ansible-deploy/pull/1452). If you're running this bridge, you may "
|
|
"wish to [upgrade](./docs/maintenance-upgrading-services.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:1998
|
|
msgid "2021-11-11"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2000
|
|
msgid "Dropped support for Postgres v9.6"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2002
|
|
msgid ""
|
|
"Postgres v9.6 reached its end of life today, so the playbook will refuse "
|
|
"to run for you if you're still on that version."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2004
|
|
msgid ""
|
|
"Synapse still supports v9.6 (for now), but we're retiring support for it "
|
|
"early, to avoid having to maintain support for so many Postgres versions."
|
|
" Users that are still on Postgres v9.6 can easily [upgrade Postgres](docs"
|
|
"/maintenance-postgres.md#upgrading-postgresql) via the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2007
|
|
msgid "2021-10-23"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2009
|
|
msgid "Hangouts bridge no longer updated, superseded by a Googlechat bridge"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2011
|
|
msgid ""
|
|
"The mautrix-hangouts bridge is no longer receiving updates upstream and "
|
|
"is likely to stop working in the future. We still retain support for this"
|
|
" bridge in the playbook, but you're encouraged to switch away from it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2013
|
|
msgid ""
|
|
"There's a new [mautrix-googlechat](https://github.com/mautrix/googlechat)"
|
|
" bridge that you can [install using the playbook](docs/configuring-"
|
|
"playbook-bridge-mautrix-googlechat.md). Your **Hangouts bridge data will "
|
|
"not be migrated**, however. You need to start fresh with the new bridge."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2016
|
|
msgid "2021-08-23"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2018
|
|
msgid "LinkedIn bridging support via beeper-linkedin"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2020
|
|
msgid ""
|
|
"Thanks to [Alexandar Mechev](https://github.com/apmechev), the playbook "
|
|
"can now install the [beeper-linkedin](https://gitlab.com/beeper/linkedin)"
|
|
" bridge for bridging to [LinkedIn](https://www.linkedin.com/) Messaging."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2022
|
|
msgid ""
|
|
"This brings the total number of bridges supported by the playbook up to "
|
|
"20. See all supported bridges [here](docs/configuring-playbook.md"
|
|
"#bridging-other-networks)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2024
|
|
msgid ""
|
|
"To get started with bridging to LinkedIn, see [Setting up Beeper LinkedIn"
|
|
" bridging](docs/configuring-playbook-bridge-beeper-linkedin.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2027
|
|
msgid "2021-08-20"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2029
|
|
msgid "Sygnal upgraded - ARM support and no longer requires a database"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2031
|
|
msgid ""
|
|
"The [Sygnal](docs/configuring-playbook-sygnal.md) push gateway has been "
|
|
"upgraded from `v0.9.0` to `v0.10.1`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2033
|
|
msgid ""
|
|
"This is an optional component for the playbook, so most of our users "
|
|
"wouldn't care about this announcement."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2035
|
|
msgid ""
|
|
"Since this feels like a relatively big (and untested, as of yet) Sygnal "
|
|
"change, we're putting up this changelog entry."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2037
|
|
msgid ""
|
|
"The new version is also available for the ARM architecture. It also no "
|
|
"longer requires a database anymore. If you need to downgrade to the "
|
|
"previous version, changing `matrix_sygnal_version` or "
|
|
"`matrix_sygnal_docker_image` will not be enough, as we've removed the "
|
|
"`database` configuration completely. You'd need to switch to an earlier "
|
|
"playbook commit."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2040
|
|
msgid "2021-05-21"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2042
|
|
msgid "Hydrogen support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2044
|
|
msgid ""
|
|
"Thanks to [Aaron Raimist](https://github.com/aaronraimist), the playbook "
|
|
"now supports [Hydrogen](https://github.com/vector-im/hydrogen-web) - a "
|
|
"new lightweight Matrix client with legacy and mobile browser support."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2046
|
|
msgid ""
|
|
"By default, we still install Element Web, as Hydrogen is still not fully-"
|
|
"featured. Still, people who'd like to try Hydrogen out can now install it"
|
|
" via the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2048
|
|
msgid ""
|
|
"Additional details are available in [Setting up Hydrogen](docs"
|
|
"/configuring-playbook-client-hydrogen.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2051
|
|
msgid "2021-05-19"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2053
|
|
msgid "Heisenbridge support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2055
|
|
msgid ""
|
|
"Thanks to [Toni Spets (hifi)](https://github.com/hifi), the playbook now "
|
|
"supports bridging to "
|
|
"[IRC](https://en.wikipedia.org/wiki/Internet_Relay_Chat) using yet "
|
|
"another bridge (besides matrix-appservice-irc), called "
|
|
"[Heisenbridge](https://github.com/hifi/heisenbridge)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2057
|
|
msgid ""
|
|
"Additional details are available in [Setting up Heisenbridge bouncer-"
|
|
"style IRC bridging](docs/configuring-playbook-bridge-heisenbridge.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2060
|
|
msgid "2021-04-16"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2062
|
|
msgid "Disabling TLSv1 and TLSv1.1 for Coturn"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2064
|
|
msgid ""
|
|
"To improve security, we've [removed TLSv1 and TLSv1.1 "
|
|
"support](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/pull/999) from our default "
|
|
"[Coturn](https://github.com/coturn/coturn) configuration."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2066
|
|
msgid ""
|
|
"If you need to support old clients, you can re-enable both (or whichever "
|
|
"one you need) with the following configuration:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2074
|
|
msgid "2021-04-05"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2076
|
|
msgid "Automated local Postgres backup support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2078
|
|
msgid ""
|
|
"Thanks to [foxcris](https://github.com/foxcris), the playbook can now "
|
|
"make automated local Postgres backups on a fixed schedule using [docker-"
|
|
"postgres-backup-local](https://github.com/prodrigestivill/docker-"
|
|
"postgres-backup-local)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2080
|
|
msgid ""
|
|
"Additional details are available in [Setting up postgres backup](docs"
|
|
"/configuring-playbook-postgres-backup.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2083
|
|
msgid "2021-04-03"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2085
|
|
msgid "Mjolnir moderation tool (bot) support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2087
|
|
msgid ""
|
|
"Thanks to [Aaron Raimist](https://github.com/aaronraimist), the playbook "
|
|
"can now install and configure the [Mjolnir](https://github.com/matrix-"
|
|
"org/mjolnir) moderation tool (bot)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2089
|
|
msgid ""
|
|
"Additional details are available in [Setting up Mjolnir](docs"
|
|
"/configuring-playbook-bot-mjolnir.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2092
|
|
msgid "2021-03-20"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2094
|
|
msgid "Sygnal push gateway support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2096
|
|
msgid ""
|
|
"The playbook can now install the [Sygnal](https://github.com/matrix-"
|
|
"org/sygnal) push gateway for you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2098
|
|
msgid ""
|
|
"This is only useful to people who develop/build their own Matrix client "
|
|
"applications."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2100
|
|
msgid ""
|
|
"Additional details are available in our [Setting up the Sygnal push "
|
|
"gateway](docs/configuring-playbook-sygnal.md) docs."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2103
|
|
msgid "2021-03-16"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2105
|
|
msgid "Go-NEB support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2107
|
|
msgid ""
|
|
"Thanks to [Zir0h](https://github.com/Zir0h), the playbook can now install"
|
|
" and configure the [Go-NEB](https://github.com/matrix-org/go-neb) bot."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2109
|
|
msgid ""
|
|
"Additional details are available in [Setting up Go-NEB](docs/configuring-"
|
|
"playbook-bot-go-neb.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2112
|
|
msgid "2021-02-19"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2114
|
|
msgid "GroupMe bridging support via mx-puppet-groupme"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2116
|
|
msgid ""
|
|
"Thanks to [Cody Neiman](https://github.com/xangelix), the playbook can "
|
|
"now install the [mx-puppet-groupme](https://gitlab.com/robintown/mx-"
|
|
"puppet-groupme) bridge for bridging to [GroupMe](https://groupme.com)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2118
|
|
msgid ""
|
|
"This brings the total number of bridges supported by the playbook up to "
|
|
"18. See all supported bridges [here](docs/configuring-playbook.md"
|
|
"#bridging-other-networks)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2120
|
|
msgid ""
|
|
"To get started, follow our [Setting up MX Puppet GroupMe](docs"
|
|
"/configuring-playbook-bridge-mx-puppet-groupme.md) docs."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2122
|
|
msgid "Mautrix Instagram bridging support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2124
|
|
msgid ""
|
|
"The playbook now supports bridging with "
|
|
"[Instagram](https://www.instagram.com/) by installing the [mautrix-"
|
|
"instagram](https://github.com/tulir/mautrix-instagram) bridge. This "
|
|
"playbook functionality is available thanks to "
|
|
"[@MarcProe](https://github.com/MarcProe)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2126
|
|
msgid ""
|
|
"Additional details are available in [Setting up Mautrix Instagram "
|
|
"bridging](docs/configuring-playbook-bridge-mautrix-instagram.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2128
|
|
msgid "Synapse workers support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2130
|
|
msgid ""
|
|
"After [lots and lots of work](https://github.com/spantaleev/matrix-"
|
|
"docker-ansible-deploy/pull/456) (done over many months by [Marcel "
|
|
"Partap](https://github.com/eMPee584), [Max "
|
|
"Klenk](https://github.com/maxklenk), a few others from the [Technical "
|
|
"University of Dresden, Germany](https://tu-dresden.de/) and various other"
|
|
" contributors), support for Synapse workers has finally landed."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2132
|
|
msgid ""
|
|
"Having support for workers makes the playbook suitable for larger "
|
|
"homeserver deployments."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2134
|
|
msgid ""
|
|
"Our setup is not yet perfect (we don't support all types of workers; "
|
|
"scaling some of them (like `pusher`, `federation_sender`) beyond a single"
|
|
" instance is not yet supported). Still, it's a great start and can "
|
|
"already power homeservers with thousands of users, like the [Matrix "
|
|
"deployment at TU Dresden](https://doc.matrix.tu-dresden.de/en/) discussed"
|
|
" in [Matrix Live S06E09 - TU Dresden on their Matrix "
|
|
"deployment](https://www.youtube.com/watch?v=UHJX2pmT2gk)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2136
|
|
msgid ""
|
|
"By default, workers are disabled and Synapse runs as a single process "
|
|
"(homeservers don't necessarily need the complexity and increased memory "
|
|
"requirements of running a worker-based setup)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2138
|
|
msgid ""
|
|
"To enable Synapse workers, follow our [Load balancing with workers](docs"
|
|
"/configuring-playbook-synapse.md#load-balancing-with-workers) "
|
|
"documentation."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2141
|
|
msgid "2021-02-12"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2143
|
|
msgid ""
|
|
"(Potential Breaking Change) Monitoring/metrics support using Prometheus "
|
|
"and Grafana"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2145
|
|
msgid ""
|
|
"Thanks to [@Peetz0r](https://github.com/Peetz0r), the playbook can now "
|
|
"install a bunch of tools for monitoring your Matrix server: the "
|
|
"[Prometheus](https://prometheus.io) time-series database server, the "
|
|
"Prometheus [node-exporter](https://prometheus.io/docs/guides/node-"
|
|
"exporter/) host metrics exporter, and the [Grafana](https://grafana.com/)"
|
|
" web UI."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2147
|
|
msgid ""
|
|
"To get get these installed, follow our [Enabling metrics and graphs "
|
|
"(Prometheus, Grafana) for your Matrix server](docs/configuring-playbook-"
|
|
"prometheus-grafana.md) docs page."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2149
|
|
msgid ""
|
|
"This update comes with a **potential breaking change** for people who "
|
|
"were already exposing Synapse metrics (for consumption via another "
|
|
"Prometheus installation). From now on, `matrix_synapse_metrics_enabled: "
|
|
"true` no longer exposes metrics publicly via matrix-nginx-proxy (at "
|
|
"`https://matrix.example.com/_synapse/metrics`). To do so, you'd need to "
|
|
"explicitly set `matrix_nginx_proxy_proxy_synapse_metrics: true`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2152
|
|
msgid "2021-01-31"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2154
|
|
msgid "Etherpad support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2156
|
|
msgid ""
|
|
"Thanks to [@pushytoxin](https://github.com/pushytoxin), the playbook can "
|
|
"now install the [Etherpad](https://etherpad.org) realtime collaborative "
|
|
"text editor. It can be used in a [Jitsi](https://jitsi.org/) audio/video "
|
|
"call or integrated as a widget into Matrix chat rooms via the "
|
|
"[Dimension](https://dimension.t2bot.io) integration manager."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2158
|
|
msgid ""
|
|
"To get it installed, follow [our Etherpad docs page](docs/configuring-"
|
|
"playbook-etherpad.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2161
|
|
msgid "2021-01-22"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2163
|
|
msgid "(Breaking Change) Postgres changes that require manual intervention"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2165
|
|
msgid ""
|
|
"We've made a lot of changes to our Postgres setup and some manual action "
|
|
"is required (described below). Sorry about the hassle."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2167
|
|
msgid ""
|
|
"**TLDR**: people running an [external Postgres server](docs/configuring-"
|
|
"playbook-external-postgres.md) don't need to change anything for now. "
|
|
"Everyone else (the common/default case) is affected and manual "
|
|
"intervention is required."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2169
|
|
msgid "Why?"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2171
|
|
msgid ""
|
|
"we had a default Postgres password (`matrix_postgres_connection_password:"
|
|
" synapse-password`), which we think is **not ideal for security "
|
|
"anymore**. We now ask you to generate/provide a strong password yourself."
|
|
" Postgres is normally not exposed outside the container network, making "
|
|
"it relatively secure, but still:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2172
|
|
msgid ""
|
|
"by tweaking the configuration, you may end up intentionally or "
|
|
"unintentionally exposing your Postgres server to the local network (or "
|
|
"even publicly), while still using the default default credentials "
|
|
"(`synapse` + `synapse-password`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2173
|
|
msgid ""
|
|
"we can't be sure we trust all these services (bridges, etc). Some of them"
|
|
" may try to talk to or attack `matrix-postgres` using the default "
|
|
"credentials (`synapse` + `synapse-password`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2174
|
|
msgid ""
|
|
"you may have other containers running on the same Docker network, which "
|
|
"may try to talk to or attack `matrix-postgres` using the default "
|
|
"credentials (`synapse` + `synapse-password`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2175
|
|
msgid ""
|
|
"our Postgres usage **was overly-focused on Synapse** (default username of"
|
|
" `synapse` and default/main database of `homeserver`). Additional "
|
|
"homeserver options are likely coming in the future "
|
|
"([Dendrite](https://matrix.org/docs/projects/server/dendrite), "
|
|
"[Conduit](https://matrix.org/docs/projects/server/conduit), [The "
|
|
"Construct](https://matrix.org/docs/projects/server/construct)), so being "
|
|
"too focused on `matrix-synapse` is not great. From now on, Synapse is "
|
|
"just another component of this playbook, which happens to have an "
|
|
"*additional database* (called `synapse`) on the Postgres server."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2176
|
|
msgid ""
|
|
"we try to reorganize things a bit, to make the playbook even friendlier "
|
|
"to people running an [external Postgres server](docs/configuring-"
|
|
"playbook-external-postgres.md). Work on this will proceed in the future."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2178
|
|
msgid ""
|
|
"So, this is some **effort to improve security** and to **prepare for a "
|
|
"brighter future of having more homeserver options** than just Synapse."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2180
|
|
msgid "What has really changed?"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2182
|
|
msgid ""
|
|
"the default superuser Postgres username is now `matrix` (used to be "
|
|
"`synapse`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2183
|
|
msgid "the default Postgres database is now `matrix` (used to be `homeserver`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2184
|
|
msgid ""
|
|
"Synapse's database is now `synapse` (used to be `homeserver`). This is "
|
|
"now just another \"additional database\" that the playbook manages for "
|
|
"you"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2185
|
|
msgid ""
|
|
"Synapse's user called `synapse` is just a regular user that can only use "
|
|
"the `synapse` database (not a superuser anymore)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2187
|
|
msgid "What do I do if I'm using the integrated Postgres server (default)?"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2189
|
|
msgid ""
|
|
"By default, the playbook runs an integrated Postgres server for you in a "
|
|
"container (`matrix-postgres`). Unless you've explicitly configured an "
|
|
"[external Postgres server](docs/configuring-playbook-external-"
|
|
"postgres.md), these steps are meant for you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2191
|
|
msgid ""
|
|
"To migrate to the new setup, expect a few minutes of downtime, while you "
|
|
"follow these steps:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2193
|
|
msgid ""
|
|
"We believe the steps below are safe and you won't encounter any data "
|
|
"loss, but consider [making a Postgres backup](docs/maintenance-"
|
|
"postgres.md#backing-up-postgresql) anyway. If you've never backed up "
|
|
"Postgres, now would be a good time to try it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2195
|
|
msgid ""
|
|
"Generate a strong password to be used for your superuser Postgres user "
|
|
"(called `matrix`). You can use `pwgen -s 64 1` to generate it, or some "
|
|
"other tool. The **maximum length** for a Postgres password is 100 bytes "
|
|
"(characters). Don't go crazy!"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2197
|
|
msgid ""
|
|
"Update your playbook's `inventory/host_vars/matrix.example.com/vars.yml` "
|
|
"file, adding a line like this:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2202 ../../../CHANGELOG.md:2214
|
|
msgid ""
|
|
".. where `YOUR_POSTGRES_PASSWORD_HERE` is to be replaced with the "
|
|
"password you generated during step #2."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2204
|
|
msgid ""
|
|
"Stop all services: `ansible-playbook -i inventory/hosts setup.yml "
|
|
"--tags=stop`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2205
|
|
msgid "Log in to the server via SSH. The next commands will be performed there."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2206
|
|
msgid "Start the Postgres database server: `systemctl start matrix-postgres`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2207
|
|
msgid "Open a Postgres shell: `/usr/local/bin/matrix-postgres-cli`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2208
|
|
msgid ""
|
|
"Execute the following query, while making sure to **change the password "
|
|
"inside** (**don't forget the ending `;`**):"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2216
|
|
msgid ""
|
|
"Execute the following queries as you see them (no modifications "
|
|
"necessary, so you can just **paste them all at once**):"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2234
|
|
msgid "You may need to press *Enter* after pasting the lines above."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2236
|
|
msgid ""
|
|
"Re-run the playbook normally: `ansible-playbook -i inventory/hosts "
|
|
"setup.yml --tags=setup-all,start`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2238
|
|
msgid "What do I do if I'm using an external Postgres server?"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2240
|
|
msgid ""
|
|
"If you've explicitly configured an [external Postgres server](docs"
|
|
"/configuring-playbook-external-postgres.md), there are **no changes** "
|
|
"that you need to do at this time."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2242
|
|
msgid ""
|
|
"The fact that we've renamed Synapse's database from `homeserver` to "
|
|
"`synapse` (in our defaults) should not affect you, as you're already "
|
|
"explicitly defining `matrix_synapse_database_database` (if you've "
|
|
"followed our guide, that is). If you're not explicitly defining this "
|
|
"variable, you may wish to do so (`matrix_synapse_database_database: "
|
|
"homeserver`), to avoid the new `synapse` default and keep things as they "
|
|
"were."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2245
|
|
msgid "2021-01-20"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2247
|
|
msgid ""
|
|
"(Breaking Change) The mautrix-facebook bridge now requires a Postgres "
|
|
"database"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2249
|
|
msgid ""
|
|
"**Update from 2021-11-15**: SQLite support has been re-added to the "
|
|
"mautrix-facebook bridge in "
|
|
"[v0.3.2](https://github.com/mautrix/facebook/releases/tag/v0.3.2). You "
|
|
"can ignore this changelog entry."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2251
|
|
msgid ""
|
|
"A new version of the [mautrix-facebook](https://github.com/tulir/mautrix-"
|
|
"facebook) bridge has been released. It's a full rewrite of its backend "
|
|
"and the bridge now requires Postgres. New versions of the bridge can no "
|
|
"longer run on SQLite."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2253
|
|
msgid ""
|
|
"**TLDR**: if you're NOT using an [external Postgres server](docs"
|
|
"/configuring-playbook-external-postgres.md) and have NOT forcefully kept "
|
|
"the bridge on SQLite during [The big move to all-on-Postgres (potentially"
|
|
" dangerous)](#the-big-move-to-all-on-postgres-potentially-dangerous), you"
|
|
" will be automatically upgraded without manual intervention. All you need"
|
|
" to do is send a `login` message to the Facebook bridge bot again."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2255
|
|
msgid "Whether this change requires your intervention depends mostly on:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2256
|
|
msgid ""
|
|
"whether you're using an [external Postgres server](docs/configuring-"
|
|
"playbook-external-postgres.md). If yes, then [you need to do something"
|
|
"](#upgrade-path-for-people-running-an-external-postgres-server)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2257
|
|
msgid ""
|
|
"or whether you've force-changed the bridge's database engine to SQLite "
|
|
"(`matrix_mautrix_facebook_database_engine: 'sqlite'` in your `vars.yml`) "
|
|
"some time in the past (likely during [The big move to all-on-Postgres "
|
|
"(potentially dangerous)](#the-big-move-to-all-on-postgres-potentially-"
|
|
"dangerous))."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2259
|
|
msgid ""
|
|
"As already mentioned above, you most likely don't need to do anything. If"
|
|
" you rerun the playbook and don't get an error, you've been automatically"
|
|
" upgraded. Just send a `login` message to the Facebook bridge bot again. "
|
|
"Otherwise, read below for a solution."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2261
|
|
msgid ""
|
|
"Upgrade path for people NOT running an external Postgres server (default "
|
|
"for the playbook)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2263
|
|
msgid ""
|
|
"If you're **not running an external Postgres server**, then this bridge "
|
|
"either already works on Postgres for you, or you've intentionally kept it"
|
|
" back on SQLite with custom configuration "
|
|
"(`matrix_mautrix_facebook_database_engine: 'sqlite'` in your `vars.yml`) "
|
|
"."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2265
|
|
msgid ""
|
|
"Simply remove that custom configuration from your `vars.yml` file (if "
|
|
"it's there) and re-run the playbook. It should upgrade you automatically."
|
|
" You'll need to send a `login` message to the Facebook bridge bot again."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2267
|
|
msgid ""
|
|
"Alternatively, [you can stay on SQLite for a little longer](#staying-on-"
|
|
"sqlite-for-a-little-longer-temporary-solution)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2269
|
|
msgid "Upgrade path for people running an external Postgres server"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2271
|
|
msgid ""
|
|
"For people using the internal Postgres server (the default for the "
|
|
"playbook):"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2272
|
|
msgid ""
|
|
"we automatically create an additional `matrix_mautrix_facebook` Postgres "
|
|
"database and credentials to access it"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2273
|
|
msgid ""
|
|
"we automatically adjust the bridge's `matrix_mautrix_facebook_database_*`"
|
|
" variables to point the bridge to that Postgres database"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2274
|
|
msgid ""
|
|
"we use [pgloader](https://pgloader.io/) to automatically import the "
|
|
"existing SQLite data for the bridge into the `matrix_mautrix_facebook` "
|
|
"Postgres database"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2276
|
|
msgid ""
|
|
"If you are using an [external Postgres server](docs/configuring-playbook-"
|
|
"external-postgres.md), unfortunately we currently can't do any of that "
|
|
"for you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2278
|
|
msgid "You have 3 ways to proceed:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2280
|
|
msgid "contribute to the playbook to make this possible (difficult)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2281
|
|
msgid "or, do the migration \"steps\" manually:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2282
|
|
msgid "stop the bridge (`systemctl stop matrix-mautrix-facebook`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2283
|
|
msgid "create a new `matrix_mautrix_facebook` Postgres database for it"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2284
|
|
msgid ""
|
|
"run [pgloader](https://pgloader.io/) manually (we import this bridge's "
|
|
"data using default settings and it works well)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2285
|
|
msgid ""
|
|
"define `matrix_mautrix_facebook_database_*` variables in your `vars.yml` "
|
|
"file (credentials, etc.) - you can find their defaults in `roles/custom"
|
|
"/matrix-mautrix-facebook/defaults/main.yml`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2286
|
|
msgid ""
|
|
"switch the bridge to Postgres (`matrix_mautrix_facebook_database_engine: "
|
|
"'postgres'` in your `vars.yml` file)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2287
|
|
msgid ""
|
|
"re-run the playbook (`--tags=setup-all,start`) and ensure the bridge "
|
|
"works (`systemctl status matrix-mautrix-facebook` and `journalctl -fu "
|
|
"matrix-mautrix-facebook`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2288
|
|
msgid "send a `login` message to the Facebook bridge bot again"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2289
|
|
msgid ""
|
|
"or, [stay on SQLite for a little longer (temporary solution)](#staying-"
|
|
"on-sqlite-for-a-little-longer-temporary-solution)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2291
|
|
msgid "Staying on SQLite for a little longer (temporary solution)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2293
|
|
msgid ""
|
|
"To keep using this bridge with SQLite for a little longer (**not "
|
|
"recommended**), use the following configuration in your `vars.yml` file:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2303
|
|
msgid ""
|
|
"If you do this, keep in mind that **you can't run this forever**. This "
|
|
"SQLite-supporting bridge version is not getting any updates and will "
|
|
"break sooner or later. The playbook will also drop support for SQLite at "
|
|
"some point in the future."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2306
|
|
msgid "2021-01-17"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2308
|
|
msgid "matrix-corporal goes 2.0"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2310
|
|
msgid ""
|
|
"[matrix-corporal v2 has been released](https://github.com/devture/matrix-"
|
|
"corporal/releases/tag/2.0.0) and the playbook also supports it now."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2312
|
|
msgid "No manual intervention is required in the common case."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2314
|
|
msgid ""
|
|
"The new [matrix-corporal](https://github.com/devture/matrix-corporal) "
|
|
"version is also the first one to support Interactive Authentication. If "
|
|
"you wish to enable that (hint: you should), you'll need to set up the "
|
|
"[REST auth password provider](docs/configuring-playbook-rest-auth.md). "
|
|
"There's more information in [our matrix-corporal docs](docs/configuring-"
|
|
"playbook-matrix-corporal.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2317
|
|
msgid "2021-01-14"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2319
|
|
msgid "Moving from cronjobs to systemd timers"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2321
|
|
msgid ""
|
|
"We no longer use cronjobs for Let's Encrypt SSL renewal and `matrix-"
|
|
"nginx-proxy`/`matrix-coturn` reloading. Instead, we've switched to "
|
|
"systemd timers."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2323
|
|
msgid ""
|
|
"The largest benefit of this is that we no longer require you to install a"
|
|
" cron daemon, thus simplifying our install procedure."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2325
|
|
msgid ""
|
|
"The playbook will migrate you from cronjobs to systemd timers "
|
|
"automatically. This is just a heads up."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2328
|
|
msgid "2021-01-08"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2330
|
|
msgid "(Breaking Change) New SSL configuration"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2332
|
|
msgid ""
|
|
"SSL configuration (protocols, ciphers) can now be more easily controlled "
|
|
"thanks to us making use of configuration presets."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2334
|
|
msgid ""
|
|
"We define a few presets (old, intermediate, modern), following the "
|
|
"[Mozilla SSL Configuration Generator](https://ssl-"
|
|
"config.mozilla.org/#server=nginx)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2336
|
|
msgid ""
|
|
"A new variable `matrix_nginx_proxy_ssl_preset` controls which preset is "
|
|
"used (defaults to `\"intermediate\"`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2338
|
|
msgid ""
|
|
"Compared to before, this changes nginx's `ssl_prefer_server_ciphers` to "
|
|
"`off` (used to default to `on`). It also add some more ciphers to the "
|
|
"list, giving better performance on mobile devices, and removes some weak "
|
|
"ciphers. More information in the [documentation](docs/configuring-"
|
|
"playbook-nginx.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2340
|
|
msgid "To revert to the old behaviour, set the following variables:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2347
|
|
msgid ""
|
|
"Just like before, you can still use your own custom protocols by "
|
|
"specifying them in `matrix_nginx_proxy_ssl_protocols`. Doing so overrides"
|
|
" the values coming from the preset."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2350
|
|
msgid "2021-01-03"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2352
|
|
msgid "Signal bridging support via mautrix-signal"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2354
|
|
msgid ""
|
|
"Thanks to [laszabine](https://github.com/laszabine)'s efforts, the "
|
|
"playbook now supports bridging to [Signal](https://www.signal.org/) via "
|
|
"the [mautrix-signal](https://github.com/tulir/mautrix-signal) bridge. See"
|
|
" our [Setting up Mautrix Signal bridging](docs/configuring-playbook-"
|
|
"bridge-mautrix-signal.md) documentation page for getting started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2356
|
|
msgid ""
|
|
"If you had installed the mautrix-signal bridge while its Pull Request was"
|
|
" still work-in-progress, you can migrate your data to the new and final "
|
|
"setup by referring to [this comment](https://github.com/spantaleev"
|
|
"/matrix-docker-ansible-deploy/pull/686#issuecomment-753510789)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2359
|
|
msgid "2020-12-23"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2361
|
|
msgid "The big move to all-on-Postgres (potentially dangerous)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2363
|
|
msgid ""
|
|
"**TLDR**: all your bridges (and other services) will likely be auto-"
|
|
"migrated from SQLite/nedb to Postgres, hopefully without trouble. You can"
|
|
" opt-out (see how below), if too worried about breakage."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2365
|
|
msgid ""
|
|
"Until now, we've only used Postgres as a database for Synapse. All other "
|
|
"services (bridges, bots, etc.) were kept simple and used a file-based "
|
|
"database (SQLite or nedb)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2367
|
|
msgid ""
|
|
"Since [this huge pull request](https://github.com/spantaleev/matrix-"
|
|
"docker-ansible-deploy/pull/740), **all of our services now use Postgres "
|
|
"by default**. Thanks to [Johanna Dorothea "
|
|
"Reichmann](https://github.com/jdreichmann) for starting the work on it "
|
|
"and for providing great input!"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2369
|
|
msgid "Moving all services to Postgres brings a few **benefits** to us:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2371
|
|
msgid "**improved performance**"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2372
|
|
msgid ""
|
|
"**improved compatibility**. Most bridges are deprecating SQLite/nedb "
|
|
"support or offer less features when not on Postgres."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2373
|
|
msgid ""
|
|
"**easier backups**. It's still some effort to take a proper backup "
|
|
"(Postgres dump + various files, keys), but a Postgres dump now takes you "
|
|
"much further."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2374
|
|
msgid ""
|
|
"we're now **more prepared to introduce other services** that need a "
|
|
"Postgres database - [Dendrite](https://github.com/matrix-org/dendrite), "
|
|
"the [mautrix-signal](https://github.com/tulir/mautrix-signal) bridge "
|
|
"(existing [pull request](https://github.com/spantaleev/matrix-docker-"
|
|
"ansible-deploy/pull/686)), etc."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2376
|
|
msgid "Key takeway"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2378
|
|
msgid ""
|
|
"existing installations that use an [external "
|
|
"Postgres](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/blob/master/docs/configuring-playbook-external-postgres.md) server"
|
|
" should be unaffected (they remain on SQLite/nedb for all services, "
|
|
"except Synapse)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2380
|
|
msgid ""
|
|
"for existing installations which use our integrated Postgres database "
|
|
"server (`matrix-postgres`, which is the default), **we automatically "
|
|
"migrate data** from SQLite/nedb to Postgres and **archive the database "
|
|
"files** (`something.db` -> `something.db.backup`), so you can restore "
|
|
"them if you need to go back (see how below)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2382
|
|
msgid "Opting-out of the Postgres migration"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2384
|
|
msgid ""
|
|
"This is a **very large and somewhat untested change** (potentially "
|
|
"dangerous), so **if you're not feeling confident/experimental, opt-out** "
|
|
"of it for now. Still, it's the new default and what we (and various "
|
|
"bridges) will focus on going forward, so don't stick to old ways for too "
|
|
"long."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2386
|
|
msgid ""
|
|
"You can remain on SQLite/nedb (at least for now) by adding a variable "
|
|
"like this to your `vars.yml` file for each service you use: "
|
|
"`matrix_COMPONENT_database_engine: sqlite` (e.g. "
|
|
"`matrix_mautrix_facebook_database_engine: sqlite`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2388
|
|
msgid ""
|
|
"Some services (like `appservice-irc` and `appservice-slack`) don't use "
|
|
"SQLite, so use `nedb`, instead of `sqlite` for them."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2390
|
|
msgid "Going back to SQLite/nedb if things went wrong"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2392
|
|
msgid ""
|
|
"If you went with the Postgres migration and it went badly for you (some "
|
|
"bridge not working as expected or not working at all), do this:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2394
|
|
msgid ""
|
|
"stop all services (`ansible-playbook -i inventory/hosts setup.yml "
|
|
"--tags=stop`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2395
|
|
msgid ""
|
|
"SSH into the server and rename the old database files "
|
|
"(`something.db.backup` -> `something.db`). Example: `mv /matrix/mautrix-"
|
|
"facebook/data/mautrix-facebook.db.backup /matrix/mautrix-facebook/data"
|
|
"/mautrix-facebook.db`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2396
|
|
msgid ""
|
|
"switch the affected service back to SQLite (e.g. "
|
|
"`matrix_mautrix_facebook_database_engine: sqlite`). Some services (like "
|
|
"`appservice-irc` and `appservice-slack`) don't use SQLite, so use `nedb`,"
|
|
" instead of `sqlite` for them."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2397
|
|
msgid ""
|
|
"re-run the playbook (`ansible-playbook -i inventory/hosts setup.yml "
|
|
"--tags=setup-all,start`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2398
|
|
msgid "[get in touch](README.md#support) with us"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2400
|
|
msgid "2020-12-11"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2402
|
|
msgid "synapse-janitor support removed"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2404
|
|
msgid ""
|
|
"We've removed support for the unmaintained [synapse-"
|
|
"janitor](https://github.com/xwiki-labs/synapse_scripts) script. There's "
|
|
"been past reports of it corrupting the Synapse database. Since there "
|
|
"hasn't been any new development on it and it doesn't seem too useful "
|
|
"nowadays, there's no point in including it in the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2406
|
|
msgid ""
|
|
"If you need to clean up or compact your database, consider using the "
|
|
"Synapse Admin APIs directly. See our [Synapse maintenance](docs"
|
|
"/maintenance-synapse.md) and [Postgres maintenance](docs/maintenance-"
|
|
"postgres.md) documentation pages for more details."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2408
|
|
msgid "Docker 20.10 is here"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2410
|
|
msgid ""
|
|
"(No need to do anything special in relation to this. Just something to "
|
|
"keep in mind)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2412
|
|
msgid ""
|
|
"Docker 20.10 got released recently and your server will likely get it the"
|
|
" next time you update."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2414
|
|
msgid ""
|
|
"This is the first major Docker update in a long time and it packs a lot "
|
|
"of changes. Some of them introduced some breakage for us initially (see "
|
|
"[here](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/commit/d08b27784f222effcbce2abf924bf07bbe0893be) and "
|
|
"[here](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/commit/7593d969e316cc0144bce378a5be58c76c2c37ee)), but it should "
|
|
"be all good now."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2417
|
|
msgid "2020-12-08"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2419
|
|
msgid ""
|
|
"openid APIs exposed by default on the federation port when federation "
|
|
"disabled"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2421
|
|
msgid ""
|
|
"We've changed some defaults. People running with our default "
|
|
"configuration (federation enabled), are not affected at all."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2423
|
|
msgid ""
|
|
"If you are running an unfederated server "
|
|
"(`matrix_synapse_federation_enabled: false`), this may be of interest to "
|
|
"you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2425
|
|
msgid ""
|
|
"When federation is disabled, but ma1sd or Dimension are enabled, we'll "
|
|
"now expose the `openid` APIs on the federation port. These APIs are "
|
|
"necessary for some ma1sd features to work. If you'd like to prevent this,"
|
|
" you can: `matrix_synapse_federation_port_openid_resource_required: "
|
|
"false`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2428
|
|
msgid "2020-11-27"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2430
|
|
msgid "Recent Jitsi updates may require configuration changes"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2432
|
|
msgid ""
|
|
"We've recently [updated from Jitsi build 4857 to build "
|
|
"5142](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/pull/719), which brings a lot of configuration changes."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2434
|
|
msgid "**If you use our default Jitsi settings, you won't have to do anything.**"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2436
|
|
msgid ""
|
|
"People who have [fine-tuned Jitsi](docs/configuring-playbook-jitsi.md"
|
|
"#optional-fine-tune-jitsi) may find that some options got renamed now, "
|
|
"others are gone and yet others still need to be defined in another way."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2438
|
|
msgid ""
|
|
"The next time you run the playbook [installation](docs/installing.md) "
|
|
"command, our validation logic will tell you if you're using some "
|
|
"variables like that and will recommend a migration path for each one."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2440
|
|
msgid ""
|
|
"Additionally, we've recently disabled transcriptions "
|
|
"(`jitsi_enable_transcriptions: false`) and recording "
|
|
"(`jitsi_enable_recording: false`) by default. These features did not work"
|
|
" anyway, because we don't install the required dependencies for them "
|
|
"(Jigasi and Jibri, respectively). If you've been somehow pointing your "
|
|
"Jitsi installation to some manually installed Jigasi/Jibri service, you "
|
|
"may need to toggle these flags back to enabled to have transcriptions and"
|
|
" recordings working."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2443
|
|
msgid "2020-11-23"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2445 ../../../CHANGELOG.md:2453
|
|
msgid "Breaking change matrix-sms-bridge"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2447
|
|
msgid ""
|
|
"Because of many problems using gammu as SMS provider, matrix-sms-bridge "
|
|
"now uses (https://github.com/RebekkaMa/android-sms-gateway-server) by "
|
|
"default. See (the docs)[./docs/configuring-playbook-bridge-matrix-bridge-"
|
|
"sms.md] which new vars you need to add."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2449
|
|
msgid ""
|
|
"If you are using this playbook to deploy matrix-sms-bridge and still "
|
|
"really want to use gammu as SMS provider, we could possibly add support "
|
|
"for both android-sms-gateway-server and gammu."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2451
|
|
msgid "2020-11-13"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2455
|
|
msgid ""
|
|
"The new version of [matrix-sms-bridge](https://github.com/benkuly/matrix-"
|
|
"sms-bridge) changed its database from neo4j to h2. You need to sync the "
|
|
"bridge at the first start. Note that this only will sync rooms where the "
|
|
"@smsbot:yourServer is member. For rooms without @smsbot:yourServer you "
|
|
"need to kick and invite the telephone number **or** invite "
|
|
"@smsbot:yourServer."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2457
|
|
msgid ""
|
|
"Add the following to your `vars.yml` file: "
|
|
"`matrix_sms_bridge_container_extra_arguments=['--env "
|
|
"SPRING_PROFILES_ACTIVE=initialsync']`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2458
|
|
msgid ""
|
|
"Login to your host shell and remove old systemd file from your host: `rm "
|
|
"/etc/systemd/system/matrix-sms-bridge-database.service`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2459
|
|
msgid ""
|
|
"Run `ansible-playbook -i inventory/hosts setup.yml --tags=setup-matrix-"
|
|
"sms-bridge,start`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2460
|
|
msgid ""
|
|
"Login to your host shell and check the logs with `journalctl -u matrix-"
|
|
"sms-bridge` until the sync finished."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2461
|
|
msgid "Remove the var from the first step."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2462
|
|
msgid ""
|
|
"Run `ansible-playbook -i inventory/hosts setup.yml --tags=setup-"
|
|
"all,start`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2464
|
|
msgid "2020-11-10"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2466
|
|
msgid "Dynamic DNS support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2468
|
|
msgid ""
|
|
"Thanks to [Scott Crossen](https://github.com/scottcrossen), the playbook "
|
|
"can now manage Dynamic DNS for you using "
|
|
"[ddclient](https://ddclient.net/)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2470
|
|
msgid ""
|
|
"To learn more, follow our [Dynamic DNS docs page](docs/configuring-"
|
|
"playbook-dynamic-dns.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2473
|
|
msgid "2020-10-28"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2475
|
|
msgid ""
|
|
"(Compatibility Break) https://matrix.example.com/ now redirects to "
|
|
"https://element.example.com/"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2477
|
|
msgid ""
|
|
"Until now, we used to serve a static page coming from Synapse at "
|
|
"`https://matrix.example.com/`. This page was not very useful to anyone."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2479
|
|
msgid ""
|
|
"Since `matrix.example.com` may be accessed by regular users in certain "
|
|
"conditions, it's probably better to redirect them to a better place (e.g."
|
|
" to [Element Web](docs/configuring-playbook-client-element-web.md))."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2481
|
|
msgid ""
|
|
"If Element Web is installed (`matrix_client_element_enabled: true`, which"
|
|
" it is by default), we now redirect people to it, instead of showing them"
|
|
" a Synapse static page."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2483
|
|
msgid ""
|
|
"If you'd like to control where the redirect goes, use the "
|
|
"`matrix_nginx_proxy_proxy_matrix_client_redirect_root_uri_to_domain` "
|
|
"variable. To restore the old behavior of not redirecting anywhere and "
|
|
"serving the Synapse static page, set it to an empty value "
|
|
"(`matrix_nginx_proxy_proxy_matrix_client_redirect_root_uri_to_domain: "
|
|
"\"\"`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2486
|
|
msgid "2020-10-26"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2488
|
|
msgid ""
|
|
"(Compatibility Break) /_synapse/admin is no longer publicly exposed by "
|
|
"default"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2490
|
|
msgid ""
|
|
"We used to expose the Synapse Admin APIs publicly (at "
|
|
"`https://matrix.example.com/_synapse/admin`). These APIs require "
|
|
"authentication with a valid access token, so it's not that big a deal to "
|
|
"expose them."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2492
|
|
msgid ""
|
|
"However, following [official Synapse's reverse-proxying "
|
|
"recommendations](https://github.com/element-"
|
|
"hq/synapse/blob/master/docs/reverse_proxy.md#synapse-administration-"
|
|
"endpoints), we're no longer exposing `/_synapse/admin` by default."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2494
|
|
msgid ""
|
|
"If you'd like to restore restore the old behavior and expose "
|
|
"`/_synapse/admin` publicly, you can use the following configuration (in "
|
|
"your `vars.yml`):"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2501
|
|
msgid "2020-10-02"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2503
|
|
msgid "Minimum Ansible version raised to v2.7.0"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2505
|
|
msgid ""
|
|
"We were claiming to support [Ansible](https://www.ansible.com/) v2.5.2 "
|
|
"and higher, but issues like [#662](https://github.com/spantaleev/matrix-"
|
|
"docker-ansible-deploy/issues/662) demonstrate that we need at least "
|
|
"v2.7.0."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2507
|
|
msgid ""
|
|
"If you've been using the playbook without getting any errors until now, "
|
|
"you're probably on a version higher than that already (or you're not "
|
|
"using the `matrix-ma1sd` and `matrix-client-element` roles)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2509
|
|
msgid ""
|
|
"Our [Ansible docs page](docs/ansible.md) contains information on how to "
|
|
"run a more up-to-date version of Ansible."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2512
|
|
msgid "2020-10-01"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2514
|
|
msgid "Postgres 13 support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2516
|
|
msgid ""
|
|
"The playbook now installs [Postgres "
|
|
"13](https://www.postgresql.org/about/news/postgresql-13-released-2077/) "
|
|
"by default."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2518
|
|
msgid ""
|
|
"If you have have an existing setup, it's likely running on an older "
|
|
"Postgres version (9.x, 10.x, 11.x or 12.x). You can easily upgrade by "
|
|
"following the [upgrading PostgreSQL guide](docs/maintenance-postgres.md"
|
|
"#upgrading-postgresql)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2520
|
|
msgid "2020-09-01"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2522
|
|
msgid "matrix-registration support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2524
|
|
msgid ""
|
|
"The playbook can now help you set up [matrix-"
|
|
"registration](https://github.com/ZerataX/matrix-registration) - an "
|
|
"application that lets you keep your Matrix server's registration private,"
|
|
" but still allow certain users (those having a unique registration link) "
|
|
"to register by themselves."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2526
|
|
msgid ""
|
|
"See our [Setting up matrix-registration](docs/configuring-playbook-"
|
|
"matrix-registration.md) documentation page to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2529
|
|
msgid "2020-08-21"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2531
|
|
msgid "rust-synapse-compress-state support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2533
|
|
msgid ""
|
|
"The playbook can now help you use [rust-synapse-compress-"
|
|
"state](https://github.com/matrix-org/rust-synapse-compress-state) to "
|
|
"compress the state groups in your Synapse database."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2535
|
|
msgid ""
|
|
"See our [Compressing state with rust-synapse-compress-state](docs"
|
|
"/maintenance-synapse.md#compressing-state-with-rust-synapse-compress-"
|
|
"state) documentation page to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2538
|
|
msgid "2020-07-22"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2540
|
|
msgid "Synapse Admin support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2542
|
|
msgid ""
|
|
"The playbook can now help you set up [synapse-admin](https://github.com"
|
|
"/Awesome-Technologies/synapse-admin)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2544
|
|
msgid ""
|
|
"See our [Setting up Synapse Admin](docs/configuring-playbook-synapse-"
|
|
"admin.md) documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2547
|
|
msgid "2020-07-20"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2549
|
|
msgid "matrix-reminder-bot support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2551
|
|
msgid ""
|
|
"The playbook can now help you set up [matrix-reminder-"
|
|
"bot](https://github.com/anoadragon453/matrix-reminder-bot)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2553
|
|
msgid ""
|
|
"See our [Setting up matrix-reminder-bot](docs/configuring-playbook-bot-"
|
|
"matrix-reminder-bot.md) documentation to get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2556
|
|
msgid "2020-07-17"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2558
|
|
msgid "(Compatibility Break) Riot is now Element"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2560
|
|
msgid ""
|
|
"As per the official announcement, [Riot has been rebraned to "
|
|
"Element](https://element.io/blog/welcome-to-element/)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2562
|
|
msgid ""
|
|
"The playbook follows suit. Existing installations have a few options for "
|
|
"how to handle this."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2564
|
|
msgid ""
|
|
"See our [Migrating to Element Web](docs/configuring-playbook-riot-web.md"
|
|
"#migrating-to-element) documentation page for more details."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2567
|
|
msgid "2020-07-03"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2569
|
|
msgid "Steam bridging support via mx-puppet-steam"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2571
|
|
msgid ""
|
|
"Thanks to [Hugues Morisset](https://github.com/izissise)'s efforts, the "
|
|
"playbook now supports bridging to [Steam](https://steamapp.com/) via the "
|
|
"[mx-puppet-steam](https://github.com/icewind1991/mx-puppet-steam) bridge."
|
|
" See our [Setting up MX Puppet Steam bridging](docs/configuring-playbook-"
|
|
"bridge-mx-puppet-steam.md) documentation page for getting started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2574
|
|
msgid "2020-07-01"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2576
|
|
msgid "Discord bridging support via mx-puppet-discord"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2578
|
|
msgid ""
|
|
"Thanks to [Hugues Morisset](https://github.com/izissise)'s efforts, the "
|
|
"playbook now supports bridging to [Discord](https://discordapp.com/) via "
|
|
"the [mx-puppet-discord](https://github.com/Sorunome/mx-puppet-discord) "
|
|
"bridge. See our [Setting up MX Puppet Discord bridging](docs/configuring-"
|
|
"playbook-bridge-mx-puppet-discord.md) documentation page for getting "
|
|
"started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2580
|
|
msgid ""
|
|
"**Note**: this is a new Discord bridge. The playbook still retains "
|
|
"Discord bridging via [matrix-appservice-discord](docs/configuring-"
|
|
"playbook-bridge-appservice-discord.md). You're free too use the bridge "
|
|
"that serves you better, or even both (for different users and use-cases)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2583
|
|
msgid "2020-06-30"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2585
|
|
msgid "Instagram and Twitter bridging support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2587
|
|
msgid ""
|
|
"Thanks to [Johanna Dorothea Reichmann](https://github.com/jdreichmann)'s "
|
|
"efforts, the playbook now supports bridging to "
|
|
"[Instagram](https://www.instagram.com/) via the [mx-puppet-"
|
|
"instagram](https://github.com/Sorunome/mx-puppet-instagram) bridge. See "
|
|
"our [Setting up MX Puppet Instagram bridging](docs/configuring-playbook-"
|
|
"bridge-mx-puppet-instagram.md) documentation page for getting started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2589
|
|
msgid ""
|
|
"Thanks to [Tulir Asokan](https://github.com/tulir)'s efforts, the "
|
|
"playbook now supports bridging to [Twitter](https://twitter.com/) via the"
|
|
" [mx-puppet-twitter](https://github.com/Sorunome/mx-puppet-twitter) "
|
|
"bridge. See our [Setting up MX Puppet Twitter bridging](docs/configuring-"
|
|
"playbook-bridge-mx-puppet-twitter.md) documentation page for getting "
|
|
"started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2592
|
|
msgid "2020-06-28"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2594
|
|
msgid ""
|
|
"(Post Mortem / fixed Security Issue) Re-enabling User Directory search "
|
|
"powered by the ma1sd Identity Server"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2596 ../../../CHANGELOG.md:2625
|
|
msgid ""
|
|
"User Directory search requests used to go to the ma1sd identity server by"
|
|
" default, which queried its own stores and the Synapse database."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2598
|
|
msgid ""
|
|
"ma1sd's [security issue](https://github.com/ma1uta/ma1sd/issues/44) has "
|
|
"been fixed in version `2.4.0`, with [this "
|
|
"commit](ma1uta/ma1sd@2bb5a734d11662b06471113cf3d6b4cee5e33a85). `ma1sd "
|
|
"2.4.0` is now the default version for this playbook. For more information"
|
|
" on what happened, please check the mentioned issue."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2600
|
|
msgid ""
|
|
"We are re-enabling user directory search with this update. Those who "
|
|
"would like to keep it disabled can use this configuration: "
|
|
"`matrix_nginx_proxy_proxy_matrix_user_directory_search_enabled: false`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2602
|
|
msgid "As always, re-running the playbook is enough to get the updated bits."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2604
|
|
msgid "2020-06-11"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2606
|
|
msgid "SMS bridging requires db reset"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2608
|
|
msgid ""
|
|
"The current version of [matrix-sms-bridge](https://github.com/benkuly"
|
|
"/matrix-sms-bridge) needs you to delete the database to work as expected."
|
|
" Just remove `/matrix/matrix-sms-bridge/database/*`. It also adds a new "
|
|
"requried var `matrix_sms_bridge_default_region`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2610
|
|
msgid ""
|
|
"To reuse your existing rooms, invite `@smsbot:yourServer` to the room or "
|
|
"write a message. You are also able to use automated room creation with "
|
|
"telephonenumers by writing `sms send -t 01749292923 \"Hello World\"` in a"
|
|
" room with `@smsbot:yourServer`. See [the "
|
|
"docs](https://github.com/benkuly/matrix-sms-bridge) for more information."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2612
|
|
msgid "2020-06-05"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2614
|
|
msgid "SMS bridging support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2616
|
|
msgid ""
|
|
"Thanks to [benkuly](https://github.com/benkuly)'s efforts, the playbook "
|
|
"now supports bridging to SMS (with one telephone number only) via "
|
|
"[matrix-sms-bridge](https://github.com/benkuly/matrix-sms-bridge)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2618
|
|
msgid ""
|
|
"See our [Setting up Matrix SMS bridging](docs/configuring-playbook-"
|
|
"bridge-matrix-bridge-sms.md) documentation page for getting started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2621
|
|
msgid "2020-05-19"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2623
|
|
msgid ""
|
|
"(Compatibility Break / Security Issue) Disabling User Directory search "
|
|
"powered by the ma1sd Identity Server"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2627
|
|
msgid ""
|
|
"ma1sd current has [a security "
|
|
"issue](https://github.com/ma1uta/ma1sd/issues/44), which made it leak "
|
|
"information about all users - including users created by bridges, etc."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2629
|
|
msgid ""
|
|
"Until the issue gets fixed, we're making User Directory search not go to "
|
|
"ma1sd by default. You **need to re-run the playbook and restart services "
|
|
"to apply this workaround**."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2631
|
|
msgid ""
|
|
"*If you insist on restoring the old behavior* (**which has a security "
|
|
"issue!**), you *might* use this configuration: "
|
|
"`matrix_nginx_proxy_proxy_matrix_user_directory_search_enabled: \"{{ "
|
|
"matrix_ma1sd_enabled }}\"`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2634
|
|
msgid "2020-04-28"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2636
|
|
msgid "Newer IRC bridge (with potential breaking change)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2638
|
|
msgid ""
|
|
"This upgrades matrix-appservice-irc from 0.14.1 to 0.16.0. Upstream made"
|
|
" a change to how you define manual mappings. If you added a `mapping` to"
|
|
" your configuration, you will need to update it accoring to the [upstream"
|
|
" instructions](https://github.com/matrix-org/matrix-appservice-"
|
|
"irc/blob/master/CHANGELOG.md#0150-2020-02-05). If you did not include "
|
|
"`mappings` in your configuration for IRC, no change is necessary. "
|
|
"`mappings` is not part of the default configuration."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2647
|
|
msgid "2020-04-23"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2649 ../../../CHANGELOG.md:2880
|
|
msgid "Slack bridging support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2651
|
|
msgid ""
|
|
"Thanks to [Rodrigo Belem](https://github.com/rbelem)'s efforts, the "
|
|
"playbook now supports bridging to [Slack](https://slack.com) via the [mx-"
|
|
"puppet-slack](https://github.com/Sorunome/mx-puppet-slack) bridge."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2653
|
|
msgid ""
|
|
"See our [Setting up MX Puppet Slack bridging](docs/configuring-playbook-"
|
|
"bridge-mx-puppet-slack.md) documentation page for getting started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2656
|
|
msgid "2020-04-09"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2658
|
|
msgid "Skype bridging support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2660
|
|
msgid ""
|
|
"Thanks to [Rodrigo Belem](https://github.com/rbelem)'s efforts, the "
|
|
"playbook now supports bridging to [Skype](https://www.skype.com) via the "
|
|
"[mx-puppet-skype](https://github.com/Sorunome/mx-puppet-skype) bridge."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2662
|
|
msgid ""
|
|
"See our [Setting up MX Puppet Skype bridging](docs/configuring-playbook-"
|
|
"bridge-mx-puppet-skype.md) documentation page for getting started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2665
|
|
msgid "2020-04-05"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2667
|
|
msgid "Private Jitsi support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2669
|
|
msgid ""
|
|
"The [Jitsi support](#jitsi-support) we had landed a few weeks ago was "
|
|
"working well, but it was always open to the whole world."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2671
|
|
msgid ""
|
|
"Running such an open instance is not desirable to most people, so "
|
|
"[teutat3s](https://github.com/teutat3s) has contributed support for "
|
|
"making Jitsi use authentication."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2673
|
|
msgid ""
|
|
"To make your Jitsi server more private, see the [configure internal Jitsi"
|
|
" authentication and guests mode](docs/configuring-playbook-jitsi.md"
|
|
"#optional-configure-internal-jitsi-authentication-and-guests-mode) "
|
|
"section in our Jitsi documentation."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2676
|
|
msgid "2020-04-03"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2678
|
|
msgid "(Potential Backward Compatibility Break) ma1sd replaces mxisd"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2680
|
|
msgid ""
|
|
"Thanks to [Marcel Partap](https://github.com/eMPee584)'s efforts, the "
|
|
"[mxisd](https://github.com/kamax-io/mxisd) identity server, which has "
|
|
"been deprecated for a long time, has finally been replaced by "
|
|
"[ma1sd](https://github.com/ma1uta/ma1sd), a compatible fork."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2682
|
|
msgid ""
|
|
"**If you're using the default playbook configuration**, you don't need to"
|
|
" do anything -- your mxisd installation will be replaced with ma1sd and "
|
|
"all existing data will be migrated automatically the next time you run "
|
|
"the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2684
|
|
msgid ""
|
|
"**If you're doing something more special** (defining custom "
|
|
"`matrix_mxisd_*` variables), the playbook will ask you to rename them to "
|
|
"`matrix_ma1sd_*`. You're also encouraged to test that ma1sd works well "
|
|
"for such a more custom setup."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2687
|
|
msgid "2020-03-29"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2689
|
|
msgid "Archlinux support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2691
|
|
msgid ""
|
|
"Thanks to [Christian Lupus](https://github.com/christianlupus)'s efforts,"
|
|
" the playbook now supports installing to an "
|
|
"[Archlinux](https://www.archlinux.org/) server."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2694
|
|
msgid "2020-03-24"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2696
|
|
msgid "Jitsi support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2698
|
|
msgid ""
|
|
"The playbook can now (optionally) install the [Jitsi](https://jitsi.org/)"
|
|
" video-conferencing platform and integrate it with [Riot](docs"
|
|
"/configuring-playbook-riot-web.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2700
|
|
msgid ""
|
|
"See our [Jitsi documentation page](docs/configuring-playbook-jitsi.md) to"
|
|
" get started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2703
|
|
msgid "2020-03-15"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2705
|
|
msgid "Raspberry Pi support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2707
|
|
msgid ""
|
|
"Thanks to [Gergely Horváth](https://github.com/hooger)'s effort, the "
|
|
"playbook supports installing to a Raspberry Pi server, for at least some "
|
|
"of the services."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2709
|
|
msgid ""
|
|
"Since most ready-made container images do not support that architecture, "
|
|
"we achieve this by building images locally on the device itself. See our "
|
|
"[Self-building documentation page](docs/self-building.md) for how to get "
|
|
"started."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2712
|
|
msgid "2020-02-26"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2714
|
|
msgid "Riot-web themes are here"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2716
|
|
msgid "The playbook now makes it easy to install custom riot-web themes."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2718
|
|
msgid ""
|
|
"To learn more, take a look at our [riot-web documentation on Themes](docs"
|
|
"/configuring-playbook-riot-web.md#themes)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2721
|
|
msgid "2020-02-24"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2723
|
|
msgid "Customize the server name in Riot's login page"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2725
|
|
msgid ""
|
|
"You can now customize the server name string that Riot-web displays in "
|
|
"its login page."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2727
|
|
msgid "These playbook variables, with these default values, have been added:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2733
|
|
msgid ""
|
|
"The login page previously said \"Sign in to your Matrix account on "
|
|
"matrix.example.org\" (the homeserver's domain name). It will now say "
|
|
"\"Sign in … on example.org\" (the server name) by default, or \"Sign in …"
|
|
" on Our Server\" if you set the variable to \"Our Server\"."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2735
|
|
msgid ""
|
|
"To support this, the config.json template is changed to use the "
|
|
"configuration key `default_server_config` for setting the default HS/IS, "
|
|
"and the new configuration key `server_name` is added in there."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2738
|
|
msgid "2020-01-30"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2740
|
|
msgid "Disabling TLSv1.1"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2742
|
|
msgid ""
|
|
"To improve security, we've removed TLSv1.1 support from our default "
|
|
"matrix-nginx-proxy configuration."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2744
|
|
msgid ""
|
|
"If you need to support old clients, you can re-enable it with the "
|
|
"following configuration: `matrix_nginx_proxy_ssl_protocols: \"TLSv1.1 "
|
|
"TLSv1.2 TLSv1.3\"`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2747
|
|
msgid "2020-01-21"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2749
|
|
msgid "Postgres collation changes (action required!)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2751
|
|
msgid ""
|
|
"By default, we've been using a UTF-8 collation for Postgres. This is "
|
|
"known to cause Synapse some troubles (see the [relevant "
|
|
"issue](https://github.com/matrix-org/synapse/issues/6722)) on systems "
|
|
"that use [glibc](https://www.gnu.org/software/libc/). We run Postgres in "
|
|
"an [Alpine Linux](https://alpinelinux.org/) container (which uses "
|
|
"[musl](https://www.musl-libc.org/), and not glibc), so our users are "
|
|
"likely not affected by the index corruption problem observed by others."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2753
|
|
msgid ""
|
|
"Still, we might become affected in the future. In any case, it's imminent"
|
|
" that Synapse will complain about databases which do not use a C "
|
|
"collation."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2755
|
|
msgid "To avoid future problems, we recommend that you run the following command:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2761
|
|
msgid ""
|
|
"It forces a [Postgres database upgrade](docs/maintenance-postgres.md"
|
|
"#upgrading-postgresql), which would recreate your Postgres database using"
|
|
" the proper (`C`) collation. If you are low on disk space, or run into "
|
|
"trouble, refer to the Postgres database upgrade documentation page."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2764
|
|
msgid "2020-01-14"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2766
|
|
msgid "Added support for Appservice Webhooks"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2768
|
|
msgid ""
|
|
"Thanks to a contribution from [Björn "
|
|
"Marten](https://github.com/tripleawwy) from "
|
|
"[netresearch](https://www.netresearch.de/), the playbook can now install "
|
|
"and configure [matrix-appservice-webhooks](https://github.com/turt2live"
|
|
"/matrix-appservice-webhooks) for you. This bridge provides support for "
|
|
"Slack-compatible webhooks."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2770
|
|
msgid ""
|
|
"Learn more in [Setting up Appservice Webhooks bridging](docs/configuring-"
|
|
"playbook-bridge-appservice-webhooks.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2773
|
|
msgid "2020-01-12"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2775
|
|
msgid "Added support for automatic Double Puppeting for all Mautrix bridges"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2777
|
|
msgid ""
|
|
"Double Puppeting can now be easily enabled for all Mautrix bridges "
|
|
"supported by the playbook (Facebook, Hangouts, Whatsapp, Telegram)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2779
|
|
msgid ""
|
|
"This is possible due to those bridges' integration with [matrix-synapse-"
|
|
"shared-secret-auth](https://github.com/devture/matrix-synapse-shared-"
|
|
"secret-auth) - yet another component that this playbook can install for "
|
|
"you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2781
|
|
msgid ""
|
|
"To get started, following the playbook's documentation for the bridge "
|
|
"you'd like to configure."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2784
|
|
msgid "2019-12-06"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2786
|
|
msgid "Added support for an alternative method for using another webserver"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2788
|
|
msgid ""
|
|
"We have added support for making `matrix-nginx-proxy` not being so "
|
|
"invasive, so that it would be easier to [use your own webserver](docs"
|
|
"/configuring-playbook-own-webserver.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2790
|
|
msgid ""
|
|
"The documentation has been updated with a **Method 2**, which might make "
|
|
"\"own webserver\" setup easier in some cases (such as [reverse-proxying "
|
|
"using Traefik](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/issues/296))."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2792
|
|
msgid ""
|
|
"**Existing users** are not affected by this and **don't need to change "
|
|
"anything**. The defaults are still the same (`matrix-nginx-proxy` "
|
|
"obtaining SSL certificates and doing everything for you automatically)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2795
|
|
msgid "2019-11-10"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2797
|
|
msgid "Tightened security around room directory publishing"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2799
|
|
msgid ""
|
|
"As per this [advisory blog post](https://matrix.org/blog/2019/11/09"
|
|
"/avoiding-unwelcome-visitors-on-private-matrix-servers), we've decided to"
|
|
" change the default publishing rules for the Matrix room directory."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2801
|
|
msgid ""
|
|
"Our general goal is to favor privacy and security when running personal "
|
|
"(family & friends) and corporate homeservers. Both of these likely "
|
|
"benefit from having a more secure default of **not showing the room "
|
|
"directory without authentication** and **not publishing the room "
|
|
"directory over federation**."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2803
|
|
msgid ""
|
|
"As with anything else, these new defaults can be overriden by changing "
|
|
"the `matrix_synapse_allow_public_rooms_without_auth` and "
|
|
"`matrix_synapse_allow_public_rooms_over_federation` variables, "
|
|
"respectively."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2806
|
|
msgid "2019-10-05"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2808
|
|
msgid "Improved Postgres upgrading/importing"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2810
|
|
msgid ""
|
|
"Postgres [upgrading](docs/maintenance-postgres.md#upgrading-postgresql) "
|
|
"and [importing](docs/importing-postgres.md) have been improved to add "
|
|
"support for multiple databases and roles."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2812
|
|
msgid ""
|
|
"Previously, the playbook would only take care of the `homeserver` "
|
|
"database and `synapse` user. We now back up and restore all databases and"
|
|
" users on the Postgres server."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2814
|
|
msgid ""
|
|
"For now, the playbook only uses that one database (`homeserver`) and that"
|
|
" one single user (`synapse`), so it's all the same. However, in the "
|
|
"future, additional components besides Synapse may also make use the "
|
|
"Postgres database server. One such example is the [matrix-appservice-"
|
|
"slack](https://github.com/matrix-org/matrix-appservice-slack) bridge, "
|
|
"which strongly encourages use of Postgres in its v1.0 release. We are yet"
|
|
" to upgrade to it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2816
|
|
msgid ""
|
|
"Additionally, Postgres [upgrading](docs/maintenance-postgres.md"
|
|
"#upgrading-postgresql) now uses gzipped dump files by default, to "
|
|
"minimize disk space usage."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2819
|
|
msgid "2019-10-04"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2821
|
|
msgid "Postgres 12 support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2823
|
|
msgid ""
|
|
"The playbook now installs [Postgres "
|
|
"12](https://www.postgresql.org/about/news/1976/) by default."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2825
|
|
msgid ""
|
|
"If you have have an existing setup, it's likely running on an older "
|
|
"Postgres version (9.x, 10.x or 11.x). You can easily upgrade by following"
|
|
" the [upgrading PostgreSQL guide](docs/maintenance-postgres.md#upgrading-"
|
|
"postgresql)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2828
|
|
msgid "2019-10-03"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2830
|
|
msgid "Synapse 1.4.0"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2832
|
|
msgid ""
|
|
"Synapse 1.4.0 [is "
|
|
"out](https://matrix.org/blog/2019/10/03/synapse-1-4-0-released) with lots"
|
|
" of changes related to privacy."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2834
|
|
msgid ""
|
|
"Its new defaults (which we adopt as well) mean that certain old data will"
|
|
" automatically get purged after a certain number of days. 1.4.0 "
|
|
"automatically garbage collects redacted messages (defaults to 7 days) and"
|
|
" removes unused IP and user agent information stored in the user_ips "
|
|
"table (defaults to 30 days). If you'd like to preserve this data, we "
|
|
"encourage you to look at the `redaction_retention_period` and "
|
|
"`user_ips_max_age` options (controllable by the "
|
|
"`matrix_synapse_redaction_retention_period` and "
|
|
"`matrix_synapse_user_ips_max_age` playbook variables, respectively) "
|
|
"before doing the upgrade. If you'd like to keep data indefinitely, set "
|
|
"these variables to `null` (e.g. "
|
|
"`matrix_synapse_redaction_retention_period: ~`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2836
|
|
msgid ""
|
|
"From now on the `trusted_key_servers` setting for Synapse is "
|
|
"configurable. It still defaults to `matrix.org` just like it always has, "
|
|
"but in a more explicit way now. If you'd like to use another trusted key "
|
|
"server, adjust the `matrix_synapse_trusted_key_servers` playbook "
|
|
"variable."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2838
|
|
msgid ""
|
|
"Synapse 1.4.0 also changes lots of things related to identity server "
|
|
"integration. Because Synapse will now by default be responsible for "
|
|
"validating email addresses for user accounts, running without an identity"
|
|
" server looks more feasible. We still [have "
|
|
"concerns](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/pull/275/files#r331104117) over disabling the identity server by "
|
|
"default, so for now it remains enabled."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2841
|
|
msgid "2019-09-09"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2843
|
|
msgid "Synapse Simple Antispam support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2845
|
|
msgid ""
|
|
"There have been lots of invite-spam attacks lately and "
|
|
"[Travis](https://github.com/t2bot) has created a Synapse module "
|
|
"([synapse-simple-antispam](https://github.com/t2bot/synapse-simple-"
|
|
"antispam)) to let people protect themselves."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2847
|
|
msgid ""
|
|
"From now on, you can easily install and configure this spam checker "
|
|
"module through the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2849
|
|
msgid ""
|
|
"Learn more in [Setting up Synapse Simple Antispam](docs/configuring-"
|
|
"playbook-synapse-simple-antispam.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2852
|
|
msgid "2019-08-25"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2854
|
|
msgid "Extensible Riot-web configuration"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2856
|
|
msgid ""
|
|
"Similarly to [Extensible Synapse configuration](#extensible-synapse-"
|
|
"configuration) (below), Riot-web configuration is also extensible now."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2858
|
|
msgid ""
|
|
"From now on, you can extend/override Riot-web's configuration by making "
|
|
"use of the `matrix_riot_web_configuration_extension_json` variable. This "
|
|
"should be enough for most customization needs."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2860
|
|
msgid ""
|
|
"If you need even more power, you can now also take full control and "
|
|
"override `matrix_riot_web_configuration_default` (or "
|
|
"`matrix_riot_web_configuration`) directly."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2862
|
|
msgid ""
|
|
"Learn more in [Configuring Riot-web](docs/configuring-playbook-riot-"
|
|
"web.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2865
|
|
msgid "2019-08-22"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2867
|
|
msgid "Extensible Synapse configuration"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2869
|
|
msgid ""
|
|
"Previously, we had to create custom Ansible variables for each and every "
|
|
"Synapse setting. This lead to too much effort (and configuration "
|
|
"ugliness) to all of Synapse's settings, so naturally, not all features of"
|
|
" Synapse could be controlled through the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2871
|
|
msgid ""
|
|
"From now on, you can extend/override the Synapse server's configuration "
|
|
"by making use of the `matrix_synapse_configuration_extension_yaml` "
|
|
"variable. This should be enough for most customization needs."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2873
|
|
msgid ""
|
|
"If you need even more power, you can now also take full control and "
|
|
"override `matrix_synapse_configuration` (or "
|
|
"`matrix_synapse_configuration_yaml`) directly."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2875
|
|
msgid ""
|
|
"Learn more here in [Configuring Synapse](docs/configuring-playbook-"
|
|
"synapse.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2878
|
|
msgid "2019-08-21"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2882
|
|
msgid ""
|
|
"Thanks to the [great work](https://github.com/spantaleev/matrix-docker-"
|
|
"ansible-deploy/pull/205) of "
|
|
"[kingoftheconnors](https://github.com/kingoftheconnors) and [Stuart "
|
|
"Mumford (Cadair)](https://github.com/Cadair), the playbook now supports "
|
|
"bridging to [Slack](https://slack.com) via the [appservice-"
|
|
"slack](https://github.com/matrix-org/matrix-appservice-slack) bridge."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2884
|
|
msgid ""
|
|
"Additional details are available in [Setting up Appservice Slack "
|
|
"bridging](docs/configuring-playbook-bridge-appservice-slack.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2886
|
|
msgid "Google Hangouts bridging support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2888
|
|
msgid ""
|
|
"Thanks to the [great work](https://github.com/spantaleev/matrix-docker-"
|
|
"ansible-deploy/pull/251) of [Eduardo Beltrame "
|
|
"(Munfred)](https://github.com/Munfred) and [Robbie D "
|
|
"(microchipster)](https://github.com/microchipster), the playbook now "
|
|
"supports bridging to [Google Hangouts](https://hangouts.google.com/) via "
|
|
"the [mautrix-hangouts](https://mau.dev/tulir/mautrix-hangouts) bridge."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2890
|
|
msgid ""
|
|
"Additional details are available in [Setting up Mautrix Hangouts "
|
|
"bridging](docs/configuring-playbook-bridge-mautrix-hangouts.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2893
|
|
msgid "2019-08-05"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2895
|
|
msgid "Email2Matrix support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2897
|
|
msgid ""
|
|
"Support for [Email2Matrix](https://github.com/devture/email2matrix) has "
|
|
"been added."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2899
|
|
msgid "It's an optional feature that you can enable via the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2901
|
|
msgid ""
|
|
"To learn more, see the [playbook's documentation on Email2Matrix](./docs"
|
|
"/configuring-playbook-email2matrix.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2904
|
|
msgid "2019-08-03"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2906
|
|
msgid "Synapse logging level has been reduced to WARNING"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2908
|
|
msgid ""
|
|
"After [some discussion in our support "
|
|
"room](https://matrix.to/#/!PukFFdIcHgtaaHZflT:devture.com/$156476852524179TBeKy:matrix.org?via=devture.com&via=matrix.org&via=librem.one),"
|
|
" we've decided to change the default logging level for Synapse from "
|
|
"`INFO` to `WARNING`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2910
|
|
msgid ""
|
|
"This greatly reduces the number of log messages that are being logged, "
|
|
"leading to:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2912
|
|
msgid "much less disk space dedicated to Synapse and thus, logs kept for longer"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2913
|
|
msgid ""
|
|
"easier to find some important `WARNING`, `ERROR` and `CRITICAL` messages,"
|
|
" as they're not longer buried in thousands of non-important `INFO` "
|
|
"messages"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2915
|
|
msgid ""
|
|
"If you'd like to track down an issue, you [can always increase the "
|
|
"logging level as described here](./docs/maintenance-and-"
|
|
"troubleshooting.md#increasing-synapse-logging)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2918
|
|
msgid "2019-07-08"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2920
|
|
msgid "Synapse Maintenance docs and synapse-janitor support are available"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2922
|
|
msgid "The playbook can now help you with Synapse's maintenance."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2924
|
|
msgid ""
|
|
"There's a new documentation page about [Synapse maintenance](./docs"
|
|
"/maintenance-synapse.md) and another section on [Postgres "
|
|
"vacuuming](./docs/maintenance-postgres.md#vacuuming-postgresql)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2926
|
|
msgid ""
|
|
"Among other things, if your Postgres database has grown significantly "
|
|
"over time, you may wish to [ask the playbook to purge unused data with "
|
|
"synapse-janitor](./docs/maintenance-synapse.md#purging-unused-data-with-"
|
|
"synapse-janitor) for you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2928
|
|
msgid "(BC Break) Rename run control variables"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2930
|
|
msgid "Some internal playbook control variables have been renamed."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2932
|
|
msgid ""
|
|
"This change **only affects people who run this playbook's roles from "
|
|
"another playbook**. If you're using this playbook as-is, you're not "
|
|
"affected and don't need to do anything."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2934
|
|
msgid "The following variables have been renamed:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2936
|
|
msgid "from `run_import_postgres` to `run_postgres_import`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2937
|
|
msgid "from `run_import_sqlite_db` to `run_postgres_import_sqlite_db`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2938
|
|
msgid "from `run_upgrade_postgres` to `run_postgres_upgrade`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2939
|
|
msgid "from `run_import_media_store` to `run_synapse_import_media_store`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2940
|
|
msgid "from `run_register_user` to `run_synapse_register_user`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2941
|
|
msgid "from `run_update_user_password` to `run_synapse_update_user_password`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2944
|
|
msgid "2019-07-04"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2946
|
|
msgid "Synapse no longer logs to text files"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2948
|
|
msgid ""
|
|
"Following what the official Synapse Docker image is doing "
|
|
"([#5565](https://github.com/matrix-org/synapse/pull/5565)) and what we've"
|
|
" been doing for mostly everything installed by this playbook, **Synapse "
|
|
"no longer logs to text files** (`/matrix/synapse/run/homeserver.log*`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2950
|
|
msgid ""
|
|
"From now on, Synapse would only log to console, which goes to systemd's "
|
|
"journald. To see Synapse's logs, execute: `journalctl -fu matrix-synapse`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2952
|
|
msgid ""
|
|
"Because of this, the following variables have become obsolete and were "
|
|
"removed:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2954
|
|
msgid "`matrix_synapse_max_log_file_size_mb`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2955
|
|
msgid "`matrix_synapse_max_log_files_count`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2957
|
|
msgid ""
|
|
"To prevent confusion, it'd be better if you delete all old files manually"
|
|
" after you've upgraded (`rm -f /matrix/synapse/run/homeserver.log*`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2959
|
|
msgid ""
|
|
"Because Synapse is incredibly chatty when it comes to logging (here's "
|
|
"[one such issue](https://github.com/matrix-org/synapse/issues/4751) "
|
|
"describing the problem), if you're running an ancient distribution (like "
|
|
"CentOS 7.0), be advised that systemd's journald default logging "
|
|
"restrictions may not be high enough to capture all log messages generated"
|
|
" by Synapse. This is especially true if you've got a busy (Synapse) "
|
|
"server. We advise that you manually add `RateLimitInterval=0` and "
|
|
"`RateLimitBurst=0` under `[Storage]` in the `/etc/systemd/journald.conf` "
|
|
"file, followed by restarting the logging service (`systemctl restart "
|
|
"systemd-journald`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2962
|
|
msgid "2019-06-27"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2964
|
|
msgid ""
|
|
"(BC Break) Discord bridge configuration is now entirely managed by the "
|
|
"playbook"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2966
|
|
msgid ""
|
|
"Until now, the `config.yaml` file for the [Discord bridge](docs"
|
|
"/configuring-playbook-bridge-appservice-discord.md) was managed by the "
|
|
"playbook, but the `registration.yaml` file was not."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2968
|
|
msgid "From now on, the playbook will keep both configuration files sync for you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2970
|
|
msgid ""
|
|
"This means that if you were making manual changes to the `/matrix"
|
|
"/appservice-discord/discord-registration.yaml` configuration file, those "
|
|
"would be lost the next time you run the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2972
|
|
msgid ""
|
|
"The bridge now stores configuration in a subdirectory (`/matrix"
|
|
"/appservice-discord/config`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2974
|
|
msgid ""
|
|
"Likewise, data is now also stored in a subdirectory (`/matrix/appservice-"
|
|
"discord/data`). When you run the playbook with an existing database file "
|
|
"(`/matrix/appservice-discord/discord.db`), the playbook will stop the "
|
|
"bridge and relocate the database file to the `./data` directory. There's "
|
|
"no data-loss involved. You'll need to restart the bridge manually though "
|
|
"(`--tags=start`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2976
|
|
msgid ""
|
|
"The main directory (`/matrix/appservice-discord`) may contain some "
|
|
"leftover files (`user-store.db`, `room-store.db`, `config.yaml`, "
|
|
"`discord-registration.yaml`, `invite_link`). These are no longer "
|
|
"necessary and can be deleted manually."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2978
|
|
msgid ""
|
|
"We're now following the default sample configuration for the Discord "
|
|
"bridge. If you need to override some values, define them in "
|
|
"`matrix_appservice_discord_configuration_extension_yaml`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2981
|
|
msgid "2019-06-24"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2983
|
|
msgid ""
|
|
"(BC Break) WhatsApp bridge configuration is now entirely managed by the "
|
|
"playbook"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2985
|
|
msgid ""
|
|
"Until now, configuration files for the [WhatsApp bridge](docs"
|
|
"/configuring-playbook-bridge-mautrix-whatsapp.md) were created by the "
|
|
"playbook initially, but never modified later on."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2987 ../../../CHANGELOG.md:3004
|
|
#: ../../../CHANGELOG.md:3023 ../../../CHANGELOG.md:3062
|
|
msgid "From now on, the playbook will keep the configuration in sync for you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2989
|
|
msgid ""
|
|
"This means that if you were making manual changes to the `/matrix"
|
|
"/mautrix-whatsapp/config.yaml` or `/matrix/mautrix-"
|
|
"whatsapp/registration.yaml` configuration files, those would be lost the "
|
|
"next time you run the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2991
|
|
msgid ""
|
|
"The bridge now stores configuration in a subdirectory (`/matrix/mautrix-"
|
|
"whatsapp/config`), so your old configuration remains in the base "
|
|
"directory (`/matrix/mautrix-whatsapp`). You need to migrate any manual "
|
|
"changes over to the new "
|
|
"`matrix_mautrix_whatsapp_configuration_extension_yaml` variable, so that "
|
|
"the playbook would apply them for you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2993
|
|
msgid ""
|
|
"Likewise, data is now also stored in a subdirectory (`/matrix/mautrix-"
|
|
"whatsapp/data`). When you run the playbook with an existing database file"
|
|
" (`/matrix/mautrix-whatsapp/mautrix-whatsapp.db`), the playbook will stop"
|
|
" the bridge and relocate the database file to the `./data` directory. "
|
|
"There's no data-loss involved. You'll need to restart the bridge manually"
|
|
" though (`--tags=start`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2995
|
|
msgid "We're now following the default configuration for the WhatsApp bridge."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:2998
|
|
msgid "2019-06-20"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3000
|
|
msgid ""
|
|
"(BC Break) IRC bridge configuration is now entirely managed by the "
|
|
"playbook"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3002
|
|
msgid ""
|
|
"Until now, configuration files for the [IRC bridge](docs/configuring-"
|
|
"playbook-bridge-appservice-irc.md) were created by the playbook "
|
|
"initially, but never modified later on."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3006
|
|
msgid ""
|
|
"This means that if you were making manual changes to the `/matrix"
|
|
"/appservice-irc/config.yaml` or `/matrix/appservice-"
|
|
"irc/registration.yaml` configuration files, those would be lost the next "
|
|
"time you run the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3008
|
|
msgid ""
|
|
"The bridge now stores configuration in a subdirectory (`/matrix"
|
|
"/appservice-irc/config`), so your old configuration remains in the base "
|
|
"directory (`/matrix/appservice-irc`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3010
|
|
msgid ""
|
|
"Previously, we asked people to configure bridged IRC servers by extending"
|
|
" the bridge configuration "
|
|
"(`matrix_appservice_irc_configuration_extension_yaml`). While this is "
|
|
"still possible and will continue working forever, **we now recommend "
|
|
"defining IRC servers in the easier to use "
|
|
"`matrix_appservice_irc_ircService_servers` variable**. See [our IRC "
|
|
"bridge documentation page](docs/configuring-playbook-bridge-appservice-"
|
|
"irc.md) for an example."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3012
|
|
msgid ""
|
|
"If you decide to continue using "
|
|
"`matrix_appservice_irc_configuration_extension_yaml`, you might be "
|
|
"interested to know that `ircService.databaseUri` and a few other keys now"
|
|
" have default values in the base configuration "
|
|
"(`matrix_appservice_irc_configuration_yaml`). You may wish to stop "
|
|
"redefining those keys, unless you really intend to override them. You "
|
|
"most likely only need to override `ircService.servers`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3014
|
|
msgid ""
|
|
"Bridge data (`passkey.pem` and database files) is now also stored in a "
|
|
"subdirectory (`/matrix/appservice-irc/data`). When you run the playbook "
|
|
"with an existing `/matrix/appservice-irc/passkey.pem` file, the playbook "
|
|
"will stop the bridge and relocate the passkey and database files "
|
|
"(`rooms.db` and `users.db`) to the `./data` directory. There's no data-"
|
|
"loss involved. You'll need to restart the bridge manually though "
|
|
"(`--tags=start`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3017
|
|
msgid "2019-06-15"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3019
|
|
msgid ""
|
|
"(BC Break) Telegram bridge configuration is now entirely managed by the "
|
|
"playbook"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3021
|
|
msgid ""
|
|
"Until now, configuration files for the [Telegram bridge](docs"
|
|
"/configuring-playbook-bridge-mautrix-telegram.md) were created by the "
|
|
"playbook initially, but never modified later on."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3025
|
|
msgid ""
|
|
"This means that if you were making manual changes to the `/matrix"
|
|
"/mautrix-telegram/config.yaml` or `/matrix/mautrix-"
|
|
"telegram/registration.yaml` configuration files, those would be lost the "
|
|
"next time you run the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3027
|
|
msgid ""
|
|
"The bridge now stores configuration in a subdirectory (`/matrix/mautrix-"
|
|
"telegram/config`), so your old configuration remains in the base "
|
|
"directory (`/matrix/mautrix-telegram`). You need to migrate any manual "
|
|
"changes over to the new "
|
|
"`matrix_mautrix_telegram_configuration_extension_yaml` variable, so that "
|
|
"the playbook would apply them for you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3029
|
|
msgid ""
|
|
"Likewise, data is now also stored in a subdirectory (`/matrix/mautrix-"
|
|
"telegram/data`). When you run the playbook with an existing database file"
|
|
" (`/matrix/mautrix-telegram/mautrix-telegram.db`), the playbook will stop"
|
|
" the bridge and relocate the database file to the `./data` directory. "
|
|
"There's no data-loss involved. You'll need to restart the bridge manually"
|
|
" though (`--tags=start`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3031
|
|
msgid ""
|
|
"Also, we're now following the default configuration for the Telegram "
|
|
"bridge, so some default configuration values are different:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3033
|
|
msgid ""
|
|
"`edits_as_replies` (used to be `false`, now `true`) - previously replies "
|
|
"were not sent over to Matrix at all; ow they are sent over as a reply to "
|
|
"the original message"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3034
|
|
msgid ""
|
|
"`inline_images` (used to be `true`, now `false`) - this has to do with "
|
|
"captioned images. Inline-image (included caption) are said to exhibit "
|
|
"troubles on Riot iOS. When `false`, the caption arrives on the Matrix "
|
|
"side as a separate message."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3035
|
|
msgid ""
|
|
"`authless_portals` (used to be `false`, now `true`) - creating portals "
|
|
"from the Telegram side is now possible"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3036
|
|
msgid ""
|
|
"`whitelist_group_admins` (used to be `false`, now `true`) - allows "
|
|
"Telegram group admins to use the bot commands"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3038
|
|
msgid ""
|
|
"If the new values are not to your liking, use "
|
|
"`matrix_mautrix_telegram_configuration_extension_yaml` to specify an "
|
|
"override (refer to `matrix_mautrix_telegram_configuration_yaml` to figure"
|
|
" out which variable goes where)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3041
|
|
msgid "2019-06-12"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3043
|
|
msgid "Synapse v1.0"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3045
|
|
msgid ""
|
|
"With [Synapse v1.0 now available](https://matrix.org/blog/2019/06/11"
|
|
"/introducing-matrix-1-0-and-the-matrix-org-foundation) and most people "
|
|
"being on at least Synapse v0.99, it's time to remove the `_matrix._tcp` "
|
|
"DNS SRV record that we've been keeping for compatibility with old Synapse"
|
|
" versions (<= 0.34)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3047
|
|
msgid ""
|
|
"According to the [Server Discovery "
|
|
"specification](https://matrix.org/docs/spec/server_server/r0.1.2.html"
|
|
"#server-discovery), it's no harm to keep the DNS SRV record. But since "
|
|
"it's not necessary for federating with the larger Matrix network anymore,"
|
|
" you should be safe to get rid of it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3049
|
|
msgid ""
|
|
"**Note**: don't confuse the `_matrix._tcp` and `_matrix-identity._tcp` "
|
|
"DNS SRV records. The latter, **must not** be removed."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3051
|
|
msgid ""
|
|
"For completeness, we must say that using a `_matrix._tcp` [SRV record for"
|
|
" Server Delegation](docs/howto-server-delegation.md#server-delegation-"
|
|
"via-a-dns-srv-record-advanced) is still valid and useful for certain "
|
|
"deployments. It's just that our guide recommends the [`/.well-"
|
|
"known/matrix/server` Server Delegation method](docs/howto-server-"
|
|
"delegation.md#server-delegation-via-a-well-known-file), due to its easier"
|
|
" implementation when using this playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3053
|
|
msgid ""
|
|
"Besides this optional/non-urgent DNS change, assuming you're already on "
|
|
"Synapse v0.99, upgrading to Synapse v1.0 should be as simple as [re-"
|
|
"running the playbook](docs/maintenance-upgrading-services.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3056
|
|
msgid "2019-06-07"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3058
|
|
msgid ""
|
|
"(BC Break) Facebook bridge configuration is now entirely managed by the "
|
|
"playbook"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3060
|
|
msgid ""
|
|
"Until now, configuration files for the [Facebook bridge](docs"
|
|
"/configuring-playbook-bridge-mautrix-facebook.md) were created by the "
|
|
"playbook initially, but never modified later on."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3064
|
|
msgid ""
|
|
"This means that if you were making manual changes to the `/matrix"
|
|
"/mautrix-facebook/config.yaml` or `/matrix/mautrix-"
|
|
"facebook/registration.yaml` configuration files, those would be lost the "
|
|
"next time you run the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3066
|
|
msgid ""
|
|
"The bridge now stores configuration in a subdirectory (`/matrix/mautrix-"
|
|
"facebook/config`), so your old configuration remains in the base "
|
|
"directory (`/matrix/mautrix-facebook`). You need to migrate any manual "
|
|
"changes over to the new "
|
|
"`matrix_mautrix_facebook_configuration_extension_yaml` variable, so that "
|
|
"the playbook would apply them for you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3068
|
|
msgid ""
|
|
"Likewise, data is now also stored in a subdirectory (`/matrix/mautrix-"
|
|
"facebook/data`). When you run the playbook with an existing database file"
|
|
" (`/matrix/mautrix-facebook/mautrix-facebook.db`), the playbook will stop"
|
|
" the bridge and relocate the database file to the `./data` directory. "
|
|
"There's no data-loss involved. You'll need to restart the bridge manually"
|
|
" though (`--tags=start`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3071
|
|
msgid "2019-05-25"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3073
|
|
msgid "Support for exposing container ports publicly (not just to the host)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3075
|
|
msgid ""
|
|
"Until now, various roles supported a `matrix_*_expose_port` variable, "
|
|
"which would expose their container's port to the host. This was mostly "
|
|
"useful for reverse-proxying manually (in case `matrix-nginx-proxy` was "
|
|
"disabled). It could also be used for installing some playbook services "
|
|
"(e.g. bridges, etc.) and wiring them to a separate (manual) Matrix setup."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3077
|
|
msgid ""
|
|
"`matrix_*_expose_port` variables were not granular enough - sometimes "
|
|
"they would expose one port, other times multiple. They also didn't "
|
|
"provide control over **where** to expose (to which port number and to "
|
|
"which network interface), because they would usually hardcode something "
|
|
"like `127.0.0.1:8080`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3079
|
|
msgid ""
|
|
"All such variables have been superseded by a better (more flexible) way "
|
|
"to do it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3081
|
|
msgid ""
|
|
"**Most** people (including those not using `matrix-nginx-proxy`), **don't"
|
|
" need** to bother with this."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3083
|
|
msgid "Porting examples follow for people having more customized setups:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3085
|
|
msgid ""
|
|
"**from** `matrix_synapse_container_expose_client_api_port: true` **to** "
|
|
"`matrix_synapse_container_client_api_host_bind_port: '127.0.0.1:8008'`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3087
|
|
msgid ""
|
|
"**from** `matrix_synapse_container_expose_federation_api_port: true` "
|
|
"**to** `matrix_synapse_container_federation_api_plain_host_bind_port: "
|
|
"'127.0.0.1:8048'` and possibly "
|
|
"`matrix_synapse_container_federation_api_tls_host_bind_port: '8448'`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3089
|
|
msgid ""
|
|
"**from** `matrix_synapse_container_expose_metrics_port: true` **to** "
|
|
"`matrix_synapse_container_metrics_api_host_bind_port: '127.0.0.1:9100'`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3091
|
|
msgid ""
|
|
"**from** `matrix_riot_web_container_expose_port: true` **to** "
|
|
"`matrix_riot_web_container_http_host_bind_port: '127.0.0.1:8765'`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3093
|
|
msgid ""
|
|
"**from** `matrix_mxisd_container_expose_port: true` **to** "
|
|
"`matrix_mxisd_container_http_host_bind_port: '127.0.0.1:8090'`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3095
|
|
msgid ""
|
|
"**from** `matrix_dimension_container_expose_port: true` **to** "
|
|
"`matrix_dimension_container_http_host_bind_port: '127.0.0.1:8184'`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3097
|
|
msgid ""
|
|
"**from** `matrix_corporal_container_expose_ports: true` **to** "
|
|
"`matrix_corporal_container_http_gateway_host_bind_port: "
|
|
"'127.0.0.1:41080'` and possibly "
|
|
"`matrix_corporal_container_http_api_host_bind_port: '127.0.0.1:41081'`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3099
|
|
msgid ""
|
|
"**from** `matrix_appservice_irc_container_expose_client_server_api_port: "
|
|
"true` **to** `matrix_appservice_irc_container_http_host_bind_port: "
|
|
"'127.0.0.1:9999'`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3101
|
|
msgid ""
|
|
"**from** "
|
|
"`matrix_appservice_discord_container_expose_client_server_api_port: true`"
|
|
" **to** `matrix_appservice_discord_container_http_host_bind_port: "
|
|
"'127.0.0.1:9005'`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3103
|
|
msgid ""
|
|
"As always, if you forget to remove usage of some outdated variable, the "
|
|
"playbook will warn you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3106
|
|
msgid "2019-05-23"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3108
|
|
msgid "(BC Break) Ansible 2.8 compatibility"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3110
|
|
msgid ""
|
|
"Thanks to [@danbob](https://github.com/danbob), the playbook now "
|
|
"[supports the new Ansible 2.8](https://github.com/spantaleev/matrix-"
|
|
"docker-ansible-deploy/pull/187)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3112
|
|
msgid ""
|
|
"A manual change is required to the `inventory/hosts` file, changing the "
|
|
"group name from `matrix-servers` to `matrix_servers` (dash to "
|
|
"underscore)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3114
|
|
msgid "To avoid doing it manually, run this:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3115
|
|
msgid "Linux: `sed -i 's/matrix-servers/matrix_servers/g' inventory/hosts`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3116
|
|
msgid "Mac: `sed -i '' 's/matrix-servers/matrix_servers/g' inventory/hosts`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3119
|
|
msgid "2019-05-21"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3121
|
|
msgid "Synapse no longer required"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3123
|
|
msgid ""
|
|
"The playbook no longer insists on installing [Synapse](https://github.com"
|
|
"/element-hq/synapse) via the `matrix-synapse` role."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3125
|
|
msgid ""
|
|
"If you would prefer to install Synapse another way and just use the "
|
|
"playbook to install other services, it should be possible "
|
|
"(`matrix_synapse_enabled: false`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3127
|
|
msgid ""
|
|
"Note that it won't necessarily be the best experience, since the playbook"
|
|
" wires things to Synapse by default. If you're using your own Synapse "
|
|
"instance (especially one not running in a container), you may have to "
|
|
"override many variables to point them to the correct place."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3129
|
|
msgid ""
|
|
"Having Synapse not be a required component potentially opens the door for"
|
|
" installing alternative Matrix homeservers."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3131
|
|
msgid "Bridges are now separate from the Synapse role"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3133
|
|
msgid ""
|
|
"Bridges are no longer part of the `matrix-synapse` role. Each bridge now "
|
|
"lives in its own separate role (`roles/custom/matrix-bridge-*`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3135
|
|
msgid ""
|
|
"These bridge roles are independent of the `matrix-synapse` role, so it "
|
|
"should be possible to use them with a Synapse instance installed another "
|
|
"way (not through the playbook)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3137
|
|
msgid "Renaming inconsistently-named Synapse variables"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3139
|
|
msgid "For better consistency, the following variables have been renamed:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3141
|
|
msgid ""
|
|
"`matrix_enable_room_list_search` was renamed to "
|
|
"`matrix_synapse_enable_room_list_search`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3142
|
|
msgid ""
|
|
"`matrix_alias_creation_rules` was renamed to "
|
|
"`matrix_synapse_alias_creation_rules`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3143
|
|
msgid ""
|
|
"`matrix_nginx_proxy_matrix_room_list_publication_rulesdata_path` was "
|
|
"renamed to `matrix_synapse_room_list_publication_rules`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3146
|
|
msgid "2019-05-09"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3148
|
|
msgid ""
|
|
"Besides a myriad of bug fixes and minor improvements, here are the more "
|
|
"notable (bigger) features we can announce today."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3150
|
|
msgid "Mautrix Facebook/Messenger bridging support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3152
|
|
msgid ""
|
|
"The playbook now supports bridging with "
|
|
"[Facebook](https://www.facebook.com/) by installing the [mautrix-"
|
|
"facebook](https://github.com/tulir/mautrix-facebook) bridge. This "
|
|
"playbook functionality is available thanks to "
|
|
"[@izissise](https://github.com/izissise)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3154
|
|
msgid ""
|
|
"Additional details are available in [Setting up Mautrix Facebook "
|
|
"bridging](docs/configuring-playbook-bridge-mautrix-facebook.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3156
|
|
msgid "mxisd Registration feature integration"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3158
|
|
msgid ""
|
|
"The playbook can now help you integrate with mxisd's "
|
|
"[Registration](https://github.com/kamax-"
|
|
"matrix/mxisd/blob/master/docs/features/registration.md) feature."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3160
|
|
msgid ""
|
|
"Learn more in [mxisd-controlled Registration](docs/configuring-playbook-"
|
|
"mxisd.md#mxisd-controlled-registration)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3163
|
|
msgid "2019-04-16"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3165
|
|
msgid "Caddy webserver examples"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3167
|
|
msgid ""
|
|
"If you prefer using the [Caddy](https://caddyserver.com/) webserver "
|
|
"instead of our own integrated nginx, we now have examples for it in the "
|
|
"[`examples/caddy`](examples/caddy) directory"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3169
|
|
msgid "2019-04-10"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3171
|
|
msgid "Goofys support for other S3-compatible object stores"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3173
|
|
msgid ""
|
|
"Until now, you could optionally host Synapse's media repository on Amazon"
|
|
" S3, but we now also support [using other S3-compatible object "
|
|
"stores](docs/configuring-playbook-s3.md),"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3176
|
|
msgid "2019-04-03"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3178
|
|
msgid "Ansible >= 2.5 is required"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3180
|
|
msgid ""
|
|
"Due to recent playbook improvements and the fact that the world keeps "
|
|
"turning, we're bumping the [version requirement for "
|
|
"Ansible](docs/ansible.md#supported-ansible-versions) (2.4 -> 2.5)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3182
|
|
msgid ""
|
|
"We've also started building our own Docker image of Ansible "
|
|
"([devture/ansible](https://hub.docker.com/r/devture/ansible/)), which is "
|
|
"useful for people who can't upgrade their local Ansible installation (see"
|
|
" [Using Ansible via Docker](docs/ansible.md#using-ansible-via-docker))."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3185
|
|
msgid "2019-03-19"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3187
|
|
msgid "TLS support for Coturn"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3189
|
|
msgid ""
|
|
"We've added TLS support to the Coturn TURN server installed by the "
|
|
"playbook by default. The certificates from the Matrix domain will be used"
|
|
" for the Coturn server."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3191
|
|
msgid ""
|
|
"This feature is enabled by default for new installations. To make use of "
|
|
"TLS support for your existing Matrix server's Coturn, make sure to "
|
|
"rebuild both Coturn and Synapse:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3197
|
|
msgid ""
|
|
"People who have an extra firewall (besides the iptables firewall, which "
|
|
"Docker manages automatically), will need to open these additional "
|
|
"firewall ports: `5349/tcp` (TURN over TCP) and `5349/udp` (TURN over "
|
|
"UDP)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3199
|
|
msgid ""
|
|
"People who build their own custom playbook from our roles should be aware"
|
|
" that:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3201
|
|
msgid ""
|
|
"the `matrix-coturn` role and actually starting Coturn (e.g. "
|
|
"`--tags=start`), requires that certificates are already put in place. For"
|
|
" this reason, it's usually a good idea to have the `matrix-coturn` role "
|
|
"execute after `matrix-nginx-proxy` (which retrieves the certificates)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3203
|
|
msgid ""
|
|
"there are a few variables that can help you enable TLS support for "
|
|
"Coturn. See the `matrix-coturn` section in [group_vars/matrix-"
|
|
"servers](./group_vars/matrix-servers)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3206
|
|
msgid "2019-03-12"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3208
|
|
msgid "matrix-nginx-proxy support for serving the base domain"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3210
|
|
msgid ""
|
|
"If you don't have a dedicated server for your base domain and want to set"
|
|
" up [Server Delegation via a well-known file](docs/howto-server-"
|
|
"delegation.md#server-delegation-via-a-well-known-file), the playbook has "
|
|
"got you covered now."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3212
|
|
msgid ""
|
|
"It's now possible for the playbook to obtain an SSL certificate and serve"
|
|
" the necessary files for Matrix Server Delegation on your base domain. "
|
|
"Take a look at the new [Serving the base domain](docs/configuring-"
|
|
"playbook-base-domain-serving.md) documentation page."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3214
|
|
msgid "(BC break) matrix-nginx-proxy data variable renamed"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3216
|
|
msgid ""
|
|
"`matrix_nginx_proxy_data_path` was renamed to "
|
|
"`matrix_nginx_proxy_base_path`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3218
|
|
msgid ""
|
|
"There's a new `matrix_nginx_proxy_data_path` variable, which has a "
|
|
"different use-purpose now (it's a subdirectory of "
|
|
"`matrix_nginx_proxy_base_path` and is meant for storing various data "
|
|
"files)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3221
|
|
msgid "2019-03-10"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3223
|
|
msgid "Dimension integration manager support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3225
|
|
msgid ""
|
|
"Thanks to [NullIsNot0](https://github.com/NullIsNot0), the playbook can "
|
|
"now (optionally) install the [Dimension](https://dimension.t2bot.io/) "
|
|
"integration manager. To learn more, see the [Setting up Dimension](docs"
|
|
"/configuring-playbook-dimension.md) documentation page."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3228
|
|
msgid "2019-03-07"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3230
|
|
msgid "Ability to customize mxisd's email templates"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3232
|
|
msgid ""
|
|
"Thanks to [Sylvia van Os](https://github.com/TheLastProject), mxisd's "
|
|
"email templates can now be customized easily. To learn more, see the "
|
|
"[Customizing email templates](docs/configuring-playbook-mxisd.md"
|
|
"#customizing-email-templates) documentation page."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3235
|
|
msgid "2019-03-05"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3237
|
|
msgid "Discord bridging support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3239
|
|
msgid ""
|
|
"[@Lionstiger](https://github.com/Lionstiger) has done some great work "
|
|
"adding Discord bridging support via [matrix-appservice-"
|
|
"discord](https://github.com/matrix-org/matrix-appservice-discord). To "
|
|
"learn more, see the [Setting up Appservice Discord bridging](docs"
|
|
"/configuring-playbook-bridge-appservice-discord.md) documentation page."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3242
|
|
msgid "2019-02-19"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3244
|
|
msgid "Renaming variables"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3246 ../../../CHANGELOG.md:3563
|
|
#: ../../../CHANGELOG.md:3648 ../../../CHANGELOG.md:3768
|
|
msgid "The following playbook variables were renamed:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3248
|
|
msgid "from `host_specific_hostname_identity` to `matrix_domain`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3249
|
|
msgid "from `hostname_identity` to `matrix_domain`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3250
|
|
msgid "from `hostname_matrix` to `matrix_server_fqn_matrix`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3251
|
|
msgid "from `hostname_riot` to `matrix_server_fqn_riot`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3252
|
|
msgid ""
|
|
"from `host_specific_matrix_ssl_lets_encrypt_support_email` to "
|
|
"`matrix_ssl_lets_encrypt_support_email`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3254
|
|
msgid ""
|
|
"Doing that, we've simplified things, made names less confusing "
|
|
"(hopefully) and moved all variable names under the `matrix_` prefix."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3257
|
|
msgid "2019-02-16"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3259
|
|
msgid "Riot v1.0.1 support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3261
|
|
msgid "You can now use the brand new and redesigned Riot."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3263
|
|
msgid ""
|
|
"The new version no longer has a homepage by default, so we've also "
|
|
"removed the custom homepage that we've been installing."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3265
|
|
msgid ""
|
|
"However, we still provide you with hooks to install your own `home.html` "
|
|
"file by specifying the `matrix_riot_web_embedded_pages_home_path` "
|
|
"variable (used to be called `matrix_riot_web_homepage_template` before)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3268
|
|
msgid "2019-02-14"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3270
|
|
msgid "Synapse v0.99.1"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3272
|
|
msgid ""
|
|
"As we're moving toward Synapse v1.0, things are beginning to stabilize. "
|
|
"Upgrading from v0.99.0 to v0.99.1 should be painless."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3274
|
|
msgid ""
|
|
"If you've been overriding the default configuration so that you can "
|
|
"terminate TLS at the Synapse side (`matrix_synapse_no_tls: false`), "
|
|
"you'll now have to replace this custom configuration with "
|
|
"`matrix_synapse_tls_federation_listener_enabled: true`. The "
|
|
"`matrix_synapse_no_tls` variable is no more."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3277
|
|
msgid "2019-02-06"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3279
|
|
msgid "Synapse v0.99 support and preparation for Synapse v1.0"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3281
|
|
msgid ""
|
|
"Matrix is undergoing a lot of changes as it matures towards Synapse v1.0."
|
|
" The first step is the Synapse v0.99 transitional release, which this "
|
|
"playbook now supports."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3283
|
|
msgid ""
|
|
"If you've been using this playbook successfully until now, you'd be aware"
|
|
" that we've been doing [Server Delegation](docs/howto-server-"
|
|
"delegation.md) using a `_matrix._tcp` DNS SRV record (as per [Configuring"
|
|
" DNS](docs/configuring-dns.md))."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3285
|
|
msgid ""
|
|
"Due to changes related to certificate file requirements that will affect "
|
|
"us at Synapse v1.0, we'll have to stop using a **`_matrix._tcp` DNS SRV "
|
|
"record in the future** (when Synapse goes to v1.0 - around 5th of March "
|
|
"2019). We **still need to keep the SRV record for now**, for backward "
|
|
"compatibility with older Synapse versions (lower than v0.99)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3287
|
|
msgid ""
|
|
"**What you need to do now** is make use of this transitional Synapse "
|
|
"v0.99 release to **prepare your federation settings for the future**. You"
|
|
" have 2 choices to prepare yourself for compatibility with the future "
|
|
"Synapse v1.0:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3289
|
|
msgid ""
|
|
"(recommended) set up [Server Delegation via a well-known file](docs"
|
|
"/howto-server-delegation.md#server-delegation-via-a-well-known-file), "
|
|
"unless you are affected by the [Downsides of well-known-based Server "
|
|
"Delegation](docs/howto-server-delegation.md#downsides-of-well-known-"
|
|
"based-server-delegation). If you had previously set up the well-known "
|
|
"`client` file, depending on how you've done it, it may be that there is "
|
|
"nothing new required of you (besides [upgrading](docs/maintenance-"
|
|
"upgrading-services.md)). After upgrading, you can [run a self-check](docs"
|
|
"/maintenance-checking-services.md), which will tell you if you need to do"
|
|
" anything extra with regard to setting up [Server Delegation via a well-"
|
|
"known file](docs/howto-server-delegation.md#server-delegation-via-a-well-"
|
|
"known-file). After some time, when most people have upgraded to Synapse "
|
|
"v0.99 and older releases have disappeared, be prepared to drop your "
|
|
"`_matrix._tcp` SRV record."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3291
|
|
msgid ""
|
|
"(more advanced) if the [Downsides of well-known-based Server "
|
|
"Delegation](docs/howto-server-delegation.md#downsides-of-well-known-"
|
|
"based-server-delegation) are not to your liking, **as an alternative**, "
|
|
"you can set up [Server Delegation via a DNS SRV record](docs/howto-"
|
|
"server-delegation.md#server-delegation-via-a-dns-srv-record-advanced). In"
|
|
" such a case, you get to keep using your existing `_matrix._tcp` DNS SRV "
|
|
"record forever and need to NOT set up a `/.well-known/matrix/server` "
|
|
"file. Don't forget that you need to do certificate changes though. Follow"
|
|
" the guide at [Server Delegation via a DNS SRV record](docs/howto-server-"
|
|
"delegation.md#server-delegation-via-a-dns-srv-record-advanced)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3294
|
|
msgid "2019-02-01"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3296
|
|
msgid "TLS v1.3 support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3298
|
|
msgid ""
|
|
"Now that the [nginx Docker image](https://hub.docker.com/_/nginx) has "
|
|
"[added support for TLS v1.3](https://github.com/nginxinc/docker-"
|
|
"nginx/issues/190), we have enabled that protocol by default."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3300
|
|
msgid "When using:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3302
|
|
msgid ""
|
|
"the **integrated nginx server**: TLS v1.3 support might not kick in "
|
|
"immediately, because the nginx version hasn't been bumped and you may "
|
|
"have an older build of the nginx Docker image (currently "
|
|
"`nginx:1.15.8-alpine`). Typically, we do not re-pull images that you "
|
|
"already have. When the nginx version gets bumped in the future, everyone "
|
|
"will get the update. Until then, you could manually force-pull the "
|
|
"rebuilt Docker image by running this on the server: `docker pull "
|
|
"nginx:1.15.8-alpine`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3304
|
|
msgid ""
|
|
"**your own external nginx server**: if your external nginx server is too "
|
|
"old, the new configuration we generate for you in `/matrix/nginx-"
|
|
"proxy/conf.d/` might not work anymore, because it mentions `TLSv1.3` and "
|
|
"your nginx version might not support that. You can adjust the SSL "
|
|
"protocol list by overriding the `matrix_nginx_proxy_ssl_protocols` "
|
|
"variable. Learn more in the documentation page for [Using your own "
|
|
"webserver, instead of this playbook's nginx proxy](docs/configuring-"
|
|
"playbook-own-webserver.md)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3306
|
|
msgid ""
|
|
"**another web server**: you don't need to do anything to accommodate this"
|
|
" change"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3309
|
|
msgid "2019-01-31"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3311
|
|
msgid "IRC bridging support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3313
|
|
msgid ""
|
|
"[Devon Maloney (@Plailect)](https://github.com/Plailect) has done some "
|
|
"great work bringing IRC bridging support via [matrix-appservice-"
|
|
"irc](https://github.com/TeDomum/matrix-appservice-irc). To learn more, "
|
|
"see the [Setting up Appservice IRC bridging](docs/configuring-playbook-"
|
|
"bridge-appservice-irc.md) documentation page."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3316
|
|
msgid "2019-01-29"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3318
|
|
msgid ""
|
|
"Running container processes as non-root, without capabilities and read-"
|
|
"only"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3320
|
|
msgid ""
|
|
"To improve security, this playbook no longer starts container processes "
|
|
"as the `root` user. Most containers were dropping privileges anyway, but "
|
|
"we were trusting them with `root` privileges until they would do that. "
|
|
"Not anymore -- container processes now start as a non-root user (usually "
|
|
"`matrix`) from the get-go."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3322
|
|
msgid ""
|
|
"For additional security, various capabilities are also dropped (see [why "
|
|
"it's important](https://github.com/projectatomic/atomic-site/issues/203))"
|
|
" for all containers."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3324
|
|
msgid ""
|
|
"Additionally, most containers now use a read-only filesystem (see [why "
|
|
"it's important](https://www.projectatomic.io/blog/2015/12/making-docker-"
|
|
"images-write-only-in-production/)). Containers are given write access "
|
|
"only to the directories they need to write to."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3326
|
|
msgid ""
|
|
"A minor breaking change is the "
|
|
"`matrix_nginx_proxy_proxy_matrix_client_api_client_max_body_size` "
|
|
"variable having being renamed to "
|
|
"`matrix_nginx_proxy_proxy_matrix_client_api_client_max_body_size_mb` "
|
|
"(note the `_mb` suffix). The new variable expects a number value (e.g. "
|
|
"`25M` -> `25`). If you weren't customizing this variable, this wouldn't "
|
|
"affect you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3328
|
|
msgid "matrix-mailer is now based on Exim, not Postfix"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3330
|
|
msgid ""
|
|
"While we would have preferred to stay with "
|
|
"[Postfix](http://www.postfix.org/), we found out that it cannot run as a "
|
|
"non-root user. We've had to replace it with [Exim](https://www.exim.org/)"
|
|
" (via the [devture/exim-relay](https://hub.docker.com/r/devture/exim-"
|
|
"relay) container image)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3332
|
|
msgid ""
|
|
"The internal `matrix-mailer` service (running in a container) now listens"
|
|
" on port `8025` (used to be `587` before). The playbook will update your "
|
|
"Synapse and mxisd email settings to match (`matrix-mailer:587` -> "
|
|
"`matrix-mailer:8025`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3334
|
|
msgid ""
|
|
"Using the [devture/exim-relay](https://hub.docker.com/r/devture/exim-"
|
|
"relay) container image instead of "
|
|
"[panubo/postfix](https://hub.docker.com/r/panubo/postfix/) also gives us "
|
|
"a nice disk usage reduction (~200MB -> 8MB)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3337
|
|
msgid "2019-01-17"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3339
|
|
msgid "(BC Break) Making the playbook's roles more independent of one another"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3341
|
|
msgid ""
|
|
"The following change **affects people running a more non-standard setup**"
|
|
" - external Postgres or using our roles in their own other playbook. "
|
|
"**Most users don't need to do anything**, besides becoming aware of the "
|
|
"new glue variables file [`group_vars/matrix-servers`](group_vars/matrix-"
|
|
"servers)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3344
|
|
msgid ""
|
|
"Because people like using the playbook's components independently "
|
|
"(outside of this playbook) and because it's much better for "
|
|
"maintainability, we've continued working on separating them. Still, we'd "
|
|
"like to offer a turnkey solution for running a fully-featured Matrix "
|
|
"server, so this playbook remains important for wiring up the various "
|
|
"components."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3346
|
|
msgid ""
|
|
"With the new changes, **all roles are now only dependent on the minimal "
|
|
"`matrix-base` role**. They are no longer dependent among themselves."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3348
|
|
msgid ""
|
|
"In addition, the following components can now be completely disabled (for"
|
|
" those who want/need to):"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3349
|
|
msgid "`matrix-coturn` by using `matrix_coturn_enabled: false`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3350
|
|
msgid "`matrix-mailer` by using `matrix_mailer_enabled: false`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3351
|
|
msgid "`matrix-postgres` by using `matrix_postgres_enabled: false`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3353
|
|
msgid "The following changes had to be done:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3355
|
|
msgid ""
|
|
"glue variables had to be introduced to the playbook, so it can wire "
|
|
"together the various components. Those glue vars are stored in the "
|
|
"[`group_vars/matrix-servers`](group_vars/matrix-servers) file. When "
|
|
"overriding variables for a given component (role), you need to be aware "
|
|
"of both the role defaults (`role/ROLE/defaults/main.yml`) and the role's "
|
|
"corresponding section in the [`group_vars/matrix-servers`](group_vars"
|
|
"/matrix-servers) file."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3357
|
|
msgid ""
|
|
"`matrix_postgres_use_external` has been superceeded by the more "
|
|
"consistently named `matrix_postgres_enabled` variable and a few other "
|
|
"`matrix_synapse_database_` variables. See the [Using an external "
|
|
"PostgreSQL server (optional)](docs/configuring-playbook-external-"
|
|
"postgres.md) documentation page for an up-to-date replacement."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3359
|
|
msgid ""
|
|
"Postgres tools (`matrix-postgres-cli` and `matrix-make-user-admin`) are "
|
|
"no longer installed if you're not enabling the `matrix-postgres` role "
|
|
"(`matrix_postgres_enabled: false`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3361
|
|
msgid ""
|
|
"roles, being more independent now, are more minimal and do not do so much"
|
|
" magic for you. People that are building their own playbook using our "
|
|
"roles will definitely need to take a look at the [`group_vars/matrix-"
|
|
"servers`](group_vars/matrix-servers) file and adapt their playbooks with "
|
|
"the same (or similar) wiring logic."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3364
|
|
msgid "2019-01-16"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3366
|
|
msgid "Splitting the playbook into multiple roles"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3368
|
|
msgid ""
|
|
"For better maintainability, the playbook logic (which all used to reside "
|
|
"in a single `matrix-server` role) has been split out into a number of "
|
|
"different roles: `matrix-synapse`, `matrix-postgres`, `matrix-riot-web`, "
|
|
"`matrix-mxisd`, etc. (see the `roles/` directory)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3371
|
|
msgid ""
|
|
"To keep the filesystem more consistent with this separation, the "
|
|
"**Postgres data had to be relocated**."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3373
|
|
msgid ""
|
|
"The default value of `matrix_postgres_data_path` was changed from "
|
|
"`/matrix/postgres` to `/matrix/postgres/data`. The `/matrix/postgres` "
|
|
"directory is what we consider a base path now (new variable "
|
|
"`matrix_postgres_base_path`). **Your Postgres data files will "
|
|
"automatically be relocated by the playbook** (`/matrix/postgres/*` -> "
|
|
"`/matrix/postgres/data/`) when you run with `--tags=setup-all` (or "
|
|
"`--tags=setup-postgres`). While this shouldn't cause data-loss, **it's "
|
|
"better if you do a Postgres backup just in case**. You'd need to restart "
|
|
"all services after this migration (`--tags=start`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3376
|
|
msgid "2019-01-11"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3378
|
|
msgid "(BC Break) mxisd configuration changes"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3380
|
|
msgid ""
|
|
"To be more flexible and to support the upcoming "
|
|
"[mxisd](https://github.com/kamax-io/mxisd) 1.3.0 (when it gets released),"
|
|
" we've had to redo how mxisd gets configured."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3383
|
|
msgid "The following variables are no longer supported by this playbook:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3385
|
|
msgid "`matrix_mxisd_ldap_enabled`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3386
|
|
msgid "`matrix_mxisd_ldap_connection_host`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3387
|
|
msgid "`matrix_mxisd_ldap_connection_tls`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3388
|
|
msgid "`matrix_mxisd_ldap_connection_port`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3389
|
|
msgid "`matrix_mxisd_ldap_connection_baseDn`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3390
|
|
msgid "`matrix_mxisd_ldap_connection_baseDns`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3391 ../../../CHANGELOG.md:3392
|
|
msgid "`matrix_mxisd_ldap_connection_bindDn`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3393 ../../../CHANGELOG.md:3397
|
|
msgid "`matrix_mxisd_ldap_connection_bindPassword`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3394
|
|
msgid "`matrix_mxisd_ldap_filter`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3395
|
|
msgid "`matrix_mxisd_ldap_attribute_uid_type`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3396
|
|
msgid "`matrix_mxisd_ldap_attribute_uid_value`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3398
|
|
msgid "`matrix_mxisd_ldap_attribute_name`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3399
|
|
msgid "`matrix_mxisd_ldap_attribute_threepid_email`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3400
|
|
msgid "`matrix_mxisd_ldap_attribute_threepid_msisdn`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3401
|
|
msgid "`matrix_mxisd_ldap_identity_filter`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3402
|
|
msgid "`matrix_mxisd_ldap_identity_medium`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3403
|
|
msgid "`matrix_mxisd_ldap_auth_filter`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3404
|
|
msgid "`matrix_mxisd_ldap_directory_filter`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3405
|
|
msgid "`matrix_mxisd_template_config`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3407
|
|
msgid ""
|
|
"You are encouraged to use the `matrix_mxisd_configuration_extension_yaml`"
|
|
" variable to define your own mxisd configuration additions and overrides."
|
|
" Refer to the [default variables file](roles/custom/matrix-"
|
|
"mxisd/defaults/main.yml) for more information."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3409
|
|
msgid "This new way of configuring mxisd is beneficial because:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3411
|
|
msgid ""
|
|
"it lets us support all mxisd configuration options, as the playbook "
|
|
"simply forwards them to mxisd without needing to care or understand them"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3412
|
|
msgid ""
|
|
"it lets you upgrade to newer mxisd versions and make use of their "
|
|
"features, without us having to add support for them explicitly"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3415
|
|
msgid "2019-01-08"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3417
|
|
msgid "(BC Break) Cronjob schedule no longer configurable"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3419
|
|
msgid ""
|
|
"Due to the way we manage cronjobs now, you can no longer configure the "
|
|
"schedule they're invoked at."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3421
|
|
msgid ""
|
|
"If you were previously using "
|
|
"`matrix_ssl_lets_encrypt_renew_cron_time_definition` or "
|
|
"`matrix_nginx_proxy_reload_cron_time_definition` to set a custom "
|
|
"schedule, you should note that these variables don't affect anything "
|
|
"anymore."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3424
|
|
msgid ""
|
|
"If you miss this functionality, please [open an "
|
|
"Issue](https://github.com/spantaleev/matrix-docker-ansible-"
|
|
"deploy/issues/new) and let us know about your use case!"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3427
|
|
msgid "2018-12-23"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3429
|
|
msgid "(BC Break) More SSL certificate retrieval methods"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3431
|
|
msgid ""
|
|
"The playbook now lets you decide between 3 different SSL certificate "
|
|
"retrieval methods:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3432
|
|
msgid "(default) obtaining free SSL certificates from Let's Encrypt"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3433
|
|
msgid "generating self-signed SSL certificates"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3434
|
|
msgid "managing SSL certificates manually"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3436
|
|
msgid ""
|
|
"Learn more in [Adjusting SSL certificate retrieval](docs/configuring-"
|
|
"playbook-ssl-certificates.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3438
|
|
msgid ""
|
|
"For people who use Let's Encrypt (mostly everyone, since it's the "
|
|
"default), you'll also have to rename a variable in your configuration:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3440
|
|
msgid "before: `host_specific_matrix_ssl_support_email`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3441
|
|
msgid "after: `host_specific_matrix_ssl_lets_encrypt_support_email`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3443
|
|
msgid "(BC Break) mxisd upgrade with multiple base DN support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3445
|
|
msgid ""
|
|
"mxisd has bee upgraded to [version 1.2.2](https://github.com/kamax-"
|
|
"matrix/mxisd/releases/tag/v1.2.2), which supports [multiple base "
|
|
"DNs](https://github.com/kamax-"
|
|
"matrix/mxisd/blob/v1.2.2/docs/stores/ldap.md#base)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3447
|
|
msgid ""
|
|
"If you were configuring this playbook's "
|
|
"`matrix_mxisd_ldap_connection_baseDn` variable until now (a string "
|
|
"containing a single base DN), you'll need to change to configuring the "
|
|
"`matrix_mxisd_ldap_connection_baseDns` variable (an array containing "
|
|
"multiple base DNs)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3449
|
|
msgid "Example change:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3451
|
|
msgid "before: `matrix_mxisd_ldap_connection_baseDn: OU=Users,DC=example,DC=org`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3452
|
|
msgid ""
|
|
"after: `matrix_mxisd_ldap_connection_baseDns: "
|
|
"['OU=Users,DC=example,DC=org']`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3455
|
|
msgid "2018-12-21"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3457
|
|
msgid "Synapse 0.34.0 and Python 3"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3459
|
|
msgid ""
|
|
"Synapse has been upgraded to 0.34.0 and now uses Python 3. Based on "
|
|
"feedback from others, running Synapse on Python 3 is supposed to decrease"
|
|
" memory usage significantly (~2x)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3462
|
|
msgid "2018-12-12"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3464
|
|
msgid "Riot homepage customization"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3466
|
|
msgid ""
|
|
"You can now customize some parts of the Riot homepage (or even completely"
|
|
" replace it with your own custom page). See the "
|
|
"`matrix_riot_web_homepage_` variables in `roles/custom/matrix-riot-"
|
|
"web/defaults/main.yml`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3469
|
|
msgid "2018-12-04"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3471
|
|
msgid "mxisd extensibility"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3473
|
|
msgid ""
|
|
"The [LDAP identity store for mxisd](https://github.com/kamax-"
|
|
"matrix/mxisd/blob/master/docs/stores/ldap.md) can now be configured "
|
|
"easily using playbook variables (see the `matrix_mxisd_ldap_` variables "
|
|
"in `roles/custom/matrix-server/defaults/main.yml`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3476
|
|
msgid "2018-11-28"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3478
|
|
msgid "More scripts"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3480
|
|
msgid "matrix-remove-all allows to uninstall everything with a single command"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3481
|
|
msgid "matrix-make-user-admin allows to upgrade a user's privileges"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3483
|
|
msgid "LDAP auth support via matrix-synapse-ldap3"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3485
|
|
msgid ""
|
|
"The playbook can now install and configure [LDAP auth "
|
|
"support](https://github.com/matrix-org/matrix-synapse-ldap3) for you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3487
|
|
msgid ""
|
|
"Additional details are available in [Setting up the LDAP authentication "
|
|
"password provider module](docs/configuring-playbook-ldap-auth.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3490
|
|
msgid "2018-11-23"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3492
|
|
msgid "Support for controlling public registration and room auto-join"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3494
|
|
msgid ""
|
|
"The playbook now lets you enable public registration for users "
|
|
"(controlled via `matrix_synapse_enable_registration`). By default, public"
|
|
" registration is forbidden."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3496
|
|
msgid ""
|
|
"You can also make people automatically get auto-joined to rooms "
|
|
"(controlled via `matrix_synapse_auto_join_rooms`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3498
|
|
msgid "Support for changing the welcome user ID (welcome bot)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3500
|
|
msgid ""
|
|
"By default, `@riot-bot:matrix.org` is used to welcome newly registered "
|
|
"users. This can be changed to something else (or disabled) via the new "
|
|
"`matrix_riot_web_welcome_user_id` variable."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3503
|
|
msgid "2018-11-14"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3505
|
|
msgid "Ability to set Synapse log levels"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3507
|
|
msgid ""
|
|
"The playbook now allows you to set the log levels used by Synapse. The "
|
|
"default logging levels remain the same."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3509
|
|
msgid ""
|
|
"You can now override following variables with any of the supported log "
|
|
"levels listed here: https://docs.python.org/3/library/logging.html"
|
|
"#logging-levels"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3518
|
|
msgid "2018-11-03"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3520
|
|
msgid "Customize parts of Riot's config"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3522
|
|
msgid ""
|
|
"You can now customize some parts of Riot's `config.json`. These playbook "
|
|
"variables, with these default values, have been added:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3533
|
|
msgid ""
|
|
"This now allows you use a custom integration manager like "
|
|
"[Dimension](https://dimension.t2bot.io). For example, if you wish to use "
|
|
"the Dimension instance hosted at dimension.t2bot.io, you can set the "
|
|
"following in your vars.yml file:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3542
|
|
msgid "SSL protocols used to serve Riot and Synapse"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3544
|
|
msgid ""
|
|
"There's now a new `matrix_nginx_proxy_ssl_protocols` playbook variable, "
|
|
"which controls the SSL protocols used to serve Riot and Synapse. Its "
|
|
"default value is `TLSv1.1 TLSv1.2`. This playbook previously used `TLSv1 "
|
|
"TLSv1.1 TLSv1.2` to serve Riot and Synapse."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3546
|
|
msgid ""
|
|
"You may wish to reenable TLSv1 if you need to access Riot in older "
|
|
"browsers."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3548
|
|
msgid ""
|
|
"Note: Currently the dockerized nginx doesn't support TLSv1.3. See "
|
|
"https://github.com/nginxinc/docker-nginx/issues/190 for more details."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3551
|
|
msgid "2018-11-01"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3553
|
|
msgid "Postgres 11 support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3555
|
|
msgid ""
|
|
"The playbook now installs [Postgres "
|
|
"11](https://www.postgresql.org/about/news/1894/) by default."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3557
|
|
msgid ""
|
|
"If you have have an existing setup, it's likely running on an older "
|
|
"Postgres version (9.x or 10.x). You can easily upgrade by following the "
|
|
"[upgrading PostgreSQL guide](docs/maintenance-postgres.md#upgrading-"
|
|
"postgresql)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3559 ../../../CHANGELOG.md:3646
|
|
#: ../../../CHANGELOG.md:3766
|
|
msgid "(BC Break) Renaming playbook variables"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3561
|
|
msgid ""
|
|
"Due to the large amount of features added to this playbook lately, to "
|
|
"keep things manageable we've had to reorganize its configuration "
|
|
"variables a bit."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3565
|
|
msgid "from `matrix_docker_image_mxisd` to `matrix_mxisd_docker_image`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3566
|
|
msgid ""
|
|
"from `matrix_docker_image_mautrix_telegram` to "
|
|
"`matrix_mautrix_telegram_docker_image`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3567
|
|
msgid ""
|
|
"from `matrix_docker_image_mautrix_whatsapp` to "
|
|
"`matrix_mautrix_whatsapp_docker_image`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3568
|
|
msgid "from `matrix_docker_image_mailer` to `matrix_mailer_docker_image`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3569
|
|
msgid "from `matrix_docker_image_coturn` to `matrix_coturn_docker_image`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3570
|
|
msgid "from `matrix_docker_image_goofys` to `matrix_s3_goofys_docker_image`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3571
|
|
msgid "from `matrix_docker_image_riot` to `matrix_riot_web_docker_image`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3572
|
|
msgid "from `matrix_docker_image_nginx` to `matrix_nginx_proxy_docker_image`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3573
|
|
msgid "from `matrix_docker_image_synapse` to `matrix_synapse_docker_image`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3574
|
|
msgid ""
|
|
"from `matrix_docker_image_postgres_v9` to "
|
|
"`matrix_postgres_docker_image_v9`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3575
|
|
msgid ""
|
|
"from `matrix_docker_image_postgres_v10` to "
|
|
"`matrix_postgres_docker_image_v10`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3576
|
|
msgid ""
|
|
"from `matrix_docker_image_postgres_latest` to "
|
|
"`matrix_postgres_docker_image_latest`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3579
|
|
msgid "2018-10-26"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3581
|
|
msgid "Mautrix Whatsapp bridging support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3583
|
|
msgid ""
|
|
"The playbook now supports bridging with "
|
|
"[Whatsapp](https://www.whatsapp.com/) by installing the [mautrix-"
|
|
"whatsapp](https://github.com/tulir/mautrix-whatsapp) bridge. This "
|
|
"playbook functionality is available thanks to "
|
|
"[@izissise](https://github.com/izissise)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3585
|
|
msgid ""
|
|
"Additional details are available in [Setting up Mautrix Whatsapp "
|
|
"bridging](docs/configuring-playbook-bridge-mautrix-whatsapp.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3588
|
|
msgid "2018-10-25"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3590
|
|
msgid "Support for controlling Matrix federation"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3592
|
|
msgid ""
|
|
"The playbook can now help you with [Controlling Matrix federation](docs"
|
|
"/configuring-playbook-federation), should you wish to run a more private "
|
|
"(isolated) server."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3595
|
|
msgid "2018-10-24"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3597
|
|
msgid "Disabling riot-web guests"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3599
|
|
msgid ""
|
|
"From now on, Riot's configuration setting `disable_guests` would be set "
|
|
"to `true`. The homeserver was rejecting guests anyway, so this is just a "
|
|
"cosmetic change affecting Riot's UI."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3602
|
|
msgid "2018-10-21"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3604
|
|
msgid "Self-check maintenance command"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3606
|
|
msgid ""
|
|
"The playbook can now [check if services are configured correctly](docs"
|
|
"/maintenance-checking-services.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3609
|
|
msgid "2018-10-05"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3611
|
|
msgid "Presence tracking made configurable"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3613
|
|
msgid ""
|
|
"The playbook can now enable/disable user presence-status tracking in "
|
|
"Synapse, through the playbook's `matrix_synapse_use_presence` variable "
|
|
"(having a default value of `true` - enabled)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3615
|
|
msgid ""
|
|
"If users participate in large rooms with many other servers, disabling "
|
|
"presence will decrease server load significantly."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3618
|
|
msgid "2018-09-27"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3620
|
|
msgid "Synapse Cache Factor made configurable"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3622
|
|
msgid ""
|
|
"The playbook now makes the Synapse cache factor configurable, through the"
|
|
" playbook's `matrix_synapse_cache_factor` variable (having a default "
|
|
"value of `0.5`)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3624
|
|
msgid ""
|
|
"Changing that value allows you to potentially decrease RAM usage or to "
|
|
"increase performance by caching more stuff. Some information on it is "
|
|
"available here: https://github.com/element-hq/synapse#help-synapse-eats-"
|
|
"all-my-ram"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3627
|
|
msgid "2018-09-26"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3629
|
|
msgid "Disabling Docker container logging"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3631
|
|
msgid "`--log-driver=none` is used for all Docker containers now."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3633
|
|
msgid ""
|
|
"All these containers are started through systemd anyway and get logged in"
|
|
" journald, so there's no need for Docker to be logging the same thing "
|
|
"using the default `json-file` driver. Doing that was growing "
|
|
"`/var/lib/docker/containers/..` infinitely until service/container "
|
|
"restart."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3635
|
|
msgid ""
|
|
"As a result of this, things like `docker logs matrix-synapse` won't work "
|
|
"anymore. `journalctl -u matrix-synapse` is how one can see the logs."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3638
|
|
msgid "2018-09-17"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3640
|
|
msgid "Service discovery support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3642
|
|
msgid ""
|
|
"The playbook now helps you set up [service "
|
|
"discovery](https://matrix.org/docs/spec/client_server/r0.4.0.html#server-"
|
|
"discovery) using a `/.well-known/matrix/client` file."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3644
|
|
msgid ""
|
|
"Additional details are available in [Configuring service discovery via "
|
|
".well-known](docs/configuring-well-known.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3650
|
|
msgid "from `matrix_nginx_riot_web_data_path` to `matrix_riot_web_data_path`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3651
|
|
msgid ""
|
|
"from `matrix_riot_web_default_identity_server_url` to "
|
|
"`matrix_identity_server_url`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3654
|
|
msgid "2018-09-07"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3656
|
|
msgid "Mautrix Telegram bridging support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3658
|
|
msgid ""
|
|
"The playbook now supports bridging with [Telegram](https://telegram.org/)"
|
|
" by installing the [mautrix-telegram](https://github.com/tulir/mautrix-"
|
|
"telegram) bridge. This playbook functionality is available thanks to "
|
|
"[@izissise](https://github.com/izissise)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3660
|
|
msgid ""
|
|
"Additional details are available in [Setting up Mautrix Telegram "
|
|
"bridging](docs/configuring-playbook-bridge-mautrix-telegram.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3662
|
|
msgid "Events cache size increase and configurability for Matrix Synapse"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3664
|
|
msgid ""
|
|
"The playbook now lets you configure Matrix Synapse's `event_cache_size` "
|
|
"configuration via the `matrix_synapse_event_cache_size` playbook "
|
|
"variable."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3666
|
|
msgid ""
|
|
"Previously, this value was hardcoded to `\"10K\"`. From now on, a more "
|
|
"reasonable default of `\"100K\"` is used."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3668
|
|
msgid "Password-peppering support for Matrix Synapse"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3670
|
|
msgid ""
|
|
"The playbook now supports enabling password-peppering for increased "
|
|
"security in Matrix Synapse via the "
|
|
"`matrix_synapse_password_config_pepper` playbook variable. Using a "
|
|
"password pepper is disabled by default (just like it used to be before "
|
|
"this playbook variable got introduced) and is not to be enabled/disabled "
|
|
"after initial setup, as that would invalidate all existing passwords."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3672
|
|
msgid "Statistics-reporting support for Matrix Synapse"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3674
|
|
msgid ""
|
|
"There's now a new `matrix_synapse_report_stats` playbook variable, which "
|
|
"controls the `report_stats` configuration option for Matrix Synapse. It "
|
|
"defaults to `false`, so no change is required to retain your privacy."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3676
|
|
msgid ""
|
|
"If you'd like to start reporting statistics about your homeserver (things"
|
|
" like number of users, number of messages sent, uptime, load, etc.) to "
|
|
"matrix.org, you can turn on stats reporting."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3679
|
|
msgid "2018-08-29"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3681
|
|
msgid "Changing the way SSL certificates are retrieved"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3683
|
|
msgid ""
|
|
"We've been using [acmetool](https://github.com/hlandau/acme) (with the "
|
|
"[willwill/acme-docker](https://hub.docker.com/r/willwill/acme-docker/) "
|
|
"Docker image) until now."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3685
|
|
msgid ""
|
|
"Due to the Docker image being deprecated, and things looking bleak for "
|
|
"acmetool's support of the newer ACME v2 API endpoint, we've switched to "
|
|
"using [certbot](https://certbot.eff.org/) (with the "
|
|
"[certbot/certbot](https://hub.docker.com/r/certbot/certbot/) Docker "
|
|
"image)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3687
|
|
msgid ""
|
|
"Simply re-running the playbook will retrieve new certificates (via "
|
|
"certbot) for you. To ensure you don't leave any old files behind, though,"
|
|
" you'd better do this:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3689
|
|
msgid "`systemctl stop 'matrix*'`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3690
|
|
msgid ""
|
|
"stop your custom webserver, if you're running one (only affects you if "
|
|
"you've installed with `matrix_nginx_proxy_enabled: false`)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3691
|
|
msgid "`mv /matrix/ssl /matrix/ssl-acmetool-delete-later`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3692
|
|
msgid "re-run the playbook's [installation](docs/installing.md)"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3693
|
|
msgid "possibly delete `/matrix/ssl-acmetool-delete-later`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3696
|
|
msgid "2018-08-21"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3698
|
|
msgid "Matrix Corporal support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3700
|
|
msgid ""
|
|
"The playbook can now install and configure [matrix-"
|
|
"corporal](https://github.com/devture/matrix-corporal) for you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3702
|
|
msgid ""
|
|
"Additional details are available in [Setting up Matrix Corporal](docs"
|
|
"/configuring-playbook-matrix-corporal.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3705
|
|
msgid "2018-08-20"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3707
|
|
msgid "Matrix Synapse rate limit control variables"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3709
|
|
msgid ""
|
|
"The following new variables can now be configured to control Matrix "
|
|
"Synapse's rate-limiting (default values are shown below)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3716
|
|
msgid "Shared Secret Auth support via matrix-synapse-shared-secret-auth"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3718
|
|
msgid ""
|
|
"The playbook can now install and configure [matrix-synapse-shared-secret-"
|
|
"auth](https://github.com/devture/matrix-synapse-shared-secret-auth) for "
|
|
"you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3720
|
|
msgid ""
|
|
"Additional details are available in [Setting up the Shared Secret Auth "
|
|
"password provider module](docs/configuring-playbook-shared-secret-"
|
|
"auth.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3723
|
|
msgid "2018-08-17"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3725
|
|
msgid "REST auth support via matrix-synapse-rest-auth"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3727
|
|
msgid ""
|
|
"The playbook can now install and configure [matrix-synapse-rest-"
|
|
"auth](https://github.com/kamax-io/matrix-synapse-rest-auth) for you."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3729
|
|
msgid ""
|
|
"Additional details are available in [Setting up the REST authentication "
|
|
"password provider module](docs/configuring-playbook-rest-auth.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3731
|
|
msgid "Compression improvements"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3733
|
|
msgid ""
|
|
"Shifted Matrix Synapse compression from happening in the Matrix Synapse, "
|
|
"to happening in the nginx proxy that's in front of it."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3736
|
|
msgid ""
|
|
"Additionally, `riot-web` also gets compressed now (in the nginx proxy), "
|
|
"which drops the initial page load's size from 5.31MB to 1.86MB."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3739
|
|
msgid "Disabling some unnecessary Synapse services"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3741
|
|
msgid "The following services are not necessary, so they have been disabled:"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3742
|
|
msgid "on the federation port (8448): the `client` service"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3743
|
|
msgid ""
|
|
"on the http port (8008, exposed over 443): the old Angular `webclient` "
|
|
"and the `federation` service"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3745
|
|
msgid ""
|
|
"Federation runs only on the federation port (8448) now. The Client APIs "
|
|
"run only on the http port (8008) now."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3748
|
|
msgid "2018-08-15"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3750
|
|
msgid "mxisd Identity Server support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3752
|
|
msgid ""
|
|
"The playbook now sets up an [mxisd](https://github.com/kamax-io/mxisd) "
|
|
"Identity Server for you by default. Additional details are available in "
|
|
"[Setting up ma1sd Identity Server](docs/configuring-playbook-mxisd.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3755
|
|
msgid "2018-08-14"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3757
|
|
msgid "Email-sending support"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3759
|
|
msgid ""
|
|
"The playbook now configures an email-sending service (postfix) by "
|
|
"default. Additional details are available in [Adjusting email-sending "
|
|
"settings](docs/configuring-playbook-email.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3761
|
|
msgid ""
|
|
"With this, Matrix Synapse is able to send email notifications for missed "
|
|
"messages, etc."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3764
|
|
msgid "2018-08-08"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3770
|
|
msgid "from `matrix_max_upload_size_mb` to `matrix_synapse_max_upload_size_mb`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3771
|
|
msgid ""
|
|
"from `matrix_max_log_file_size_mb` to "
|
|
"`matrix_synapse_max_log_file_size_mb`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3772
|
|
msgid "from `matrix_max_log_files_count` to `matrix_synapse_max_log_files_count`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3773
|
|
msgid "from `docker_matrix_image` to `matrix_docker_image_synapse`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3774
|
|
msgid "from `docker_nginx_image` to `matrix_docker_image_nginx`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3775
|
|
msgid "from `docker_riot_image` to `matrix_docker_image_riot`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3776
|
|
msgid "from `docker_goofys_image` to `matrix_docker_image_goofys`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3777
|
|
msgid "from `docker_coturn_image` to `matrix_docker_image_coturn`"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3779
|
|
msgid ""
|
|
"If you're overriding any of them in your `vars.yml` file, you'd need to "
|
|
"change to the new names."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3781
|
|
msgid "Renaming Ansible playbook tag"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3783
|
|
msgid ""
|
|
"The command for executing the whole playbook has changed. The `setup-"
|
|
"main` tag got renamed to `setup-all`."
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3785
|
|
msgid "Docker container linking"
|
|
msgstr ""
|
|
|
|
#: ../../../CHANGELOG.md:3787
|
|
msgid ""
|
|
"Changed the way the Docker containers are linked together. The ones that "
|
|
"need to communicate with others operate in a `matrix` network now and not"
|
|
" in the default bridge network."
|
|
msgstr ""
|
|
|