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