---
title: radarr Stack
description: Radarr media server stack for NetGrimoire.
published: true
date: 2026-05-08T03:28:32.837Z
tags: docker,swarm,radarr,netgrimoire
editor: markdown
dateCreated: 2026-05-08T03:28:32.837Z
---

# 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.

## Architecture
| Service | Image | Port | Role |
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** radarr.netgrimoire.com, radarr:7878
- **Homepage group:** Jolly Roger

---

## Build & Configuration

### Prerequisites
No specific prerequisites are required for this stack.

### Volume Setup
```bash
mkdir -p /DockerVol/Radarr:/config
chown -R radarr:radarr /DockerVol/Radarr
```

### Environment Variables
```bash
generate: openssl rand -hex 32
```

### Deploy
```bash
cd services/swarm/stack/radarr
set -a && source .env && set +a
docker stack config --compose-file radarr-stack.yml > resolved.yml
docker stack deploy --compose-file resolved.yml radarr
rm resolved.yml
docker stack services radarr
```

### First Run
Run the `./deploy.sh` script to initialize the Radarr database and configuration.

---

## User Guide

### Accessing radarr
| Service | URL | Purpose |
|---------|-----|---------|
- Caddy: radarr.netgrimoire.com

### Primary Use Cases
To access Radarr, navigate to [Caddy Domain](caddy-docker-proxy labels) in your web browser.

### NetGrimoire Integrations
Radarr connects to the following services:
* Uptime Kuma (kuma.* labels)
* Homepage (homepage.* labels)

---

## Operations

### Monitoring
.kuma.monitors:
```bash
docker stack services radarr
docker service logs -f radarr
```

### Backups
Critical data is stored on `/DockerVol/Radarr`. Reconstructable data is stored on the same volume.

### Restore
```bash
cd services/swarm/stack/radarr
./deploy.sh
```

---

## 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 |

---

## Changelog

| 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 |

<Generated by Gremlin on 2026-05-08T03:28:32.837Z>
<Source: swarm/radarr.yaml>