mirror of
https://github.com/plexguide/Huntarr.io.git
synced 2025-12-30 17:39:07 -05:00
656 lines
35 KiB
HTML
656 lines
35 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<title>Frequently Asked Questions - Huntarr.io Documentation</title>
|
|
<link rel="stylesheet" href="css/main.css">
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
|
|
<script src="js/main.js" defer></script>
|
|
|
|
</head>
|
|
<body>
|
|
<div class="sidebar">
|
|
<div class="sidebar-logo">
|
|
<img src="images/huntarr-logo.png" alt="Huntarr Logo">
|
|
<h2>Huntarr.io</h2>
|
|
</div>
|
|
|
|
<nav class="sidebar-nav">
|
|
<div class="sidebar-section">
|
|
<h3 class="sidebar-section-title">Getting Started</h3>
|
|
<ul>
|
|
<li><a href="donate.html"><i class="fas fa-heart" style="color: #e91e63; font-size: 18px; width: 24px; height: 24px; margin-right: 8px; display: inline-flex; align-items: center; justify-content: center;"></i> Donate</a></li>
|
|
<li><a href="getting-started/installation.html"><svg class="svg-icon" viewBox="0 0 24 24" fill="currentColor"><path d="M19 9h-4V3H9v6H5l7 7 7-7zM5 18v2h14v-2H5z"></path></svg> Installation</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="sidebar-section">
|
|
<h3 class="sidebar-section-title">Core</h3>
|
|
<ul>
|
|
<li><a href="index.html"><svg class="svg-icon" viewBox="0 0 24 24" fill="currentColor"><path d="M10 20v-6h4v6h5v-8h3L12 3 2 12h3v8z"></path></svg> Home</a></li>
|
|
<li><a href="apps/index.html"><svg class="svg-icon" viewBox="0 0 24 24" fill="currentColor"><path d="M4 8h4V4H4v4zm6 12h4v-4h-4v4zm-6 0h4v-4H4v4zm0-6h4v-4H4v4zm6 0h4v-4h-4v4zm6-10v4h4V4h-4zm-6 4h4V4h-4v4zm6 6h4v-4h-4v4zm0 6h4v-4h-4v4z"></path></svg> Apps</a></li>
|
|
<li><a href="settings/settings.html"><svg class="svg-icon" viewBox="0 0 24 24" fill="currentColor"><path d="M19.14 12.94c.04-.3.06-.61.06-.94 0-.32-.02-.64-.07-.94l2.03-1.58c.18-.14.23-.41.12-.61l-1.92-3.32c-.12-.22-.37-.29-.59-.22l-2.39.96c-.5-.38-1.03-.7-1.62-.94l-.36-2.54c-.04-.24-.24-.41-.48-.41h-3.84c-.24 0-.43.17-.47.41l-.36 2.54c-.59.24-1.13.57-1.62.94l-2.39-.96c-.22-.08-.47 0-.59.22L2.74 8.87c-.12.21-.08.47.12.61l2.03 1.58c-.05.3-.09.63-.09.94s.02.64.07.94l-2.03 1.58c-.18.14-.23.41-.12.61l1.92 3.32c.12.22.37.29.59.22l2.39-.96c.5.38 1.03.7 1.62.94l.36 2.54c.05.24.24.41.48.41h3.84c.24 0 .44-.17.47-.41l.36-2.54c.59-.24 1.13-.56 1.62-.94l2.39.96c.22.08.47 0 .59-.22l1.92-3.32c.12-.22.07-.47-.12-.61l-2.01-1.58zM12 15.6c-1.98 0-3.6-1.62-3.6-3.6s1.62-3.6 3.6-3.6 3.6 1.62 3.6 3.6-1.62 3.6-3.6 3.6z"></path></svg> Settings</a></li>
|
|
<li><a href="features/index.html"><i class="fas fa-star" style="width: 24px; height: 24px; margin-right: 8px; display: inline-flex; align-items: center; justify-content: center;"></i> Features</a></li>
|
|
<li class="active"><a href="faq.html"><i class="fas fa-question-circle" style="width: 24px; height: 24px; margin-right: 8px; display: inline-flex; align-items: center; justify-content: center;"></i> FAQ</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="sidebar-section">
|
|
<h3 class="sidebar-section-title">Resources</h3>
|
|
<ul>
|
|
<li><a href="https://github.com/plexguide/Huntarr.io" target="_blank"><svg class="svg-icon" viewBox="0 0 24 24" fill="currentColor"><path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"></path></svg> GitHub</a></li>
|
|
<li><a href="https://discord.com/invite/PGJJjR5Cww" target="_blank"><i class="fab fa-discord" style="color: #5865F2; font-size: 18px; width: 24px; height: 24px; margin-right: 8px; display: inline-flex; align-items: center; justify-content: center;"></i> Discord</a></li>
|
|
<li><a href="https://www.reddit.com/r/huntarr/" target="_blank"><i class="fab fa-reddit-alien" style="color: #FF4500; font-size: 18px; width: 24px; height: 24px; margin-right: 8px; display: inline-flex; align-items: center; justify-content: center;"></i> Reddit</a></li>
|
|
|
|
</ul>
|
|
</div>
|
|
</nav>
|
|
</div>
|
|
|
|
<div class="main-content">
|
|
<div class="container">
|
|
<h1>Frequently Asked Questions</h1>
|
|
|
|
<section class="faq-overview">
|
|
<p>This FAQ addresses the most common real-world issues that new Huntarr users face. These are based on actual support requests and community discussions.</p>
|
|
|
|
<div class="alert alert-info">
|
|
<strong>💡 Quick Tip:</strong> Most issues are Docker-related or configuration problems. Start with the <strong>Installation & First Setup</strong> section if you're just getting started.
|
|
</div>
|
|
</section>
|
|
|
|
<section id="toc" class="toc">
|
|
<h3>Table of Contents</h3>
|
|
<ul>
|
|
<li><a href="#first-setup">🚀 Installation & First Setup</a></li>
|
|
<li><a href="#common-errors">❌ Common Error Messages</a></li>
|
|
<li><a href="#docker-issues">🐳 Docker Problems</a></li>
|
|
<li><a href="#connection-problems">🔗 Connection Issues</a></li>
|
|
<li><a href="#not-finding-content">🔍 "It's Not Finding Anything"</a></li>
|
|
<li><a href="#performance-issues">⚡ Performance & Speed</a></li>
|
|
<li><a href="#security-locked-out">🔒 Locked Out / Security</a></li>
|
|
</ul>
|
|
</section>
|
|
|
|
<section id="first-setup" class="installation-methods">
|
|
<h2><i class="fas fa-rocket" style="margin-right: 10px; color: #3498db;"></i>Installation & First Setup</h2>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">I'm completely new to Huntarr. What exactly does it do?</div>
|
|
<div class="faq-answer">
|
|
Huntarr automatically searches for missing content in your Sonarr, Radarr, Lidarr, Readarr, and Whisparr applications. Think of it as a "search assistant" that runs constantly to find missing episodes, movies, music, and books.
|
|
|
|
<div class="alert alert-success">
|
|
<strong>What it does:</strong> Finds missing content, upgrades quality, manages download queues
|
|
<br><strong>What it doesn't do:</strong> Replace your *arr apps, download content directly, or manage files
|
|
</div>
|
|
|
|
<strong>Prerequisites:</strong>
|
|
<ul>
|
|
<li>At least one *arr application (Sonarr, Radarr, etc.) already installed and working</li>
|
|
<li>Indexers configured in your *arr apps</li>
|
|
<li>Download client (qBittorrent, Deluge, etc.) configured</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">What's the easiest way to install Huntarr?</div>
|
|
<div class="faq-answer">
|
|
<strong>Docker is strongly recommended</strong> for all platforms. Here's the simplest setup:
|
|
|
|
<pre class="terminal"><code>docker run -d --name huntarr \
|
|
--restart unless-stopped \
|
|
-p 9705:9705 \
|
|
-v /path/to/huntarr/config:/config \
|
|
-e TZ=America/New_York \
|
|
huntarr/huntarr:latest</code></pre>
|
|
|
|
<div class="alert alert-warning">
|
|
<strong>Replace:</strong>
|
|
<ul>
|
|
<li><code>/path/to/huntarr/config</code> with your actual path (e.g., <code>/opt/huntarr</code>)</li>
|
|
<li><code>America/New_York</code> with your timezone</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<strong>After installation:</strong>
|
|
<ol>
|
|
<li>Open <code>http://YOUR_IP:9705</code></li>
|
|
<li>Create admin account</li>
|
|
<li>Add your *arr applications in Settings</li>
|
|
</ol>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">Windows Defender is blocking the installer - is this safe?</div>
|
|
<div class="faq-answer">
|
|
This is normal for open-source software that isn't Microsoft-signed. The installer is safe, but Windows shows warnings.
|
|
|
|
<strong>To install on Windows:</strong>
|
|
<ol>
|
|
<li>When Windows SmartScreen appears, click <strong>"More info"</strong></li>
|
|
<li>Click <strong>"Run anyway"</strong> at the bottom</li>
|
|
<li>Allow through Windows Firewall when prompted</li>
|
|
</ol>
|
|
|
|
<div class="alert alert-info">
|
|
<strong>Alternative:</strong> Use Docker Desktop on Windows to avoid these security warnings entirely.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">Can't access Huntarr at http://localhost:9705</div>
|
|
<div class="faq-answer">
|
|
Common causes and solutions:
|
|
|
|
<ul>
|
|
<li><strong>Wrong IP:</strong> Try <code>http://YOUR_SERVER_IP:9705</code> instead of localhost</li>
|
|
<li><strong>Port conflict:</strong> Another app is using port 9705</li>
|
|
<li><strong>Firewall:</strong> Port 9705 is blocked</li>
|
|
<li><strong>Container not running:</strong> Check with <code>docker ps | grep huntarr</code></li>
|
|
</ul>
|
|
|
|
<strong>Quick troubleshooting:</strong>
|
|
<pre class="terminal"><code># Check if Huntarr is running
|
|
docker ps | grep huntarr
|
|
|
|
# Check the logs
|
|
docker logs huntarr
|
|
|
|
# Restart if needed
|
|
docker restart huntarr</code></pre>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section id="common-errors" class="installation-methods">
|
|
<h2><i class="fas fa-exclamation-triangle" style="margin-right: 10px; color: #e74c3c;"></i>Common Error Messages</h2>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">"Failed to connect to API" or "Connection timeout"</div>
|
|
<div class="faq-answer">
|
|
This means Huntarr can't reach your *arr applications.
|
|
|
|
<strong>Check these in order:</strong>
|
|
<ol>
|
|
<li><strong>URL format:</strong> Use <code>http://IP:PORT</code> (e.g., <code>http://192.168.1.10:8989</code>)</li>
|
|
<li><strong>Remove trailing slash:</strong> Don't use <code>http://IP:PORT/</code></li>
|
|
<li><strong>Test manually:</strong> Can you access the *arr app in your browser?</li>
|
|
<li><strong>Network access:</strong> Can Huntarr's container reach your *arr apps?</li>
|
|
</ol>
|
|
|
|
<div class="alert alert-warning">
|
|
<strong>Docker networking tip:</strong> If both Huntarr and your *arr apps are in Docker, they need to be on the same network or use host networking.
|
|
</div>
|
|
|
|
<strong>Quick test:</strong>
|
|
<pre class="terminal"><code># Test from inside Huntarr container
|
|
docker exec -it huntarr wget -qO- http://YOUR_ARR_IP:PORT/api/v3/system/status</code></pre>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">"Invalid API key" or "401 Unauthorized"</div>
|
|
<div class="faq-answer">
|
|
Your API key is wrong or missing.
|
|
|
|
<strong>To get the correct API key:</strong>
|
|
<ol>
|
|
<li>Open your *arr application (Sonarr, Radarr, etc.)</li>
|
|
<li>Go to <strong>Settings → General</strong></li>
|
|
<li>Look for <strong>"API Key"</strong> section</li>
|
|
<li>Copy the entire key (usually 32 characters)</li>
|
|
<li>Paste it exactly into Huntarr settings</li>
|
|
</ol>
|
|
|
|
<div class="alert alert-info">
|
|
<strong>Note:</strong> Each *arr application has its own unique API key. Don't use the same key for different apps.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">"Permission denied" or file/folder errors</div>
|
|
<div class="faq-answer">
|
|
This is usually a Docker volume permission issue.
|
|
|
|
<strong>Fix permissions:</strong>
|
|
<pre class="terminal"><code># Stop Huntarr
|
|
docker stop huntarr
|
|
|
|
# Fix ownership (replace with your actual path)
|
|
sudo chown -R 1000:1000 /path/to/huntarr/config
|
|
|
|
# Start Huntarr
|
|
docker start huntarr</code></pre>
|
|
|
|
<div class="alert alert-warning">
|
|
<strong>Prevention:</strong> Create the config directory and set permissions before running Huntarr for the first time.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">"No items found" or "Nothing to process"</div>
|
|
<div class="faq-answer">
|
|
This usually means your content is not marked as "Monitored" in your *arr apps.
|
|
|
|
<strong>Check this:</strong>
|
|
<ol>
|
|
<li>Open your *arr application</li>
|
|
<li>Look at your movies/shows/music</li>
|
|
<li>Ensure items are marked as <strong>"Monitored"</strong> (usually a toggle or checkbox)</li>
|
|
<li>Check that you have <strong>missing</strong> content (red icons in *arr apps)</li>
|
|
</ol>
|
|
|
|
<div class="alert alert-info">
|
|
<strong>In Huntarr settings:</strong> Make sure "Monitored Only" is enabled if you only want to search for monitored content.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section id="docker-issues" class="installation-methods">
|
|
<h2><i class="fab fa-docker" style="margin-right: 10px; color: #2496ed;"></i>Docker Problems</h2>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">Huntarr container keeps restarting or crashing</div>
|
|
<div class="faq-answer">
|
|
<strong>Check the logs first:</strong>
|
|
<pre class="terminal"><code>docker logs huntarr</code></pre>
|
|
|
|
<strong>Common causes:</strong>
|
|
<ul>
|
|
<li><strong>Permission issues:</strong> Config directory not writable</li>
|
|
<li><strong>Port conflict:</strong> Port 9705 already in use</li>
|
|
<li><strong>Memory limits:</strong> Not enough RAM allocated</li>
|
|
<li><strong>Corrupted config:</strong> Bad configuration files</li>
|
|
</ul>
|
|
|
|
<strong>Reset if needed:</strong>
|
|
<pre class="terminal"><code># Stop and remove container
|
|
docker stop huntarr && docker rm huntarr
|
|
|
|
# Clear config (backup first!)
|
|
rm -rf /path/to/huntarr/config/*
|
|
|
|
# Recreate container
|
|
docker run -d --name huntarr ...</code></pre>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">Can't reach *arr apps from Huntarr container</div>
|
|
<div class="faq-answer">
|
|
This is a Docker networking issue.
|
|
|
|
<strong>Solution 1 - Use host networking:</strong>
|
|
<pre class="terminal"><code>docker run -d --name huntarr \
|
|
--network host \
|
|
--restart unless-stopped \
|
|
-v /path/to/huntarr/config:/config \
|
|
huntarr/huntarr:latest</code></pre>
|
|
|
|
<strong>Solution 2 - Use Docker bridge with correct IPs:</strong>
|
|
<ul>
|
|
<li>Find your host's Docker IP: <code>ip route show default</code></li>
|
|
<li>Use that IP in Huntarr settings instead of localhost</li>
|
|
<li>Example: <code>http://172.17.0.1:8989</code> instead of <code>http://localhost:8989</code></li>
|
|
</ul>
|
|
|
|
<div class="alert alert-success">
|
|
<strong>Tip:</strong> Host networking is usually the easiest for beginners.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">Docker-compose setup</div>
|
|
<div class="faq-answer">
|
|
Here's a complete docker-compose.yml example:
|
|
|
|
<pre class="terminal"><code>version: '3.8'
|
|
services:
|
|
huntarr:
|
|
image: huntarr/huntarr:latest
|
|
container_name: huntarr
|
|
restart: unless-stopped
|
|
ports:
|
|
- "9705:9705"
|
|
volumes:
|
|
- ./huntarr-config:/config
|
|
environment:
|
|
- TZ=America/New_York
|
|
- PUID=1000
|
|
- PGID=1000</code></pre>
|
|
|
|
<strong>Run with:</strong>
|
|
<pre class="terminal"><code>docker-compose up -d</code></pre>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section id="connection-problems" class="installation-methods">
|
|
<h2><i class="fas fa-plug" style="margin-right: 10px; color: #f39c12;"></i>Connection Issues</h2>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">Settings won't save or keep resetting</div>
|
|
<div class="faq-answer">
|
|
This indicates a file permission problem.
|
|
|
|
<strong>Fix it:</strong>
|
|
<ol>
|
|
<li>Stop Huntarr: <code>docker stop huntarr</code></li>
|
|
<li>Check directory ownership: <code>ls -la /path/to/huntarr/</code></li>
|
|
<li>Fix permissions: <code>sudo chown -R 1000:1000 /path/to/huntarr/</code></li>
|
|
<li>Start Huntarr: <code>docker start huntarr</code></li>
|
|
</ol>
|
|
|
|
<div class="alert alert-warning">
|
|
<strong>Make sure:</strong> The config directory exists and is writable before starting Huntarr.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">Web interface loads but settings pages are blank</div>
|
|
<div class="faq-answer">
|
|
Usually a browser caching issue or JavaScript error.
|
|
|
|
<strong>Try these in order:</strong>
|
|
<ol>
|
|
<li><strong>Hard refresh:</strong> Ctrl+F5 (Windows) or Cmd+Shift+R (Mac)</li>
|
|
<li><strong>Clear browser cache</strong> for the Huntarr site</li>
|
|
<li><strong>Try incognito/private mode</strong></li>
|
|
<li><strong>Try a different browser</strong></li>
|
|
<li><strong>Check browser console</strong> for JavaScript errors (F12)</li>
|
|
</ol>
|
|
|
|
<div class="alert alert-info">
|
|
<strong>Common cause:</strong> Browser extensions or ad blockers interfering with the interface.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section id="not-finding-content" class="installation-methods">
|
|
<h2><i class="fas fa-search" style="margin-right: 10px; color: #2ecc71;"></i>"It's Not Finding Anything"</h2>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">Huntarr says it's running but not finding missing content</div>
|
|
<div class="faq-answer">
|
|
<strong>Checklist to verify:</strong>
|
|
|
|
<ol>
|
|
<li><strong>Content is monitored:</strong> Check your *arr apps - items must be marked "Monitored"</li>
|
|
<li><strong>Content is actually missing:</strong> Look for red indicators in your *arr apps</li>
|
|
<li><strong>Indexers are working:</strong> Test manual search in your *arr apps</li>
|
|
<li><strong>Download queue isn't full:</strong> Check your download client</li>
|
|
<li><strong>Huntarr settings:</strong> Verify hunt missing/upgrade limits aren't 0</li>
|
|
</ol>
|
|
|
|
<div class="alert alert-success">
|
|
<strong>Easy test:</strong> In your *arr app, manually search for a missing episode/movie. If that doesn't find anything, the problem isn't with Huntarr.
|
|
</div>
|
|
|
|
<strong>Check Huntarr's processing:</strong>
|
|
Look at the dashboard counters - they should increase over time if content is being processed.
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">Why are the search counters not increasing?</div>
|
|
<div class="faq-answer">
|
|
<strong>Most common reasons:</strong>
|
|
|
|
<ul>
|
|
<li><strong>No missing content:</strong> Everything is already downloaded</li>
|
|
<li><strong>Content not monitored:</strong> Items aren't marked as monitored in *arr apps</li>
|
|
<li><strong>Future releases:</strong> "Skip Future Episodes/Movies" is enabled and content isn't released yet</li>
|
|
<li><strong>Download queue full:</strong> Queue size exceeds your minimum threshold</li>
|
|
<li><strong>API limits reached:</strong> Hourly API cap is hit</li>
|
|
</ul>
|
|
|
|
<strong>Quick check:</strong>
|
|
<ol>
|
|
<li>Go to your Sonarr/Radarr wanted pages</li>
|
|
<li>Verify there are missing items shown</li>
|
|
<li>Check if they're marked as "Monitored"</li>
|
|
</ol>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">Searches are slow or timing out</div>
|
|
<div class="faq-answer">
|
|
<strong>Optimize your settings:</strong>
|
|
|
|
<ul>
|
|
<li><strong>Increase sleep duration:</strong> Use 15+ minutes between cycles</li>
|
|
<li><strong>Reduce batch sizes:</strong> Lower "Hunt Missing" and "Hunt Upgrades" numbers</li>
|
|
<li><strong>Set API limits:</strong> Use reasonable hourly caps (20-50 per app)</li>
|
|
<li><strong>Check indexers:</strong> Slow indexers can cause timeouts</li>
|
|
</ul>
|
|
|
|
<div class="alert alert-warning">
|
|
<strong>Remember:</strong> Huntarr is designed to run continuously. It doesn't need to be aggressive - slow and steady is better for indexer health.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section id="performance-issues" class="installation-methods">
|
|
<h2><i class="fas fa-tachometer-alt" style="margin-right: 10px; color: #9b59b6;"></i>Performance & Speed</h2>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">Huntarr is using too much CPU/memory</div>
|
|
<div class="faq-answer">
|
|
<strong>Reduce resource usage:</strong>
|
|
|
|
<ul>
|
|
<li><strong>Increase sleep duration:</strong> 20-30 minutes between cycles</li>
|
|
<li><strong>Lower batch sizes:</strong> Process fewer items per cycle</li>
|
|
<li><strong>Set stricter API limits:</strong> Prevent overloading</li>
|
|
<li><strong>Enable "Skip Future Items":</strong> Avoid unnecessary processing</li>
|
|
</ul>
|
|
|
|
<div class="alert alert-info">
|
|
<strong>Normal behavior:</strong> CPU usage spikes during processing cycles, then returns to low levels during sleep periods.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">Getting rate-limited by indexers</div>
|
|
<div class="faq-answer">
|
|
<strong>Protect your indexers:</strong>
|
|
|
|
<ol>
|
|
<li><strong>Set hourly API caps:</strong> 20-50 requests per hour per app</li>
|
|
<li><strong>Increase sleep duration:</strong> 20+ minutes between cycles</li>
|
|
<li><strong>Lower batch sizes:</strong> 5-10 missing items, 2-5 upgrades per cycle</li>
|
|
<li><strong>Enable monitored-only:</strong> Don't search for unmonitored content</li>
|
|
</ol>
|
|
|
|
<div class="alert alert-warning">
|
|
<strong>Important:</strong> Rate limits protect both you and the indexer community. Don't try to bypass them.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section id="security-locked-out" class="installation-methods">
|
|
<h2><i class="fas fa-lock" style="margin-right: 10px; color: #e74c3c;"></i>Locked Out / Security</h2>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">Forgot my Huntarr password</div>
|
|
<div class="faq-answer">
|
|
<strong>Reset authentication:</strong>
|
|
|
|
<pre class="terminal"><code># Stop Huntarr
|
|
docker stop huntarr
|
|
|
|
# Remove credentials file
|
|
# Credentials are now stored in the database at /config/huntarr.db (Docker) or /path/to/huntarr/data/huntarr.db (local)
|
|
# To reset credentials, delete the database file or use the web interface
|
|
|
|
# Start Huntarr
|
|
docker start huntarr</code></pre>
|
|
|
|
Now you can access the web interface and create a new admin account.
|
|
|
|
<div class="alert alert-warning">
|
|
<strong>Note:</strong> This also resets any two-factor authentication settings.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">2FA is not working or lost my device</div>
|
|
<div class="faq-answer">
|
|
Same solution as password reset - remove the credentials file:
|
|
|
|
<pre class="terminal"><code># Credentials are now stored in the database at /config/huntarr.db (Docker) or /path/to/huntarr/data/huntarr.db (local)
|
|
# To reset credentials, delete the database file or use the web interface</code></pre>
|
|
|
|
This will reset both password and 2FA settings.
|
|
</div>
|
|
</div>
|
|
|
|
<div class="faq-item">
|
|
<div class="faq-question">Should I expose Huntarr to the internet?</div>
|
|
<div class="faq-answer">
|
|
<strong>Generally not recommended</strong> unless you need remote access.
|
|
|
|
<strong>If you must expose it:</strong>
|
|
<ul>
|
|
<li>Enable strong authentication</li>
|
|
<li>Use 2FA</li>
|
|
<li>Use a reverse proxy with SSL</li>
|
|
<li>Consider VPN access instead</li>
|
|
</ul>
|
|
|
|
<div class="alert alert-info">
|
|
<strong>Best practice:</strong> Keep Huntarr on your local network and use VPN for remote access.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section class="installation-methods">
|
|
<h2><i class="fas fa-question" style="margin-right: 10px; color: #3498db;"></i>Still Need Help?</h2>
|
|
|
|
<div class="alert alert-info">
|
|
<strong>Before asking for help, please:</strong>
|
|
<ol>
|
|
<li>Check that your *arr apps work correctly on their own</li>
|
|
<li>Verify you can manually search for content in your *arr apps</li>
|
|
<li>Note the exact error messages you're seeing</li>
|
|
<li>Check the Docker logs: <code>docker logs huntarr</code></li>
|
|
</ol>
|
|
</div>
|
|
|
|
<div class="app-cards-grid">
|
|
<div class="app-card">
|
|
<div class="app-card-header">
|
|
<div class="app-card-icon" style="background-color: #5865F2;">
|
|
<i class="fab fa-discord" style="font-size: 24px;"></i>
|
|
</div>
|
|
<h3 class="app-card-title">Discord Community</h3>
|
|
</div>
|
|
<div class="app-card-content">
|
|
<p>Get real-time help from the community and developers.</p>
|
|
</div>
|
|
<div class="app-card-footer">
|
|
<a href="https://discord.com/invite/PGJJjR5Cww" target="_blank">Join Discord →</a>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="app-card">
|
|
<div class="app-card-header">
|
|
<div class="app-card-icon" style="background-color: #333;">
|
|
<i class="fab fa-github" style="font-size: 24px;"></i>
|
|
</div>
|
|
<h3 class="app-card-title">GitHub Issues</h3>
|
|
</div>
|
|
<div class="app-card-content">
|
|
<p>Report bugs or request features on GitHub.</p>
|
|
</div>
|
|
<div class="app-card-footer">
|
|
<a href="https://github.com/plexguide/Huntarr.io/issues" target="_blank">Open Issue →</a>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="app-card">
|
|
<div class="app-card-header">
|
|
<div class="app-card-icon" style="background-color: #FF4500;">
|
|
<i class="fab fa-reddit-alien" style="font-size: 24px;"></i>
|
|
</div>
|
|
<h3 class="app-card-title">Reddit Community</h3>
|
|
</div>
|
|
<div class="app-card-content">
|
|
<p>Discuss with other users and share experiences.</p>
|
|
</div>
|
|
<div class="app-card-footer">
|
|
<a href="https://www.reddit.com/r/huntarr/" target="_blank">Visit Subreddit →</a>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<footer>
|
|
Huntarr.io | FAQ | Updated for real-world usage - Admin9705
|
|
</footer>
|
|
</div>
|
|
</div>
|
|
|
|
<a href="#toc" class="back-to-top" id="back-to-top" title="Back to Top">
|
|
<svg width="24" height="24" viewBox="0 0 24 24" fill="currentColor">
|
|
<path d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path>
|
|
</svg>
|
|
</a>
|
|
|
|
<script>
|
|
// Show/hide back-to-top button based on scroll position
|
|
window.addEventListener('scroll', function() {
|
|
var backToTopButton = document.getElementById('back-to-top');
|
|
if (window.pageYOffset > 300) {
|
|
backToTopButton.classList.add('visible');
|
|
} else {
|
|
backToTopButton.classList.remove('visible');
|
|
}
|
|
});
|
|
|
|
// Smooth scroll to the target when clicking on table of contents links
|
|
document.querySelectorAll('.toc a').forEach(function(anchor) {
|
|
anchor.addEventListener('click', function(e) {
|
|
e.preventDefault();
|
|
var targetId = this.getAttribute('href');
|
|
var targetElement = document.querySelector(targetId);
|
|
window.scrollTo({
|
|
top: targetElement.offsetTop - 20,
|
|
behavior: 'smooth'
|
|
});
|
|
});
|
|
});
|
|
|
|
// Smooth scroll for anchor links
|
|
document.querySelectorAll('a[href^="#"]').forEach(anchor => {
|
|
anchor.addEventListener('click', function (e) {
|
|
e.preventDefault();
|
|
const target = document.querySelector(this.getAttribute('href'));
|
|
if (target) {
|
|
target.scrollIntoView({
|
|
behavior: 'smooth',
|
|
block: 'start'
|
|
});
|
|
}
|
|
});
|
|
});
|
|
</script>
|
|
</body>
|
|
</html> |