From f3608b0f302d7c898e824c077d5bb39733a70974 Mon Sep 17 00:00:00 2001
From: Nicolas Meienberger <github@thisprops.com>
Date: Wed, 18 Feb 2026 21:55:46 +0100
Subject: [PATCH] docs: update TROUBLESHOOTING.md with LOG_LEVEL instruction

---
 TROUBLESHOOTING.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md
index a6a2a106..d8d305f4 100644
--- a/TROUBLESHOOTING.md
+++ b/TROUBLESHOOTING.md
@@ -7,6 +7,17 @@ In case you need further assistance, feel free to open a new issue with detailed
 > [!WARNING]
 > Make sure to never share sensitive information such as passwords, access keys, or personal data in public issues so remove them from logs before posting.
 
+Before troubleshooting, enable debug logging so the logs contain enough detail to diagnose issues.
+
+```yaml
+services:
+  zerobyte:
+    environment:
+      - LOG_LEVEL=debug
+```
+
+After adding `LOG_LEVEL=debug`, restart Zerobyte and then collect logs.
+
 To view the logs, run the command below:
 
 ```bash