refactor: rewrite radarr_dev to match template conventions

- Rename docker-compose.yml to compose.yaml
- Add defaults, restart policy, and proxy network
- Fix VOL_PATH to use base /data pattern
- Rewrite README with new section order and Getting Started guide
- Assume qBittorrent download client, Prowlarr indexer sync
This commit is contained in:
2026-07-02 21:31:38 -07:00
parent cd70772880
commit d2b67fcc76
4 changed files with 98 additions and 17 deletions
+77 -3
View File
@@ -1,6 +1,80 @@
# Radarr # Radarr
Official Site: https://radarr.video/ ## Overview
proxy port: 7878
Radarr is an automated movie collection manager that monitors and downloads movies for you. It keeps track of movies on your watchlist (which can be populated from various sources like Trakt or IMDb lists) and scans your configured indexers for available releases. When a movie is found that matches your specified quality profiles, Radarr automatically sends it to your download client (like qBittorrent or SABnzbd). Once the download is finished, Radarr handles the rest by renaming the file according to your rules, moving it to your movie library folder, and notifying your media server to pick up the new content. It also has the ability to automatically upgrade existing movies in your library to a higher quality version when one becomes available. Radarr is an automated movie collection manager for Usenet and BitTorrent users. It monitors your watchlist (from Trakt, IMDb, etc.), scans configured indexers for releases, and sends matches to your download client. After download, it renames and organizes files into your movie library and notifies your media server.
## Project Details
- **Project Repository:** [https://radarr.video/](https://radarr.video/)
- **Container Image:** [ghcr.io/hotio/radarr](https://hotio.dev/containers/radarr/)
- **Reverse Proxy Port:** `7878`
## Getting Started
Open http://localhost:7878 in your browser and complete the initial setup wizard:
1. **Choose your UI language**
2. **Add a download client** — select qBittorrent, enter its host/port/credentials
3. **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., `/movies`) — this is where your organized movie library will live
- Click **Add Movie** and search by title — Radarr fetches metadata, posters, and available releases
- Optionally connect a **List** (Trakt, IMDb, etc.) to auto-import movies from your watchlists
### Download flow
qBittorrent downloads to its own directory → Radarr picks it up, renames the file, and moves it into `<Root Folder>/Movie Name (Year)/`
## Environment Variable Notes
| Variable | Description |
|---|---|
| `RADARR_IMAGE` | Container image (default: `ghcr.io/hotio/radarr:release`) |
| `RADARR_RESTART` | Restart policy (default: `unless-stopped`) |
| `RADARR_PORT` | Published port for the web UI (default: `7878`) |
| `VOL_PATH` | Base path for persistent data volumes (default: `/data`) |
| `TZ` | Container timezone (default: `America/Vancouver`) |
## Volume Notes
| Volume | Purpose |
|---|---|
| `${VOL_PATH:-/data}/radarr/config` | Application configuration and database |
| `${VOL_PATH:-/data}/radarr/data` | Download client data and working directory |
## Network Notes
Requires an external `proxy` network. Create it once with:
```bash
docker network create proxy
```
## Docker Run
```bash
docker run -d \
--name=radarr \
-e PUID=1000 \
-e PGID=1000 \
-e UMASK=002 \
-e TZ=America/Vancouver \
-p 7878:7878 \
-v ${VOL_PATH:-/data}/radarr/config:/config \
-v ${VOL_PATH:-/data}/radarr/data:/data \
--network proxy \
--restart unless-stopped \
ghcr.io/hotio/radarr:release
```
## Dockhand Stack, Deploy from Git
- **Cookbooks Repository**
- **stackname:** radarr_dev
- **Compose file path:** radarr_dev/compose.yaml
- **Additional env file (optional):** radarr_dev/sample.env
Load `radarr_dev/sample.env` into the Environment variables in Dockhand, then create the Stack.
+20
View File
@@ -0,0 +1,20 @@
services:
radarr:
image: ${RADARR_IMAGE:-ghcr.io/hotio/radarr:release}
restart: ${RADARR_RESTART:-unless-stopped}
volumes:
- ${VOL_PATH:-/data}/radarr/config:/config
- ${VOL_PATH:-/data}/radarr/data:/data
environment:
- PUID=1000
- PGID=1000
- UMASK=002
- TZ=${TZ:-America/Vancouver}
ports:
- "${RADARR_PORT:-7878}:7878"
networks:
- proxy
networks:
proxy:
external: true
-13
View File
@@ -1,13 +0,0 @@
services:
radarr:
image: ${RADARR_IMAGE}
ports:
- "7878:7878"
environment:
- PUID=1000
- PGID=1000
- UMASK=002
- TZ=${TZ}
volumes:
- ${VOL_PATH}/radarr/config:/config
- ${VOL_PATH}/radarr/data:/data
+1 -1
View File
@@ -1,4 +1,4 @@
# Radarr # Radarr
VOL_PATH=./data/radarr/config VOL_PATH=/data
RADARR_IMAGE=ghcr.io/hotio/radarr:release RADARR_IMAGE=ghcr.io/hotio/radarr:release
TZ="America/Vancouver" TZ="America/Vancouver"