Arr Dashboard

Version 2.21.0 — The media-only storage & auth resilience release. The combined Storage figure now filters to disks holding configured *arr root folders, so container / and config volumes no longer inflate the total — with a new expandable storage breakdown panel explaining exactly which disks were counted, deduplicated, or excluded and why (#504, #505, closes #495). Works across containerized, bare-metal Linux, and Windows-native deployments (drive roots + UNC paths), and degrades safely when no root folders are configured. A misconfigured OIDC provider can no longer lock you out: the five global gates that silently disabled password and passkey auth when OIDC was enabled are gone — password, passkey, and OIDC now coexist (#501, closes #498). Tautulli's sparse get_metadata responses for deleted Plex items no longer flood Dashboard/Pulse with validation warnings (#502, closes #497). Security: hono override bumped to 4.12.21 closing CVE-2026-47673…47676 (#503). Plus dependency sweeps (#499, #500).

A unified dashboard for managing multiple Sonarr, Radarr, Prowlarr, Lidarr, Readarr, Plex, Tautulli, Jellyfin, Emby, and Seerr instances. Consolidate your media automation management into a single, secure, and powerful interface.

Now integrates with autobrr/qui as a federated peer for torrent-layer observability — surface seed health, ratios, and cross-seed siblings alongside your *arr/library data without arr-dashboard owning torrent-layer logic. See docs/QUI.md for setup.

Screenshots

Features

Unified Dashboard

• Multi-Instance Aggregation — View queue, calendar, history, and statistics across all Sonarr, Radarr, Prowlarr, Lidarr, and Readarr instances from a single view
• Global Search — Search for content across all your indexers simultaneously via Prowlarr
• Library Management — Browse, filter, and manage your movies, TV shows, music, and books in one place
• Calendar View — See upcoming releases across all instances with poster art and external links
• History Tracking — Download and import history from all services with timeline and table views

Plex & Tautulli Integration

• Now Playing — Real-time view of active Plex streams with user avatars, progress bars, transcode/direct play indicators, and bandwidth metrics
• Continue Watching / On Deck — See what's queued up next across your Plex libraries
• Recently Added — Latest additions to your Plex library with poster thumbnails
• Watch History — Historical watch data captured every 5 minutes from active sessions; enriched with codec/LAN-WAN/platform metadata when Tautulli is configured
• Plex Statistics — Dedicated stats tab with leaderboards (top + most-popular per media type), user analytics, device breakdown, codec distribution, bandwidth forecasting, quality scores, and daily activity charts. Works without Tautulli — analytics flow from the dashboard's own session-snapshot capture; Tautulli adds optional enrichment
• Library Enrichment — Watch status, play counts, and last-watched dates shown on library items
• Connect with Plex — OAuth-assisted setup discovers your reachable Plex servers and auto-fills the URL and token

Jellyfin & Emby Integration

• Full Plex Parity — Now playing, on-deck, recently added, watch history, library enrichment, and cleanup rules — at parity with the Plex integration
• Native Analytics — User, device, transcode, codec, bandwidth, quality score, and episode completion analytics sourced directly from Jellyfin/Emby (no Tautulli-equivalent required)
• Unified Backend — Emby is supported through a unified Jellyfin/Emby backend; both services work identically and can run side-by-side
• Watch-Aware Cleanup — 7 library cleanup rule evaluators use Jellyfin/Emby watch data (last watched, watch count, on-deck, user rating, watched-by, added-at, episode completion)

Seerr Integration

• Request Management — View, approve, and decline media requests directly from the dashboard
• User Management — Browse users with request counts, quotas, and permissions
• Issue Tracking — View and manage reported media issues
• Notification Agents — Configure Seerr notification agents from the dashboard

Content Discovery

• TMDB Integration — Discover trending, popular, and upcoming content
• One-Click Add — Add discovered content to any Radarr/Sonarr instance
• Seerr Availability — See request status and availability on the Discover page

TRaSH Guides Integration

• Quality Profiles — Apply TRaSH Guides quality profiles to your instances with guided wizard
• Custom Formats — Sync custom formats with recommended scores from TRaSH score sets
• Profile Cloning — Clone quality profiles from running instances with automatic TRaSH profile linking for ongoing score updates
• Templates — Create reusable configuration templates with instance-specific overrides
• Naming Schemes — Deploy TRaSH-recommended naming schemes for Radarr and Sonarr
• Auto-Sync — Keep configurations up-to-date with TRaSH Guides changes
• Deployment Preview — Preview changes before applying, with backup and rollback support
• Profile Groups — Profiles organized by category (Standard, Anime, French, German, SQP)

Notification System

• 8 Channels — Discord, Telegram, Email (SMTP), Pushover, Gotify, Ntfy, Pushbullet, and Browser Push (Web Push API)
• Event Subscriptions — Per-channel subscription grid for 12+ event types
• Rich Metadata — Contextual details in every notification (instance names, affected items, durations)
• Delivery Logs — Searchable history of all dispatched notifications with delivery status

Library Cleanup

• Rule-Based Engine — Define cleanup rules using 20+ condition types: age, size, rating, genre, tag, quality, watched status (Plex/Tautulli), request status (Seerr), and more
• Approval Queue — Dry-run evaluation presents candidates for human review before deletion
• Scheduled Execution — Automated runs with configurable intervals
• Audit Logging — Complete history of cleanup actions with item details and rule matches

Auto-Tagger

• Criteria-Based Tagging — Apply tags to Sonarr/Radarr items automatically based on rules across 50+ condition types (genre, year, codec, audio channels, watch state, Plex labels/collections, custom format score, file path regex, …) — same DSL as Library Cleanup
• Composite Rules — Combine multiple criteria with AND/OR (e.g., "tag any 4K release from a premium release group as premium")
• Real-Time via Connect Webhooks — Sub-second tagging on import via Sonarr/Radarr Connect webhook handler with per-user Bearer-token auth (token is SHA-256 hashed at rest, shown once at generation)
• Pairs With Label Sync — Auto-Tagger seeds the source-side tag; Label Sync optionally mirrors it to Plex/Jellyfin/Emby labels
• Per-Rule Lock — Scheduled tick and on-demand "Run now" can't race for the same rule

Automated Hunting

• Missing Content Search — Automatically search for missing movies, episodes, albums, and books
• Quality Upgrades — Find better quality versions of existing content
• Per-Instance Config — Enable/disable and configure search intervals, batch sizes, and filters per instance
• Rate Limiting — Configurable hourly API caps to prevent abuse
• Activity Logging — Track all automated search activity with detailed history

Queue Cleaner

• Automated Queue Management — Remove stalled, slow, or problematic downloads based on configurable rules
• Strike System — Warn items before removal with configurable strike thresholds
• Dry Run Mode — Preview what would be cleaned without making changes
• Auto-Import — Automatically import completed downloads that are stuck in queue

Security & Authentication

• Multi-Auth Support — Password, OIDC (Authelia/Authentik/Keycloak), or Passkeys (WebAuthn)
• Encrypted Storage — All API keys encrypted at rest (AES-256-GCM)
• Session Management — Secure HTTP-only cookie sessions with multi-device support
• Incognito Mode — Hide sensitive data (media titles, usernames, server names, URLs) across the entire UI — disguises everything as Linux ISO downloads for safe screenshotting
• Zero-Config Security — Auto-generated encryption keys on first run

Management

• Backup & Restore — Automated encrypted backups with configurable retention and scheduling
• Tag Organization — Organize instances with custom tags and storage groups
• Multi-Instance — Manage unlimited instances across all supported services
• System Settings — Configurable ports, listen address, and application restart from the UI

Quick Start

Docker (Recommended)

docker run -d \
  --name arr-dashboard \
  -p 3000:3000 \
  -v /path/to/config:/config \
  -e PUID=1000 \
  -e PGID=1000 \
  --restart unless-stopped \
  khak1s/arr-dashboard:latest

Docker Compose

services:
  arr-dashboard:
    image: khak1s/arr-dashboard:latest
    container_name: arr-dashboard
    environment:
      - PUID=1000  # Set to your user ID (run `id -u` on host)
      - PGID=1000  # Set to your group ID (run `id -g` on host)
    volumes:
      - ./config:/config
    ports:
      - 3000:3000
    restart: unless-stopped

Then start:

docker-compose up -d

First Time Setup

1. Open http://your-server-ip:3000
2. Create your admin account on first run
3. Add your Sonarr/Radarr/Prowlarr instances in Settings
4. Optionally connect Plex, Tautulli, and Seerr
5. Start managing your media!

Supported Services

Compatible Services

Some newer *arr-style projects (for example Sportarr, or future Readarr-replacement projects like Chaptarr) expose APIs that closely mirror Sonarr or Radarr. These can be added to arr-dashboard today by creating a Sonarr or Radarr instance and pointing it at the compatible service. Most surfaces (queue, calendar, library, history) will work as long as the third-party project stays compatible with the upstream Sonarr or Radarr API contract.

This is a best-effort path rather than a supported integration. arr-dashboard does not test against these services, and behavior outside the documented Servarr API surface is not guaranteed. If a service diverges from the upstream API, expect breakage and treat it as a known limitation rather than a bug.

First-class support is reserved for services listed in the table above.

Version Tags

Upgrading from 2.4.x? See RELEASE_NOTES.md for migration instructions. The volume mount path changed from /app/data to /config.

Configuration

Zero Configuration Required

The application auto-generates all necessary security keys on first run. No environment variables needed for basic operation.

Config Volume Contents

The /config volume contains critical data that must be preserved:

Important: If secrets.json is lost, encrypted API keys cannot be decrypted. You would need to re-enter all service API keys. Always preserve your entire /config volume when upgrading or migrating.

Optional Environment Variables

Note: Two modes are supported for running as a non-root user:

PUID/PGID (default): Set PUID and PGID to match the owner of your config directory. The container starts as root, sets up permissions, then drops privileges. This follows the LinuxServer.io convention.

Rootless (--user): Run the container directly as a non-root user with --user UID:GID or user: "UID:GID" in Compose. No root required — ideal for Kubernetes and security-hardened deployments. Ensure /config is writable by the specified user. PUID/PGID env vars are ignored in this mode.

Platform Support

Unraid

Community Applications template available. See the wiki for detailed instructions.

Synology/QNAP

Use Docker Compose method with appropriate volume paths.

PostgreSQL Database

By default, Arr Dashboard uses SQLite stored at /config/prod.db. For larger deployments:

docker run -d \
  --name arr-dashboard \
  -p 3000:3000 \
  -v /path/to/config:/config \
  -e DATABASE_URL="postgresql://user:password@hostname:5432/arr_dashboard" \
  khak1s/arr-dashboard:latest

The schema is automatically synchronized on startup. You can switch between SQLite and PostgreSQL at any time — create a backup first (Settings → Backup).

Architecture

arr-dashboard/
├── apps/
│   ├── api/          # Fastify 4 API server (port 3001)
│   └── web/          # Next.js 16 frontend (port 3000)
├── packages/
│   └── shared/       # Shared Zod schemas & TypeScript types
└── docker/
    └── start-combined.sh  # Single-container startup

Technology Stack

Development

Prerequisites

• Node.js 22+
• pnpm 10+

Setup

git clone https://github.com/Kha-kis/arr-dashboard.git
cd arr-dashboard
pnpm install
pnpm run dev

The API runs at http://localhost:3001 and the web app at http://localhost:3000.

Building from Source

pnpm run build
docker build -t arr-dashboard:local .

Database Commands

cd apps/api
pnpm run db:push      # Sync schema to database
pnpm run db:generate  # Regenerate Prisma client

Security

Best Practices

1. Use HTTPS — Set up a reverse proxy (nginx, Caddy, Traefik) with TLS
2. Keep Private — Don't expose *arr instances directly to the internet
3. Regular Backups — Use the built-in encrypted backup feature
4. Strong Passwords — Use unique, strong passwords for all services
5. Keep Updated — Pull latest Docker images regularly

Docker Security Hardening (Optional)

Using PUID/PGID (starts as root, drops privileges):

docker run -d \
  --name arr-dashboard \
  --security-opt=no-new-privileges:true \
  --cap-drop=ALL \
  -p 3000:3000 \
  -v /path/to/config:/config \
  -e PUID=1000 \
  -e PGID=1000 \
  khak1s/arr-dashboard:latest

Using rootless mode (no root required):

docker run -d \
  --name arr-dashboard \
  --user 1000:1000 \
  -p 3000:3000 \
  -v /path/to/config:/config \
  khak1s/arr-dashboard:latest

Ensure /path/to/config is owned by UID:GID 1000:1000 when using rootless mode.

Reverse Proxy Example (nginx)

server {
    listen 443 ssl http2;
    server_name dashboard.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

Updating

docker-compose pull
docker-compose up -d

Troubleshooting

Getting Help

1. Check container logs: docker logs arr-dashboard
2. Review existing issues
3. Open a new issue with your version number, deployment method, and error messages

Documentation

Full Documentation Wiki

For Contributors: See CLAUDE.md for technical architecture and development guide.

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

License

MIT License - see LICENSE for details.

Acknowledgments

• Sonarr / Radarr / Prowlarr / Lidarr / Readarr — The *arr stack
• Plex / Tautulli — Media server analytics
• Seerr — Media request management
• TRaSH Guides — Quality profile recommendations
• TMDB — Movie and TV show metadata

Made with love for the self-hosted community