# 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)