From b7a1e7f169926b96232b288c6de9f43b96bec283 Mon Sep 17 00:00:00 2001
From: Julian <489233+naydichev@users.noreply.github.com>
Date: Thu, 17 Dec 2020 08:55:10 +0100
Subject: [PATCH] Updated Kobo Integration (markdown)

---
 Kobo-Integration.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/Kobo-Integration.md b/Kobo-Integration.md
index e37cc20..32fd9ef 100644
--- a/Kobo-Integration.md
+++ b/Kobo-Integration.md
@@ -39,4 +39,25 @@ Deleting a book from Calibre/Calibre-Web **will not** cause it to be removed fro
 ### Reading state and statistics
 Book progress and reading statistics are synced with and stored in Calibre-Web. At the moment, Calibre-Web will only display whether books have been completed (Read) or not (Unread).
 
+## Troubleshooting
+
+If you're having trouble with Kobo sync, there are a few things you can do to help identify the problem:
+1. enable debug logs on the Kobo itself
+  - search for `devmodeon` on the kobo
+  - go to settings -> device information -> on page 2, developer options
+  - here you can enable logs for specifig settings
+
+2. enable debug logs in calibre
+  - go to the calibre web admin panel
+  - go to basic configuration
+  - expand `Logfile configuration`
+  - adjust the log level (and location)
+  - optionally (though very useful) enable the access log
+
+3. monitor logs from the Kobo during a sync
+  - figure out the IP of your Kobo (you can do this from settings -> device information)
+  - run netcat to view the logs on your local machine: `nc $KOBO_IP 5001`
+
+4. if you're using a reverse proxy (such as nginx), enable access/error logs
+  - see nginx documentation for steps on how to do this for your setup