From 39936a95f87e388c30b030f046706ad84bd77bc8 Mon Sep 17 00:00:00 2001
From: Pixelguin <11445611+Pixelguin@users.noreply.github.com>
Date: Mon, 5 Jan 2026 08:11:20 -0800
Subject: [PATCH] Add troubleshooting steps for "Reconnecting" error on mobile

---
 docs/troubleshooting.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 3d090306..e093647e 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -129,3 +129,14 @@ keyboard.
 
 ## iOS app
 Sorry, there is no way to debug or get the logs from the iOS app (yet), outside of running the app in Xcode.
+
+## Other
+
+### "Reconnecting..." / Late notifications on mobile (self-hosted)
+
+If all of your topics are showing as "Reconnecting" and notifications are taking a long time (30+ minutes) to come in, or if you're only getting new pushes with a manual refresh, double-check your configuration:
+
+* If ntfy is behind a reverse proxy, make sure `behind_proxy` is enabled.
+* If ntfy is behind Nginx, make sure WebSockets are enabled.
+* Make sure you have granted permission to access all of your topics, either to a logged-in user account or to `everyone`. All subscribed topics are joined into a single WebSocket/JSON, so a single topic that receives `403 Forbidden` will prevent the entire request from going through.
+  * In particular, double-check that your user has permission to read `up*` if you are using UnifiedPush.