Skip to content

Migrating

new-usemame edited this page Jul 4, 2026 · 1 revision

Migrating

From upstream CWA

One line. Stop the container, swap the image, start it.

- image: crocodilestick/calibre-web-automated:latest
+ image: ghcr.io/new-usemame/calibre-web-nextgen:latest
docker compose pull && docker compose up -d

Settings, users, OAuth tokens, and KOReader sync state are preserved. The data format is identical, so reverting is the reverse one-line change.

From stock Calibre-Web

  1. Stop your existing Calibre-Web container.
  2. In the new compose file, point /config at the same /config folder you used for Calibre-Web.
  3. Whatever you bound as /books in Calibre-Web should be bound as /calibre-library here.
  4. Pick an empty folder for /cwa-book-ingest (it's CWA-specific; no equivalent in stock CW).
  5. Start the container.

Users, settings, and shelves carry over. The first launch takes a few extra seconds while CWA registers itself with the existing app database.

Clone this wiki locally