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.
10427 Commits
13 Branches
1.3 GiB
 
 
Tree: 90d3cf78b3
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '90d3cf78b3'
${ noResults }
matrix-docker-ansible-deploy/i18n/translation-templates/docs/configuring-playbook-s3-goo...

179 lines
7.7 KiB
Raw Blame History 

  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-s3-goofys.md:1

  20. msgid "Storing Matrix media files on Amazon S3 with Goofys (optional)"

  21. msgstr ""

  22. 

  23. #: ../../../docs/configuring-playbook-s3-goofys.md:3

  24. msgid "If you'd like to store Synapse's content repository (`media_store`) files on Amazon S3 (or other S3-compatible service), you can let this playbook configure [Goofys](https://github.com/kahing/goofys) for you."

  25. msgstr ""

  26. 

  27. #: ../../../docs/configuring-playbook-s3-goofys.md:5

  28. msgid "Another (and better performing) way to use S3 storage with Synapse is [synapse-s3-storage-provider](configuring-playbook-synapse-s3-storage-provider.md)."

  29. msgstr ""

  30. 

  31. #: ../../../docs/configuring-playbook-s3-goofys.md:7

  32. msgid "Using a Goofys-backed media store works, but performance may not be ideal. If possible, try to use a region which is close to your Matrix server."

  33. msgstr ""

  34. 

  35. #: ../../../docs/configuring-playbook-s3-goofys.md:9

  36. msgid "If you'd like to move your locally-stored media store data to Amazon S3 (or another S3-compatible object store), we also provide some migration instructions below."

  37. msgstr ""

  38. 

  39. #: ../../../docs/configuring-playbook-s3-goofys.md:11

  40. msgid "Adjusting the playbook configuration"

  41. msgstr ""

  42. 

  43. #: ../../../docs/configuring-playbook-s3-goofys.md:13

  44. msgid "After [creating the S3 bucket and configuring it](configuring-playbook-s3.md#bucket-creation-and-security-configuration), add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):"

  45. msgstr ""

  46. 

  47. #: ../../../docs/configuring-playbook-s3-goofys.md:23

  48. msgid "You can use any S3-compatible object store by **additionally** configuring these variables:"

  49. msgstr ""

  50. 

  51. #: ../../../docs/configuring-playbook-s3-goofys.md:30

  52. msgid "If you have local media store files and wish to migrate to Backblaze B2 subsequently, follow our [migration guide to Backblaze B2](#migrating-to-backblaze-b2) below instead of applying this configuration as-is."

  53. msgstr ""

  54. 

  55. #: ../../../docs/configuring-playbook-s3-goofys.md:32

  56. msgid "Migrating from local filesystem storage to S3"

  57. msgstr ""

  58. 

  59. #: ../../../docs/configuring-playbook-s3-goofys.md:34

  60. msgid "It's a good idea to [make a complete server backup](faq.md#how-do-i-back-up-the-data-on-my-server) before migrating your local media store to an S3-backed one."

  61. msgstr ""

  62. 

  63. #: ../../../docs/configuring-playbook-s3-goofys.md:36

  64. msgid "After making the backup, follow one of the guides below for a migration path from a locally-stored media store to one stored on S3-compatible storage:"

  65. msgstr ""

  66. 

  67. #: ../../../docs/configuring-playbook-s3-goofys.md:38

  68. msgid "[Migrating to any S3-compatible storage (universal, but likely slow)](#migrating-to-any-s3-compatible-storage-universal-but-likely-slow)"

  69. msgstr ""

  70. 

  71. #: ../../../docs/configuring-playbook-s3-goofys.md:39

  72. msgid "[Migrating to Backblaze B2](#migrating-to-backblaze-b2)"

  73. msgstr ""

  74. 

  75. #: ../../../docs/configuring-playbook-s3-goofys.md:41

  76. msgid "Migrating to any S3-compatible storage (universal, but likely slow)"

  77. msgstr ""

  78. 

  79. #: ../../../docs/configuring-playbook-s3-goofys.md:43

  80. msgid "Proceed with the steps below without stopping Matrix services"

  81. msgstr ""

  82. 

  83. #: ../../../docs/configuring-playbook-s3-goofys.md:45

  84. msgid "Start by adding the base S3 configuration in your `vars.yml` file (seen above, may be different depending on the S3 provider of your choice)"

  85. msgstr ""

  86. 

  87. #: ../../../docs/configuring-playbook-s3-goofys.md:47

  88. msgid "In addition to the base configuration you see above, add this to your `vars.yml` file:"

  89. msgstr ""

  90. 

  91. #: ../../../docs/configuring-playbook-s3-goofys.md:53

  92. msgid "This enables S3 support, but mounts the S3 storage bucket to `/matrix/s3-media-store` without hooking it to your homeserver yet. Your homeserver will still continue using your local filesystem for its media store."

  93. msgstr ""

  94. 

  95. #: ../../../docs/configuring-playbook-s3-goofys.md:55

  96. msgid "Run the playbook to apply the changes: `ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,start`"

  97. msgstr ""

  98. 

  99. #: ../../../docs/configuring-playbook-s3-goofys.md:57

  100. msgid "Do an **initial sync of your files** by running this **on the server** (it may take a very long time):"

  101. msgstr ""

  102. 

  103. #: ../../../docs/configuring-playbook-s3-goofys.md:63

  104. msgid "You may need to install `rsync` manually."

  105. msgstr ""

  106. 

  107. #: ../../../docs/configuring-playbook-s3-goofys.md:65

  108. #: ../../../docs/configuring-playbook-s3-goofys.md:106

  109. msgid "Stop all Matrix services (`ansible-playbook -i inventory/hosts setup.yml --tags=stop`)"

  110. msgstr ""

  111. 

  112. #: ../../../docs/configuring-playbook-s3-goofys.md:67

  113. msgid "Start the S3 service by running this **on the server**: `systemctl start matrix-goofys`"

  114. msgstr ""

  115. 

  116. #: ../../../docs/configuring-playbook-s3-goofys.md:69

  117. msgid "Sync the files again by re-running the `rsync` command you see in step #5"

  118. msgstr ""

  119. 

  120. #: ../../../docs/configuring-playbook-s3-goofys.md:71

  121. msgid "Stop the S3 service by running this **on the server**: `systemctl stop matrix-goofys`"

  122. msgstr ""

  123. 

  124. #: ../../../docs/configuring-playbook-s3-goofys.md:73

  125. #: ../../../docs/configuring-playbook-s3-goofys.md:114

  126. msgid "Get the old media store out of the way by running this command on the server:"

  127. msgstr ""

  128. 

  129. #: ../../../docs/configuring-playbook-s3-goofys.md:79

  130. msgid "Remove the `matrix_s3_media_store_path` configuration from your `vars.yml` file (undoing step #3 above)"

  131. msgstr ""

  132. 

  133. #: ../../../docs/configuring-playbook-s3-goofys.md:81

  134. #: ../../../docs/configuring-playbook-s3-goofys.md:122

  135. msgid "Run the playbook: `ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,start`"

  136. msgstr ""

  137. 

  138. #: ../../../docs/configuring-playbook-s3-goofys.md:83

  139. #: ../../../docs/configuring-playbook-s3-goofys.md:124

  140. msgid "You're done! Verify that loading existing (old) media files works and that you can upload new ones."

  141. msgstr ""

  142. 

  143. #: ../../../docs/configuring-playbook-s3-goofys.md:85

  144. #: ../../../docs/configuring-playbook-s3-goofys.md:126

  145. msgid "When confident that it all works, get rid of the local media store directory: `rm -rf /matrix/synapse/storage/media-store-local-backup`"

  146. msgstr ""

  147. 

  148. #: ../../../docs/configuring-playbook-s3-goofys.md:87

  149. msgid "Migrating to Backblaze B2"

  150. msgstr ""

  151. 

  152. #: ../../../docs/configuring-playbook-s3-goofys.md:89

  153. msgid "While all Matrix services are running, run the following command on the server:"

  154. msgstr ""

  155. 

  156. #: ../../../docs/configuring-playbook-s3-goofys.md:91

  157. msgid "(you need to adjust the 3 `--env` line below with your own data)"

  158. msgstr ""

  159. 

  160. #: ../../../docs/configuring-playbook-s3-goofys.md:104

  161. msgid "This is some initial file sync, which may take a very long time."

  162. msgstr ""

  163. 

  164. #: ../../../docs/configuring-playbook-s3-goofys.md:108

  165. msgid "Run the command from step #1 again."

  166. msgstr ""

  167. 

  168. #: ../../../docs/configuring-playbook-s3-goofys.md:110

  169. msgid "Doing this will sync any new files that may have been created locally in the meantime."

  170. msgstr ""

  171. 

  172. #: ../../../docs/configuring-playbook-s3-goofys.md:112

  173. msgid "Now that Matrix services aren't running, we're sure to get Backblaze B2 and your local media store fully in sync."

  174. msgstr ""

  175. 

  176. #: ../../../docs/configuring-playbook-s3-goofys.md:120

  177. msgid "Put the [Backblaze B2 settings](configuring-playbook-s3.md#backblaze-b2) in your `vars.yml` file"

  178. msgstr ""