Übersicht

Bindery is a self-hosted ebook and audiobook automation server. Search OpenLibrary, Hardcover, and DNB for books and authors; monitor authors and series; hand requests to your *arr-style indexers and download client (NZB or torrent); import completed files into your library with proper metadata; serve an OPDS 1.2 catalogue to e-readers. Distroless image, Apache 2.0. First-run: open the WebUI to create an admin account. No env vars required for auth. Default user is 99:100. If you change PUID/PGID, also change the --user value in Extra Parameters; the container will fail fast if they don't match.

Laufzeit-Argumente

Web-UI: http://[IP]:[PORT:8787]/
Netzwerk: bridge
Privilegiert: false
Extra Params: --user 99:100

Konfiguration der Vorlage

WebUIPorttcp

HTTP port for the web interface, API, and OPDS catalogue.

Ziel: 8787
Standard: 8787
Wert: 8787

ConfigPathrw

SQLite database, image cache, and backups. Must persist across container restarts.

Ziel: /config
Standard: /mnt/user/appdata/bindery
Wert: /mnt/user/appdata/bindery

BooksPathrw

Imported ebook library root. Bindery moves/copies/hardlinks files here from Downloads after import.

Ziel: /books

AudiobooksPathrw

Optional separate root for imported audiobook folders. Leave blank to keep audiobooks under /books. If you map a path here, also set BINDERY_AUDIOBOOK_DIR=/audiobooks below.

Ziel: /audiobooks

DownloadsPathrw

Watch folder for completed downloads. Should match the path SABnzbd / qBittorrent writes to.

Ziel: /downloads

Log LevelVariable

Log verbosity: debug, info, warn, error.

Ziel: BINDERY_LOG_LEVEL
Standard: info|debug|warn|error

PUIDVariable

UID the container will validate against. Must match the UID half of the --user flag in Extra Parameters. Default 99 = Unraid 'nobody'.

Ziel: BINDERY_PUID
Standard: 99
Wert: 99

PGIDVariable

GID the container will validate against. Must match the GID half of the --user flag in Extra Parameters. Default 100 = Unraid 'users'.

Ziel: BINDERY_PGID
Standard: 100
Wert: 100

Audiobook DirectoryVariable

Set to /audiobooks if you mapped a separate Audiobooks path above. If blank, audiobooks are imported into /books alongside ebooks.

Ziel: BINDERY_AUDIOBOOK_DIR

URL BaseVariable

Subpath prefix when hosting behind a reverse proxy at /bindery (e.g. SWAG / Nginx Proxy Manager). Leave blank for root.

Ziel: BINDERY_URL_BASE

Trusted ProxiesVariable

Comma-separated CIDR list of reverse proxies allowed to set X-Forwarded-* headers. Required if you rely on X-Forwarded-For for auth or rate limits.

Ziel: BINDERY_TRUSTED_PROXY

Cookie SecureVariable

Session cookie Secure flag: auto (detect TLS via X-Forwarded-Proto), always, or never.

Ziel: BINDERY_COOKIE_SECURE
Standard: auto|always|never

Download Path RemapVariable

Comma-separated from:to pairs, used when SABnzbd / qBittorrent reports a path that doesn't match what Bindery sees. Example: /downloads:/data/downloads