matrix-docker-ansible-deploy/i18n/translation-templates/docs/configuring-playbook-federation.pot

86 lines
4.7 KiB
Plaintext
Raw Normal View History

# 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>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: matrix-docker-ansible-deploy \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-12-20 07:23+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../../docs/configuring-playbook-federation.md:1
msgid "Controlling Matrix federation (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:3
msgid "By default, your server federates with the whole Matrix network. That is, people on your server can communicate with people on any other Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:5
msgid "**Note**: in the sample `vars.yml` ([`examples/vars.yml`](../examples/vars.yml)), we recommend to use a short user ID like `@alice:example.com` instead of `@alice:matrix.example.com` and set up [server delegation](howto-server-delegation.md) / redirection. Without a proper configuration, your server will effectively not be part of the Matrix network. If you find your server is not federated, make sure to [check whether services work](maintenance-checking-services.md) and your server is properly delegated."
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:7
msgid "Federating only with select servers"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:9
msgid "To make your server only federate with servers of your choosing, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:17
msgid "If you wish to disable federation, you can do that with an empty list (`[]`), or better yet by completely disabling federation (see below)."
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:19
msgid "Exposing the room directory over federation"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:21
msgid "By default, your server's public rooms directory is not exposed to other servers via federation."
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:23
msgid "If you wish to expose it, add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:29
msgid "Disabling federation"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:31
msgid "To completely disable federation, isolating your server from the rest of the Matrix network, add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:37
msgid "With that, your server's users will only be able to talk among themselves, but not to anyone who is on another server."
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:39
msgid "**Disabling federation does not necessarily disable the federation port** (`8448`). Services like [Dimension](configuring-playbook-dimension.md) and [ma1sd](configuring-playbook-ma1sd.md) normally rely on `openid` APIs exposed on that port. Even if you disable federation and only if necessary, we may still be exposing the federation port and serving the `openid` APIs there. To override this and completely disable Synapse's federation port use:"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:51
msgid "Changing the federation port from 8448 to a different port to use a CDN that only accepts 443/80 ports"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:53
msgid "Why? This change could be useful for people running small Synapse instances on small severs/VPSes to avoid being impacted by a simple DOS/DDOS when bandwidth, RAM, an CPU resources are limited and if your hosting provider does not provide a DOS/DDOS protection."
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:55
msgid "The following changes in the configuration file (`inventory/host_vars/matrix.example.com/vars.yml`) will allow this and make it possible to proxy the federation through a CDN such as CloudFlare or any other:"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:66
msgid "**Use this at you own risk as all the possible side-effects of doing this are not fully known. However, it has been tested and works fine and passes all the tests on <https://federationtester.matrix.org/> without issues.**"
msgstr ""