Admirarr
CLI for self-hosted media server stacks. One binary, 26 commands, JSON output everywhere.
Install: curl -fsSL https://get.admirarr.dev | sh
Commands
Status & Diagnostics
admirarr status [-o json] [--live] # Fleet dashboard — services, libraries, queues, disk
admirarr health [-o json] # Health warnings from Radarr, Sonarr, Prowlarr
admirarr disk [-o json] # Disk space breakdown
admirarr docker [-o json] # Docker container status
admirarr doctor [-o json] # 15 diagnostic categories, 34 checks
admirarr doctor --fix # Built-in fixes → AI agent for the rest
Library
admirarr movies [-o json] # Movie library with file status
admirarr shows [-o json] # TV shows with episode counts
admirarr recent [-o json] # Recently added (Jellyfin or Plex)
admirarr history [-o json] # Watch history
admirarr missing [-o json] # Monitored without files
admirarr requests [-o json] # Seerr media requests
Search & Add
admirarr search "<query>" [-o json] # Search all Prowlarr indexers
admirarr find "<query>" [-o json] # Search Radarr releases
admirarr add-movie "<query>" # Interactive: search → pick → add to Radarr
admirarr add-show "<query>" # Interactive: search → pick → add to Sonarr
Downloads
admirarr downloads [-o json] # Active qBittorrent torrents
admirarr downloads pause [hash|all] # Pause torrents
admirarr downloads resume [hash|all] # Resume torrents
admirarr downloads remove <hash> [--delete-files]
admirarr queue [-o json] # Radarr + Sonarr import queues
Indexers
admirarr indexers [-o json] # Prowlarr indexer status
admirarr indexers setup # Interactive indexer wizard
admirarr indexers add <name> # Add an indexer
admirarr indexers remove <name> # Remove an indexer
admirarr indexers test # Test all indexer connectivity
admirarr indexers sync # Sync indexers to config.yaml
Quality Profiles
admirarr recyclarr # Recyclarr status
admirarr recyclarr sync [instance] # Run Recyclarr sync
admirarr recyclarr verify # Check quality profiles
admirarr recyclarr instances # List configured instances
Management
admirarr scan # Trigger media server library scan
admirarr restart <service> # Restart a Docker container
admirarr logs <service> # Recent logs
admirarr setup # Full setup wizard (12 phases)
admirarr migrate # Generate Docker Compose stack
Services
Default stack: Jellyfin, Radarr, Sonarr, Prowlarr, qBittorrent, Gluetun, Seerr, Bazarr, FlareSolverr, Watchtower
Optional: Plex, Lidarr, Readarr, Whisparr, SABnzbd, Autobrr, Unpackerr, Recyclarr, Profilarr, Tdarr, Tautulli, Jellystat, Notifiarr, Maintainerr
Auto-detects media server (Jellyfin first, then Plex). Services detected via HTTP regardless of deployment method.
Workflow Patterns
| Goal | Commands |
|---|---|
| Understand stack state | status → doctor → health |
| Fix an issue | doctor -o json → identify → restart / fix → doctor again |
| Add content | movies -o json (check exists) → add-movie → downloads → queue |
| Stuck downloads | downloads -o json → queue -o json → health → doctor |
| Missing content | missing -o json → requests -o json |
Rules
-o jsonwhen parsing output- Confirm with user before
restartor destructive actions - Present data as clean tables, not raw JSON
- Never delete user files or media
- Never modify *Arr databases directly