# SOME DESCRIPTIVE TITLE. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community # members # This file is distributed under the same license as the # matrix-docker-ansible-deploy package. # FIRST AUTHOR , 2024. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-12-16 12:05+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" "Language-Team: jp \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.16.0\n" #: ../../../docs/configuring-playbook-ntfy.md:1 msgid "Setting up the ntfy push notifications server (optional)" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:3 msgid "" "The playbook can install and configure the [ntfy](https://ntfy.sh/) push " "notifications server for you." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:5 msgid "" "Using the [UnifiedPush](https://unifiedpush.org) standard, ntfy enables " "self-hosted (Google-free) push notifications from Matrix (and other) " "servers to UnifiedPush-compatible Matrix compatible client apps running " "on Android and other devices." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:7 msgid "" "This role is intended to support UnifiedPush notifications for use with " "the Matrix and Matrix-related services that this playbook installs. This " "role is not intended to support all of ntfy's other features." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:9 msgid "" "**Note**: In contrast to push notifications using Google's FCM or Apple's" " APNs, the use of UnifiedPush allows each end-user to choose the push " "notification server that they prefer. As a consequence, deploying this " "ntfy server does not by itself ensure any particular user or device or " "client app will use it." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:11 msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:13 msgid "" "To enable ntfy, add the following configuration to your " "`inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:27 msgid "" "For a more complete list of variables that you could override, see the " "[`defaults/main.yml` file](https://github.com/mother-of-all-self-hosting" "/ansible-role-ntfy/blob/main/defaults/main.yml) of the ntfy Ansible role." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:29 msgid "" "For a complete list of ntfy config options that you could put in " "`ntfy_configuration_extension_yaml`, see the [ntfy config " "documentation](https://ntfy.sh/docs/config/#config-options)." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:31 msgid "Adjusting the ntfy URL" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:33 msgid "" "By default, this playbook installs ntfy on the `ntfy.` subdomain " "(`ntfy.example.com`) and requires you to [adjust your DNS records" "](#adjusting-dns-records)." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:35 msgid "" "By tweaking the `ntfy_hostname` variable, you can easily make the service" " available at a **different hostname** than the default one." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:37 msgid "" "Example additional configuration for your " "`inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:44 msgid "Adjusting DNS records" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:46 msgid "" "Once you've decided on the domain, **you may need to adjust your DNS** " "records to point the ntfy domain to the Matrix server." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:48 msgid "" "By default, you will need to create a CNAME record for `ntfy`. See " "[Configuring DNS](configuring-dns.md) for details about DNS changes." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:50 msgid "Installing" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:52 msgid "" "After configuring the playbook and potentially [adjusting your DNS " "records](#adjusting-dns-records), run the playbook with [playbook tags" "](playbook-tags.md) as below:" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:59 msgid "" "The shortcut commands with the [`just` program](just.md) are also " "available: `just install-all` or `just setup-all`" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:61 msgid "" "`just install-all` is useful for maintaining your setup quickly ([2x-5x " "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-" "runtime) than `just setup-all`) when its components remain unchanged. If " "you adjust your `vars.yml` to remove other components, you'd need to run " "`just setup-all`, or these components will still remain installed. Note " "these shortcuts run the `ensure-matrix-users-created` tag too." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:63 msgid "Usage" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:65 msgid "" "To make use of your ntfy installation, on Android for example, you need " "two things:" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:67 msgid "the `ntfy` app" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:68 msgid "a UnifiedPush-compatible Matrix app" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:70 msgid "" "You need to install the `ntfy` app on each device on which you want to " "receive push notifications through your ntfy server. The `ntfy` app will " "provide UnifiedPush notifications to any number of UnifiedPush-compatible" " messaging apps installed on the same device." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:72 msgid "Setting up the `ntfy` Android app" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:74 msgid "" "Install the [ntfy Android app](https://ntfy.sh/docs/subscribe/phone/) " "from F-droid or Google Play." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:75 msgid "" "In its Settings -> `General: Default server`, enter your ntfy server URL," " such as `https://ntfy.example.com`." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:76 msgid "In its Settings -> `Advanced: Connection protocol`, choose `WebSockets`." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:78 msgid "" "That is all you need to do in the ntfy app. It has many other features, " "but for our purposes you can ignore them. In particular you do not need " "to follow any instructions about subscribing to a notification topic as " "UnifiedPush will do that automatically." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:80 msgid "Setting up a UnifiedPush-compatible Matrix app" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:82 msgid "" "Install any UnifiedPush-enabled Matrix app on that same device. The " "Matrix app will learn from the `ntfy` app that you have configured " "UnifiedPush on this device, and then it will tell your Matrix server to " "use it." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:84 msgid "Steps needed for specific Matrix apps:" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:86 msgid "FluffyChat-android:" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:87 msgid "Should auto-detect and use it. No manual settings." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:89 msgid "SchildiChat-android:" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:90 msgid "" "enable `Settings` -> `Notifications` -> `UnifiedPush: Force custom push " "gateway`." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:91 msgid "" "choose `Settings` -> `Notifications` -> `UnifiedPush: Re-register push " "distributor`. *(For info, a more complex alternative to achieve the same " "is: delete the relevant unifiedpush registration in `ntfy` app, force-" "close SchildiChat, re-open it.)*" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:92 msgid "" "verify `Settings` -> `Notifications` -> `UnifiedPush: Notification " "targets` as described below in the \"Troubleshooting\" section." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:94 msgid "Element-android v1.4.26+:" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:95 msgid "choose `Settings` -> `Notifications` -> `Notification method` -> `ntfy`" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:96 msgid "" "verify `Settings` -> `Troubleshoot` -> `Troubleshoot notification " "settings`" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:98 msgid "" "If the Matrix app asks, \"Choose a distributor: FCM Fallback or ntfy\", " "then choose \"ntfy\"." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:100 msgid "" "If the Matrix app doesn't seem to pick it up, try restarting it and try " "the Troubleshooting section below." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:102 msgid "Web App" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:104 msgid "" "ntfy also has a web app to subscribe to and push to topics from the " "browser. This may be helpful to further troubleshoot UnifiedPush problems" " or to use ntfy for other purposes. The web app only runs in the browser " "locally (after downloading the JavaScript)." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:106 msgid "" "The web app is disabled in this playbook by default as the expectation is" " that most users won't use it. You can either use the [official hosted " "one](https://ntfy.sh/app) (it supports using other public reachable ntfy " "instances) or host it yourself by setting `ntfy_web_root: \"app\"` and " "re-running Ansible." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:108 msgid "Troubleshooting" msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:110 msgid "" "First check that the Matrix client app you are using supports " "UnifiedPush. There may well be different variants of the app." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:112 msgid "" "Set the ntfy server's log level to 'DEBUG', as shown in the example " "settings above, and watch the server's logs with `sudo journalctl -fu " "matrix-ntfy`." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:114 msgid "" "To check if UnifiedPush is correctly configured on the client device, " "look at \"Settings -> Notifications -> Notification Targets\" in Element " "Android or SchildiChat Android, or \"Settings -> Notifications -> " "Devices\" in FluffyChat. There should be one entry for each Matrix client" " app that has enabled push notifications, and when that client is using " "UnifiedPush you should see a URL that begins with your ntfy server's URL." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:116 msgid "" "In the \"Notification Targets\" screen in Element Android or SchildiChat " "Android, two relevant URLs are shown, \"push\\_key\" and \"Url\", and " "both should begin with your ntfy server's URL. If \"push\\_key\" shows " "your server but \"Url\" shows an external server such as " "`up.schildi.chat` then push notifications will still work but are being " "routed through that external server before they reach your ntfy server. " "To rectify that, in SchildiChat (at least around version 1.4.20.sc55) you" " must enable the `Force custom push gateway` setting as described in the " "\"Usage\" section above." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:118 msgid "" "If it is not working, useful tools are \"Settings -> Notifications -> Re-" "register push distributor\" and \"Settings -> Notifications -> " "Troubleshoot Notifications\" in SchildiChat Android (possibly also " "Element Android). In particular the \"Endpoint/FCM\" step of that " "troubleshooter should display your ntfy server's URL that it has " "discovered from the ntfy client app." msgstr "" #: ../../../docs/configuring-playbook-ntfy.md:120 msgid "" "The simple [UnifiedPush " "troubleshooting](https://unifiedpush.org/users/troubleshooting/) app [UP-" "Example](https://f-droid.org/en/packages/org.unifiedpush.example/) can be" " used to manually test UnifiedPush registration and operation on an " "Android device." msgstr ""