Frank
5829a0bfe8
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.
58 lines
2.0 KiB
Markdown
58 lines
2.0 KiB
Markdown
# 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)](https://wiki.servarr.com/readarr).
|
|
|
|
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
|
|
|
|
```yaml
|
|
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
|