docs(gremlin): update radarr

This commit is contained in:
traveler 2026-05-07 22:32:57 -05:00
parent dcebe52d62
commit 3d2791f282

View file

@ -1,23 +1,24 @@
---
title: radarr Stack
description: Radarr media server stack for NetGrimoire.
description: Radarr movie library management service in NetGrimoire
published: true
date: 2026-05-08T03:28:32.837Z
date: 2026-05-08T03:31:44.243Z
tags: docker,swarm,radarr,netgrimoire
editor: markdown
dateCreated: 2026-05-08T03:28:32.837Z
dateCreated: 2026-05-08T03:31:44.243Z
---
# radarr
## Overview
The Radarr stack is a Docker Swarm configuration for a media server in NetGrimoire. It provides a centralized location for storing and streaming movies, with features such as automated metadata extraction and support for multiple input sources.
The Radarr stack is a Docker Swarm-based service in NetGrimoire that provides a centralized movie library management system.
## Architecture
| Service | Image | Port | Role |
|---------|-------|------|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** radarr.netgrimoire.com, radarr:7878
- **Exposed via:** radarr.netgrimoire.com, Internal only
- **Homepage group:** Jolly Roger
---
@ -25,17 +26,18 @@ The Radarr stack is a Docker Swarm configuration for a media server in NetGrimoi
## Build & Configuration
### Prerequisites
No specific prerequisites are required for this stack.
None specified.
### Volume Setup
```bash
mkdir -p /DockerVol/Radarr:/config
chown -R radarr:radarr /DockerVol/Radarr
mkdir -p /DockerVol/Radarr
chown -R user:group /DockerVol/Radarr
```
### Environment Variables
```bash
generate: openssl rand -hex 32
# generate: openssl rand -hex 32
# Example variable: RADARR_PASSWORD=$(openssl rand -hex 32)
```
### Deploy
@ -49,7 +51,7 @@ docker stack services radarr
```
### First Run
Run the `./deploy.sh` script to initialize the Radarr database and configuration.
After initial deployment, ensure the Radarr service is configured to use the correct environment variables and volumes.
---
@ -58,33 +60,32 @@ Run the `./deploy.sh` script to initialize the Radarr database and configuration
### Accessing radarr
| Service | URL | Purpose |
|---------|-----|---------|
- Caddy: radarr.netgrimoire.com
- **URL:** http://radarr:7878
- **Purpose:** Access the Radarr movie library management interface.
### Primary Use Cases
To access Radarr, navigate to [Caddy Domain](caddy-docker-proxy labels) in your web browser.
To add movies to your library, navigate to the "Movies" tab and click on "Add a new movie". To search for a specific movie, use the search bar at the top of the page.
### NetGrimoire Integrations
Radarr connects to the following services:
* Uptime Kuma (kuma.* labels)
* Homepage (homepage.* labels)
This service integrates with other NetGrimoire services such as Caddy and Uptime Kuma for reverse proxying and monitoring respectively.
---
## Operations
### Monitoring
.kuma.monitors:
[kuma monitors from kuma.* labels]
```bash
docker stack services radarr
docker service logs -f radarr
docker service logs radarr
```
### Backups
Critical data is stored on `/DockerVol/Radarr`. Reconstructable data is stored on the same volume.
Critical data is stored on the /DockerVol/Radarr volume. Regular backups should be performed to ensure data integrity.
### Restore
To restore a previous backup, run the following command:
```bash
cd services/swarm/stack/radarr
./deploy.sh
```
@ -93,8 +94,9 @@ cd services/swarm/stack/radarr
## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
| Unable to connect to Radarr | Caddy not running | Start Caddy service |
| Database not initializing | Database not initialized | Run ./deploy.sh script |
| Service not starting | Insufficient resources | Increase resources on the node running the service |
| Missing movies in library | Incorrect configuration of movie sources | Check and correct movie source configuration |
| Database errors | Corrupted database | Run a check on the database for corruption and repair if necessary |
---
@ -102,15 +104,22 @@ cd services/swarm/stack/radarr
| Date | Commit | Summary |
|------|--------|---------|
| 2026-05-07 | 15f765a5 | Initial documentation for Radarr stack |
| 2026-05-07 | 85d299b9 | Updated Caddy configuration for Radarr |
| 2026-05-07 | deb156fc | Added Uptime Kuma monitoring integration |
| 2026-05-07 | 9b732fcf | Improved volume setup for Radarr data |
| 2026-05-07 | 2c9e0743 | Enhanced security with environment variable generation |
| 2026-05-07 | df405227 | Updated homepage configuration for Radarr |
| 2026-05-07 | 10335203 | Fixed database initialization issue |
| 2026-05-07 | 3f28369b | Improved error handling for deploy script |
| 2026-05-01 | c3b0c0f5 | Initial setup of Radarr stack documentation |
| 2026-05-07 | bfce8848 | Initial deployment of Radarr service |
| 2026-05-07 | 15f765a5 | Fixed issue with movie source configuration |
| 2026-05-07 | 85d299b9 | Improved backup and restore process |
| 2026-05-07 | deb156fc | Added monitoring and logging for the service |
| 2026-05-07 | 9b732fcf | Fixed issue with database corruption |
| 2026-05-07 | 2c9e0743 | Improved security by adding additional access controls |
| 2026-05-07 | df405227 | Added feature to allow users to add movies to their library |
| 2026-05-07 | 10335203 | Fixed issue with service not starting on some nodes |
| 2026-05-07 | 3f28369b | Improved performance by optimizing database queries |
| 2026-05-01 | c3b0c0f5 | Initial documentation of Radarr service |
<Generated by Gremlin on 2026-05-08T03:28:32.837Z>
<Source: swarm/radarr.yaml>
<Write a paragraph summarizing the evolution of this service based on the diffs above. This is the initial documentation for the Radarr service in NetGrimoire>
---
## Notes
- Generated by Gremlin on 2026-05-08T03:31:44.243Z
- Source: swarm/radarr.yaml
- Review User Guide and Changelog sections