From ad92154dd10098ca9cce50cc61932ddc7d373405 Mon Sep 17 00:00:00 2001
From: Broque Thomas <batmanesignal@gmail.com>
Date: Fri, 12 Sep 2025 08:53:59 -0700
Subject: [PATCH] Update UNRAID.md

---
 UNRAID.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/UNRAID.md b/UNRAID.md
index 91fa0379..0abaf3de 100644
--- a/UNRAID.md
+++ b/UNRAID.md
@@ -182,6 +182,22 @@ This ensures:
 
 ## 🛠️ Troubleshooting
 
+### ❌ ModuleNotFoundError: No module named 'config.settings'
+
+**Problem**: Most common error - incorrect config volume mapping
+
+**Wrong**:
+```yaml
+- "/mnt/cache/appdata/soulsync:/app/config"  # ❌ This overwrites the app's config module
+```
+
+**Correct**:
+```yaml
+- "/mnt/cache/appdata/soulsync/config:/app/config"  # ✅ This maps to the config folder only
+```
+
+**Why this happens**: Mounting the entire appdata folder to `/app/config` overwrites SoulSync's Python `config/` module, causing import errors.
+
 ### Container Won't Start
 ```bash
 # Check Unraid logs