mirror of
https://github.com/plexguide/Huntarr.io.git
synced 2026-02-19 23:37:26 -05:00
2997382d37
- Move donate page from help/donate.html to donate.html (URL: .../donate.html) - Update all doc links and README to new donate URL - Sidebar Donate link: red border, left accent, subtle red glow and background - Applies to all doc pages via shared main.css
279 lines
14 KiB
HTML
279 lines
14 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<title>FAQ & Troubleshooting - Huntarr Docs</title>
|
|
<link rel="icon" type="image/png" href="../images/huntarr-logo.png">
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
|
|
<link rel="stylesheet" href="../css/main.css">
|
|
</head>
|
|
<body>
|
|
|
|
<!-- Mobile Topbar -->
|
|
<div class="docs-mobile-topbar">
|
|
<button class="mob-hamburger" aria-label="Open navigation"><span></span><span></span><span></span></button>
|
|
<img src="../images/huntarr-logo.png" alt="Huntarr" class="mob-logo">
|
|
<span class="mob-title">Documentation</span>
|
|
</div>
|
|
|
|
<!-- Sidebar Backdrop (mobile) -->
|
|
<div class="docs-sidebar-backdrop"></div>
|
|
|
|
<div class="docs-layout">
|
|
|
|
<!-- ===== SIDEBAR ===== -->
|
|
<nav class="docs-sidebar" aria-label="Documentation navigation">
|
|
<a href="../index.html" class="sidebar-brand">
|
|
<img src="../images/huntarr-logo.png" alt="Huntarr">
|
|
<span>Huntarr</span>
|
|
</a>
|
|
|
|
<div class="sidebar-scroll">
|
|
|
|
<!-- Getting Started -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">Getting Started</div>
|
|
<div class="nav-group-items">
|
|
<a href="../index.html"><i class="fas fa-home"></i> Welcome</a>
|
|
<a href="../getting-started/installation.html"><i class="fas fa-download"></i> Installation</a>
|
|
<a href="../getting-started/setup-wizard.html"><i class="fas fa-magic"></i> Setup Wizard</a>
|
|
<a href="../getting-started/first-steps.html"><i class="fas fa-rocket"></i> First Steps</a>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Apps -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">Apps</div>
|
|
<div class="nav-group-items">
|
|
<a href="../apps/index.html"><i class="fas fa-th-large"></i> Overview</a>
|
|
<a href="../apps/sonarr.html"><i class="fas fa-tv"></i> Sonarr</a>
|
|
<a href="../apps/radarr.html"><i class="fas fa-film"></i> Radarr</a>
|
|
<a href="../apps/lidarr.html"><i class="fas fa-music"></i> Lidarr</a>
|
|
<a href="../apps/readarr.html"><i class="fas fa-book"></i> Readarr</a>
|
|
<a href="../apps/whisparr.html"><i class="fas fa-mask"></i> Whisparr</a>
|
|
<a href="../apps/prowlarr.html"><i class="fas fa-search"></i> Prowlarr</a>
|
|
<a href="../apps/swaparr.html"><i class="fas fa-exchange-alt"></i> Swaparr</a>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Movie Hunt -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">Movie Hunt</div>
|
|
<div class="nav-group-items">
|
|
<a href="../movie-hunt/index.html"><i class="fas fa-clapperboard"></i> Overview <span class="nav-badge nav-badge-beta">Beta</span></a>
|
|
<a href="../movie-hunt/media-collection.html"><i class="fas fa-photo-film"></i> Media Collection</a>
|
|
<a href="../movie-hunt/indexers-clients.html"><i class="fas fa-server"></i> Indexers & Clients</a>
|
|
<a href="../movie-hunt/profiles.html"><i class="fas fa-sliders"></i> Profiles</a>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- NZB Hunt -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">NZB Hunt</div>
|
|
<div class="nav-group-items">
|
|
<a href="../nzb-hunt/index.html"><i class="fas fa-newspaper"></i> Overview <span class="nav-badge nav-badge-beta">Beta</span></a>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Requestarr -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">Requests</div>
|
|
<div class="nav-group-items">
|
|
<a href="../requestarr/index.html"><i class="fas fa-hand-paper"></i> Requests</a>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Settings -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">Settings</div>
|
|
<div class="nav-group-items">
|
|
<a href="../settings/index.html"><i class="fas fa-cog"></i> Main Settings</a>
|
|
<a href="../settings/scheduling.html"><i class="fas fa-clock"></i> Scheduling</a>
|
|
<a href="../settings/notifications.html"><i class="fas fa-bell"></i> Notifications</a>
|
|
<a href="../settings/backup-restore.html"><i class="fas fa-database"></i> Backup & Restore</a>
|
|
<a href="../settings/log-settings.html"><i class="fas fa-file-alt"></i> Log Settings</a>
|
|
<a href="../settings/user-account.html"><i class="fas fa-user-shield"></i> User Account</a>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- System -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">System</div>
|
|
<div class="nav-group-items">
|
|
<a href="../system/hunt-manager.html"><i class="fas fa-tasks"></i> Hunt Manager</a>
|
|
<a href="../system/logs.html"><i class="fas fa-scroll"></i> Logs</a>
|
|
<a href="../system/api.html"><i class="fas fa-code"></i> API Reference</a>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Help -->
|
|
<div class="nav-group">
|
|
<div class="nav-group-title">Help</div>
|
|
<div class="nav-group-items">
|
|
<a href="faq.html" class="active"><i class="fas fa-question-circle"></i> FAQ</a>
|
|
<a href="community.html"><i class="fas fa-users"></i> Community</a>
|
|
<a href="https://plexguide.github.io/Huntarr.io/donate.html"><i class="fas fa-heart"></i> Donate</a>
|
|
</div>
|
|
</div>
|
|
|
|
</div><!-- /sidebar-scroll -->
|
|
|
|
<div class="sidebar-footer">
|
|
<a href="https://discord.com/invite/PGJJjR5Cww" target="_blank" class="sf-discord" title="Discord"><i class="fab fa-discord"></i></a>
|
|
<a href="https://www.reddit.com/r/huntarr/" target="_blank" class="sf-reddit" title="Reddit"><i class="fab fa-reddit-alien"></i></a>
|
|
<a href="https://github.com/plexguide/Huntarr.io" target="_blank" class="sf-github" title="GitHub"><i class="fab fa-github"></i></a>
|
|
<a href="https://plexguide.github.io/Huntarr.io/donate.html" class="sf-heart" title="Donate"><i class="fas fa-heart"></i></a>
|
|
</div>
|
|
</nav>
|
|
|
|
<!-- ===== MAIN ===== -->
|
|
<main class="docs-main">
|
|
<div class="docs-content">
|
|
|
|
<h1>FAQ & Troubleshooting</h1>
|
|
<p class="page-subtitle">Answers to common questions and solutions to frequent issues.</p>
|
|
|
|
<h2>General</h2>
|
|
|
|
<h3>What is Huntarr?</h3>
|
|
<p>Huntarr is an automated media hunting companion for the *arr stack (Sonarr, Radarr, Lidarr, Readarr, Whisparr). It continuously searches for missing media and upgrades existing files to better quality. It also includes Movie Hunt (standalone movie grabber), NZB Hunt (Usenet search), and Requests (media requests for the person running Huntarr, not for other users).</p>
|
|
|
|
<h3>How does Huntarr differ from the built-in search in Sonarr/Radarr?</h3>
|
|
<p>The *arr apps have their own search capabilities, but they only search when you manually trigger it or when new items are added. Huntarr runs on a schedule, continuously re-trying searches for items that haven't been found yet, and looking for quality upgrades.</p>
|
|
|
|
<h3>Does Huntarr replace Sonarr/Radarr?</h3>
|
|
<p>No. Huntarr works alongside your *arr apps. It uses their APIs to trigger searches. You still need Sonarr, Radarr, etc. for managing your library. The exception is Movie Hunt, which is a standalone movie grabber.</p>
|
|
|
|
<h3>What ports does Huntarr use?</h3>
|
|
<p>By default, Huntarr runs on port 9705. You can change this in Settings > Main or via the HUNTARR_PORT environment variable.</p>
|
|
|
|
<h2>Installation</h2>
|
|
|
|
<h3>Docker container won't start</h3>
|
|
<ul>
|
|
<li>Check that port 9705 isn't already in use</li>
|
|
<li>Verify your volume mappings exist and are writable</li>
|
|
<li>Check container logs: <code>docker logs huntarr</code></li>
|
|
<li>Ensure the image is up-to-date: <code>docker pull huntarr/huntarr:latest</code></li>
|
|
</ul>
|
|
|
|
<h3>"Permission denied" errors</h3>
|
|
<ul>
|
|
<li>Ensure the /config directory is writable by the container</li>
|
|
<li>Check file ownership: the container runs as root by default</li>
|
|
<li>On Unraid, ensure the template has correct path mappings</li>
|
|
</ul>
|
|
|
|
<h3>Huntarr is unreachable</h3>
|
|
<ul>
|
|
<li>Verify the container is running: <code>docker ps | grep huntarr</code></li>
|
|
<li>Check the port mapping in your Docker configuration</li>
|
|
<li>Try accessing directly: <code>http://your-server-ip:9705</code></li>
|
|
<li>Check firewall rules</li>
|
|
</ul>
|
|
|
|
<h2>App Connections</h2>
|
|
|
|
<h3>"API key invalid" error</h3>
|
|
<ul>
|
|
<li>Re-copy the API key from your *arr app (Settings > General > Security)</li>
|
|
<li>Ensure there are no extra spaces or characters</li>
|
|
<li>Verify the URL includes the correct port</li>
|
|
<li>Test the URL directly in your browser (should show the *arr web UI)</li>
|
|
</ul>
|
|
|
|
<h3>Can't connect to *arr app</h3>
|
|
<ul>
|
|
<li>Verify the app is running and accessible</li>
|
|
<li>Use the internal Docker network name if both are in Docker (e.g., <code>http://sonarr:8989</code>)</li>
|
|
<li>Check that you're using the correct port</li>
|
|
<li>Try the IP address instead of hostname</li>
|
|
</ul>
|
|
|
|
<h3>Multiple instances of the same app</h3>
|
|
<p>Yes, Huntarr fully supports multiple instances. Add each instance separately with its own URL and API key. You can configure different schedules and settings per instance.</p>
|
|
|
|
<h2>Hunting</h2>
|
|
|
|
<h3>Hunts run but nothing is found</h3>
|
|
<ul>
|
|
<li>Check that your *arr app has working indexers</li>
|
|
<li>Verify the media is monitored in the *arr app</li>
|
|
<li>For movies, check the Minimum Availability setting</li>
|
|
<li>Try searching manually in the *arr app — if it doesn't find anything there, Huntarr won't either</li>
|
|
<li>Increase caps gradually; some media takes multiple search attempts</li>
|
|
</ul>
|
|
|
|
<h3>Hunts are too aggressive / indexer bans</h3>
|
|
<ul>
|
|
<li>Reduce the cap per cycle (start with 1-3)</li>
|
|
<li>Increase the schedule interval (30-60 minutes minimum)</li>
|
|
<li>Use per-instance schedules to stagger load</li>
|
|
<li>Check your indexer's rate limits</li>
|
|
</ul>
|
|
|
|
<h3>Hunt schedules aren't running</h3>
|
|
<ul>
|
|
<li>Verify the schedule is enabled in Settings > Scheduling</li>
|
|
<li>Check that the app instance is connected and enabled</li>
|
|
<li>Review logs for any error messages</li>
|
|
<li>Restart Huntarr if schedules seem stuck</li>
|
|
</ul>
|
|
|
|
<h2>Movie Hunt</h2>
|
|
|
|
<h3>Movie Hunt isn't finding movies</h3>
|
|
<ul>
|
|
<li>Verify you have at least one indexer configured and working</li>
|
|
<li>Check that a download client is configured</li>
|
|
<li>Ensure the movie's minimum availability allows searching</li>
|
|
<li>Try searching directly in NZB Hunt to test indexer connectivity</li>
|
|
</ul>
|
|
|
|
<h3>Downloads aren't completing</h3>
|
|
<ul>
|
|
<li>Verify your download client is running and accessible</li>
|
|
<li>Check the download client's logs for errors</li>
|
|
<li>Ensure the download category exists in your client</li>
|
|
<li>Check available disk space</li>
|
|
</ul>
|
|
|
|
<h2>Database & Backup</h2>
|
|
|
|
<h3>Huntarr lost my settings after restart</h3>
|
|
<ul>
|
|
<li>This was a known issue that has been fixed in recent versions</li>
|
|
<li>Update to the latest version</li>
|
|
<li>Enable automatic backups as insurance</li>
|
|
<li>Check that your /config volume is properly mounted and persistent</li>
|
|
</ul>
|
|
|
|
<h3>How to migrate to a new server</h3>
|
|
<ol>
|
|
<li>Create a backup in Settings > Backup & Restore</li>
|
|
<li>Copy the backup file to the new server</li>
|
|
<li>Install Huntarr on the new server</li>
|
|
<li>Complete the setup wizard</li>
|
|
<li>Upload and restore the backup</li>
|
|
</ol>
|
|
|
|
<div class="alert alert-info">
|
|
<strong>Need more help?</strong>
|
|
<p>If your question isn't answered here, join our <a href="https://discord.com/invite/PGJJjR5Cww" target="_blank" style="color: inherit; text-decoration: underline;">Discord server</a> for community support.</p>
|
|
</div>
|
|
|
|
</div><!-- /docs-content -->
|
|
|
|
<footer class="docs-footer">
|
|
<p>Huntarr is open source. <a href="https://github.com/plexguide/Huntarr.io" target="_blank">GitHub</a> · <a href="https://discord.com/invite/PGJJjR5Cww" target="_blank">Discord</a> · <a href="https://www.reddit.com/r/huntarr/" target="_blank">Reddit</a></p>
|
|
</footer>
|
|
</main>
|
|
|
|
</div><!-- /docs-layout -->
|
|
|
|
<button class="back-to-top" aria-label="Back to top"><i class="fas fa-arrow-up"></i></button>
|
|
<script src="../js/main.js"></script>
|
|
</body>
|
|
</html>
|