Frank
8212d4451a
Mechanical identity rename across the knowledge base, AGENTS.md, README, the
hermes config example, and homepage services.json. No behavior change; served
aliases on the LLM endpoints change with the deploy of commit 69f87c8.
3.3 KiB
type, title, description, tags, timestamp
| type | title | description | tags | timestamp | |||
|---|---|---|---|---|---|---|---|
| reference | Readarr | Readarr ebook/audiobook manager in the *arr stack on FrankBook-Pro — retired upstream, pinned image, parked qB download client. |
|
2026-09-03T00:00:00Z |
Readarr
RETIRED UPSTREAM (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. This instance still runs on a pinned image tag; see below.
Readarr manages ebooks and audiobooks in the *arr stack. The stack runs on FrankBook-Pro (the Mac mini) as quadlet units inside its podman machine — not on Dankserver. It organizes books into the Calibre library that Calibre-Web serves.
Host: FrankBook-Pro (podman machine) — Access: direct port 8787 (no reverse-proxy vhost; the *arr stack is exempt by construction from the Anubis guard chain) — Docs: https://wiki.servarr.com/readarr
Facts
| Item | Value |
|---|---|
| Image | lscr.io/linuxserver/readarr:amd64-1.0.980 — pinned tag (LSIO ships no untagged latest for readarr; the tag was pinned after a manifest probe) |
| Port | 8787 (host) → 8787 (container) |
| Env | PUID=0, PGID=0, TZ=America/Los_Angeles, UMASK_SET=022 |
| Config root | /Volumes/COMPLETE/readarr-data:/config |
| Min RAM | 256 MB |
| Metadata | Goodreads / StoryGraph (provider status at retirement) |
Deployment (current)
Quadlet unit readarr.container from this repo (frankbook-pro/readarr/quadlet/)
is installed inside the podman machine at
/home/core/.config/containers/systemd/readarr.service by the frankbook-pro
handler in scripts/deploy-remote.sh. Unit shape:
[Container]
ContainerName=readarr
Image=lscr.io/linuxserver/readarr:amd64-1.0.980
Environment=PUID=0
Environment=PGID=0
Environment=TZ=America/Los_Angeles
Environment=UMASK_SET=022
Volume=/Volumes/COMPLETE/readarr-data:/config
PublishPort=8787:8787
[Service]
TimeoutStartSec=900
Restart=always
Configuration
- Add Prowlarr as the indexer source (torrent indexers with book content; the Byrutor row feeds Readarr — see Prowlarr).
- The qBittorrent download client is parked: Readarr's abandoned client fails auth against newer qB Web-API versions (see qBittorrent for the 4.6.7 pin rationale); re-enable only after the image changes. Until then, books are imported manually or via Calibre tooling.
- Set author profile (format preference: epub, mobi, etc.).
- Set quality profile for audiobooks (320 kbps MP3, 128 kbps, lossless).
- Set the root folder to the books root under the COMPLETE volume.
Gotchas
- Readarr is abandoned upstream (retired May 2026; last line was 0.4.x before
the final tags). The pinned
amd64-1.0.980tag exists precisely because:latestdoes not exist for this image on LSIO. - Calibre integration is folder-based, not API-based. Readarr drops files into the books root which Calibre-Web serves.
- Not all indexers carry all formats (epub, mobi, pdf). Goodreads/StoryGraph metadata helps match editions while those providers still respond.
See Also
- ARR-Stack — full *arr stack documentation
- Calibre-Web — ebook web frontend that serves Readarr downloads