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.
 
 

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