Frank
e3eb5334cb
- 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
45 lines
1.8 KiB
Markdown
45 lines
1.8 KiB
Markdown
# 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
|
|
|
|
- [[Dankserver Stack]]
|
|
- [[Calibre]] — the underlying library engine (host tool, not a container)
|