Prowlarr¶
What it is¶
Prowlarr is an indexer manager/proxy built on the popular Arr .net/react stack to integrate with your various PVR apps. Prowlarr supports management of both Torrent Trackers and Usenet Indexers. As of July 2026, it remains the industry standard for centralized metadata acquisition, featuring native MCP 3.0 Task Protocol support for automated tracker synchronization and Gemma 3 multimodal analysis for indexer health monitoring.
What problem it solves¶
It centralizes the management of indexers and trackers. Instead of configuring the same 10 indexers in Sonarr, Radarr, Lidarr, and Readarr manually, you configure them once in Prowlarr, and they are automatically synchronized across all your applications. It solves "configuration drift" and provides a unified interface for agentic discovery of media across the entire self-hosted stack.
Where it fits in the stack¶
Category: Services / Media Management. It sits in the indexer management layer, acting as a proxy and synchronization hub between your PVR applications (Sonarr/Radarr) and your media sources (trackers/indexers). It is a critical component for agentic content retrieval.
Typical use cases¶
- Centralized Indexer Management: Adding a new private tracker once and having it available everywhere.
- Proxying Requests: Hiding your PVR apps behind a single proxy for indexer requests.
- Indexer Health Monitoring: Using Gemma 3 to analyze failure patterns and automatically rotate trackers.
- Agentic Search: Providing a structured API for Gemma 3 to query availability of specific media across multiple trackers via the MCP 3.0 Task Protocol.
- Automated Tracker Rotation: Implementing GitOps-driven tracker management via n8n.
Strengths¶
- Seamless Synchronization: Automatically pushes indexer configurations to Sonarr, Radarr, Lidarr, and Readarr.
- Broad Support: Supports hundreds of Torrent trackers and Usenet indexers.
- Unified UI: Consistent interface with other Arr apps.
- Authentication: Modern versions (2026) include built-in "Basic" authentication and OIDC support (via Authentik) to secure the UI.
- MCP 3.0 Integration: Native support for standardized task representations, allowing AI agents to orchestrate complex acquisition workflows.
Limitations¶
- Arr Ecosystem Focus: Optimized for the Arr suite; may be less useful if you only use standalone downloaders or alternative PVRs.
- Resource Usage: Like other Arr apps, it has a non-trivial RAM footprint compared to lightweight alternatives like Jackett.
- Complexity: For users with only one tracker, the overhead of managing Prowlarr may exceed the benefits.
When to use it¶
- When you use multiple "Arr" applications (Sonarr, Radarr, etc.) and want to centralize indexer management.
- To replace Jackett for a more modern, synchronized experience.
- When you want automatic health monitoring and per-app indexer assignment.
- For managing access to private trackers across multiple geographically distributed downloaders using Tailscale.
When not to use it¶
- If you only use a single PVR application and don't mind manual configuration.
- On extremely resource-constrained devices where Jackett might be preferred for its slightly lower overhead.
Getting started¶
Docker Compose¶
services:
prowlarr:
image: lscr.io/linuxserver/prowlarr:latest
container_name: prowlarr
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/London
volumes:
- /path/to/prowlarr/config:/config
ports:
- 9696:9696
restart: unless-stopped
Hello World¶
- Access the UI at
http://localhost:9696. - Go to Settings > Apps and add your Sonarr/Radarr instances using their API keys.
- Go to Indexers and add your first tracker or indexer.
- Watch as the indexer is automatically added to your connected PVR apps!
CLI examples¶
Prowlarr is primarily managed via Web UI or API, but you can check logs or restart via Docker:
# View logs
docker logs -f prowlarr
# Restart service
docker restart prowlarr
# Check the version of Prowlarr running
docker exec prowlarr /app/prowlarr/Prowlarr --version
API examples¶
Prowlarr uses a REST API similar to other Arr apps.
# Get all configured indexers
curl -H "X-Api-Key: YOUR_API_KEY" \
-X GET "http://localhost:9696/api/v1/indexer"
# Test a specific indexer (replace {id} with indexer ID)
curl -H "X-Api-Key: YOUR_API_KEY" \
-X POST "http://localhost:9696/api/v1/indexer/test/{id}"
Related tools / concepts¶
- Jackett — The predecessor and primary alternative.
- Jellyfin — The frontend media server.
- Plex — Alternative media server.
- qbittorrent — Standard BitTorrent client.
- qbittorrent-automation — For agentic acquisition workflows.
- n8n — Workflow engine for media automation.
- Tailscale — For secure remote access to the Prowlarr UI.
- Authentik — For SSO integration.
- Paperless-ngx — For automated document ingestion.
- Local LLMs Guide — Reference for Gemma 3 and other models.
Sources / references¶
Contribution Metadata¶
- Last reviewed: 2026-07-21
- Confidence: high