Skip to content

Add Calibre-Web ebook library service#37

Merged
riccjohn merged 3 commits into
mainfrom
add-calibre-web
Apr 20, 2026
Merged

Add Calibre-Web ebook library service#37
riccjohn merged 3 commits into
mainfrom
add-calibre-web

Conversation

@riccjohn
Copy link
Copy Markdown
Owner

@riccjohn riccjohn commented Apr 20, 2026

Closes #19

Summary

  • Adds calibre-web service to docker-compose.yml using lscr.io/linuxserver/calibre-web:latest with a read-only Syncthing library mount (:ro prevents metadata.db corruption)
  • Adds Books group with calibreweb widget to the Homepage dashboard, wired between the Media and Files groups
  • Documents CALIBRE_PATH, CALIBREWEB_USERNAME, and CALIBREWEB_PASSWORD in .env.example
  • Adds first-run setup instructions to README.md (step 10)

Test plan

  • docker compose config --quiet exits 0
  • ./scripts/lint-config.sh exits 0 — all 8 HOMEPAGE_VAR_* and 13 .env.example var checks pass
  • On server: set CALIBRE_PATH in .env, run docker compose up -d calibre-web, complete first-run wizard at https://calibre-web.woggles.work
  • Verify Homepage Books group shows Calibre-Web widget with correct library stats

🤖 Generated with Claude Code

riccjohn and others added 3 commits April 19, 2026 19:35
Adds calibre-web behind Traefik with a read-only Syncthing library mount,
Homepage Books group with widget, and full env var documentation.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Reuses the same host path Syncthing writes to, eliminating a redundant
env var. Database path in the first-run wizard is now /sync/Calibre_Library.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@riccjohn riccjohn merged commit a3bf6c5 into main Apr 20, 2026
1 check passed
@riccjohn riccjohn deleted the add-calibre-web branch April 20, 2026 01:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Calibre-Web ebook service

1 participant