🩹 What changed for you
Your admin → View Logs button is back. It was hidden, and the on-disk log file was always empty because everything was forced to stdout-only. Now logs go to BOTH docker logs (unchanged) AND /config/calibre-web.log (5 MiB × 5 backups = up to 30 MiB of retained history). You can read them right in admin → Server Status → View Logs without docker CLI access.
KOReader sync failures are no longer silent. If sync isn't working and you can't tell why, the log now tells you in one line:
WARN KOReader sync_disabled: rejecting /kosync/users/auth from <your IP>.
Enable in Admin → CWA Settings → KOReader Sync.
This is the exact diagnostic that would have explained @uschi1's "I migrated and now sync just stopped" thread (issue #312) — the toggle defaults off after migration from stock CWA, and previously there was nothing in the logs to point at that. Same goes for invalid passwords and book-not-recognized-by-checksum cases — they used to be DEBUG-only.
New "Get Support Pack" button. Right next to the existing Download Debug Package. The Support Pack is sanitized: passwords, OAuth tokens, public IPs, install paths, and Bearer/Basic auth header values are stripped. Safe to attach to a public GitHub issue. The full unredacted Download Debug Package is still there for admin/private use.
📥 Get it
docker pull ghcr.io/new-usemame/calibre-web-nextgen:latest
# or pin the tag:
docker pull ghcr.io/new-usemame/calibre-web-nextgen:v4.0.137
Compose users: nothing changes — your existing volumes carry forward. The first start after upgrade quietly migrates the config_logfile setting from /dev/stdout back to the file-default so your log viewer has content immediately. docker logs keeps working exactly as before.
🙏 Credit
Surfaced by @uschi1 in #312. She tried everything — reinstalled the plugin, switched devices — until "delete + redownload the book" accidentally un-broke it. This release makes that scenario self-diagnosable so the next user doesn't need to GitHub-thread their way to a fix.
📋 Full change
Single PR: #332 (admin-visible logs + sanitized debug pack + KOReader-sync log coverage). 60 unit tests, container-verified, Playwright UI pilot. See CHANGES-vs-upstream.md for the technical details.
🛟 If something's off
Open an issue at https://github.com/new-usemame/Calibre-Web-NextGen/issues — the new Get Support Pack button gives you a clean zip ready to attach.