Skip to main content

General

General configuration settings that apply to the entire Cleanuparr application.

System Settings

🎗️Display Support Banner

Shows the support section on the dashboard with links to GitHub and sponsors.

🧪Dry Run

Logs all operations without making changes. Test your configuration safely before enabling live deletions and notifications.

📡Status Check

Periodically checks for new Cleanuparr versions. Disable this if your environment has restricted outbound network access.

💡Note

When disabled, the version check and "update available" notification in the sidebar will not appear.

HTTP Configuration

🔄HTTP Max Retries

Number of retry attempts for failed HTTP requests to *arrs, download clients, and other services.

⏱️HTTP Timeout

Seconds to wait before timing out HTTP requests to *arrs, download clients, and other services.

🔒HTTP Certificate Validation

SSL certificate validation for HTTPS connections.

Options:

  • Enabled: Validate all SSL certificates
  • Disabled for Local Addresses: Skip validation for local/private IP addresses only
  • Disabled: Skip all validation (not recommended)

Search Settings

✅Search Enabled

Automatically search for replacements after removing downloads from *arr apps.

💡Note

If using Huntarr, disable this to let Huntarr handle searching.

⏳Search Delay

Seconds to wait before triggering replacement searches. Prevents overwhelming indexers with rapid requests.

🚨Warning

A lower value will result in faster searches, but may cause issues such as being rate limited or banned by the indexer.

Download Management

🚯Ignored Downloads

Downloads matching these patterns are skipped during all cleaning operations. Match by:

  • Torrent hash
  • qBittorrent tag or category
  • Deluge label
  • Transmission category (last directory from the save location)
  • µTorrent label
  • Tracker domain

Examples:

fa800a7d7c443a2c3561d1f8f393c089036dade1
tv-sonarr
qbit-tag
mytracker.com

State Management

⏳Strike Inactivity Window

Controls how long strike data is retained using a sliding window. Strikes for a download are automatically cleaned up after the download goes this many hours without receiving a new strike.

How it works:

  • The window resets every time a new strike is recorded for a download
  • As long as a download keeps getting new strikes, all of its strike history is preserved
  • Once a download stops receiving strikes for the configured number of hours, all of its strikes are removed
  • This effectively means: "forget about downloads that haven't been problematic recently"

Example: With a value of 72 hours (3 days):

  • Download A receives strikes on Monday, Tuesday, and Wednesday. On Saturday (72 hours after the last strike on Wednesday), all of its strikes are cleaned up.
  • Download B receives a strike on Monday. On Thursday (72 hours later), its strike is cleaned up.
  • Download C receives strikes on Monday and Thursday. The window resets on Thursday, so cleanup happens on Sunday (72 hours after Thursday).
💡Note

Lower values clean up strikes faster, but may cause Cleanuparr to re-strike downloads it has already dealt with. This value needs to be adjusted based on your Queue Cleaner run interval.

🧹Purge All Strikes

Immediately and permanently deletes all strike data for all downloads. This resets all strike counters to zero.

🚨Warning

This action cannot be undone. All downloads will start with zero strikes after a purge, which means previously problematic downloads may need to accumulate strikes again before being acted upon.

Logging Settings

📊Log Level

Controls log detail level. Lower levels include all higher-level messages.

📐Rolling Size (MB)

Maximum log file size before creating a new file. Larger values mean fewer files but bigger individual file sizes.

🗂️Retained File Count

Number of non-archived log files to keep. Older files are removed or archived based on your settings.

⏳Time Limit

Maximum age for non-archived logs. Older files are removed or archived based on your settings.

🗄️Archive Enabled

Archive old log files instead of deleting them. Preserves history while reducing disk usage through compression.

💡Note

Recommended if Cleanuparr generates many logs on your setup.

🧾Archive Retained Count

Number of archived log files to keep. Older archives are deleted.

🕒Archive Time Limit

Maximum age for archived logs before deletion.