Skip to main content

​
Chaptarr

Ebook and audiobook collection manager — a fork of the retired Readarr that handles both in one instance. Replaces the two Bookshelf instances. Runs on i3 (debian-1) as a Swarm service (chaptarr_chaptarr) on the swarm overlay. Image robertlordhood/chaptarr:latest (v0.9.439), port 8789. The earlier “runs on Pentium, inside the gluetun namespace” description is obsolete.

​
URL

ServiceURL
Chaptarrhttps://chaptarr.augustin.ai

​
How It Works

Hardcover import list → Chaptarr → Prowlarr (8 indexers) → qBittorrent/Gluetun → /media/books/ or /media/audiobooks/
  • Ebooks: host cron copies new files to the CWA ingest folder → Calibre library (see Reading Pipeline)
  • Audiobooks: Audiobookshelf picks them up from /media/audiobooks/

​
Configuration

  • Metadata server: api2.chaptarr.com (Settings → Development). The default api.chaptarr.com has SSL issues.
  • Download client: qBittorrent at gluetun:8085 (reached over the swarm overlay by service DNS — Chaptarr is no longer inside gluetun’s namespace, so it is not localhost).
  • Indexers: Prowlarr at prowlarr:9696 (overlay DNS).
  • Root folders: /media/books (ebooks), /media/audiobooks (audiobooks).
  • Import list: Hardcover Library — imports Want to Read + Currently Reading.

​
Management

No official CLI. API at http://chaptarr:8789/api/v1 (overlay) with X-Api-Key from chaptarr/config/config.xml. curl is not installed in the container — use wget -qO- --header="X-Api-Key: …" for in-container API calls.

​
Architecture

chaptarr.augustin.ai → Cloudflare tunnel → Traefik (i3, Swarm provider) → chaptarr_chaptarr (overlay)
Routed by Traefik’s Swarm provider via deploy.labels in chaptarr/compose.yaml.

​
Status

Several stages are currently broken (Hardcover import list returns nothing; NO_MATCH_HOLY_GRAIL import failures; indexer throttling). See the Known Issues section of the Reading Pipeline doc.