Known Issues

Current known issues and limitations.

Mobile Apps

Android

  • Instant delivery notification - The persistent notification for instant delivery cannot be hidden on Android 13+ without disabling the feature
  • Large attachments - Very large attachments may fail to download on low-memory devices
  • Notification grouping - Many notifications in quick succession may be grouped by Android

iOS

  • Background updates - iOS aggressively manages background connections, causing potential delays
  • Attachment previews - Large image previews may not display inline on older devices
  • Widget limitations - Home screen widget updates are managed by iOS and may be delayed

Web App

  • Safari notifications - Safari on macOS may require additional permission prompts
  • Firefox PWA - Firefox doesn't support PWA installation natively
  • Incognito mode - Some features may not work in private/incognito browsing

Server

  • SQLite locking - Under very high load, SQLite may experience lock contention
  • Large message cache - Very large cache files may impact startup time
  • Email attachments - Email notifications don't include attachments

API

  • WebSocket reconnection - WebSocket connections may not automatically reconnect after network changes
  • SSE in some proxies - Some reverse proxies may buffer SSE streams incorrectly
  • JSON parsing - Very long messages may cause issues with some JSON parsers

Workarounds

Instant delivery notification

On Android 13+, you can minimize (but not remove) the notification:

  1. Long-press the notification
  2. Tap the settings gear
  3. Set to "Silent"

iOS delays

For critical notifications:

  1. Use high priority (4-5)
  2. Accept some delay is inherent to iOS
  3. Consider a VoIP-based solution for truly instant needs

Proxy buffering

Configure your reverse proxy to disable buffering for ntfy paths:

nginx:

location / {
    proxy_buffering off;
    proxy_cache off;
}

Reporting Issues

Found a new issue? Report it on GitHub Issues.

Please include:

  • Platform and version
  • Steps to reproduce
  • Expected vs actual behavior
  • Relevant logs