From 88f7650f6459d64ccba11101ec41dd8ef1aec1a3 Mon Sep 17 00:00:00 2001 From: traveler Date: Thu, 7 May 2026 22:23:17 -0500 Subject: [PATCH] docs(gremlin): update radarr --- Netgrimoire/Services/radarr/radarr.md | 63 +++++++++++++-------------- 1 file changed, 31 insertions(+), 32 deletions(-) diff --git a/Netgrimoire/Services/radarr/radarr.md b/Netgrimoire/Services/radarr/radarr.md index fc950a9..a17741b 100644 --- a/Netgrimoire/Services/radarr/radarr.md +++ b/Netgrimoire/Services/radarr/radarr.md @@ -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 \ No newline at end of file