
Prowlarr
Centralized indexer management for the *arr ecosystem
Prowlarr is an indexer manager/proxy built on the popular *arr .NET/ReactJS base stack to integrate with your various PVR apps. Prowlarr supports both torrent trackers and Usenet indexers, integrating seamlessly with Sonarr, Radarr, Lidarr, and Readarr offering complete management of your indexers with no per-app indexer setup required. QuickBox Pro installs Prowlarr from the nightly branch at / with automatic SQLite compatibility patches for Debian 11.
Centralized Management
Add indexers once in Prowlarr and they automatically sync to all connected *arr applications
Application Sync
Automatic synchronization with Sonarr, Radarr, Lidarr, Readarr, and other supported apps
Indexer Statistics
Monitor indexer health, response times, and success rates from a unified dashboard
Multi-Protocol Support
Supports both torrent trackers and Usenet indexers with extensive provider compatibility
Automatic Updates
Stay current with the latest indexer definitions and provider configurations
Advanced Configuration
Custom indexer categories, rate limiting, and proxy support for enhanced control
Installation
Symptoms
- QuickBox Pro v3 installed and configured
- At least one
*arrapp installed (Sonarr, Radarr, Lidarr, or Readarr) - Indexer accounts (torrent trackers or Usenet providers)
- User account created on the server
Resolution
- Use QuickBox's qb command for installation
- Automatic integration with existing
*arrapps - Per-user installation with isolated settings
Install from the Dashboard
Open App Dashboard → Package Management (/), find Prowlarr in the catalog (browse Indexers or search), and click Install. The dashboard streams the install log live and Prowlarr appears in your Application Control panel when it finishes. Reinstall and Remove are in the same Package Management panel. To update, use the amber Update badge on the Prowlarr row in the App Dashboard. Prowlarr ships on the nightly branch — there is nothing to pick in the install dialog.
What you see is gated by your account: admins manage any user’s apps; regular users manage their own. See App Management for the full flow.
Install from the CLI (automation)
The CLI runs the same scripts as the Dashboard and is suited to automation and scripting:
qb help prowlarr
qb install prowlarr -u username
qb reinstall prowlarr -u username
qb update prowlarr -u username
qb remove prowlarr -u usernameFull flag reference: CLI Reference.
Prowlarr’s web UI runs on an auto-assigned port (base 9696, secure 9797,
incremented per user) — find it in the dashboard or ~/. On
Debian 11 (Bullseye), QuickBox automatically applies a SQLite compatibility patch during
install and update — no manual step required.
Accessing Prowlarr
After installation, access Prowlarr at:
https://your-server-ip/username/prowlarrProwlarr is automatically integrated into your QuickBox dashboard. Find it on the App Dashboard (the default control view), stay on Application Control and expand its row for port and status. The API & Secrets section shows the Prowlarr API key masked, with buttons to reveal it and copy it. Click Open to launch the web interface.
Initial Configuration
1. Add Indexers
Navigate to Indexers → Add Indexer and configure your sources:
Popular Torrent Trackers:
- Public trackers: The Pirate Bay, 1337x, RARBG (no login required)
- Private trackers: IPTorrents, TorrentLeech, PassThePopcorn (require credentials)
Usenet Indexers:
- NZBGeek, NZBPlanet, NZBFinder
- DrunkenSlug, DOGnzb, NZB.su
- Requires API keys from providers
Configuration Steps:
- Click Add Indexer (+)
- Search for your indexer by name
- Enter credentials (username, password, API key, or cookie)
- Click Test to verify connection
- Save the indexer
2. Connect Applications
Link Prowlarr to your *arr apps for automatic indexer synchronization:
- Go to Settings → Apps
- Click Add Application (+)
- Select application type (Sonarr, Radarr, Lidarr, or Readarr)
- Enter connection details:
- Prowlarr Server:
http://localhost:9696 - Radarr Server:
http://(example)localhost:7878 - API Key: Copy it from that app’s row on the App Dashboard (API & Secrets section), or from the
*arrapp itself (Settings → General → Security → API Key) - Sync Level: Choose Full Sync for complete management
- Prowlarr Server:
- Click Test then Save
Prowlarr can sync indexers to Sportarr. Until Prowlarr ships a native Sportarr application type, add Sportarr under Settings → Apps as a Sonarr application, using Sportarr’s address and API key. The Sportarr wiki keeps the current steps and the categories to select: Prowlarr integration .
Prowlarr can automatically discover *arr applications running on the same server. Enable automatic discovery in Settings → General to simplify setup.
3. Test and Verify
After adding indexers:
- Click Test All Indexers button in Indexers tab
- Verify green checkmarks for successful connections
- Fix any red errors (usually authentication, rate limiting, or expired accounts)
- Verify indexers appear in your connected
*arrapps
Service Management
Prowlarr runs as a systemd service for reliability and automatic startup.
systemctl status prowlarr@username # Check status
systemctl restart prowlarr@username # Restart service
journalctl -u prowlarr@username -f # View live logs
systemctl enable prowlarr@username # Start on boot
systemctl disable prowlarr@username # Prevent auto-startBack up and restore
QuickBox backs Prowlarr up for you from the dashboard or the CLI, and the app keeps running while it does. Every backup is saved to /, named with the version and the date.
| Backup | What it saves |
|---|---|
| Config Only | config., the small configuration file. Your indexers, applications and history are in the database, so use Full Backup for them |
| Full Backup | Two archives: prowlarr-<version>-config_<date>.tar. holds your config folder / (the prowlarr. database, taken as a consistent copy, plus config.), and prowlarr-<version>-application_<date>.tar. holds the install tree /. The logs, Media, Backups and Update folders are left out |
| Nginx | Prowlarr’s nginx config, username. |
From the dashboard: to back up, open the App Dashboard, stay on Application Control, expand the Prowlarr row (click the row, or the arrow beside the app name, to open its options), open Operations, click Backup, then pick Full backup. Backup also offers Config Only and Nginx Only. You can instead open Content → Asset Management Center (AMC in the sidebar), choose the Application Backups tab, expand the Prowlarr row and click Back up now; that row lists every saved file with download and delete buttons. See App Management → Application Backups for who can see the tab.
To roll back from the dashboard: expand the Prowlarr row on the App Dashboard, open Operations, click Restore, pick the backup, then click Rollback. For a Full Backup the window offers Rollback, which puts back both the install tree and the config archive. Restore appears only when your account is allowed to restore backups.
From the CLI:
# Config Only: config.xml
qb manage software -o backup -u username -s prowlarr
# Full Backup: config folder with the database, plus the install tree
qb manage software -o backup -o app -u username -s prowlarr
# Roll back to a Full Backup: pick the version from a menu, then confirm
qb manage software -o rollback -o app -u username -s prowlarrEvery option is described in the qb manage reference.
A rollback stops Prowlarr, clears the stale -wal, -shm and -journal files beside each restored database, puts the archives back, and starts Prowlarr again. If Prowlarr was answering on its port before the rollback, the command waits for it to answer again and reports an error instead of finishing quietly if it does not come back.
qb remove prowlarr and qb reinstall prowlarr both delete / (the database and settings) and the backup folder / with every backup in it, and clear the rollback list. Before either one, download the Full Backup from the Application Backups tab in the Asset Management Center, or copy the folder somewhere QuickBox does not manage:
cp -a /home/username/.QuickBox/software/prowlarr/backup /home/username/prowlarr-backup-savedTroubleshooting
Prowlarr Won’t Start (Debian 11 Bullseye)
Symptoms
- Prowlarr crashes on startup with SQLite errors
- Journal logs show 'System.DllNotFoundException: libe_sqlite3'
- Service fails to start after update
Resolution
- Check if SQLite patch is applied:
ls -la /opt/ username/ Prowlarr/ libe_sqlite3. so - Reinstall to apply patch: qb reinstall prowlarr -u username
- Check logs: journalctl -u prowlarr@username -n 50
- Verify systemd override:
cat /etc/ systemd/ system/ prowlarr@username. service. d/ override. conf
Indexers Not Syncing to Apps
Symptoms
- Indexers added in Prowlarr but not appearing in Sonarr/Radarr
- Connection test fails with API errors
- Apps show as connected but no sync occurs
- Indexers appear but don't work in apps
Resolution
- Verify API keys match in both Prowlarr and target app
- Check connection: Settings → Apps → Test connection
- Ensure sync level is set to 'Full Sync' or 'Add Only'
- Manually trigger sync: Settings → Apps → Sync App Indexers button
- Check logs for specific errors: journalctl -u prowlarr@username -f
Rate Limiting Issues
# Check indexer response times in web UI
# Settings → Indexers → View indexer stats
# Adjust rate limits per indexer
# Edit Indexer → Advanced → Rate Limit (requests per second)
# Check for ban warnings in logs
journalctl -u prowlarr@username -f | grep -i "rate\|ban"Permission Issues
qb fix permissions -u username
systemctl restart prowlarr@usernameConfiguration Reset
Take a Full Backup first so you can undo the reset later with a rollback. The dashboard steps for both are in Back up and restore.
# Take a Full Backup first
qb manage software -o backup -o app -u username -s prowlarr
# To undo the reset later, roll back: qb manage software -o rollback -o app -u username -s prowlarr
# Stop service
systemctl stop prowlarr@username
# Remove configuration (will be regenerated)
rm -rf ~/.config/Prowlarr/*
# Restart service
systemctl start prowlarr@usernameBest Practices
Do
- Use Prowlarr as the single source of truth for all indexer management
- Test indexers regularly to catch expired accounts or API changes
- Set appropriate rate limits to avoid bans from indexers
- Use 'Full Sync' mode for complete indexer lifecycle management
- Monitor indexer statistics to identify underperforming sources
- Keep Prowlarr updated via qb update prowlarr for latest indexer definitions
- Document indexer API keys in a secure password manager
- Use categories to control which indexers sync to which apps
Don't
- Don't configure indexers manually in Sonarr/Radarr—use Prowlarr instead
- Don't use the same API key across multiple Prowlarr installations
- Don't ignore rate limit warnings—can result in indexer bans
- Don't add too many indexers—quality over quantity for better performance
- Don't forget to test indexers after adding them
- Don't share indexer accounts—violates most tracker terms of service
- Don't disable authentication if Prowlarr is accessible from the internet
- Don't manually delete indexers from apps—remove them in Prowlarr
Related Applications
Media Management
3Download Clients
4Additional Resources
Join the Community
Media server operators sharing configs, getting support, and shaping the future of QuickBox Pro.
- Dedicated Support
- Feature Previews
- Community Configs
- Active Discussions