
NZBHydra2
Usenet meta-search aggregator for multiple indexers
NZBHydra2 is a meta search for NZB indexers. It provides easy access to a number of raw and newznab based indexers, allowing you to search all your indexers from one place and use it as an indexer source for tools like Sonarr, Radarr, or CouchPotato. QuickBox Pro installs NZBHydra2 from the latest GitHub release at / with a Python 3 wrapper and automatic nginx reverse proxy configuration.
Unified Search
Search multiple Usenet indexers simultaneously from a single interface
Statistics & History
Track search performance, download history, and indexer usage statistics
Automatic Fallback
Automatically retry failed searches on alternative indexers
Indexer Management
Configure and prioritize indexers with custom search categories
API Integration
Newznab and Torznab API support for seamless *arr app integration
Performance Tracking
Monitor response times, success rates, and indexer health from dashboard
NZBHydra2 v5+ ships a self-contained native binary—Java is not required. QuickBox Pro installs NZBHydra2 with a Python 3 wrapper and no additional runtime dependencies.
Installation
Symptoms
- QuickBox Pro v3 installed and configured
- Multiple Usenet indexers with API access
- At least one
*arrapp installed (Sonarr, Radarr, etc.) - User account created on the server
Resolution
- Use QuickBox's qb command for installation
- No additional runtime dependencies required
- Per-user installation with isolated settings
Install from the Dashboard
Open App Dashboard → Package Management (/), find NZBHydra2
in the catalog (browse Indexers or search), and click Install. The dashboard streams the
install log live and NZBHydra2 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 NZBHydra2 row in the App Dashboard.
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 nzbhydra2
qb install nzbhydra2 -u username
qb reinstall nzbhydra2 -u username
qb update nzbhydra2 -u username
qb remove nzbhydra2 -u usernameFull flag reference: CLI Reference.
NZBHydra2 runs on an auto-assigned port (base 5075, incremented per user) — find it
in the dashboard or ~/.
Accessing NZBHydra2
After installation, access NZBHydra2 at:
https://your-server-ip/username/nzbhydra2NZBHydra2 is automatically integrated into your QuickBox dashboard. Find it on the App Dashboard (the default control view), expand its row for port and status, and click Open to launch the web interface.
Configuration and Files
Initial Configuration
1. Add Indexers
Configure your Usenet indexers:
- Navigate to Config → Indexers
- Click Add new indexer
- Select indexer type:
- Newznab (most common)
- Torznab (torrent indexers)
- AnizB (anime-focused)
- Enter indexer details:
- Name: Indexer name (e.g., “NZBGeek”)
- URL: Indexer API URL
- API Key: Your indexer API key
- Search Categories: Configure categories to search
- Click Test to verify connection
- Save the indexer
Popular Usenet Indexers:
- NZBGeek, NZBPlanet, NZBFinder
- DrunkenSlug, DOGnzb, NZB.su
- UsenetCrawler, NZBCat
2. Configure Search Settings
Optimize search behavior:
- Go to Config → Searching
- Configure options:
- Generate queries: Enable query generation for better results
- Timeout: Set search timeout (default: 20 seconds)
- Remove trailing…: Clean up search queries
- Forbid words: Block unwanted content
- Save configuration
3. Connect to *arr Applications
Link NZBHydra2 to your automation tools:
Sonarr/Radarr/Lidarr/Readarr:
- Open your
*arrapp - Go to Settings → Indexers → Add (+)
- Select Newznab
- Enter NZBHydra2 connection details:
- Name: “NZBHydra2”
- URL:
http://(or your port)localhost:5075 - API Path:
/api - API Key: Copy from NZBHydra2’s row on the App Dashboard (API & Secrets section), or from NZBHydra2 (Config → Main → API Key)
- Categories: Select appropriate media types
- Click Test then Save
Configure NZBHydra2 once as an indexer in each *arr app. NZBHydra2 will automatically search all configured indexers and aggregate results.
Service Management
NZBHydra2 runs as a systemd service for reliability and automatic startup.
systemctl status nzbhydra2@username # Check status
systemctl restart nzbhydra2@username # Restart service
journalctl -u nzbhydra2@username -f # View live logs
systemctl enable nzbhydra2@username # Start on boot
systemctl disable nzbhydra2@username # Prevent auto-startBack up and restore
QuickBox backs NZBHydra2 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 | nzbhydra., the configuration file that holds your indexers, categories and download settings |
| Full Backup | Two archives: nzbhydra2-<version>-config_<date>.tar. holds your config folder / (nzbhydra. plus the data beside it; the logs folder is left out), and nzbhydra2-<version>-application_<date>.tar. holds the install tree / |
| Nginx | NZBHydra2’s nginx config, username. |
From the dashboard: to back up, open the App Dashboard, stay on Application Control, expand the NZBHydra2 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 NZBHydra2 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 NZBHydra2 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: nzbhydra.yml
qb manage software -o backup -u username -s nzbhydra2
# Full Backup: config folder plus the install tree
qb manage software -o backup -o app -u username -s nzbhydra2
# Roll back to a Full Backup: pick the version from a menu, then confirm
qb manage software -o rollback -o app -u username -s nzbhydra2Every option is described in the qb manage reference.
A rollback stops NZBHydra2, puts the archives back, and starts NZBHydra2 again. If NZBHydra2 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 nzbhydra2 and qb reinstall nzbhydra2 both delete / (your indexers 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/nzbhydra2/backup /home/username/nzbhydra2-backup-savedTroubleshooting
NZBHydra2 Won’t Start
Check the service journal for errors:
journalctl -u nzbhydra2@username -fVerify the Python wrapper and native binary are executable:
ls -la /opt/username/NZBHydra2/core /opt/username/NZBHydra2/nzbhydra2wrapperPy3.pyIf permissions are wrong, reinstall to fix them:
qb reinstall nzbhydra2 -u usernameWhen installing or updating via the QuickBox dashboard, operation logs are written to / and can be viewed in the dashboard’s log viewer.
Indexer Connection Failures
Symptoms
- Indexer test fails with API errors
- Searches return no results from specific indexers
- Timeout errors during searches
- Invalid API key errors
Resolution
- Verify API key is correct on indexer website
- Check indexer URL includes full API endpoint
- Test indexer directly in their web interface
- Increase timeout in Config → Searching
- Check indexer status page for downtime
Dependency Issues
If the service fails to start after an update, verify Python 3 is available:
# Check Python 3 is available (used by wrapper script)
python3 --version
# Reinstall to refresh all files and permissions
qb reinstall nzbhydra2 -u usernamePermission Issues
qb fix permissions -u username
systemctl restart nzbhydra2@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 nzbhydra2
# To undo the reset later, roll back: qb manage software -o rollback -o app -u username -s nzbhydra2
# Stop service
systemctl stop nzbhydra2@username
# Remove configuration (will be regenerated)
rm ~/.config/NZBHydra2/nzbhydra.yml
# Restart service
systemctl start nzbhydra2@usernameBest Practices
Do
- Add multiple indexers for comprehensive coverage and redundancy
- Monitor indexer statistics to identify underperforming sources
- Configure appropriate search categories for each indexer
- Use query generation for improved search results
- Keep NZBHydra2 updated via qb update nzbhydra2
- Set reasonable timeouts to balance speed and completeness
- Review search history to optimize indexer priorities
- Document indexer API keys in a secure password manager
Don't
- Don't add too many slow indexers—they'll delay all searches
- Don't share your NZBHydra2 API key publicly—grants full access
- Don't ignore failed indexers—remove or fix them to improve performance
- Don't use extremely short timeouts—may miss slower indexers
- Don't forget to test indexers after adding them
- Don't manually edit nzbhydra.yml while service is running
- Don't expose NZBHydra2 directly to the internet without authentication
- Don't manually edit service unit files—use
qb reinstallto refresh them
FAQ
Related Applications
Media Management
3Download Clients
2Additional 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