mirror of https://github.com/nickyeoman/docker-compose-cookbooks.git synced 2026-09-04 02:46:23 +00:00

Files

T

codeandClaude Fable 5 8ab413804a normalize all stacks to conventions

- VOL_PATH always defaults to /data; vscode/opencode VOL_PROJECTS nests it
- TZ defaults to America/Vancouver (was UTC in etherpad, ntfy, redis)
- compose section order fixed (volumes before environment, command after networks)
- all default secrets are the literal ChangeThisPassword (grep-friendly,
  users must change them); removed a real key from ollama sample.env
- sample.env synced with compose: missing vars added with defaults, dead vars removed
- invoiceninja_dev/openarchiver_dev: app services had no environment block,
  wired all sample.env vars through so the stacks actually work
- opencode: sample.env OLLAMA_HOST renamed to OLLAMA_HOST_URL to match compose
- TZ values unquoted consistently

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-16 06:24:54 +00:00

compose.yaml

feat: add readarr, whisparr, and bazarr stacks

2026-07-02 21:37:11 -07:00

README.md

feat: add readarr, whisparr, and bazarr stacks

2026-07-02 21:37:11 -07:00

sample.env

normalize all stacks to conventions

2026-07-16 06:24:54 +00:00

README.md

Readarr

Overview

Readarr is an automated eBook and audiobook collection manager for Usenet and BitTorrent users. It monitors authors on your watchlist, scans configured indexers for new releases or upgrades, and sends them to your download client. After download, it renames and organizes files into your book library and can notify your media server.

Project Details

Project Repository: https://readarr.com/
Container Image: ghcr.io/hotio/readarr
Reverse Proxy Port: 8787

Getting Started

Open http://localhost:8787 in your browser and complete the initial setup wizard:

Choose your UI language
Add a download client — select qBittorrent, enter its host/port/credentials
Add an indexer — or connect to Prowlarr for automatic indexer sync

Once the wizard finishes, you'll see an empty library. To populate it:

Go to Settings → Media Management and add a Root Folder (e.g., /books) — this is where your organized book library will live
Click Add Author and search by name — Readarr fetches metadata, covers, and available editions
Optionally connect a List (Goodreads, etc.) to auto-import authors from your reading lists

Download flow

qBittorrent downloads to its own directory → Readarr picks it up, renames the file, and moves it into <Root Folder>/Author Name/Book Name/

Environment Variable Notes

Variable	Description
`READARR_IMAGE`	Container image (default: `ghcr.io/hotio/readarr:release`)
`READARR_RESTART`	Restart policy (default: `unless-stopped`)
`READARR_PORT`	Published port for the web UI (default: `8787`)
`VOL_PATH`	Base path for persistent data volumes (default: `/data`)
`TZ`	Container timezone (default: `America/Vancouver`)

Volume Notes

Volume	Purpose
`${VOL_PATH:-/data}/readarr/config`	Application configuration and database
`${VOL_PATH:-/data}/readarr/data`	Download client data and working directory

Network Notes

Requires an external proxy network. Create it once with:

docker network create proxy

Docker Run

docker run -d \
  --name=readarr \
  -e PUID=1000 \
  -e PGID=1000 \
  -e UMASK=002 \
  -e TZ=America/Vancouver \
  -p 8787:8787 \
  -v ${VOL_PATH:-/data}/readarr/config:/config \
  -v ${VOL_PATH:-/data}/readarr/data:/data \
  --network proxy \
  --restart unless-stopped \
  ghcr.io/hotio/readarr:release

Dockhand Stack, Deploy from Git

Cookbooks Repository
stackname: readarr_dev
Compose file path: readarr_dev/compose.yaml
Additional env file (optional): readarr_dev/sample.env

Load readarr_dev/sample.env into the Environment variables in Dockhand, then create the Stack.