Readarr manages ebook acquisition and library hygiene for the Calibre-backed ebook collection.
This page documents the readarr service for ebooks. It does not cover the separate audiobook-focused instance.
- Container:
readarr
- Image:
lscr.io/linuxserver/readarr:develop
- Stack: Smithflix Stack
- Compose path:
/opt/stacks/smithflix/docker-compose.yml
- Docker network:
smithflix_default
- Restart policy:
unless-stopped
- No container healthcheck is configured as of
2026-04-07
- Public hostname:
readarr.better-than.tv
¶ Config and Data Paths
- Config root:
/srv/docker/readarr/config
- Main config file:
/srv/docker/readarr/config/config.xml
- Main database:
/srv/docker/readarr/config/readarr.db
- Log database:
/srv/docker/readarr/config/logs.db
- App log directory:
/srv/docker/readarr/config/logs
- Ebook library mount:
/media/ebooks/Calibre Library
- Download import mount:
/media/downloads/ebooks
- LAN URL:
http://192.168.0.113:8787
- Public URL:
https://readarr.better-than.tv
- Host port mapping:
8787 -> 8787
- The live NPM host includes custom cookie rewriting
¶ Authentication and Secret Locations
- Readarr auth, API keys, indexers, and downloader definitions are stored inside
/srv/docker/readarr/config
- Do not copy Readarr API keys or indexer credentials into wiki content
- This instance runs the
develop image tag and should be treated as higher-change than the stable LinuxServer defaults
- Keep the ebook library path and download-import path aligned with any configured downloader or import rules
- Validate local access on
:8787 before debugging the proxy
- Recent runtime activity showed RSS sync and import-list polling with no items processed or grabbed
- Because this is the ebook instance, keep operational notes separate from the audiobook instance documented on Readarr Audio
¶ Monitoring and Logs
- Docker logging driver is
json-file
- No container healthcheck exists, so a running container is not enough proof that searches or imports are working
- App logs are stored under
/srv/docker/readarr/config/logs
- Additional app state includes
Backups, MediaCover, Sentry, and asp subtrees inside the config root
¶ Backup and Restore
/srv/docker/readarr/config is in the documented Duplicati scope because it lives under /srv/docker- Library and download payloads under
/media are operational content, not assumed full backups
- After restore, validate indexers, downloader connectivity, and a sample import path
¶ Failure Modes and Recovery
- Downloader path drift can stop imports while RSS sync continues to look normal
- Running the
develop image increases the chance of behavior drift after image updates
- Missing or broken library mounts will block import and organization even when the UI still loads