Skip to main content

12-pulsarr.md

kstack: book: Centerpoint Home Lab chapter: Media Management page: Pulsarr tags: [pulsarr, watchlist, notifications, arr, media-management]

Overview

Pulsarr is a watchlist automation and notification bridge for the *arr stack. It monitors Plex and Jellyfin watchlists, automatically adds requested movies and TV shows to Radarr and Sonarr, and sends notifications when content is downloaded and available. It also integrates with TMDB for metadata-enriched notifications.

Access

Type URL Notes
Internal https://pulsarr.home.local LAN access via Step-CA TLS
External https://pulsarr.jeeves5454.ddns.net Authentik SSO + GeoBlock + CrowdSec

Configuration

Image: lakker/pulsarr:latest Compose project: arr stack

Traefik Labels

# External route
traefik.http.routers.pulsarr-external.rule: Host(`pulsarr.jeeves5454.ddns.net`)
traefik.http.routers.pulsarr-external.entrypoints: websecure
traefik.http.routers.pulsarr-external.tls.certresolver: letsencrypt
traefik.http.routers.pulsarr-external.middlewares: authentik-auth@docker,plex-geoblock@file,crowdsec-bouncer@file
traefik.http.routers.pulsarr-external.service: pulsarr-svc

# Internal route
traefik.http.routers.pulsarr-internal.rule: Host(`pulsarr.home.local`)
traefik.http.routers.pulsarr-internal.entrypoints: websecure
traefik.http.routers.pulsarr-internal.tls.certresolver: step-ca
traefik.http.routers.pulsarr-internal.service: pulsarr-svc

traefik.http.services.pulsarr-svc.loadbalancer.server.port: 3003

Key Environment Variables

Variable Value Purpose
TZ America/Toronto Timezone
port 3003 Application listen port
tmdbApiKey REDACTED TMDB API key for metadata and notification enrichment

Volumes / Bind Mounts

Host Path Container Path Purpose
/home/jeeves/docker/arr/pulsarr/config /app/data Pulsarr database and configuration

Integration Points

Service Purpose
Sonarr Adds TV shows from watchlists; receives completion events
Radarr Adds movies from watchlists; receives completion events
Plex Reads watchlists from Plex accounts
TMDB Fetches poster art and metadata for notifications

Notes / Gotchas

  • The TMDB API key (tmdbApiKey) is visible in the container environment — treat it as a secret. Rotate at themoviedb.org if exposed.
  • Pulsarr's watchlist sync requires Plex account API tokens configured in the Pulsarr UI settings.
  • Pulsarr is healthy-checked ((healthy) status in docker ps) — the healthcheck endpoint is configured internally.
  • Notification channels (Discord, Telegram, etc.) are configured in Pulsarr settings and stored in the /app/data bind mount.

Last Updated: 2026-06-16

No comments to display

Back to top