Files
serverAppConfigs/docs/Dankserver/Calibre-Web.md
T
Frank e3eb5334cb feat: initialize serverAppConfigs with podman stacks for Dankserver and Dankclaw
- Dankserver stack: RomM, Copyparty, Calibre-Web, node-exporter
- Dankclaw stack: Gluetun VPN (SearXNG tunnel), SearXNG+Valkey, ComfyUI
  (CPU backend), OpenWebUI, Hermes, Gitea+Postgres (migrated), Caddy
  reverse proxy, Grafana+Prometheus+Loki+Alloy observability
- Caddyfiles with .local hostname convention and basicauth homepage
- bind-mount storage policy, no named volumes
- deploy.sh mirroring vllmScripts git workflow (push -> pull -> restart -> health)
- docs/ Obsidian vault: per-service docs from frank-default-small research
  subagents (promtail EOL -> Alloy; gitea SECRET_KEY preservation; ComfyUI --cpu)
- bats test suite at 6 seams — 22 tests green
2026-08-13 20:19:41 -07:00

1.8 KiB

Calibre-Web

Calibre-Web is a web app that browses, reads, and downloads eBooks from an existing Calibre library database. It is the web frontend for the Calibre e-book manager.

Host: Dankserver — Hostname: books.dankserver.local — Docs: https://github.com/linuxserver/docker-calibre-web

Facts (from research, primary source)

Item Value
Image lscr.io/linuxserver/calibre-web:latest (already running on Dankserver)
Port 8083 (host) → 8083 (container)
Env PUID=1000, PGID=1000, TZ=Etc/UTC
Optional DOCKER_MODS=linuxserver/mods:universal-calibre (ebook conversion, x86-64 only)
Volumes /config (internal db + config), /books (existing Calibre library)
Extra tools unrar (path /usr/bin/unrar), kepubify (path /usr/bin/kepubify)

Configuration

  • Set the library path in the Calibre-Web admin page: Basic Configuration → Calibre Database → Location of Calibre database = /books.
  • Set the external binary paths in Basic Configuration → External Binaries after first login.
  • The default login is admin / admin123 on first boot; change it immediately.

Volumes

Container path Host path (convention)
/config /opt/calibre-web/config
/books the existing Calibre library directory (user-entered later)

Healthcheck

The web UI responds on 8083. A wget -q --spider check on / suffices.

Gotchas

  • If the DB path is wrong, login appears to succeed but the library is empty.
  • Ebook conversion needs the universal-calibre mod AND the external binary path set to /usr/bin/ebook-convert (or /usr/bin/ on newer versions).
  • Google OAuth needs OAUTHLIB_RELAX_TOKEN_SCOPE=1.

See Also