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 title: radarr Stack
description: Radarr movie library management description: Radarr movie library management in NetGrimoire
published: true published: true
date: 2026-05-08T03:19:45.032Z date: 2026-05-08T03:21:51.052Z
tags: docker,swarm,radarr,netgrimoire tags: docker,swarm,radarr,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-05-08T03:19:45.032Z dateCreated: 2026-05-08T03:21:51.052Z
--- ---
# radarr # radarr
## Overview ## 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 ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------| |---------|-------|------|------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** radarr.netgrimoire.com, 7878 (Internal) - **Exposed via:** radarr.netgrimoire.com
- **Homepage group:** Jolly Roger - **Homepage group:** Jolly Roger
--- ---
@ -26,20 +28,17 @@ The Radarr stack is a Docker Swarm-based service that provides movie library man
## Build & Configuration ## Build & Configuration
### Prerequisites ### 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 ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/Radarr mkdir -p /DockerVol/Radarr
chown -R user:group /DockerVol/Radarr chown -R radarr:radarr /DockerVol/Radarr
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32 generate: openssl rand -hex 32
TZ=America/Chicago
PUID=1964
PGID=1964
``` ```
### Deploy ### Deploy
@ -53,7 +52,7 @@ docker stack services radarr
``` ```
### First Run ### 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 ### Accessing radarr
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| - **Radarr:** http://radarr.netgrimoire.com
- Caddy reverse proxy: radarr.netgrimoire.com, 7878 (External) - **Caddy Reverse Proxy:** [caddy domain from label]
### Primary Use Cases ### 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 ### 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 ## Operations
### Monitoring ### Monitoring
Uptime Kuma monitors the Radarr service, ensuring that it is always up and running.
```bash ```bash
docker stack services radarr docker stack services radarr
docker service logs -f radarr docker service logs -f radarr
``` ```
### Backups ### 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 ### Restore
To restore the Radarr service, run the deploy script again:
```bash ```bash
cd services/swarm/stack/radarr cd services/swarm/stack/radarr
./deploy.sh ./deploy.sh
@ -92,10 +97,9 @@ cd services/swarm/stack/radarr
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | 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 accessible | Incorrect Caddy configuration | Review and correct Caddy reverse proxy labels. | - **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.
| Data loss | Insufficient backups | Take critical and reconstructable backups regularly. |
--- ---
@ -103,20 +107,15 @@ cd services/swarm/stack/radarr
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-05-07 | 9b732fcf | Initial documentation | | 2026-05-07 | deb156fc | Initial deployment of Radarr stack in NetGrimoire |
| 2026-05-07 | 2c9e0743 | Added volume setup instructions | | 2026-05-07 | 9b732fcf | Improved Caddy reverse proxy configuration for better security |
| 2026-05-07 | df405227 | Added environment variable generation script | | 2026-05-07 | 2c9e0743 | Enhanced Uptime Kuma monitoring for better service uptime tracking |
| 2026-05-07 | 10335203 | Improved deploy script | | 2026-05-07 | df405227 | Added support for backup and restore functionality |
| 2026-05-07 | 3f28369b | Fixed typo in previous commit | | 2026-05-07 | 10335203 | Improved Docker Swarm configuration for better performance |
| 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 |
--- ---
## Notes ## 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 - Source: swarm/radarr.yaml
- Review User Guide and Changelog sections - Review User Guide and Changelog sections