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

356 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: 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. 

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

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

  26. msgstr ""

  27. 

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

  29. msgid ""

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

  31. "notifications server for you."

  32. msgstr ""

  33. 

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

  35. msgid ""

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

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

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

  39. "on Android and other devices."

  40. msgstr ""

  41. 

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

  43. msgid ""

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

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

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

  47. msgstr ""

  48. 

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

  50. msgid ""

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

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

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

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

  55. "client app will use it."

  56. msgstr ""

  57. 

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

  59. msgid "Adjusting the playbook configuration"

  60. msgstr ""

  61. 

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

  63. msgid ""

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

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

  66. msgstr ""

  67. 

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

  69. msgid ""

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

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

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

  73. msgstr ""

  74. 

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

  76. msgid ""

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

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

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

  80. msgstr ""

  81. 

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

  83. msgid "Adjusting the ntfy URL"

  84. msgstr ""

  85. 

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

  87. msgid ""

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

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

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

  91. msgstr ""

  92. 

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

  94. msgid ""

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

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

  97. msgstr ""

  98. 

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

  100. msgid ""

  101. "Example additional configuration for your "

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

  103. msgstr ""

  104. 

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

  106. msgid "Adjusting DNS records"

  107. msgstr ""

  108. 

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

  110. msgid ""

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

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

  113. msgstr ""

  114. 

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

  116. msgid ""

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

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

  119. msgstr ""

  120. 

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

  122. msgid "Installing"

  123. msgstr ""

  124. 

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

  126. msgid ""

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

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

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

  130. msgstr ""

  131. 

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

  133. msgid ""

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

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

  136. msgstr ""

  137. 

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

  139. msgid ""

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

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

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

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

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

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

  146. msgstr ""

  147. 

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

  149. msgid "Usage"

  150. msgstr ""

  151. 

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

  153. msgid ""

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

  155. "two things:"

  156. msgstr ""

  157. 

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

  159. msgid "the `ntfy` app"

  160. msgstr ""

  161. 

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

  163. msgid "a UnifiedPush-compatible Matrix app"

  164. msgstr ""

  165. 

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

  167. msgid ""

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

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

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

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

  172. msgstr ""

  173. 

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

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

  176. msgstr ""

  177. 

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

  179. msgid ""

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

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

  182. msgstr ""

  183. 

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

  185. msgid ""

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

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

  188. msgstr ""

  189. 

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

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

  192. msgstr ""

  193. 

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

  195. msgid ""

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

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

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

  199. "UnifiedPush will do that automatically."

  200. msgstr ""

  201. 

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

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

  204. msgstr ""

  205. 

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

  207. msgid ""

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

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

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

  211. "use it."

  212. msgstr ""

  213. 

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

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

  216. msgstr ""

  217. 

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

  219. msgid "FluffyChat-android:"

  220. msgstr ""

  221. 

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

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

  224. msgstr ""

  225. 

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

  227. msgid "SchildiChat-android:"

  228. msgstr ""

  229. 

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

  231. msgid ""

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

  233. "gateway`."

  234. msgstr ""

  235. 

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

  237. msgid ""

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

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

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

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

  242. msgstr ""

  243. 

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

  245. msgid ""

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

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

  248. msgstr ""

  249. 

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

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

  252. msgstr ""

  253. 

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

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

  256. msgstr ""

  257. 

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

  259. msgid ""

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

  261. "settings`"

  262. msgstr ""

  263. 

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

  265. msgid ""

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

  267. "then choose \"ntfy\"."

  268. msgstr ""

  269. 

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

  271. msgid ""

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

  273. "the Troubleshooting section below."

  274. msgstr ""

  275. 

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

  277. msgid "Web App"

  278. msgstr ""

  279. 

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

  281. msgid ""

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

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

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

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

  286. msgstr ""

  287. 

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

  289. msgid ""

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

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

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

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

  294. "re-running Ansible."

  295. msgstr ""

  296. 

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

  298. msgid "Troubleshooting"

  299. msgstr ""

  300. 

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

  302. msgid ""

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

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

  305. msgstr ""

  306. 

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

  308. msgid ""

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

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

  311. "matrix-ntfy`."

  312. msgstr ""

  313. 

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

  315. msgid ""

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

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

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

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

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

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

  322. msgstr ""

  323. 

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

  325. msgid ""

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

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

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

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

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

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

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

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

  334. "\"Usage\" section above."

  335. msgstr ""

  336. 

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

  338. msgid ""

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

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

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

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

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

  344. "discovered from the ntfy client app."

  345. msgstr ""

  346. 

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

  348. msgid ""

  349. "The simple [UnifiedPush "

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

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

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

  353. "Android device."

  354. msgstr ""