overmind
/
matrix-docker-ansible-deploy
espelhamento de https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Fork 0
Código Issues 0 Versões 0 Wiki Atividade
Matrix Docker Ansible eploy
Você não pode selecionar mais de 25 tópicos Os tópicos devem começar com uma letra ou um número, podem incluir traços ('-') e podem ter até 35 caracteres.
11807 Commits
13 Branches
2.4 GiB
 
 
Branch: master
Branches Tags
${ item.name }
Criar branch ${ searchTerm }
de master
${ noResults }
matrix-docker-ansible-deploy/i18n/translation-templates/docs/configuring-playbook-synolo...

238 linhas
9.0 KiB
Original Link permanente Anotar Histórico 

  1. # SOME DESCRIPTIVE TITLE.

  2. # Copyright (C) 2018-2026, 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: 2026-06-29 17:11+0000\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-synology.md:7

  20. msgid "Configuring Synology DSM"

  21. msgstr ""

  22. 

  23. #: ../../../docs/configuring-playbook-synology.md:9

  24. msgid "This document is a guide for preparing Synology DSM for the installation of the [Matrix Docker Ansible Deploy](https://github.com/spantaleev/matrix-docker-ansible-deploy) project."

  25. msgstr ""

  26. 

  27. #: ../../../docs/configuring-playbook-synology.md:11

  28. msgid "**Note:** Synology DSM is a community-supported platform. It is not officially tested or maintained by the project maintainers. Use at your own discretion."

  29. msgstr ""

  30. 

  31. #: ../../../docs/configuring-playbook-synology.md:13

  32. msgid "**Intended audience:** Users already familiar with DSM, SSH, and this Ansible project."

  33. msgstr ""

  34. 

  35. #: ../../../docs/configuring-playbook-synology.md:15

  36. msgid "Assumptions"

  37. msgstr ""

  38. 

  39. #: ../../../docs/configuring-playbook-synology.md:17

  40. msgid "DSM version 7 or higher"

  41. msgstr ""

  42. 

  43. #: ../../../docs/configuring-playbook-synology.md:18

  44. msgid "`Volume1` is used as the default Docker storage location"

  45. msgstr ""

  46. 

  47. #: ../../../docs/configuring-playbook-synology.md:19

  48. msgid "You are using DSM's built-in reverse proxy for handling HTTPS"

  49. msgstr ""

  50. 

  51. #: ../../../docs/configuring-playbook-synology.md:21

  52. msgid "How Synology Support Works"

  53. msgstr ""

  54. 

  55. #: ../../../docs/configuring-playbook-synology.md:23

  56. msgid "The playbook automatically detects Synology DSM by checking for `/etc/synoinfo.conf`. When detected, it:"

  57. msgstr ""

  58. 

  59. #: ../../../docs/configuring-playbook-synology.md:25

  60. msgid "Uses `synouser` and `synogroup` (DSM-native tools) instead of standard Linux user management"

  61. msgstr ""

  62. 

  63. #: ../../../docs/configuring-playbook-synology.md:26

  64. msgid "Constrains the Python `requests` package to a version compatible with the Docker SDK"

  65. msgstr ""

  66. 

  67. #: ../../../docs/configuring-playbook-synology.md:27

  68. msgid "Ensures `/volume1` has shared mount propagation so container bind mounts work correctly"

  69. msgstr ""

  70. 

  71. #: ../../../docs/configuring-playbook-synology.md:28

  72. msgid "Deploys a `matrix-synology-boot-fix` service that runs on every boot after Docker is ready"

  73. msgstr ""

  74. 

  75. #: ../../../docs/configuring-playbook-synology.md:30

  76. msgid "You can override auto-detection by setting `matrix_base_host_is_synology: true` or `false` in your `vars.yml`."

  77. msgstr ""

  78. 

  79. #: ../../../docs/configuring-playbook-synology.md:32

  80. msgid "Matrix Service Account"

  81. msgstr ""

  82. 

  83. #: ../../../docs/configuring-playbook-synology.md:34

  84. msgid "The playbook creates a `matrix` system account using Synology's `synouser` tool. The account is secured as follows:"

  85. msgstr ""

  86. 

  87. #: ../../../docs/configuring-playbook-synology.md:36

  88. msgid "**Expired** (`expired=1`) — the account cannot be used to log in to DSM or any application"

  89. msgstr ""

  90. 

  91. #: ../../../docs/configuring-playbook-synology.md:38

  92. msgid "You must set a password for this account via `matrix_synology_user_password` in your `vars.yml` (see [vars.yml Configuration](#varsyml-configuration)). The password cannot be used to log in because the account is expired, but a non-empty password is required as an additional security layer."

  93. msgstr ""

  94. 

  95. #: ../../../docs/configuring-playbook-synology.md:40

  96. msgid "If you pre-create the `matrix` user manually before running the playbook, the playbook will not modify the existing account's settings — you are responsible for securing it."

  97. msgstr ""

  98. 

  99. #: ../../../docs/configuring-playbook-synology.md:42

  100. msgid "Boot-fix Service"

  101. msgstr ""

  102. 

  103. #: ../../../docs/configuring-playbook-synology.md:44

  104. msgid "Synology DSM has two boot-time quirks that the boot-fix service addresses automatically:"

  105. msgstr ""

  106. 

  107. #: ../../../docs/configuring-playbook-synology.md:46

  108. msgid "**`/volume1` shared mount propagation**"

  109. msgstr ""

  110. 

  111. #: ../../../docs/configuring-playbook-synology.md:48

  112. msgid "Docker requires `/volume1` to be mounted as shared (`mount --make-shared /volume1`) for container bind mounts with `bind-propagation=slave` to work correctly (used by matrix-synapse for its media store). On Synology, this cannot be inserted into the systemd chain before Container Manager starts — doing so causes Container Manager to detect a broken dependency and prompt for repair on every boot. The playbook applies this during setup, and the boot-fix service re-applies it on every subsequent reboot, safely outside Container Manager's dependency chain."

  113. msgstr ""

  114. 

  115. #: ../../../docs/configuring-playbook-synology.md:50

  116. msgid "**Skipped services at boot**"

  117. msgstr ""

  118. 

  119. #: ../../../docs/configuring-playbook-synology.md:52

  120. msgid "Synology's systemd drops services with multi-level dependency chains from the boot activation queue (e.g. `matrix-traefik → matrix-container-socket-proxy → docker`). These services show as `inactive` or `failed` after reboot even though they are enabled. The boot-fix service scans for any enabled `matrix-*.service` in either state and starts them automatically."

  121. msgstr ""

  122. 

  123. #: ../../../docs/configuring-playbook-synology.md:54

  124. msgid "**If you previously configured a Task Scheduler entry** (`Control Panel > Task Scheduler`) to run `mount --make-shared /volume1` at boot-up, you can remove it — the boot-fix service now handles this."

  125. msgstr ""

  126. 

  127. #: ../../../docs/configuring-playbook-synology.md:56

  128. msgid "Synology GUI Preparation"

  129. msgstr ""

  130. 

  131. #: ../../../docs/configuring-playbook-synology.md:58

  132. msgid "**Enable SSH**"

  133. msgstr ""

  134. 

  135. #: ../../../docs/configuring-playbook-synology.md:59

  136. msgid "`Control Panel` > `Terminal & SNMP` > `Enable SSH service`"

  137. msgstr ""

  138. 

  139. #: ../../../docs/configuring-playbook-synology.md:61

  140. msgid "**Enable SFTP**"

  141. msgstr ""

  142. 

  143. #: ../../../docs/configuring-playbook-synology.md:62

  144. msgid "`Control Panel` > `File Service` > `FTP` > `Enable SFTP service` with default port"

  145. msgstr ""

  146. 

  147. #: ../../../docs/configuring-playbook-synology.md:64

  148. msgid "**Enable User Home Directory**"

  149. msgstr ""

  150. 

  151. #: ../../../docs/configuring-playbook-synology.md:65

  152. msgid "`Control Panel` > `User & Group` > `Advanced` > `Enable user home service`"

  153. msgstr ""

  154. 

  155. #: ../../../docs/configuring-playbook-synology.md:67

  156. msgid "**Install Container Manager**"

  157. msgstr ""

  158. 

  159. #: ../../../docs/configuring-playbook-synology.md:68

  160. msgid "Install from `Package Center`"

  161. msgstr ""

  162. 

  163. #: ../../../docs/configuring-playbook-synology.md:70

  164. msgid "**Configure Reverse Proxy**"

  165. msgstr ""

  166. 

  167. #: ../../../docs/configuring-playbook-synology.md:71

  168. msgid "`Control Panel` > `Login Portal` > `Advanced` > `Reverse Proxy`"

  169. msgstr ""

  170. 

  171. #: ../../../docs/configuring-playbook-synology.md:72

  172. msgid "Create entries for each service you enable (e.g. Matrix, Element, admin page)"

  173. msgstr ""

  174. 

  175. #: ../../../docs/configuring-playbook-synology.md:73

  176. msgid "Example entry:"

  177. msgstr ""

  178. 

  179. #: ../../../docs/configuring-playbook-synology.md:74

  180. msgid "Source: `HTTPS` / `matrix.example.com` / port `443`"

  181. msgstr ""

  182. 

  183. #: ../../../docs/configuring-playbook-synology.md:75

  184. msgid "Destination: `HTTP` / `localhost` / port `81`"

  185. msgstr ""

  186. 

  187. #: ../../../docs/configuring-playbook-synology.md:77

  188. msgid "SSH Preparation"

  189. msgstr ""

  190. 

  191. #: ../../../docs/configuring-playbook-synology.md:79

  192. msgid "(Optional but Recommended) Enable SSH Key Authentication"

  193. msgstr ""

  194. 

  195. #: ../../../docs/configuring-playbook-synology.md:81

  196. msgid "Configure key-based SSH login to avoid password prompts during Ansible runs."

  197. msgstr ""

  198. 

  199. #: ../../../docs/configuring-playbook-synology.md:83

  200. msgid "Set Up the Ansible Environment"

  201. msgstr ""

  202. 

  203. #: ../../../docs/configuring-playbook-synology.md:85

  204. msgid "Create a project folder and Python virtual environment on the DSM host:"

  205. msgstr ""

  206. 

  207. #: ../../../docs/configuring-playbook-synology.md:96

  208. msgid "Inventory Configuration"

  209. msgstr ""

  210. 

  211. #: ../../../docs/configuring-playbook-synology.md:98

  212. msgid "In your `inventory/hosts` file, set the Python interpreter to your virtual environment:"

  213. msgstr ""

  214. 

  215. #: ../../../docs/configuring-playbook-synology.md:105

  216. msgid "vars.yml Configuration"

  217. msgstr ""

  218. 

  219. #: ../../../docs/configuring-playbook-synology.md:107

  220. msgid "Add the following Synology-specific variables to your `vars.yml`:"

  221. msgstr ""

  222. 

  223. #: ../../../docs/configuring-playbook-synology.md:151

  224. msgid "Running the Playbook"

  225. msgstr ""

  226. 

  227. #: ../../../docs/configuring-playbook-synology.md:167

  228. msgid "**Important:** Always include `stop` before `setup-all,start` when changing configuration. Running `setup-all` alone does not restart already-running containers."

  229. msgstr ""

  230. 

  231. #: ../../../docs/configuring-playbook-synology.md:169

  232. msgid "Creating Matrix Users"

  233. msgstr ""

  234. 

  235. #: ../../../docs/configuring-playbook-synology.md:171

  236. msgid "After the services are running, create your first Matrix user:"

  237. msgstr ""