# 06-whisparr.md

kstack:
  book: Centerpoint Home Lab
  chapter: Media Management
  page: Whisparr
  tags: [whisparr, arr, media-management, adult-content]
---

## Overview

Whisparr is a Sonarr fork purpose-built for managing adult content. It integrates
with Prowlarr for indexer searches and NZBGet for downloads, following the same
*arr workflow as Sonarr but with metadata sources appropriate for its content type.
Downloaded content is delivered to the same media volume that Stash monitors.

## Access

| Type      | URL                              | Notes                              |
|-----------|----------------------------------|------------------------------------|
| Internal  | `https://whisparr.home.local`    | LAN access via Step-CA TLS         |

No external route — internal management only.

## Configuration

**Image:** `ghcr.io/hotio/whisparr:v3`
**Compose project:** `arr` stack

### Traefik Labels

```yaml
traefik.enable: "true"
traefik.http.routers.whisparr.rule: Host(`whisparr.home.local`)
traefik.http.routers.whisparr.entrypoints: websecure
traefik.http.routers.whisparr.tls.certresolver: step-ca
traefik.http.services.whisparr.loadbalancer.server.port: 6969
```

## Volumes / Bind Mounts

| Host Path                               | Container Path | Purpose                               |
|-----------------------------------------|----------------|---------------------------------------|
| `/home/jeeves/docker/arr/Whisparr/config`| `/config`    | Whisparr database and settings        |
| `/media/jeeves/1TB_Vol2/downloads`      | `/downloads`   | NZBGet download staging (Ceph OSD)    |
| `/mnt/Multimedia`                       | `/data`        | Media library including adult content (NFS from UnRAID) |

## Integration Points

| Service   | Connection Method                              | Purpose            |
|-----------|------------------------------------------------|--------------------|
| Prowlarr  | API (`http://prowlarr:9696`) via `media-network` | Indexer search   |
| NZBGet    | API (`http://nzbget:6789`) via `media-network`   | Download client  |

## Notes / Gotchas

- The `hotio/whisparr:v3` image is a community-maintained build. Monitor the
  repository for updates as this is not an official Servarr project.
- Whisparr's library root folder should point to the same path that Stash monitors
  (`/mnt/Multimedia/ST`) so content is automatically picked up by Stash after import.
- Prowlarr indexer categories for adult content must be configured correctly in
  Prowlarr and mapped to Whisparr in the Apps settings.

---
*Last Updated: 2026-06-16*