unraid-troubleshooter

Diagnose Unraid server failures across Docker, storage, VMs, and plugins.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/engineai-nz/engineai-skills --skill unraid-troubleshooter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unraid-troubleshooter
Source: https://github.com/engineai-nz/engineai-skills/tree/main/infra/unraid-troubleshooter
Command: npx skills add https://github.com/engineai-nz/engineai-skills --skill unraid-troubleshooter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps troubleshoot and diagnose Unraid server problems when users see symptoms like array/parity errors, failing drives, crashing Docker containers, VM startup failures, or general NAS instability.

Core Features & Use Cases

  • Triage by subsystem: Routes investigation to Docker, disks/array, VMs, plugins, or overall health based on the observed symptoms.
  • Access-mode aware guidance: Switches between direct SSH/terminal diagnosis and guided step-by-step instructions for WebUI-only users.
  • Evidence-first diagnostics: Prioritizes syslog review and directs users to generate the Unraid diagnostics package before rebooting to avoid losing volatile logs.
  • What to check and where: Covers key commands and file locations for live/persisted logs, SMART checks, parity/array status, VM/libvirt logs, and common failure patterns.

Quick Start

Tell the skill: "My Unraid server shows parity check failed and one drive has errors—help me figure out the root cause and what steps to take next."

Frequently Asked Questions about unraid-troubleshooter

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

FAQPage Schema
How do I troubleshoot Unraid server failures like disabled drives and parity check errors?

Unraid parity check failures require subsystem-specific diagnostics, starting with syslog review and SMART checks via smartctl. You must generate an Unraid diagnostics package before rebooting to preserve volatile logs needed to pinpoint the failing drive.

Why are my Docker containers crashing after an Unraid server reboot?

Docker container crashes on Unraid require reviewing Docker logs and checking for post-reboot instability or plugin conflicts. Triage routes investigation to container-specific diagnostics to isolate whether the crash originates from the container config or broader system health.

Can I diagnose Unraid VM startup failures if I only have WebUI access?

Yes, you can diagnose Unraid libvirt VM startup failures with WebUI-only access through guided step-by-step instructions. The process uses access-mode aware guidance to check VM logs and system health without requiring SSH or direct terminal access.

What is the best way to collect diagnostics for SMART errors on Unraid without losing data?

The best way to collect SMART error diagnostics on Unraid is to run smartctl checks and generate the system diagnostics package before rebooting. This evidence-first approach safely captures volatile syslog data and disk status without risking data loss.

When should I not reboot my Unraid server during storage array troubleshooting?

You should not reboot your Unraid server during storage array troubleshooting until you have generated the diagnostics package and reviewed the syslog. Rebooting clears volatile logs that are critical for identifying the root cause of array and parity issues.