3 KiB
3 KiB
radarr
Overview
The Radarr stack is a Docker Swarm-based configuration for the popular movie library management service, Radarr. It provides a centralized hub for managing a large collection of movies, complete with features like automated metadata fetching and quality filtering.
Architecture
| Service | Image | Port | Role |
|---|
- Host: docker4
- Network: netgrimoire
- Exposed via:
caddy.radarr.netgrimoire.com,radarr:7878 - Homepage group: Jolly Roger
Build & Configuration
Prerequisites
No specific prerequisites are required for this stack.
Volume Setup
mkdir -p /DockerVol/Radarr:/config
chown -R radarr:radarr /DockerVol/Radarr
Environment Variables
# generate: openssl rand -hex 32
TZ=America/Chicago
PGID="1964"
PUID="1964"
CADDY_HTTPS_KEY=$(openssl rand -hex 32)
KUMA RADARR.HTTP.NAME=Radarr
KUMA RADARR.HTTP.URL=https://radarr.netgrimoire.com
Deploy
cd services/swarm/stack/radarr
set -a && source .env && set +a
docker stack config --compose-file radarr-stack.yml > resolved.yml
docker stack deploy --compose-file resolved.yml radarr
rm resolved.yml
docker stack services radarr
First Run
After a successful deployment, run the following command to initialize the database:
./deploy.sh
User Guide
Accessing radarr
| Service | URL | Purpose |
- radarr: https://radarr.netgrimoire.com |
Primary Use Cases
To use Radarr in NetGrimoire, follow these steps:
- Log in to the Radarr interface at
https://radarr.netgrimoire.com. - Configure your library by adding movies and setting quality filters.
- Set up Caddy for reverse proxying and HTTPS.
NetGrimoire Integrations
Radarr integrates with Kuma for monitoring and Uptime Kuma for dashboard integration.
Operations
Monitoring
[kuma monitors]
docker stack services radarr
<docker service logs commands>
Backups
Critical backups should be done to /DockerVol/Radarr/data/backup/ on a regular basis. Reconstructable backups can be stored in the same directory.
Restore
cd services/swarm/stack/radarr
./deploy.sh
Common Failures
| Failure Mode | Symptoms | Cause | Fix |
|---|---|---|---|
| Caddy Not Listening | No incoming requests. | Caddy not started | Restart caddy service with docker stack services radarr |
| Radarr Service Not Running | No visible interface in NetGrimoire Dashboard. | Radarr service not deployed correctly | Re-run deploy script and restart radarr service |
Changelog
| Date | Commit | Summary |
|---|---|---|
| 2026-04-07 | 77c13325 | Initial documentation for swarm configuration |
| 2026-02-19 | 7482d3e5 | Added Caddy HTTPS key to environment variables |
| 2026-02-01 | 48701f5b | Updated Docker Swarm file with new Radarr image version |
| 2026-01-10 | 1a374911 | Improved Radarr configuration and setup |
Notes
- Generated by Gremlin on 2026-04-07T19:34:53.606Z
- Source: swarm/radarr.yaml
- Review User Guide and Changelog sections