This is an incomplete list of known issues with the ntfy server, web app, Android app, and iOS app. You can find a complete list on GitHub, but I thought it may be helpful to have the prominent ones here to link to.
For some (many?) users, the iOS app is not refreshing the view when new notifications come in. Until you manually swipe down, you do not see the newly arrived messages, even though the popup appeared before.
This is caused by some weirdness between the Notification Service Extension (NSE), SwiftUI and Core Data. I am entirely clueless on how to fix it, sadly, as it is ephemeral and not clear to me what is causing it.
Please send experienced iOS developers my way to help me figure this out.
If notifications do not show up at all anymore, there are a few causes for it (that I know of):
Firebase+APNS are being weird and buggy:
If this is the case, usually it helps to remove the topic/subscription and re-add it. That will force Firebase to
re-subscribe to the Firebase topic.
Self-hosted only: No upstream-base-url
set, or base-url
mismatch:
To make self-hosted servers work with the iOS
app, I had to do some horrible things (see iOS instant notifications for details).
Be sure that in your selfhosted server:
upstream-base-url: "https://ntfy.sh"
(not your own hostname!)base-url
matches exactly what you set the Default Server in iOS toIf you see New message
notifications on iOS, your iPhone can likely not talk to your self-hosted server. Be sure that
your iOS device and your ntfy server are either on the same network, or that your phone can actually reach the server.
Turn on tracing/debugging on the server (via log-level: trace
or log-level: debug
, see troubleshooting),
and read docs on iOS instant notifications.
ntfy defaults to web-push based subscriptions when installed as a progressive web app. Firefox Android has an open bug where it reports the PWA mode incorrectly. This causes ntfy to not automatically subscribe to web push, and requires you to go to the ntfy Settings page to enable it manually.
Safari does not support playing sounds for web push notifications, and treats them all as silent. This will be fixed with iOS 17 / Safari 17, which will be released later in 2023.
When resuming the installed PWA from the background, it sometimes crashes with an error from IndexedDB/Dexie, due to a WebKit bug. A reload will fix it until a permanent fix is found.