arr-stack

Troubleshoot and maintain Unraid servarr ARR stack operations.

1|Updated Mar 18, 2024
One-click install
npx skills add https://github.com/erfianugrah/dotfiles --skill arr-stack
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arr-stack
Source: https://github.com/erfianugrah/dotfiles/tree/main/.pi/agent/skills/arr-stack
Command: npx skills add https://github.com/erfianugrah/dotfiles --skill arr-stack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The arr-stack skill helps you correctly debug, maintain, and make safe configuration changes across the Unraid-based servarr container stack (Radarr/Sonarr/Bazarr/Prowlarr plus download and transcode services) without breaking queue behavior or authentication assumptions.

Core Features & Use Cases

  • Runbook-guided troubleshooting: Diagnoses common failures such as malformed disk images, download path EXDEV/ENOSPC issues, unexpected season/episode folder mismatches, and “No valid Arr instances found”.
  • Service-accurate operational changes: Guides tasks that depend on servarr-specific rules like SABnzbd using /mnt/cache/, NVIDIA GPU contention on the GTX 1070, and qBittorrent auth/ban quirks.
  • Indexer and import workflows: Supports indexer hygiene via Prowlarr API, and manual product/import patterns using the correct API-key extraction and payload handling approach.

Quick Start

Ask: "Given the error message I paste (and which service triggered it), what is the safest next operational step in the servarr ARR stack and which configuration or API details should I check first?"

Frequently Asked Questions about arr-stack

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix EXDEV or ENOSPC errors in my Radarr and Sonarr download paths on Unraid?

Troubleshooting Radarr or Sonarr database corruption involves diagnosing specific failure patterns within the servarr stack. Safe operational maintenance requires identifying the corruption source and executing correct database recovery procedures to prevent data loss.

What is the safest way to update the servarr ARR stack on Unraid?

The safest way to update the servarr ARR stack on Unraid is by using a composer-managed approach. This method ensures safe stack updates while maintaining configuration correctness and avoiding authentication or queue behavior disruptions across Radarr, Sonarr, Bazarr, and Prowlarr.

How do I resolve "No valid Arr instances found" when configuring Prowlarr indexers?

Resolving "No valid Arr instances found" requires verifying indexer API payload handling and correct API-key extraction. You must ensure service-name detection is accurate and validate that Prowlarr is correctly synced with your Radarr and Sonarr instances.

Why does qBittorrent authentication fail or ban clients in my Unraid ARR stack?

qBittorrent authentication failures occur due to subnet auth behavior quirks within the Unraid ARR stack. Troubleshooting requires checking your network subnet settings and adjusting the qBittorrent auth configuration to prevent unexpected client bans.

How do I prevent NVIDIA GPU contention when running Tdarr transcode tasks alongside my ARR stack?

Preventing NVIDIA GPU contention requires applying stack-specific guardrails during Tdarr transcode operations. You must monitor GPU usage carefully to avoid resource exhaustion and ensure your transcode infrastructure does not impact servarr automation.

Is it safe to use Decluttarr remove_orphans off semantics with my Sonarr and Radarr setup?

Using Decluttarr remove_orphans off semantics is safe when configured with the correct stack-specific guardrails. Disabling orphan removal prevents unwanted file deletion but requires careful manual management of your Sonarr and Radarr media directories.