mirror of
https://github.com/plexguide/Huntarr.io.git
synced 2025-12-30 02:30:01 -06:00
386 lines
31 KiB
HTML
386 lines
31 KiB
HTML
<html lang="en">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<title>System Settings - 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="../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 class="active"><a href="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><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>
|
||
<li><a href="https://plexguide.github.io/Huntarr.io/donate.html" target="_blank"><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>
|
||
</ul>
|
||
</div>
|
||
</nav>
|
||
</div>
|
||
|
||
<div class="main-content">
|
||
<div class="container">
|
||
<h1>System Settings</h1>
|
||
|
||
<p>This page contains all settings for customizing your Huntarr.io instance with detailed explanations to help you optimize your setup.</p>
|
||
|
||
<div id="toc" class="toc">
|
||
<h3>Table of Contents</h3>
|
||
<ul>
|
||
<li><a href="#system-settings">System Settings</a>
|
||
<ul>
|
||
<li><a href="#check-for-updates">Check for Updates</a></li>
|
||
<li><a href="#debug-mode">Debug Mode</a></li>
|
||
<li><a href="#display-resources">Display Resources</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a href="#notifications">Notifications</a>
|
||
<ul>
|
||
<li><a href="#enable-notifications">Enable Notifications</a></li>
|
||
<li><a href="#notification-level">Notification Level</a></li>
|
||
<li><a href="#apprise-urls">Apprise URLs</a></li>
|
||
<li><a href="#notify-on-missing">Notify on Missing</a></li>
|
||
<li><a href="#notify-on-upgrade">Notify on Upgrade</a></li>
|
||
<li><a href="#include-instance">Include Instance</a></li>
|
||
<li><a href="#include-app-name">Include App Name</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a href="#stateful-management">Stateful Management</a>
|
||
<ul>
|
||
<li><a href="#emergency-reset">Emergency Reset</a></li>
|
||
<li><a href="#state-reset-hours">State Reset (Hours)</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a href="#security">Security</a>
|
||
<ul>
|
||
<li><a href="#authentication-mode">Authentication Mode</a></li>
|
||
<li><a href="#enable-ssl-verify">Enable SSL Verify</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a href="#advanced-settings">Advanced Settings</a>
|
||
<ul>
|
||
<li><a href="#api-timeout">API Timeout</a></li>
|
||
<li><a href="#command-wait-delay">Command Wait Delay</a></li>
|
||
<li><a href="#cmd-wait-attempts">CMD Wait Attempts</a></li>
|
||
<li><a href="#max-dl-queue-size">Max DL Queue Size</a></li>
|
||
<li><a href="#log-refresh-interval">Log Refresh Interval</a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</div>
|
||
|
||
<section id="system-settings">
|
||
<h2>System Settings</h2>
|
||
<p>These settings control basic functionality and appearance of your Huntarr.io instance.</p>
|
||
|
||
<h3 id="check-for-updates"><a href="#check-for-updates" class="info-icon"><i class="fas fa-info-circle"></i></a> Check for Updates</h3>
|
||
<p>When enabled, Huntarr will automatically check for new versions and notify you when updates are available.</p>
|
||
|
||
<p>We recommend keeping this enabled to ensure you're running the latest version with bug fixes and new features. Updates are not installed automatically; you'll just be notified when they're available.</p>
|
||
|
||
<p>Disabling this option means you'll need to manually check for updates, which could lead to missing important security fixes or helpful new features. Most users should leave this enabled unless running Huntarr in an air-gapped environment.</p>
|
||
|
||
<h3 id="debug-mode"><a href="#debug-mode" class="info-icon"><i class="fas fa-info-circle"></i></a> Debug Mode</h3>
|
||
<p>Enables verbose logging for troubleshooting issues. This setting applies to all apps connected to Huntarr.</p>
|
||
|
||
<p>Only enable this when you're experiencing issues and need to troubleshoot or when requested by support. Debug mode generates more detailed logs that can help identify problems, but it can also increase disk usage and slightly reduce performance.</p>
|
||
|
||
<p>When troubleshooting, enable this setting, reproduce the issue you're experiencing, then check the logs for detailed information. After resolving the issue, remember to disable debug mode to restore optimal performance.</p>
|
||
|
||
<h3 id="display-resources"><a href="#display-resources" class="info-icon"><i class="fas fa-info-circle"></i></a> Display Resources</h3>
|
||
<p>Controls whether the Resources section is shown on the home page.</p>
|
||
|
||
<p>The Resources section displays helpful links like documentation, GitHub repository, and community forums. You may want to hide this once you're familiar with Huntarr to optimize screen space.</p>
|
||
|
||
<p>New users should keep this enabled as it provides quick access to documentation and support resources. More experienced users might prefer to hide this section to focus on the core functionality of Huntarr.</p>
|
||
</section>
|
||
|
||
<section id="notifications">
|
||
<h2>Notifications</h2>
|
||
<p>Configure how Huntarr sends notifications about media processing events. Huntarr uses the powerful <a href="https://github.com/caronc/apprise" target="_blank">Apprise library</a> to support notifications to virtually any service including Discord, Telegram, Slack, email, webhooks, and dozens more.</p>
|
||
|
||
<h3 id="enable-notifications"><a href="#enable-notifications" class="info-icon"><i class="fas fa-info-circle"></i></a> Enable Notifications</h3>
|
||
<p>Master toggle to enable or disable all notifications from Huntarr.</p>
|
||
|
||
<p>When enabled, Huntarr will send notifications based on your configured settings and Apprise URLs. When disabled, no notifications will be sent regardless of other settings.</p>
|
||
|
||
<p>This is useful for temporarily silencing notifications during maintenance or testing without having to remove your Apprise URL configurations.</p>
|
||
|
||
<h3 id="notification-level"><a href="#notification-level" class="info-icon"><i class="fas fa-info-circle"></i></a> Notification Level</h3>
|
||
<p>Sets the minimum severity level for events that will trigger notifications.</p>
|
||
|
||
<ul>
|
||
<li><strong>Info:</strong> All events including successful downloads, upgrades, and general status updates</li>
|
||
<li><strong>Success:</strong> Only successful operations like completed downloads and upgrades</li>
|
||
<li><strong>Warning:</strong> Warning-level events and above (includes errors)</li>
|
||
<li><strong>Error:</strong> Only critical errors and failures</li>
|
||
</ul>
|
||
|
||
<p>Most users should use "Info" to get comprehensive notifications about Huntarr's activities. Use "Error" if you only want to be notified about problems.</p>
|
||
|
||
<h3 id="apprise-urls"><a href="#apprise-urls" class="info-icon"><i class="fas fa-info-circle"></i></a> Apprise URLs</h3>
|
||
<p>Configure one or more notification destinations using Apprise URL format. Enter one URL per line.</p>
|
||
|
||
<p>Apprise supports an extensive list of notification services. Here are some popular examples:</p>
|
||
|
||
<ul>
|
||
<li><strong>Discord:</strong> <code>discord://webhook_id/webhook_token</code></li>
|
||
<li><strong>Telegram:</strong> <code>tgram://bottoken/ChatID</code></li>
|
||
<li><strong>Slack:</strong> <code>slack://TokenA/TokenB/TokenC/Channel</code></li>
|
||
<li><strong>Email (SMTP):</strong> <code>mailto://user:pass@host:port/recipient</code></li>
|
||
<li><strong>Pushover:</strong> <code>pover://user@token</code></li>
|
||
<li><strong>Webhooks:</strong> <code>json://hostname/path</code></li>
|
||
</ul>
|
||
|
||
<p>For complete documentation of supported services and their URL formats, visit the <a href="https://github.com/caronc/apprise#supported-notifications" target="_blank">official Apprise documentation</a>.</p>
|
||
|
||
<p>You can configure multiple notification destinations by adding multiple URLs, one per line. Huntarr will send notifications to all configured services.</p>
|
||
|
||
<h3 id="notify-on-missing"><a href="#notify-on-missing" class="info-icon"><i class="fas fa-info-circle"></i></a> Notify on Missing</h3>
|
||
<p>Send notifications when Huntarr processes missing media and requests downloads from your *arr apps.</p>
|
||
|
||
<p>When enabled, you'll receive notifications like:</p>
|
||
<ul>
|
||
<li>"Found 5 missing episodes for Breaking Bad Season 2"</li>
|
||
<li>"Requested download for The Dark Knight (2008) from Radarr"</li>
|
||
</ul>
|
||
|
||
<p>This helps you stay informed about what content Huntarr is actively working to acquire for your media library.</p>
|
||
|
||
<h3 id="notify-on-upgrade"><a href="#notify-on-upgrade" class="info-icon"><i class="fas fa-info-circle"></i></a> Notify on Upgrade</h3>
|
||
<p>Send notifications when Huntarr processes media upgrades and requests better quality versions from your *arr apps.</p>
|
||
|
||
<p>When enabled, you'll receive notifications like:</p>
|
||
<ul>
|
||
<li>"Found upgrade opportunity for The Matrix (1999) - 1080p → 4K UHD"</li>
|
||
<li>"Requested quality upgrade for Game of Thrones S01E01 from Sonarr"</li>
|
||
</ul>
|
||
|
||
<p>This keeps you informed when Huntarr finds opportunities to improve the quality of your existing media collection.</p>
|
||
|
||
<h3 id="include-instance"><a href="#include-instance" class="info-icon"><i class="fas fa-info-circle"></i></a> Include Instance</h3>
|
||
<p>Include the configured instance name in notification messages when you have multiple instances of the same app type.</p>
|
||
|
||
<p>When enabled, notifications will include the instance name you configured, such as:</p>
|
||
<ul>
|
||
<li>"[Movies-4K] Found missing media..." (instead of just "[Radarr] Found missing media...")</li>
|
||
<li>"[TV-Anime] Requested upgrade..." (instead of just "[Sonarr] Requested upgrade...")</li>
|
||
</ul>
|
||
|
||
<p>This is especially useful when running multiple Sonarr or Radarr instances (e.g., separate instances for 4K content, anime, or different quality profiles).</p>
|
||
|
||
<h3 id="include-app-name"><a href="#include-app-name" class="info-icon"><i class="fas fa-info-circle"></i></a> Include App Name</h3>
|
||
<p>Include the application name (Sonarr, Radarr, etc.) in notification messages.</p>
|
||
|
||
<p>When enabled, notifications will include the source app name, such as:</p>
|
||
<ul>
|
||
<li>"[Sonarr] Found 3 missing episodes..."</li>
|
||
<li>"[Radarr] Requested download for..."</li>
|
||
</ul>
|
||
|
||
<p>When disabled, notifications will be more generic:</p>
|
||
<ul>
|
||
<li>"Found 3 missing episodes..."</li>
|
||
<li>"Requested download for..."</li>
|
||
</ul>
|
||
|
||
<p>Most users should keep this enabled for clarity about which app triggered each notification.</p>
|
||
</section>
|
||
|
||
<section id="stateful-management">
|
||
<h2>Stateful Management</h2>
|
||
<p>These settings control how Huntarr manages the state of processed media. Understanding these settings is crucial for proper operation of Huntarr's media processing capabilities.</p>
|
||
|
||
<h3 id="emergency-reset"><a href="#emergency-reset" class="info-icon"><i class="fas fa-info-circle"></i></a> 🔥 EMERGENCY RESET 🔥</h3>
|
||
<p>This button immediately resets all processed media state information.</p>
|
||
|
||
<p>Use this only in emergency situations where you need to force Huntarr to reprocess all media. This will clear all records of what media has been processed, allowing Huntarr to start fresh. This does not delete your media files or configuration settings.</p>
|
||
|
||
<p><strong>Warning:</strong> After reset, Huntarr may reprocess media that was already processed before, potentially causing duplicate downloads.</p>
|
||
|
||
<p>Situations where an emergency reset might be necessary include:</p>
|
||
<ul>
|
||
<li>After changing your media organization strategy and wanting Huntarr to reevaluate all content</li>
|
||
<li>When you suspect that Huntarr's processing data has become corrupted</li>
|
||
<li>After a significant configuration change when you want Huntarr to start fresh</li>
|
||
</ul>
|
||
|
||
<p><strong>Initial State Created:</strong> Sun, May 18, 2025, 02:45 PM (today)<br>
|
||
<strong>State Reset Date:</strong> Sun, May 25, 2025, 02:45 PM (in 7 days)</p>
|
||
|
||
<h3 id="state-reset-hours"><a href="#state-reset-hours" class="info-icon"><i class="fas fa-info-circle"></i></a> State Reset (Hours)</h3>
|
||
<p>Determines how many hours before automatically resetting processed media state information (default: 168 hours, or 7 days).</p>
|
||
|
||
<p>This setting controls how long Huntarr remembers which media files it has already processed. After this time, Huntarr will "forget" what it has processed, allowing reprocessing of media.</p>
|
||
|
||
<p>Increasing this value means Huntarr will remember processed media for longer, reducing the chance of duplicate processing. Decreasing it allows more frequent reprocessing of media, which might be useful if you often make changes to your media library or configuration.</p>
|
||
|
||
<p>Common settings values and their effects:</p>
|
||
<ul>
|
||
<li><strong>168 hours (7 days):</strong> Default setting, suitable for most users</li>
|
||
<li><strong>720 hours (30 days):</strong> Good for stable setups where you rarely add new content</li>
|
||
<li><strong>72 hours (3 days):</strong> For more active libraries with frequent changes</li>
|
||
<li><strong>24 hours (1 day):</strong> For very dynamic environments or testing setups</li>
|
||
</ul>
|
||
|
||
<p>Reset clears all processed media IDs to allow reprocessing. This is especially useful when you've made changes to your naming conventions or organization structure and want Huntarr to reprocess content according to the new rules.</p>
|
||
</section>
|
||
|
||
<section id="security">
|
||
<h2>Security</h2>
|
||
<p>These settings control access security and encryption options to protect your Huntarr installation.</p>
|
||
|
||
<h3 id="authentication-mode"><a href="#authentication-mode" class="info-icon"><i class="fas fa-info-circle"></i></a> Authentication Mode</h3>
|
||
<p>Controls how users authenticate with Huntarr. There are three options available:</p>
|
||
|
||
<h4>Login Mode</h4>
|
||
<p>Standard login required for all connections. This is the most secure option and is recommended if your Huntarr instance is accessible from the internet. With this mode, anyone accessing Huntarr will need to provide valid credentials.</p>
|
||
|
||
<h4>Local Bypass Mode</h4>
|
||
<p>Only local network connections (192.168.x.x, 10.x.x.x) bypass login. This is convenient for home networks as it doesn't require login when accessing from your local network, but still requires login when accessing remotely.</p>
|
||
|
||
<p>This mode offers a good balance between security and convenience for typical home setups. You won't need to log in when accessing Huntarr from devices on your home network, but external access will still require authentication.</p>
|
||
|
||
<h4>No Login Mode</h4>
|
||
<p>Completely disable authentication when running behind your own reverse proxy. Only use this if your instance is behind a secure reverse proxy (like Nginx or Cloudflare) that handles authentication for you.</p>
|
||
|
||
<p><strong>Warning:</strong> Using "No Login Mode" without proper security could allow unauthorized access to your media and system! Only use this mode if you have implemented alternative security measures.</p>
|
||
|
||
<h3 id="enable-ssl-verify"><a href="#enable-ssl-verify" class="info-icon"><i class="fas fa-info-circle"></i></a> Enable SSL Verify</h3>
|
||
<p>Controls whether Huntarr verifies SSL certificates when connecting to other services.</p>
|
||
|
||
<p>Normally, this should be enabled for security. It ensures Huntarr only connects to services with valid SSL certificates, protecting against man-in-the-middle attacks and unauthorized access.</p>
|
||
|
||
<p>You might need to disable this if you're using self-signed certificates on your private network. For example, if you have self-signed certificates for Sonarr, Radarr, or other services, Huntarr might not be able to connect to them unless this is disabled.</p>
|
||
|
||
<p><strong>Note:</strong> Only disable this on private, trusted networks. Disabling SSL verification on public networks or internet-facing installations could expose your system to security risks.</p>
|
||
|
||
<p>If you're experiencing connection issues with other services that use SSL, and you're using self-signed certificates or a private certificate authority, you may need to disable this option. However, a better approach would be to properly configure your certificates to be trusted by your system.</p>
|
||
</section>
|
||
|
||
<section id="advanced-settings">
|
||
<h2>Advanced Settings</h2>
|
||
<p>These settings are for advanced users who need to fine-tune Huntarr's performance and behavior. Adjust these settings only if you understand their impact on the system.</p>
|
||
|
||
<h3 id="api-timeout"><a href="#api-timeout" class="info-icon"><i class="fas fa-info-circle"></i></a> API Timeout</h3>
|
||
<p>The number of seconds Huntarr will wait for API responses before timing out (default: 120 seconds).</p>
|
||
|
||
<p>If you notice Huntarr frequently reporting timeouts when connecting to Sonarr, Radarr, or other services, you might need to increase this value. This is especially useful on slower networks or when services are under heavy load.</p>
|
||
|
||
<p>However, setting this too high could cause Huntarr to appear unresponsive if a service is down, as it will wait longer before giving up on connections.</p>
|
||
|
||
<p>This setting is particularly important if:</p>
|
||
<ul>
|
||
<li>You have services running on slower hardware like a Raspberry Pi</li>
|
||
<li>Your services are handling large libraries or running intensive tasks</li>
|
||
<li>Your network has higher latency or occasional connectivity issues</li>
|
||
</ul>
|
||
|
||
<h3 id="command-wait-delay"><a href="#command-wait-delay" class="info-icon"><i class="fas fa-info-circle"></i></a> Command Wait Delay</h3>
|
||
<p>The delay in seconds between command status checks (default: 1 second).</p>
|
||
|
||
<p>This setting controls how frequently Huntarr checks if a command sent to another service (like Sonarr or Radarr) has completed. Lower values make Huntarr more responsive but might increase network traffic. Higher values reduce network traffic but might make Huntarr seem less responsive.</p>
|
||
|
||
<p>The default of 1 second works well for most users and shouldn't need changing. In high-performance environments with many services, increasing this value slightly (to 2-3 seconds) might reduce unnecessary network traffic without significantly impacting responsiveness.</p>
|
||
|
||
<h3 id="cmd-wait-attempts"><a href="#cmd-wait-attempts" class="info-icon"><i class="fas fa-info-circle"></i></a> CMD Wait Attempts</h3>
|
||
<p>The maximum number of attempts to check command status (default: 600).</p>
|
||
|
||
<p>This setting, combined with Command Wait Delay, determines how long Huntarr will wait for a command to complete before giving up. With default settings (600 attempts × 1 second delay), Huntarr will wait up to 10 minutes.</p>
|
||
|
||
<p>If you're processing very large libraries or have slower systems, you might need to increase this value. If commands are typically quick on your system, you could decrease it to detect failed commands more quickly.</p>
|
||
|
||
<p>Calculation: Total wait time = Command Wait Delay × CMD Wait Attempts</p>
|
||
<ul>
|
||
<li>Default: 1 second × 600 attempts = 600 seconds (10 minutes)</li>
|
||
<li>For slower systems: 1 second × 1200 attempts = 1200 seconds (20 minutes)</li>
|
||
<li>For faster systems: 1 second × 300 attempts = 300 seconds (5 minutes)</li>
|
||
</ul>
|
||
|
||
<h3 id="max-dl-queue-size"><a href="#max-dl-queue-size" class="info-icon"><i class="fas fa-info-circle"></i></a> Max DL Queue Size</h3>
|
||
<p>If the current download queue for an app instance exceeds this value, downloads will be skipped until the queue reduces (default: -1, which means no limit).</p>
|
||
|
||
<p>This setting helps prevent overwhelming your download client with too many simultaneous downloads. If you notice performance issues when Huntarr triggers many downloads at once, you might want to set this to a reasonable value (like 5 or 10).</p>
|
||
|
||
<p>Setting this to -1 means there's no limit on how many downloads Huntarr will queue, which can be useful if you have a very powerful system and fast internet.</p>
|
||
|
||
<p>Consider your bandwidth and system resources when setting this value:</p>
|
||
<ul>
|
||
<li><strong>-1 (No limit):</strong> For high-bandwidth connections and powerful systems</li>
|
||
<li><strong>10-15:</strong> For good broadband connections and moderately powerful systems</li>
|
||
<li><strong>5-10:</strong> For typical home broadband connections</li>
|
||
<li><strong>1-5:</strong> For slower connections or systems with limited resources</li>
|
||
</ul>
|
||
|
||
<h3 id="log-refresh-interval"><a href="#log-refresh-interval" class="info-icon"><i class="fas fa-info-circle"></i></a> Log Refresh Interval</h3>
|
||
<p>How often Huntarr refreshes logs from apps, in seconds (default: 30 seconds).</p>
|
||
|
||
<p>This setting controls how frequently Huntarr updates the logs you see in the UI. Lower values (like 10-15 seconds) make logs update more frequently but might increase system load. Higher values (like 60 seconds) reduce system load but make logs less current.</p>
|
||
|
||
<p>The default of 30 seconds provides a good balance between timely updates and system efficiency. If you're actively troubleshooting an issue and need to see log updates more quickly, you might temporarily reduce this value. For regular operation, especially on less powerful hardware, keeping it at 30 seconds or higher is recommended.</p>
|
||
|
||
<p>When adjusting this setting, consider:</p>
|
||
<ul>
|
||
<li><strong>10-15 seconds:</strong> For active troubleshooting when you need near real-time log updates</li>
|
||
<li><strong>30 seconds:</strong> Default, good balance for most users</li>
|
||
<li><strong>60 seconds:</strong> For systems with limited resources or when logs aren't frequently needed</li>
|
||
</ul>
|
||
</section>
|
||
|
||
<div class="section-nav">
|
||
<a href="../index.html">← Back to Home</a>
|
||
</div>
|
||
|
||
<footer>
|
||
Huntarr.io | System Settings Documentation | Thanks 4 Using Huntarr - 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');
|
||
}
|
||
});
|
||
</script>
|
||
</body>
|
||
</html>
|