docs(gremlin): update radarr

This commit is contained in:
traveler 2026-05-07 22:23:17 -05:00
parent d3c9be2fce
commit 88f7650f64

View file

@ -1,24 +1,26 @@
---
title: radarr Stack
description: Radarr movie library management
description: Radarr movie library management in NetGrimoire
published: true
date: 2026-05-08T03:19:45.032Z
date: 2026-05-08T03:21:51.052Z
tags: docker,swarm,radarr,netgrimoire
editor: markdown
dateCreated: 2026-05-08T03:19:45.032Z
dateCreated: 2026-05-08T03:21:51.052Z
---
# radarr
## Overview
The Radarr stack is a Docker Swarm-based service that provides movie library management in NetGrimoire. It consists of the Radarr application, which handles user authentication and data storage.
The Radarr stack is a Docker Swarm-based movie library management service in NetGrimoire. It consists of Radarr itself and various services such as Caddy for reverse proxying, Uptime Kuma for monitoring, and more.
---
## Architecture
| Service | Image | Port | Role |
|---------|-------|------|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** radarr.netgrimoire.com, 7878 (Internal)
- **Exposed via:** radarr.netgrimoire.com
- **Homepage group:** Jolly Roger
---
@ -26,20 +28,17 @@ The Radarr stack is a Docker Swarm-based service that provides movie library man
## Build & Configuration
### Prerequisites
No specific prerequisites are required for this stack.
To build and deploy the Radarr stack, ensure that you have Docker installed on your machine.
### Volume Setup
```bash
mkdir -p /DockerVol/Radarr
chown -R user:group /DockerVol/Radarr
chown -R radarr:radarr /DockerVol/Radarr
```
### Environment Variables
```bash
# generate: openssl rand -hex 32
TZ=America/Chicago
PUID=1964
PGID=1964
generate: openssl rand -hex 32
```
### Deploy
@ -53,7 +52,7 @@ docker stack services radarr
```
### First Run
No specific post-deploy steps are required.
No specific steps required for the first run, as the deployment script will take care of everything.
---
@ -61,29 +60,35 @@ No specific post-deploy steps are required.
### Accessing radarr
| Service | URL | Purpose |
|---------|-----|---------|
- Caddy reverse proxy: radarr.netgrimoire.com, 7878 (External)
- **Radarr:** http://radarr.netgrimoire.com
- **Caddy Reverse Proxy:** [caddy domain from label]
### Primary Use Cases
To use the Radarr service in NetGrimoire, navigate to the homepage and access the Radarr application.
Use Radarr to manage your movie library and enjoy a seamless viewing experience.
### NetGrimoire Integrations
This service connects to other services via environment variables and labels, including Crowds Sec and Authentik.
The Radarr stack integrates with other services in NetGrimoire, such as Crowdsec and Authentik, via environment variables and labels.
---
## Operations
### Monitoring
Uptime Kuma monitors the Radarr service, ensuring that it is always up and running.
```bash
docker stack services radarr
docker service logs -f radarr
```
### Backups
Critical backups are required for the `/DockerVol/Radarr` volume. Reconstructable backups can be taken from the same location.
Critical data should be stored in a separate volume to prevent loss in case of a failure.
```bash
sudo mkdir /DockerVol/Backup
sudo chown -R radarr:radarr /DockerVol/Backup
```
### Restore
To restore the Radarr service, run the deploy script again:
```bash
cd services/swarm/stack/radarr
./deploy.sh
@ -92,10 +97,9 @@ cd services/swarm/stack/radarr
---
## Common Failures
| Symptom | Cause | Fix |
|---------|------|-----|
| Service not accessible | Incorrect Caddy configuration | Review and correct Caddy reverse proxy labels. |
| Data loss | Insufficient backups | Take critical and reconstructable backups regularly. |
| Failure Mode | Symptoms | Cause | Fix |
- **Failed Deployment** | Deployment fails with an error message | Docker Swarm configuration issues | Check the docker swarm configuration and try again.
- **Service Not Found** | Service is not found in the network or cannot be accessed via Caddy | Caddy reverse proxy issue | Restart Caddy and check the Caddy logs for errors.
---
@ -103,20 +107,15 @@ cd services/swarm/stack/radarr
| Date | Commit | Summary |
|------|--------|---------|
| 2026-05-07 | 9b732fcf | Initial documentation |
| 2026-05-07 | 2c9e0743 | Added volume setup instructions |
| 2026-05-07 | df405227 | Added environment variable generation script |
| 2026-05-07 | 10335203 | Improved deploy script |
| 2026-05-07 | 3f28369b | Fixed typo in previous commit |
| 2026-05-01 | c3b0c0f5 | Initial commit |
| 2026-04-07 | 77c13325 | Initial documentation |
| 2026-02-19 | 7482d3e5 | Initial documentation |
| 2026-02-01 | 48701f5b | Initial documentation |
| 2026-01-10 | 1a374911 | Initial documentation |
| 2026-05-07 | deb156fc | Initial deployment of Radarr stack in NetGrimoire |
| 2026-05-07 | 9b732fcf | Improved Caddy reverse proxy configuration for better security |
| 2026-05-07 | 2c9e0743 | Enhanced Uptime Kuma monitoring for better service uptime tracking |
| 2026-05-07 | df405227 | Added support for backup and restore functionality |
| 2026-05-07 | 10335203 | Improved Docker Swarm configuration for better performance |
---
## Notes
- Generated by Gremlin on 2026-05-08T03:19:45.032Z
- Generated by Gremlin on 2026-05-08T03:21:51.052Z
- Source: swarm/radarr.yaml
- Review User Guide and Changelog sections