overmind
/
matrix-docker-ansible-deploy
miroir de https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Bifurcation 0
Code Tickets 0 Versions 0 Wiki Activité
Matrix Docker Ansible eploy
Vous ne pouvez pas sélectionner plus de 25 sujets Les noms de sujets doivent commencer par une lettre ou un nombre, peuvent contenir des tirets ('-') et peuvent comporter jusqu'à 35 caractères.
10427 Révisions
13 Branches
91 MiB
 
 
Aborescence: 90d3cf78b3
Branches Tags
${ item.name }
Créer la branche ${ searchTerm }
de '90d3cf78b3'
${ noResults }
matrix-docker-ansible-deploy/i18n/translation-templates/docs/configuring-playbook-synaps...

122 lignes
7.5 KiB
Brut Annotations Historique 

  1. # SOME DESCRIPTIVE TITLE.

  2. # Copyright (C) 2018-2025, Slavi Pantaleev, Aine Etke, MDAD community members

  3. # This file is distributed under the same license as the matrix-docker-ansible-deploy package.

  4. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

  5. #

  6. #, fuzzy

  7. msgid ""

  8. msgstr ""

  9. "Project-Id-Version: matrix-docker-ansible-deploy \n"

  10. "Report-Msgid-Bugs-To: \n"

  11. "POT-Creation-Date: 2025-01-27 09:54+0200\n"

  12. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"

  13. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"

  14. "Language-Team: LANGUAGE <LL@li.org>\n"

  15. "MIME-Version: 1.0\n"

  16. "Content-Type: text/plain; charset=UTF-8\n"

  17. "Content-Transfer-Encoding: 8bit\n"

  18. 

  19. #: ../../../docs/configuring-playbook-synapse-admin.md:1

  20. msgid "Setting up Synapse Admin (optional)"

  21. msgstr ""

  22. 

  23. #: ../../../docs/configuring-playbook-synapse-admin.md:3

  24. msgid "The playbook can install and configure [etkecc/synapse-admin](https://github.com/etkecc/synapse-admin) (a [feature-rich](https://github.com/etkecc/synapse-admin#fork-differences) fork of [Awesome-Technologies/synapse-admin](https://github.com/Awesome-Technologies/synapse-admin), community room: [#synapse-admin:etke.cc](https://matrix.to/#/#synapse-admin:etke.cc)) for you."

  25. msgstr ""

  26. 

  27. #: ../../../docs/configuring-playbook-synapse-admin.md:5

  28. msgid "synapse-admin is a web UI tool you can use to **administrate users, rooms, media, etc. on your Matrix server**. It's designed to work with the Synapse homeserver implementation and WON'T work with Dendrite because [Dendrite Admin API](https://element-hq.github.io/dendrite/administration/adminapi) differs from [Synapse Admin API](https://element-hq.github.io/synapse/latest/usage/administration/admin_api/)."

  29. msgstr ""

  30. 

  31. #: ../../../docs/configuring-playbook-synapse-admin.md:7

  32. msgid "💡 **Note**: the latest version of synapse-admin is hosted by [etke.cc](https://etke.cc/) at [admin.etke.cc](https://admin.etke.cc/). If you only need this service occasionally and trust giving your admin credentials to a 3rd party Single Page Application, you can consider using it from there and avoiding the (small) overhead of self-hosting."

  33. msgstr ""

  34. 

  35. #: ../../../docs/configuring-playbook-synapse-admin.md:9

  36. msgid "Adjusting DNS records (optional)"

  37. msgstr ""

  38. 

  39. #: ../../../docs/configuring-playbook-synapse-admin.md:11

  40. msgid "By default, this playbook installs Synapse Admin on the `matrix.` subdomain, at the `/synapse-admin` path (https://matrix.example.com/synapse-admin). This makes it easy to install it, because it **doesn't require additional DNS records to be set up**. If that's okay, you can skip this section."

  41. msgstr ""

  42. 

  43. #: ../../../docs/configuring-playbook-synapse-admin.md:13

  44. msgid "If you wish to adjust it, see the section [below](#adjusting-the-synapse-admin-url-optional) for details about DNS configuration."

  45. msgstr ""

  46. 

  47. #: ../../../docs/configuring-playbook-synapse-admin.md:15

  48. msgid "Adjusting the playbook configuration"

  49. msgstr ""

  50. 

  51. #: ../../../docs/configuring-playbook-synapse-admin.md:17

  52. msgid "To enable Synapse Admin, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"

  53. msgstr ""

  54. 

  55. #: ../../../docs/configuring-playbook-synapse-admin.md:23

  56. msgid "**Note**: Synapse Admin requires Synapse's [Admin APIs](https://element-hq.github.io/synapse/latest/usage/administration/admin_api/index.html) to function. Access to them is restricted with a valid access token, so exposing them publicly should not be a real security concern. Still, for additional security, we normally leave them unexposed, following [official Synapse reverse-proxying recommendations](https://element-hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-endpoints). Because Synapse Admin needs these APIs to function, when installing Synapse Admin, the playbook **automatically** exposes the Synapse Admin API publicly for you. Depending on the homeserver implementation you're using (Synapse, Dendrite), this is equivalent to:"

  57. msgstr ""

  58. 

  59. #: ../../../docs/configuring-playbook-synapse-admin.md:25

  60. msgid "for [Synapse](./configuring-playbook-synapse.md) (our default homeserver implementation): `matrix_synapse_container_labels_public_client_synapse_admin_api_enabled: true`"

  61. msgstr ""

  62. 

  63. #: ../../../docs/configuring-playbook-synapse-admin.md:26

  64. msgid "for [Dendrite](./configuring-playbook-dendrite.md): `matrix_dendrite_container_labels_public_client_synapse_admin_api_enabled: true`"

  65. msgstr ""

  66. 

  67. #: ../../../docs/configuring-playbook-synapse-admin.md:28

  68. msgid "By default, synapse-admin installation will be [restricted to only work with one homeserver](https://github.com/etkecc/synapse-admin/blob/e21e44362c879ac41f47c580b04210842b6ff3d7/README.md#restricting-available-homeserver) — the one managed by the playbook. To adjust these restrictions, tweak the `matrix_synapse_admin_config_restrictBaseUrl` variable."

  69. msgstr ""

  70. 

  71. #: ../../../docs/configuring-playbook-synapse-admin.md:30

  72. msgid "[!WARNING] If you're using [Matrix Authentication Service](./configuring-playbook-matrix-authentication-service.md) (MAS) for authentication, you will be able to [log into synapse-admin with an access token](https://github.com/etkecc/synapse-admin/pull/58), but certain synapse-admin features (especially those around user management) will be limited or not work at all."

  73. msgstr ""

  74. 

  75. #: ../../../docs/configuring-playbook-synapse-admin.md:33

  76. msgid "Adjusting the Synapse Admin URL (optional)"

  77. msgstr ""

  78. 

  79. #: ../../../docs/configuring-playbook-synapse-admin.md:35

  80. msgid "By tweaking the `matrix_synapse_admin_hostname` and `matrix_synapse_admin_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one."

  81. msgstr ""

  82. 

  83. #: ../../../docs/configuring-playbook-synapse-admin.md:37

  84. msgid "Example additional configuration for your `vars.yml` file:"

  85. msgstr ""

  86. 

  87. #: ../../../docs/configuring-playbook-synapse-admin.md:45

  88. msgid "If you've changed the default hostname, you may need to create a CNAME record for the Synapse Admin domain (`admin.example.com`), which targets `matrix.example.com`."

  89. msgstr ""

  90. 

  91. #: ../../../docs/configuring-playbook-synapse-admin.md:47

  92. msgid "When setting, replace `example.com` with your own."

  93. msgstr ""

  94. 

  95. #: ../../../docs/configuring-playbook-synapse-admin.md:49

  96. msgid "Installing"

  97. msgstr ""

  98. 

  99. #: ../../../docs/configuring-playbook-synapse-admin.md:51

  100. msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:"

  101. msgstr ""

  102. 

  103. #: ../../../docs/configuring-playbook-synapse-admin.md:58

  104. msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"

  105. msgstr ""

  106. 

  107. #: ../../../docs/configuring-playbook-synapse-admin.md:60

  108. msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note these shortcuts run the `ensure-matrix-users-created` tag too."

  109. msgstr ""

  110. 

  111. #: ../../../docs/configuring-playbook-synapse-admin.md:62

  112. msgid "Usage"

  113. msgstr ""

  114. 

  115. #: ../../../docs/configuring-playbook-synapse-admin.md:64

  116. msgid "After installation, Synapse Admin will be accessible at: `https://matrix.example.com/synapse-admin/`"

  117. msgstr ""

  118. 

  119. #: ../../../docs/configuring-playbook-synapse-admin.md:66

  120. msgid "To use Synapse Admin, you need to have [registered at least one administrator account](registering-users.md) on your server."

  121. msgstr ""