overmind
/
matrix-docker-ansible-deploy
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Fork 0
Code Issues 0 Releases 0 Wiki Activity
Matrix Docker Ansible eploy
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
8814 Commits
13 Branches
36 MiB
 
 
Tree: d4f8d0918a
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'd4f8d0918a'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix...

258 lines
9.5 KiB
Raw Blame History 

  1. # SOME DESCRIPTIVE TITLE.

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

  3. # members

  4. # This file is distributed under the same license as the

  5. # matrix-docker-ansible-deploy package.

  6. # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.

  7. #

  8. #, fuzzy

  9. msgid ""

  10. msgstr ""

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

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

  13. "POT-Creation-Date: 2024-12-16 12:05+0900\n"

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

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

  16. "Language: bg\n"

  17. "Language-Team: bg <LL@li.org>\n"

  18. "Plural-Forms: nplurals=2; plural=(n != 1);\n"

  19. "MIME-Version: 1.0\n"

  20. "Content-Type: text/plain; charset=utf-8\n"

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

  22. "Generated-By: Babel 2.16.0\n"

  23. 

  24. #: ../../../docs/configuring-playbook-matrix-media-repo.md:1

  25. msgid "Storing Matrix media files using matrix-media-repo (optional)"

  26. msgstr ""

  27. 

  28. #: ../../../docs/configuring-playbook-matrix-media-repo.md:3

  29. msgid ""

  30. "[matrix-media-repo](https://docs.t2bot.io/matrix-media-repo/) (often "

  31. "abbreviated \"MMR\") is a highly customizable multi-domain media "

  32. "repository for Matrix. Intended for medium to large environments "

  33. "consisting of several homeservers, this media repo de-duplicates media "

  34. "(including remote media) while being fully compliant with the "

  35. "specification."

  36. msgstr ""

  37. 

  38. #: ../../../docs/configuring-playbook-matrix-media-repo.md:5

  39. msgid ""

  40. "Smaller/individual homeservers can still make use of this project's "

  41. "features, though it may be difficult to set up or have higher than "

  42. "expected resource consumption. Please do your research before deploying "

  43. "this as this project may not be useful for your environment."

  44. msgstr ""

  45. 

  46. #: ../../../docs/configuring-playbook-matrix-media-repo.md:7

  47. msgid ""

  48. "For a simpler alternative (which allows you to offload your media "

  49. "repository storage to S3, etc.), you can [configure S3 storage"

  50. "](configuring-playbook-s3.md) instead of setting up matrix-media-repo."

  51. msgstr ""

  52. 

  53. #: ../../../docs/configuring-playbook-matrix-media-repo.md

  54. msgid "**Table of Contents**"

  55. msgstr ""

  56. 

  57. #: ../../../docs/configuring-playbook-matrix-media-repo.md

  58. msgid "[Quickstart](#quickstart)"

  59. msgstr ""

  60. 

  61. #: ../../../docs/configuring-playbook-matrix-media-repo.md

  62. msgid "[Additional configuration options](#configuring-the-media-repo)"

  63. msgstr ""

  64. 

  65. #: ../../../docs/configuring-playbook-matrix-media-repo.md

  66. msgid ""

  67. "[Importing data from an existing media store](#importing-data-from-an-"

  68. "existing-media-store)"

  69. msgstr ""

  70. 

  71. #: ../../../docs/configuring-playbook-matrix-media-repo.md:15

  72. msgid "Quickstart"

  73. msgstr ""

  74. 

  75. #: ../../../docs/configuring-playbook-matrix-media-repo.md:17

  76. msgid ""

  77. "Add the following configuration to your "

  78. "`inventory/host_vars/matrix.example.com/vars.yml` file and [re-run the "

  79. "installation process](./installing.md) for the playbook:"

  80. msgstr ""

  81. 

  82. #: ../../../docs/configuring-playbook-matrix-media-repo.md:26

  83. msgid ""

  84. "The repo is pre-configured for integrating with the Postgres database, "

  85. "Traefik proxy and [Prometheus/Grafana](configuring-playbook-prometheus-"

  86. "grafana.md) (if metrics enabled) from this playbook for all the available"

  87. " homeserver roles. When the media repo is enabled, other media store "

  88. "roles should be disabled (if using Synapse with other media store roles)."

  89. msgstr ""

  90. 

  91. #: ../../../docs/configuring-playbook-matrix-media-repo.md:28

  92. msgid ""

  93. "By default, the media-repo will use the local filesystem for data "

  94. "storage. You can alternatively use a `s3` cloud backend as well. Access "

  95. "token caching is also enabled by default since the logout endpoints are "

  96. "proxied through the media repo."

  97. msgstr ""

  98. 

  99. #: ../../../docs/configuring-playbook-matrix-media-repo.md:30

  100. msgid "Configuring the media-repo"

  101. msgstr ""

  102. 

  103. #: ../../../docs/configuring-playbook-matrix-media-repo.md:32

  104. msgid "Additional common configuration options:"

  105. msgstr ""

  106. 

  107. #: ../../../docs/configuring-playbook-matrix-media-repo.md:91

  108. msgid ""

  109. "Full list of configuration options with documentation can be found in "

  110. "[`roles/custom/matrix-media-"

  111. "repo/defaults/main.yml`](https://github.com/spantaleev/matrix-docker-"

  112. "ansible-deploy/blob/master/roles/custom/matrix-media-"

  113. "repo/defaults/main.yml)"

  114. msgstr ""

  115. 

  116. #: ../../../docs/configuring-playbook-matrix-media-repo.md:93

  117. msgid "Signing Keys"

  118. msgstr ""

  119. 

  120. #: ../../../docs/configuring-playbook-matrix-media-repo.md:95

  121. msgid ""

  122. "Authenticated media endpoints ([MSC3916](https://github.com/matrix-org"

  123. "/matrix-spec-proposals/pull/3916)) requires MMR to have a configured "

  124. "signing key to authorize outbound federation requests. Additionally, the "

  125. "signing key must be merged with your homeserver's signing key file."

  126. msgstr ""

  127. 

  128. #: ../../../docs/configuring-playbook-matrix-media-repo.md:97

  129. msgid ""

  130. "The playbook default is to generate a MMR signing key when invoking the "

  131. "setup role and merge it with your homeserver if you are using Synapse or "

  132. "Dendrite. This can be disabled if desired by setting the option in your "

  133. "inventory:"

  134. msgstr ""

  135. 

  136. #: ../../../docs/configuring-playbook-matrix-media-repo.md:103

  137. msgid ""

  138. "If you wish to manually generate the signing key and merge it with your "

  139. "homeserver's signing key file, see https://docs.t2bot.io/matrix-media-"

  140. "repo/v1.3.5/installation/signing-key/ for more details."

  141. msgstr ""

  142. 

  143. #: ../../../docs/configuring-playbook-matrix-media-repo.md:105

  144. msgid ""

  145. "**Note that if you uninstall MMR from the playbook, it will not remove "

  146. "the old MMR signing key from your homeserver's signing key file. You will"

  147. " have to remove it manually.**"

  148. msgstr ""

  149. 

  150. #: ../../../docs/configuring-playbook-matrix-media-repo.md:107

  151. msgid "Key backup and revoking"

  152. msgstr ""

  153. 

  154. #: ../../../docs/configuring-playbook-matrix-media-repo.md:109

  155. msgid ""

  156. "Since your homeserver signing key file is modified by the playbook, a "

  157. "backup will be created in "

  158. "`HOMESERVER_DIR/config/example.com.signing.key.backup`. If you need to "

  159. "remove/revoke old keys, you can restore from this backup or remove the "

  160. "MMR key ID from your `example.com.signing.key` file."

  161. msgstr ""

  162. 

  163. #: ../../../docs/configuring-playbook-matrix-media-repo.md:111

  164. msgid ""

  165. "Additionally, its recommended after revoking a signing key to update your"

  166. " homeserver config file (`old_signing_keys` field for Synapse and "

  167. "`old_private_keys` for Dendrite). See your homeserver config file for "

  168. "further documentation on how to populate the field."

  169. msgstr ""

  170. 

  171. #: ../../../docs/configuring-playbook-matrix-media-repo.md:113

  172. msgid "Importing data from an existing media store"

  173. msgstr ""

  174. 

  175. #: ../../../docs/configuring-playbook-matrix-media-repo.md:115

  176. msgid ""

  177. "If you want to add this repo to an existing homeserver managed by the "

  178. "playbook, you will need to import existing media into MMR's database or "

  179. "you will lose access to older media while it is active. MMR versions up "

  180. "to `v1.3.3` only support importing from Synapse, but newer versions (at "

  181. "time of writing: only `latest`) also support importing from Dendrite."

  182. msgstr ""

  183. 

  184. #: ../../../docs/configuring-playbook-matrix-media-repo.md:117

  185. msgid ""

  186. "**Before importing**: ensure you have an initial matrix-media-repo "

  187. "deployment by following the [quickstart](#quickstart) guide above"

  188. msgstr ""

  189. 

  190. #: ../../../docs/configuring-playbook-matrix-media-repo.md:119

  191. msgid ""

  192. "Depending on the homeserver implementation yu're using (Synapse, "

  193. "Dendrite), you'll need to use a different import tool (part of matrix-"

  194. "media-repo) and point it to the homeserver's database."

  195. msgstr ""

  196. 

  197. #: ../../../docs/configuring-playbook-matrix-media-repo.md:121

  198. msgid "Importing data from the Synapse media store"

  199. msgstr ""

  200. 

  201. #: ../../../docs/configuring-playbook-matrix-media-repo.md:123

  202. msgid ""

  203. "To import the Synapse media store, you're supposed to invoke the "

  204. "`import_synapse` tool which is part of the matrix-media-repo container "

  205. "image. Your Synapse database is called `synapse` by default, unless "

  206. "you've changed it by modifying `matrix_synapse_database_database`."

  207. msgstr ""

  208. 

  209. #: ../../../docs/configuring-playbook-matrix-media-repo.md:125

  210. msgid ""

  211. "This guide here is adapted from the [upstream documentation about the "

  212. "import_synapse script](https://github.com/turt2live/matrix-media-repo"

  213. "#importing-media-from-synapse)."

  214. msgstr ""

  215. 

  216. #: ../../../docs/configuring-playbook-matrix-media-repo.md:127

  217. #: ../../../docs/configuring-playbook-matrix-media-repo.md:149

  218. msgid ""

  219. "Run the following command on the server (after replacing "

  220. "`postgres_connection_password` in it with the value found in your "

  221. "`vars.yml` file):"

  222. msgstr ""

  223. 

  224. #: ../../../docs/configuring-playbook-matrix-media-repo.md:139

  225. #: ../../../docs/configuring-playbook-matrix-media-repo.md:161

  226. msgid ""

  227. "Enter `1` for the Machine ID when prompted (you are not doing any "

  228. "horizontal scaling) unless you know what you're doing."

  229. msgstr ""

  230. 

  231. #: ../../../docs/configuring-playbook-matrix-media-repo.md:141

  232. #: ../../../docs/configuring-playbook-matrix-media-repo.md:163

  233. msgid ""

  234. "This should output a `msg=\"Import completed\"` when finished "

  235. "successfully!"

  236. msgstr ""

  237. 

  238. #: ../../../docs/configuring-playbook-matrix-media-repo.md:143

  239. msgid "Importing data from the Dendrite media store"

  240. msgstr ""

  241. 

  242. #: ../../../docs/configuring-playbook-matrix-media-repo.md:145

  243. msgid ""

  244. "If you're using the [Dendrite](configuring-playbook-dendrite.md) "

  245. "homeserver instead of the default for this playbook (Synapse), follow "

  246. "this importing guide here."

  247. msgstr ""

  248. 

  249. #: ../../../docs/configuring-playbook-matrix-media-repo.md:147

  250. msgid ""

  251. "To import the Dendrite media store, you're supposed to invoke the "

  252. "`import_dendrite` tool which is part of the matrix-media-repo container "

  253. "image. Your Dendrite database is called `dendrite_mediaapi` by default, "

  254. "unless you've changed it by modifying "

  255. "`matrix_dendrite_media_api_database`."

  256. msgstr ""