From 84e35077d676a4740aa092a646c468434be2004c Mon Sep 17 00:00:00 2001
From: aksPatel08 <156384104+aksPatel08@users.noreply.github.com>
Date: Fri, 6 Mar 2026 18:01:26 -0800
Subject: [PATCH] Update README.md

Fix documentation issue described in #107
---
 README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/README.md b/README.md
index 5b87fead..7b4e8335 100644
--- a/README.md
+++ b/README.md
@@ -61,6 +61,18 @@ For a full list of configuration parameter take a look at [PARAMETERS](docs/PARA
 
 For the architecture design of AudioMuse-AI, take a look to the [ARCHITECTURE](docs/ARCHITECTURE.md) page.
 
+## 🔍 Troubleshooting Connection Issues
+
+If the web interface reports **"No new albums"** or if analysis appears to be silently failing, your media server (Jellyfin/Navidrome/Emby) may be unreachable from the container.
+
+**How to verify the connection:**
+Since detailed error messages are suppressed in the UI for security, you must check the backend worker logs to see the specific connection fault:
+
+1. Identify your container name (usually `audiomuse-ai-worker`).
+2. Run the following command:
+   ```bash
+   docker logs audiomuse-ai-worker
+
 **Prerequisites:**
 * Docker and Docker Compose installed
 * A running media server (Jellyfin, Navidrome, Lyrion, or Emby)