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.
 
 

211 lines
7.3 KiB

  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-20 09:53+0200\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. #: ../../../docs/configuring-playbook-sygnal.md:1
  24. msgid "Setting up the Sygnal push gateway (optional)"
  25. msgstr ""
  26. #: ../../../docs/configuring-playbook-sygnal.md:3
  27. msgid ""
  28. "The playbook can install and configure the [Sygnal](https://github.com"
  29. "/matrix-org/sygnal) push gateway for you."
  30. msgstr ""
  31. #: ../../../docs/configuring-playbook-sygnal.md:5
  32. msgid ""
  33. "See the project's [documentation](https://github.com/matrix-"
  34. "org/sygnal/blob/master/README.md) to learn what it does and why it might "
  35. "be useful to you."
  36. msgstr ""
  37. #: ../../../docs/configuring-playbook-sygnal.md:7
  38. msgid ""
  39. "**Note**: most people don't need to install their own gateway. As "
  40. "Sygnal's [Notes for application developers](https://github.com/matrix-"
  41. "org/sygnal/blob/master/docs/applications.md) documentation says:"
  42. msgstr ""
  43. #: ../../../docs/configuring-playbook-sygnal.md:9
  44. msgid ""
  45. "It is not feasible to allow end-users to configure their own Sygnal "
  46. "instance, because the Sygnal instance needs the appropriate FCM or APNs "
  47. "secrets that belong to the application."
  48. msgstr ""
  49. #: ../../../docs/configuring-playbook-sygnal.md:11
  50. msgid ""
  51. "This optional playbook component is only useful to people who "
  52. "develop/build their own Matrix client applications themselves."
  53. msgstr ""
  54. #: ../../../docs/configuring-playbook-sygnal.md:13
  55. msgid "Adjusting the playbook configuration"
  56. msgstr ""
  57. #: ../../../docs/configuring-playbook-sygnal.md:15
  58. msgid ""
  59. "To enable Sygnal, add the following configuration to your "
  60. "`inventory/host_vars/matrix.example.com/vars.yml` file:"
  61. msgstr ""
  62. #: ../../../docs/configuring-playbook-sygnal.md:43
  63. msgid ""
  64. "For a more complete example of available fields and values they can take,"
  65. " see `roles/custom/matrix-sygnal/templates/sygnal.yaml.j2` (or the "
  66. "[upstream `sygnal.yaml.sample` configuration file](https://github.com"
  67. "/matrix-org/sygnal/blob/master/sygnal.yaml.sample))."
  68. msgstr ""
  69. #: ../../../docs/configuring-playbook-sygnal.md:45
  70. msgid ""
  71. "Configuring [GCM/FCM](https://firebase.google.com/docs/cloud-messaging/) "
  72. "is easier, as it only requires that you provide some config values."
  73. msgstr ""
  74. #: ../../../docs/configuring-playbook-sygnal.md:47
  75. msgid ""
  76. "To configure [APNS](https://developer.apple.com/notifications/) (Apple "
  77. "Push Notification Service), you'd need to provide one or more certificate"
  78. " files. To do that, the above example configuration:"
  79. msgstr ""
  80. #: ../../../docs/configuring-playbook-sygnal.md:49
  81. msgid ""
  82. "makes use of the [`aux` role](https://github.com/mother-of-all-self-"
  83. "hosting/ansible-role-aux) (and its `aux_file_definitions` variable) to "
  84. "make the playbook install files into `/matrix/sygnal/data` (the "
  85. "`matrix_sygnal_data_path` variable). See [`defaults/main.yml` "
  86. "file](https://github.com/mother-of-all-self-hosting/ansible-role-"
  87. "aux/blob/main/defaults/main.yml) of the `aux` role for usage examples. It"
  88. " also makes sure the files are owned by `matrix:matrix`, so that Sygnal "
  89. "can read them. Of course, you can also install these files manually "
  90. "yourself, if you'd rather not use `aux`."
  91. msgstr ""
  92. #: ../../../docs/configuring-playbook-sygnal.md:51
  93. msgid ""
  94. "references these files in the Sygnal configuration (`matrix_sygnal_apps`)"
  95. " using a path like `/data/..` (the `/matrix/sygnal/data` directory on the"
  96. " host system is mounted into the `/data` directory inside the container)"
  97. msgstr ""
  98. #: ../../../docs/configuring-playbook-sygnal.md:53
  99. msgid "Adjusting the Sygnal URL"
  100. msgstr ""
  101. #: ../../../docs/configuring-playbook-sygnal.md:55
  102. msgid ""
  103. "By default, this playbook installs Sygnal on the `sygnal.` subdomain "
  104. "(`sygnal.example.com`) and requires you to [adjust your DNS records"
  105. "](#adjusting-dns-records)."
  106. msgstr ""
  107. #: ../../../docs/configuring-playbook-sygnal.md:57
  108. msgid ""
  109. "By tweaking the `matrix_sygnal_hostname` and `matrix_sygnal_path_prefix` "
  110. "variables, you can easily make the service available at a **different "
  111. "hostname and/or path** than the default one."
  112. msgstr ""
  113. #: ../../../docs/configuring-playbook-sygnal.md:59
  114. msgid ""
  115. "Example additional configuration for your "
  116. "`inventory/host_vars/matrix.example.com/vars.yml` file:"
  117. msgstr ""
  118. #: ../../../docs/configuring-playbook-sygnal.md:70
  119. msgid "Adjusting DNS records"
  120. msgstr ""
  121. #: ../../../docs/configuring-playbook-sygnal.md:72
  122. msgid ""
  123. "Once you've decided on the domain and path, **you may need to adjust your"
  124. " DNS** records to point the Sygnal domain to the Matrix server."
  125. msgstr ""
  126. #: ../../../docs/configuring-playbook-sygnal.md:74
  127. msgid ""
  128. "By default, you will need to create a CNAME record for `sygnal`. See "
  129. "[Configuring DNS](configuring-dns.md) for details about DNS changes."
  130. msgstr ""
  131. #: ../../../docs/configuring-playbook-sygnal.md:76
  132. msgid ""
  133. "If you've decided to reuse the `matrix.` domain, you won't need to do any"
  134. " extra DNS configuration."
  135. msgstr ""
  136. #: ../../../docs/configuring-playbook-sygnal.md:78
  137. msgid "Installing"
  138. msgstr ""
  139. #: ../../../docs/configuring-playbook-sygnal.md:80
  140. msgid ""
  141. "After configuring the playbook and potentially [adjusting your DNS "
  142. "records](#adjusting-dns-records), run the playbook with [playbook tags"
  143. "](playbook-tags.md) as below:"
  144. msgstr ""
  145. #: ../../../docs/configuring-playbook-sygnal.md:87
  146. msgid ""
  147. "The shortcut commands with the [`just` program](just.md) are also "
  148. "available: `just install-all` or `just setup-all`"
  149. msgstr ""
  150. #: ../../../docs/configuring-playbook-sygnal.md:89
  151. msgid ""
  152. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
  153. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
  154. "runtime) than `just setup-all`) when its components remain unchanged. If "
  155. "you adjust your `vars.yml` to remove other components, you'd need to run "
  156. "`just setup-all`, or these components will still remain installed. Note "
  157. "these shortcuts run the `ensure-matrix-users-created` tag too."
  158. msgstr ""
  159. #: ../../../docs/configuring-playbook-sygnal.md:91
  160. msgid "Usage"
  161. msgstr ""
  162. #: ../../../docs/configuring-playbook-sygnal.md:93
  163. msgid ""
  164. "To make use of your Sygnal installation, you'd need to build your own "
  165. "Matrix client application, which uses the same API keys (for "
  166. "[GCM/FCM](https://firebase.google.com/docs/cloud-messaging/)) and "
  167. "certificates (for [APNS](https://developer.apple.com/notifications/)) and"
  168. " is to your Sygnal URL endpoint (e.g. `https://sygnal.example.com`)."
  169. msgstr ""
  170. #: ../../../docs/configuring-playbook-sygnal.md:95
  171. msgid ""
  172. "Refer to Sygnal's [Notes for application developers](https://github.com"
  173. "/matrix-org/sygnal/blob/master/docs/applications.md) document."
  174. msgstr ""
  175. #~ msgid ""
  176. #~ "See the project's [documentation](https://github.com"
  177. #~ "/matrix-org/sygnal) to learn what it "
  178. #~ "does and why it might be useful"
  179. #~ " to you."
  180. #~ msgstr ""