What is UnifiedPush and how to select a distributor
In previous version of FOSSWarn, the app has used a polling service to check if there are alerts for the user. This has some downsides and drains you battery and produces a delay until you receive a notifications. Since version 1.0 FOSSWarn uses the FOSS Public Alert Server to receive alerts and notifications. In order to receive these near real time notifications the server uses UnifiedPush and the client to.
UnifiedPush is a set of tool for push-notifications. Instead of polling, the client receive a push-notification and wakes up to perform an action. FOSSWarn uses unifiedPush to inform the client that an alert for the subscription occurred and the client can inform the user about that.
For push notifications, the system (in this case, the distributor app) holds an energy-efficient constant connection to the push server. This allows an application server to send a notification instantly without a lot of delay.
For polling, the app has to be woken up constantly. Every time the app wakes up, it connects to the server and checks if there is something new for the app. If this is the case, the app creates a notification and displays it; if not, the app goes back to sleep again. Using this, it is impossible to deliver near-realtime notifications. There will always be a delay. This can drain the battery, as this mechanism is not very optimized.
Using UnifiedPush, there are multiple components involved in sending a push notification from our server to our phone. In short, it works like this:
FOSS Public Alert Server -> sending notification -> Push Server (e.g. a ntfy server) -> sends message to phone -> Distributor app -> wakes -> FOSSWarn
All you have to do is choose a distributor. The distributor handles all the push notification connections for every app that is using UnifiedPush.
The whole project is about implementing a free and opensource infrastructure whithout the need for proprietary components. But you can select a Distributor which uses goggle if you really want.
If you already have a distributor installed choose this distributor in the selection menu. If you do not have a distributor installed, take a look at the overview which distributors are available for your platform. To the overview. If you don't know which one to choose, try nfty.
Do not use the default (ntfy.sh) server. This server has a rate limit of 250 notifications per day for each publisher. We can therefore not accept subscriptions with this push server. Please change the default server in the settings of the ntfy app and select a different one.
Here is an incomplete list of push ntfy servers you could choose:
- ntfy.adminforge.de 🇩🇪 Germany
- ntfy.envs.net 🇩🇪 Germany
- ntfy.mzte.de 🇩🇪 Germany
- ntfy.hostux.net 🇫🇷 France
- push.tchncs.de/ 🇩🇪 Germany
These servers might work, but we might get rate-limited:
- ntfy.tedomum.fr 🇫🇷 France
- ntfy.fossman.de 🇩🇪 Germany
Notice: The server under unifiedpush.kde.org was quite unreliable in the past. We can not recommend using it. This might change in the future.
If you know more reliable push servers, please give me a hint, and I will extend this list. Please be aware that server operators can log your messages. We are using encrypted push messages, so this should not be an issue.
If you don't change the server, the default FOSS Public Alert Server instance will not accept any subscriptions with this server. So if you get the error message Your UnifiedPush Server ntfy.sh is blocked, please check the ntfy app and change the default server. You can reset the push configuration in FOSS Warn under developer options and "troubleshoot notifications."
Please note that there is an issue with Conversations as UP distributor for FOSSWarn. This issue is tracked in #226. We are trying to fix that soon. In the meantime, please use a different UnifiedPush distributor.
For Linux there is only kunifiedpush available. The package is available for most platforms. Here, you can check if your distro has the package. (you need at least version 25.04.0)
/e/ OS brings its own fork of the ntfy app that is preinstalled. While this is a good idea, they missed making the UI accessible. With the preinstalled version, it is impossible to change the app settings, which is required to change the default server. More advanced users can read this blog post for details. For everyone else, I would recommend installing the ntfy version from the F-Droid store and following the instructions here to change the default server. I hope the /e/OS team will improve that in the future.
German - These step-by-step instructions will be translated into English as soon as time permits.
Schritt 1: FOSSWarn update installieren.
Öffnen Sie F-Droid und schauen Sie unter Updates nach einem neuen Update für die FOSSWarn app. Klicken Sie auf die App und dann auf Aktualisieren
Schritt 2: Installieren Sie einen UnifiedPush Distributor Für das neue Update und um in Zukunft Push Benachrichtigungen zu erhalten, brauchen Sie einen UnifiedPush distributor. Dieser Distributor ist eine weitere App auf ihrem Gerät, der für alle Apps die UnifiedPush verwenden, die nötigen Funktionen für Push Benachrichtigungen bereitstellt.
Für UnifiedPush gibt es mehrere Distrubutoren, die Sie verwenden können. Die am meisten verwendeten sind:
- ntfy (benötigt eine Änderung des Standardservers)
- sunUp (von Mozilla)
- NextPush (braucht eine eigene Nextcloud und dort ein Plugin)
- Conversations (durch ein Problem, aktuell nicht verwendbar mit FOSSWarn, wir arbeiten an einer Lösung)
Im folgenen werden wir die Einrichtung sowohl mit der ntfy app als auch mit der App sunup zeigen.
Schritt 3.1: installieren der ntfy app:
Öffnen Sie den F-Droid App-Store und suchen Sie nach der App "ntfy". Klicken Sie auf Installieren.
Öffnen Sie anschließend die App ntfy indem Sie auf öffnen klicken oder App in ihrem App launcher suchen.
Die App fragt nun als Erstes nach Ihrer Berechtigung für Benachrichtigungen. Wählen Sie Zulassen.
Sie sehen nun die Übersichtsseite der ntfy app. Bisher gibt es dort nichts zu sehen, da noch keine Themen abonniert sind. Für FOSSWarn ist es nun nötig, den Standard-Server zu ändern. Der voreingestellte Server erlaubt unserem Server nicht genug Benachrichtigungen am Tag zu verschicken und kann daher nicht verwendet werden. Um den Server umzustellen, klicken Sie auf die drei Punkte oben rechts und wählen Sie Einstellungen
Scrollen Sie etwas runter bis zu dem Menüpunkt Standard-Server. Dort sehen Sie, dass der voreingestellte Server ntfy.sh ist.
Klicken Sie auf dem Menüpunkt. In dem Textfenster können Sie nun einen neuen Server eintragen. Es gibt einige frei nutzbare Server, die Sie hier eintragen können. Wir stellen bspw zusammen mit KDE den Server Der KDE Server unter https://unifiedpush.kde.org zur Verfügung./unifiedpush.kde.org hat derzeit Probleme mit DDOS Angriffen und ist daher leider schlecht zu erreichen. Weiter oben finden Sie eine Liste mit Alternativen. Suchen Sie einen Server aus und tragen Sie diesen Server in das Textfeld ein und bestätigen Sie den Dialog mit ok.
Bei der Sunup app suchen Sie in F-Droid genauso wie für die ntfy app und installieren Sie diese App. Nach dem Öffnen, fragt die App in einem Dialog nach einigen Berechtigungen. Klicken Sie auf OK
Im Folgenden fragt die App nach der Berechtigungen, Ihnen Benachrichtigungen zu schicken. Klicken Sie hier auf Zulassen. Anschließend fragt die App noch nach der Berechtigung von der Batterie-Optimierung ausgenommen zu werden.
Klicken Sie auf Disable optimization und in dem anschließenden Dialog auf Zulassen.
Sie können die App nun wieder schließen. Die Einrichtung ist jetzt abgeschlossen.
Die App fragt nun, als Erstes danach welchen psuh distributor Sie nutzen wollen. Wählen Sie hier entweder ntfy oder sunup.
Durchlaufen Sie nun die Einführung und erteilen Sie die Berechtigungen für Benachrichtigungen und die Ausnahme für die Akku-Optimierung.
(nur für ntfy bei frischer Installation) Gehen Sie nun nochmal zurück in die ntfy App. Die App zeigt nun neue Hinweise an und fragt danach die Akku Optimierung zu deaktivieren soweit auf Websockets umzustellen. Klicken Sie auf "Jetzt aktivieren" und "Jetzt beheben". Dieser Schritt könnte etwas Nutzerfreundlicher sein und wird sich hoffentlich in Zukunft verbessern. Wechseln Sie nun zurück in FOSSWarn.
Sie landen nun in der Übersicht. Als Nächstes müssen Sie einen Ort hinterlegen, für den Sie Benachrichtigungen erhalten möchten.
Wechseln Sie dafür auf den Reiter "Meine Orte" und klicken Sie auf das Plus unten rechts. Es öffnen sich ein neues Fenster. Suchen Sie nun nach einem beliebigen Ort und klicken Sie auf einen der Vorschläge.
Ihnen wird nun eine Vorschau angezeigt, welches Gebiet Sie ausgewählt haben. Mit dem Schieberegler unten, können Sie die Größe des Bereichs ändern. Klicken Sie anschließend auf Ort hinzufügen.
Es dauert einen kurzen Moment und es erscheint die Meldung `Warten Sie, bis die Push-Registriebung abgeschlossen ist" und anschließend ein "Erfolgreich Registriert".
Sie haben nun erfolgreich Ihren ersten Ort hinterlegt. Sie können nun beliebig viele weitere Orte mit dem gleichen Vorgehen hinterlegen.
Hinweis für den Fall, dass hier Probleme auftreten: Die ganze Infrastruktur ist noch neu und daher kann es noch ab und an sein, dass etwas noch nicht so ganz Rund läuft. Für den Fall, dass Sie einen Fehler bekommen bei der Registrierung mit dem ntfy Server, probieren Sie folgende Lösungsschritte:
-
Versuchen Sie noch einen anderen Server. Es kann sein, dass der kde Server derzeit überlastet ist. Wir arbeiten daran, das zu verbessern, aber noch kann das ab und zu passieren. Weiter oben, finden Sie eine Liste mit Alternativen ntfy Servern.
-
Versuchen Sie einen anderen Distributor wie sunup oder NextPush.
Um den UnifiedPush distributor zu wechslen, gehen Sie in die Einstellungen von FOSSWarn -> Entwicklereinstellungen -> Fehlerbehebung bei Benachrichtigungen. Dort können Sie mit dem einem Klick auf Push Setup zurücksetzen den Distributor wechseln.
(Die hier angezeigten Keys sollten Sie nicht öffentlich teilen)
last update: 18.02.2026