Readarr Audio is the separate audiobook-focused Readarr instance. It manages audiobook acquisition and import workflows independently from the ebook instance.
This page documents the readarr-audio service. It does not replace the ebook-focused Readarr page.
- Container:
readarr-audio
- 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:
readarraudio.better-than.tv
¶ Config and Data Paths
- Config root:
/srv/docker/readarr-audio/config
- Main config file:
/srv/docker/readarr-audio/config/config.xml
- Main database:
/srv/docker/readarr-audio/config/readarr.db
- Log database:
/srv/docker/readarr-audio/config/logs.db
- App log directory:
/srv/docker/readarr-audio/config/logs
- Audiobook library mount:
/media/audiobooks
- Download import mount:
/media/downloads/audiobooks
- LAN URL:
http://192.168.0.113:8788
- Public URL:
https://readarraudio.better-than.tv
- Host port mapping:
8788 -> 8787
- The public hostname does not contain a hyphen between
readarr and audio
- The live NPM host includes custom cookie rewriting
¶ Authentication and Secret Locations
- Readarr Audio auth, API keys, indexers, and downloader definitions are stored inside
/srv/docker/readarr-audio/config
- Do not copy Readarr API keys or indexer credentials into wiki content
- This instance also runs the
develop image tag and should be treated as higher-change than a stable tag deployment
- Keep the audiobook library path and download-import path aligned with the configured downloader workflow
- Validate local access on
:8788 before debugging the proxy
- Recent runtime activity showed RSS sync and import-list polling with no items processed or grabbed
- Keep audiobook-specific policies separate from ebook automation to avoid cross-library confusion
¶ 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 healthy
- App logs are stored under
/srv/docker/readarr-audio/config/logs
- Additional app state includes
Backups, MediaCover, Sentry, and asp subtrees inside the config root
¶ Backup and Restore
/srv/docker/readarr-audio/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 audiobook import path
¶ Failure Modes and Recovery
- Downloader path drift can stop imports while RSS sync continues to appear healthy
- Running the
develop image increases the chance of behavior drift after image updates
- Confusing this service with the ebook instance can lead to incorrect library paths and broken integrations