Home
A bug-fix build of Calibre-Web-Automated (CWA). Same data layout, same configuration, same UI. The differences are listed in CHANGES-vs-upstream.md and per release on the Releases page.
Built on Calibre-Web-Automated by @crocodilestick, which is built on Calibre-Web by @janeczku and contributors, which is built on Calibre by @kovidgoyal. Original PR authors are credited by handle on every backport.
- image: crocodilestick/calibre-web-automated:latest
+ image: ghcr.io/new-usemame/calibre-web-nextgen:latestdocker compose pull && docker compose up -dLibrary, settings, users, OAuth tokens, and KOReader sync state are preserved. Switching back is the reverse one-line change.
Not using a terminal? If you run Docker through a NAS or a GUI, follow a step-by-step guide instead — they cover both a fresh install and switching from CWA, with the exact buttons for your platform: Synology · Unraid · Portainer · TrueNAS SCALE · all guides. Configuration not matching? Open an issue or ask on Discord and we'll walk you through it.
- Bug? File it here.
- Feature idea? Open a request. Anything goes, no checklist required — even half-formed ideas are welcome and help prioritize what to look at next.
- New here? See Quick start below.
- Want to back the work? Subscribe monthly on Ko-fi — recurring support funds ongoing development. One-time tips welcome too.
-
Setting up with an AI assistant (Claude, ChatGPT, etc.)? Point it at
AI_README.md— a setup guide written for the assistant to follow, verify, and hand back to you working.
CWA has an open PR queue with community-submitted bug fixes that aren't in the latest published image. This build picks the safe ones, ships them in regular releases, and adds fresh fixes for high-impact bugs that don't have an upstream PR yet. Scope is bug fixes; feature work is out of scope.
The data format and configuration are byte-compatible with upstream, so swapping images is reversible and migrations aren't needed in either direction.
Everything CWA has, plus the patches in CHANGES-vs-upstream.md. A representative slice of fixes that are in this build but not in crocodilestick/calibre-web-automated:latest:
- Cover saves from Hardcover, Google Books, iTunes, and Open Library (was returning "not a valid image" since 4.0.6).
- Metadata search and the book-delete button on Safari.
- Generate Kobo Auth Token (was returning a blank page).
- Kobo bookmark sync no longer crashes when the client omits
Location. - Auth check added to 14 admin routes (
cwa_logs,convert,epub_fixer, and others) that previously didn't require admin. - Cover-enforcer shell-injection on filenames containing quotes.
- Reverse proxy: user-profile saves honor the path prefix.
- Docker healthcheck follows the
/ → /login302 instead of failing on it. -
.cbrand.cbzuse IANA-registered mimetypes in OPDS feeds. - Higher-resolution covers from Google Books, Amazon, and an iTunes-backed fallback for high-DPI e-readers (Libra Color, etc.).
- Translation PRs merged: ja, fr, cs, hu, zh_Hans, zh_Hant, and others.
See Differences from Upstream for the full behavior table.
| I want to… | Page |
|---|---|
| Get running in 5 minutes | Quick Start |
| See the full documented compose file + per-platform guides | Installation |
| Do the first-run setup | First Run |
| Keep the image up to date | Updating |
| Come from CWA or stock Calibre-Web | Migrating |
| Add book search + requests | Shelfmark |
| Network shares, plugins, reverse proxy, Hardcover | Configuration |
| Sync reading progress with KOReader | KOReader Sync |
| Read on a Kobo e-reader | Kobo Sync |
| Fix a problem | Troubleshooting |
| Help out | Contributing |
Community-maintained CWA build. License: GPL-3.0-or-later. See LICENSE.