119 lines
No EOL
3 KiB
Markdown
119 lines
No EOL
3 KiB
Markdown
# 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
|
|
```bash
|
|
mkdir -p /DockerVol/Radarr:/config
|
|
chown -R radarr:radarr /DockerVol/Radarr
|
|
```
|
|
|
|
### Environment Variables
|
|
```bash
|
|
# 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
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
./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:
|
|
|
|
1. Log in to the Radarr interface at `https://radarr.netgrimoire.com`.
|
|
2. Configure your library by adding movies and setting quality filters.
|
|
3. 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]
|
|
```bash
|
|
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
|
|
```bash
|
|
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 |