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.
8820 Commits
8 Branches
416 MiB
 
 
 
Tree: c51e771d1a
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'c51e771d1a'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ntfy.po

355 lines
12 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: 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. 

  23. #: ../../../docs/configuring-playbook-ntfy.md:1

  24. msgid "Setting up the ntfy push notifications server (optional)"

  25. msgstr ""

  26. 

  27. #: ../../../docs/configuring-playbook-ntfy.md:3

  28. msgid ""

  29. "The playbook can install and configure the [ntfy](https://ntfy.sh/) push "

  30. "notifications server for you."

  31. msgstr ""

  32. 

  33. #: ../../../docs/configuring-playbook-ntfy.md:5

  34. msgid ""

  35. "Using the [UnifiedPush](https://unifiedpush.org) standard, ntfy enables "

  36. "self-hosted (Google-free) push notifications from Matrix (and other) "

  37. "servers to UnifiedPush-compatible Matrix compatible client apps running "

  38. "on Android and other devices."

  39. msgstr ""

  40. 

  41. #: ../../../docs/configuring-playbook-ntfy.md:7

  42. msgid ""

  43. "This role is intended to support UnifiedPush notifications for use with "

  44. "the Matrix and Matrix-related services that this playbook installs. This "

  45. "role is not intended to support all of ntfy's other features."

  46. msgstr ""

  47. 

  48. #: ../../../docs/configuring-playbook-ntfy.md:9

  49. msgid ""

  50. "**Note**: In contrast to push notifications using Google's FCM or Apple's"

  51. " APNs, the use of UnifiedPush allows each end-user to choose the push "

  52. "notification server that they prefer.  As a consequence, deploying this "

  53. "ntfy server does not by itself ensure any particular user or device or "

  54. "client app will use it."

  55. msgstr ""

  56. 

  57. #: ../../../docs/configuring-playbook-ntfy.md:11

  58. msgid "Adjusting the playbook configuration"

  59. msgstr ""

  60. 

  61. #: ../../../docs/configuring-playbook-ntfy.md:13

  62. msgid ""

  63. "To enable ntfy, add the following configuration to your "

  64. "`inventory/host_vars/matrix.example.com/vars.yml` file:"

  65. msgstr ""

  66. 

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

  68. msgid ""

  69. "For a more complete list of variables that you could override, see the "

  70. "[`defaults/main.yml` file](https://github.com/mother-of-all-self-hosting"

  71. "/ansible-role-ntfy/blob/main/defaults/main.yml) of the ntfy Ansible role."

  72. msgstr ""

  73. 

  74. #: ../../../docs/configuring-playbook-ntfy.md:29

  75. msgid ""

  76. "For a complete list of ntfy config options that you could put in "

  77. "`ntfy_configuration_extension_yaml`, see the [ntfy config "

  78. "documentation](https://ntfy.sh/docs/config/#config-options)."

  79. msgstr ""

  80. 

  81. #: ../../../docs/configuring-playbook-ntfy.md:31

  82. msgid "Adjusting the ntfy URL"

  83. msgstr ""

  84. 

  85. #: ../../../docs/configuring-playbook-ntfy.md:33

  86. msgid ""

  87. "By default, this playbook installs ntfy on the `ntfy.` subdomain "

  88. "(`ntfy.example.com`) and requires you to [adjust your DNS records"

  89. "](#adjusting-dns-records)."

  90. msgstr ""

  91. 

  92. #: ../../../docs/configuring-playbook-ntfy.md:35

  93. msgid ""

  94. "By tweaking the `ntfy_hostname` variable, you can easily make the service"

  95. " available at a **different hostname** than the default one."

  96. msgstr ""

  97. 

  98. #: ../../../docs/configuring-playbook-ntfy.md:37

  99. msgid ""

  100. "Example additional configuration for your "

  101. "`inventory/host_vars/matrix.example.com/vars.yml` file:"

  102. msgstr ""

  103. 

  104. #: ../../../docs/configuring-playbook-ntfy.md:44

  105. msgid "Adjusting DNS records"

  106. msgstr ""

  107. 

  108. #: ../../../docs/configuring-playbook-ntfy.md:46

  109. msgid ""

  110. "Once you've decided on the domain, **you may need to adjust your DNS** "

  111. "records to point the ntfy domain to the Matrix server."

  112. msgstr ""

  113. 

  114. #: ../../../docs/configuring-playbook-ntfy.md:48

  115. msgid ""

  116. "By default, you will need to create a CNAME record for `ntfy`. See "

  117. "[Configuring DNS](configuring-dns.md) for details about DNS changes."

  118. msgstr ""

  119. 

  120. #: ../../../docs/configuring-playbook-ntfy.md:50

  121. msgid "Installing"

  122. msgstr ""

  123. 

  124. #: ../../../docs/configuring-playbook-ntfy.md:52

  125. msgid ""

  126. "After configuring the playbook and potentially [adjusting your DNS "

  127. "records](#adjusting-dns-records), run the playbook with [playbook tags"

  128. "](playbook-tags.md) as below:"

  129. msgstr ""

  130. 

  131. #: ../../../docs/configuring-playbook-ntfy.md:59

  132. msgid ""

  133. "The shortcut commands with the [`just` program](just.md) are also "

  134. "available: `just install-all` or `just setup-all`"

  135. msgstr ""

  136. 

  137. #: ../../../docs/configuring-playbook-ntfy.md:61

  138. msgid ""

  139. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "

  140. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"

  141. "runtime) than `just setup-all`) when its components remain unchanged. If "

  142. "you adjust your `vars.yml` to remove other components, you'd need to run "

  143. "`just setup-all`, or these components will still remain installed. Note "

  144. "these shortcuts run the `ensure-matrix-users-created` tag too."

  145. msgstr ""

  146. 

  147. #: ../../../docs/configuring-playbook-ntfy.md:63

  148. msgid "Usage"

  149. msgstr ""

  150. 

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

  152. msgid ""

  153. "To make use of your ntfy installation, on Android for example, you need "

  154. "two things:"

  155. msgstr ""

  156. 

  157. #: ../../../docs/configuring-playbook-ntfy.md:67

  158. msgid "the `ntfy` app"

  159. msgstr ""

  160. 

  161. #: ../../../docs/configuring-playbook-ntfy.md:68

  162. msgid "a UnifiedPush-compatible Matrix app"

  163. msgstr ""

  164. 

  165. #: ../../../docs/configuring-playbook-ntfy.md:70

  166. msgid ""

  167. "You need to install the `ntfy` app on each device on which you want to "

  168. "receive push notifications through your ntfy server. The `ntfy` app will "

  169. "provide UnifiedPush notifications to any number of UnifiedPush-compatible"

  170. " messaging apps installed on the same device."

  171. msgstr ""

  172. 

  173. #: ../../../docs/configuring-playbook-ntfy.md:72

  174. msgid "Setting up the `ntfy` Android app"

  175. msgstr ""

  176. 

  177. #: ../../../docs/configuring-playbook-ntfy.md:74

  178. msgid ""

  179. "Install the [ntfy Android app](https://ntfy.sh/docs/subscribe/phone/) "

  180. "from F-droid or Google Play."

  181. msgstr ""

  182. 

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

  184. msgid ""

  185. "In its Settings -> `General: Default server`, enter your ntfy server URL,"

  186. " such as `https://ntfy.example.com`."

  187. msgstr ""

  188. 

  189. #: ../../../docs/configuring-playbook-ntfy.md:76

  190. msgid "In its Settings -> `Advanced: Connection protocol`, choose `WebSockets`."

  191. msgstr ""

  192. 

  193. #: ../../../docs/configuring-playbook-ntfy.md:78

  194. msgid ""

  195. "That is all you need to do in the ntfy app. It has many other features, "

  196. "but for our purposes you can ignore them. In particular you do not need "

  197. "to follow any instructions about subscribing to a notification topic as "

  198. "UnifiedPush will do that automatically."

  199. msgstr ""

  200. 

  201. #: ../../../docs/configuring-playbook-ntfy.md:80

  202. msgid "Setting up a UnifiedPush-compatible Matrix app"

  203. msgstr ""

  204. 

  205. #: ../../../docs/configuring-playbook-ntfy.md:82

  206. msgid ""

  207. "Install any UnifiedPush-enabled Matrix app on that same device. The "

  208. "Matrix app will learn from the `ntfy` app that you have configured "

  209. "UnifiedPush on this device, and then it will tell your Matrix server to "

  210. "use it."

  211. msgstr ""

  212. 

  213. #: ../../../docs/configuring-playbook-ntfy.md:84

  214. msgid "Steps needed for specific Matrix apps:"

  215. msgstr ""

  216. 

  217. #: ../../../docs/configuring-playbook-ntfy.md:86

  218. msgid "FluffyChat-android:"

  219. msgstr ""

  220. 

  221. #: ../../../docs/configuring-playbook-ntfy.md:87

  222. msgid "Should auto-detect and use it. No manual settings."

  223. msgstr ""

  224. 

  225. #: ../../../docs/configuring-playbook-ntfy.md:89

  226. msgid "SchildiChat-android:"

  227. msgstr ""

  228. 

  229. #: ../../../docs/configuring-playbook-ntfy.md:90

  230. msgid ""

  231. "enable `Settings` -> `Notifications` -> `UnifiedPush: Force custom push "

  232. "gateway`."

  233. msgstr ""

  234. 

  235. #: ../../../docs/configuring-playbook-ntfy.md:91

  236. msgid ""

  237. "choose `Settings` -> `Notifications` -> `UnifiedPush: Re-register push "

  238. "distributor`. *(For info, a more complex alternative to achieve the same "

  239. "is: delete the relevant unifiedpush registration in `ntfy` app, force-"

  240. "close SchildiChat, re-open it.)*"

  241. msgstr ""

  242. 

  243. #: ../../../docs/configuring-playbook-ntfy.md:92

  244. msgid ""

  245. "verify `Settings` -> `Notifications` -> `UnifiedPush: Notification "

  246. "targets` as described below in the \"Troubleshooting\" section."

  247. msgstr ""

  248. 

  249. #: ../../../docs/configuring-playbook-ntfy.md:94

  250. msgid "Element-android v1.4.26+:"

  251. msgstr ""

  252. 

  253. #: ../../../docs/configuring-playbook-ntfy.md:95

  254. msgid "choose `Settings` -> `Notifications` -> `Notification method` -> `ntfy`"

  255. msgstr ""

  256. 

  257. #: ../../../docs/configuring-playbook-ntfy.md:96

  258. msgid ""

  259. "verify `Settings` -> `Troubleshoot` -> `Troubleshoot notification "

  260. "settings`"

  261. msgstr ""

  262. 

  263. #: ../../../docs/configuring-playbook-ntfy.md:98

  264. msgid ""

  265. "If the Matrix app asks, \"Choose a distributor: FCM Fallback or ntfy\", "

  266. "then choose \"ntfy\"."

  267. msgstr ""

  268. 

  269. #: ../../../docs/configuring-playbook-ntfy.md:100

  270. msgid ""

  271. "If the Matrix app doesn't seem to pick it up, try restarting it and try "

  272. "the Troubleshooting section below."

  273. msgstr ""

  274. 

  275. #: ../../../docs/configuring-playbook-ntfy.md:102

  276. msgid "Web App"

  277. msgstr ""

  278. 

  279. #: ../../../docs/configuring-playbook-ntfy.md:104

  280. msgid ""

  281. "ntfy also has a web app to subscribe to and push to topics from the "

  282. "browser. This may be helpful to further troubleshoot UnifiedPush problems"

  283. " or to use ntfy for other purposes. The web app only runs in the browser "

  284. "locally (after downloading the JavaScript)."

  285. msgstr ""

  286. 

  287. #: ../../../docs/configuring-playbook-ntfy.md:106

  288. msgid ""

  289. "The web app is disabled in this playbook by default as the expectation is"

  290. " that most users won't use it. You can either use the [official hosted "

  291. "one](https://ntfy.sh/app) (it supports using other public reachable ntfy "

  292. "instances) or host it yourself by setting `ntfy_web_root: \"app\"` and "

  293. "re-running Ansible."

  294. msgstr ""

  295. 

  296. #: ../../../docs/configuring-playbook-ntfy.md:108

  297. msgid "Troubleshooting"

  298. msgstr ""

  299. 

  300. #: ../../../docs/configuring-playbook-ntfy.md:110

  301. msgid ""

  302. "First check that the Matrix client app you are using supports "

  303. "UnifiedPush. There may well be different variants of the app."

  304. msgstr ""

  305. 

  306. #: ../../../docs/configuring-playbook-ntfy.md:112

  307. msgid ""

  308. "Set the ntfy server's log level to 'DEBUG', as shown in the example "

  309. "settings above, and watch the server's logs with `sudo journalctl -fu "

  310. "matrix-ntfy`."

  311. msgstr ""

  312. 

  313. #: ../../../docs/configuring-playbook-ntfy.md:114

  314. msgid ""

  315. "To check if UnifiedPush is correctly configured on the client device, "

  316. "look at \"Settings -> Notifications -> Notification Targets\" in Element "

  317. "Android or SchildiChat Android, or \"Settings -> Notifications -> "

  318. "Devices\" in FluffyChat. There should be one entry for each Matrix client"

  319. " app that has enabled push notifications, and when that client is using "

  320. "UnifiedPush you should see a URL that begins with your ntfy server's URL."

  321. msgstr ""

  322. 

  323. #: ../../../docs/configuring-playbook-ntfy.md:116

  324. msgid ""

  325. "In the \"Notification Targets\" screen in Element Android or SchildiChat "

  326. "Android, two relevant URLs are shown, \"push\\_key\" and \"Url\", and "

  327. "both should begin with your ntfy server's URL. If \"push\\_key\" shows "

  328. "your server but \"Url\" shows an external server such as "

  329. "`up.schildi.chat` then push notifications will still work but are being "

  330. "routed through that external server before they reach your ntfy server. "

  331. "To rectify that, in SchildiChat (at least around version 1.4.20.sc55) you"

  332. " must enable the `Force custom push gateway` setting as described in the "

  333. "\"Usage\" section above."

  334. msgstr ""

  335. 

  336. #: ../../../docs/configuring-playbook-ntfy.md:118

  337. msgid ""

  338. "If it is not working, useful tools are \"Settings -> Notifications -> Re-"

  339. "register push distributor\" and \"Settings -> Notifications -> "

  340. "Troubleshoot Notifications\" in SchildiChat Android (possibly also "

  341. "Element Android). In particular the \"Endpoint/FCM\" step of that "

  342. "troubleshooter should display your ntfy server's URL that it has "

  343. "discovered from the ntfy client app."

  344. msgstr ""

  345. 

  346. #: ../../../docs/configuring-playbook-ntfy.md:120

  347. msgid ""

  348. "The simple [UnifiedPush "

  349. "troubleshooting](https://unifiedpush.org/users/troubleshooting/) app [UP-"

  350. "Example](https://f-droid.org/en/packages/org.unifiedpush.example/) can be"

  351. " used to manually test UnifiedPush registration and operation on an "

  352. "Android device."

  353. msgstr ""