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 title: radarr Stack
description: Radarr media server stack for NetGrimoire. description: Radarr movie library management service in NetGrimoire
published: true published: true
date: 2026-05-08T03:28:32.837Z date: 2026-05-08T03:31:44.243Z
tags: docker,swarm,radarr,netgrimoire tags: docker,swarm,radarr,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-05-08T03:28:32.837Z dateCreated: 2026-05-08T03:31:44.243Z
--- ---
# radarr # radarr
## Overview ## 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 ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** radarr.netgrimoire.com, radarr:7878 - **Exposed via:** radarr.netgrimoire.com, Internal only
- **Homepage group:** Jolly Roger - **Homepage group:** Jolly Roger
--- ---
@ -25,17 +26,18 @@ The Radarr stack is a Docker Swarm configuration for a media server in NetGrimoi
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
No specific prerequisites are required for this stack. None specified.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/Radarr:/config mkdir -p /DockerVol/Radarr
chown -R radarr:radarr /DockerVol/Radarr chown -R user:group /DockerVol/Radarr
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
generate: openssl rand -hex 32 # generate: openssl rand -hex 32
# Example variable: RADARR_PASSWORD=$(openssl rand -hex 32)
``` ```
### Deploy ### Deploy
@ -49,7 +51,7 @@ docker stack services radarr
``` ```
### First Run ### 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 ### Accessing radarr
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
- Caddy: radarr.netgrimoire.com - **URL:** http://radarr:7878
- **Purpose:** Access the Radarr movie library management interface.
### Primary Use Cases ### 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 ### NetGrimoire Integrations
Radarr connects to the following services: This service integrates with other NetGrimoire services such as Caddy and Uptime Kuma for reverse proxying and monitoring respectively.
* Uptime Kuma (kuma.* labels)
* Homepage (homepage.* labels)
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
.kuma.monitors: [kuma monitors from kuma.* labels]
```bash ```bash
docker stack services radarr docker stack services radarr
docker service logs -f radarr docker service logs radarr
``` ```
### Backups ### 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 ### Restore
To restore a previous backup, run the following command:
```bash ```bash
cd services/swarm/stack/radarr
./deploy.sh ./deploy.sh
``` ```
@ -93,8 +94,9 @@ cd services/swarm/stack/radarr
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | Symptom | Cause | Fix |
|---------|-------|-----| |---------|-------|-----|
| Unable to connect to Radarr | Caddy not running | Start Caddy service | | Service not starting | Insufficient resources | Increase resources on the node running the service |
| Database not initializing | Database not initialized | Run ./deploy.sh script | | 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 | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-05-07 | 15f765a5 | Initial documentation for Radarr stack | | 2026-05-07 | bfce8848 | Initial deployment of Radarr service |
| 2026-05-07 | 85d299b9 | Updated Caddy configuration for Radarr | | 2026-05-07 | 15f765a5 | Fixed issue with movie source configuration |
| 2026-05-07 | deb156fc | Added Uptime Kuma monitoring integration | | 2026-05-07 | 85d299b9 | Improved backup and restore process |
| 2026-05-07 | 9b732fcf | Improved volume setup for Radarr data | | 2026-05-07 | deb156fc | Added monitoring and logging for the service |
| 2026-05-07 | 2c9e0743 | Enhanced security with environment variable generation | | 2026-05-07 | 9b732fcf | Fixed issue with database corruption |
| 2026-05-07 | df405227 | Updated homepage configuration for Radarr | | 2026-05-07 | 2c9e0743 | Improved security by adding additional access controls |
| 2026-05-07 | 10335203 | Fixed database initialization issue | | 2026-05-07 | df405227 | Added feature to allow users to add movies to their library |
| 2026-05-07 | 3f28369b | Improved error handling for deploy script | | 2026-05-07 | 10335203 | Fixed issue with service not starting on some nodes |
| 2026-05-01 | c3b0c0f5 | Initial setup of Radarr stack documentation | | 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> <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>
<Source: swarm/radarr.yaml>
---
## Notes
- Generated by Gremlin on 2026-05-08T03:31:44.243Z
- Source: swarm/radarr.yaml
- Review User Guide and Changelog sections