Files
serverAppConfigs/serverAppConfigs-docs/Dankserver/readarr.md
T
Frank 5829a0bfe8 docs: rename docs/ -> serverAppConfigs-docs/ per system-wide PROJECTNAME-docs convention
All in-repo path references (AGENTS.md, README, old scripts, report artifacts,
test code paths) rewritten in the same commit; focused-test map extended for
.gitignore, old/scripts/*, dankclaw/comfyui/*, and report/* per this repo's
own convention ('add one before committing'). Obsidian wikilinks are
title-based and unaffected.
2026-08-28 02:20:06 -07:00

2.0 KiB

Readarr

RETIRED (May 2026). The Servarr Team retired Readarr: its metadata became unusable and the community migration to Open Library stalled. There is no upstream development. Alternatives: the Bookshelf community fork, or the Calibre content server. See Readarr (Retired).

Readarr manages ebooks and audiobooks in the *arr stack on Dankserver. It automatically searches, downloads, and organizes books into the Calibre library.

Host: Dankserver — Hostname: readarr.dankserver.local — Docs: https://wiki.servarr.com/readarr

Facts

Item Value
Image lscr.io/linuxserver/readarr:latest (v0.2.x development)
Port 8787 (host) → 8787 (container)
Min RAM 256 MB
Metadata Goodreads / StoryGraph

Docker Compose

readarr:
  image: lscr.io/linuxserver/readarr:latest
  container_name: readarr
  restart: unless-stopped
  environment:
    - PUID=1000
    - PGID=1000
    - TZ=America/New_York
    - UMASK_SET=022
  volumes:
    - /opt/readarr/config:/config
    - /mnt/media/books:/books
    - /mnt/media/downloads:/downloads
  ports:
    - "8787:8787"
  networks: [appnet]

Configuration

  1. Add Prowlarr as the indexer source (torrent indexers with book content).
  2. Add qBittorrent as the download client with the books category.
  3. Set author profile (format preference: epub, mobi, etc.).
  4. Set quality profile for audiobooks (320 kbps MP3, 128 kbps, lossless).
  5. Set root folder to /books.
  6. Add authors and verify downloads.

Gotchas

  • Readarr is in development (~v0.2.x). Some features may be incomplete.
  • Calibre integration is folder-based, not API-based. Readarr drops files into /books which Calibre-Web serves.
  • Not all indexers have all formats (epub, mobi, pdf). Goodreads/StoryGraph metadata helps match editions.

See Also

  • ARR-Stack — full *arr stack documentation
  • Calibre-Web — ebook web frontend that serves Readarr downloads