Add NAS Doctor — local NAS diagnostic and monitoring tool

[mcdays94]

Description

NAS Doctor is a local diagnostic and monitoring tool for your NAS. It runs periodic health checks — analyzing SMART data, disk usage, Docker containers, ZFS pools, UPS power, tunnels, and more — then surfaces findings with actionable recommendations backed by Backblaze failure rate data.

App Information

• Upstream Repository: https://github.com/mcdays94/nas-doctor
• Documentation: https://github.com/mcdays94/nas-doctor#readme
• License: MIT
• Container Image: ghcr.io/mcdays94/nas-doctor:0.5.9
• App Version: 0.5.9

Key Features

• 20+ diagnostic rules with automatic root-cause correlation
• SMART health with Backblaze failure-rate thresholds (337k+ drives)
• Service checks: HTTP, TCP, DNS, Ping/ICMP, SMB, NFS with per-check intervals
• Tunnel monitoring: Cloudflared and Tailscale (host + Docker detection)
• ZFS pool health: vdev tree, scrub/resilver, ARC stats, datasets
• UPS / power monitoring via NUT or apcupsd
• 3 dashboard themes (Midnight, Clean, Ember)
• Prometheus /metrics endpoint (80+ gauges)
• Webhook alerts: Discord, Slack, Gotify, Ntfy, generic HTTP
• Log forwarding: Loki, syslog, HTTP JSON
• Multi-server fleet monitoring

Testing

• Tested locally with Docker Compose
• All test files pass (basic-values.yaml)
• Health check configured (/api/v1/health)
• Portal configured (web UI)

Icons and Screenshots

• Icon: https://raw.githubusercontent.com/mcdays94/nas-doctor/main/icons/icon3.png
• Screenshots available at: https://github.com/mcdays94/nas-doctor#themes

Special Notes

• NAS Doctor requires SYS_RAWIO capability for smartctl to read SMART disk data
• Runs as root (uid 0) for device access — same requirement as on Unraid/Synology
• Optional host mounts for /var/log (log analysis) and /mnt (disk space monitoring)
• Docker socket mount is optional but recommended for container monitoring
• ZFS pool health works automatically on TrueNAS — no extra configuration needed

Checklist

• app.yaml metadata is complete
• questions.yaml has clear labels and descriptions
• Test files pass
• README.md is written
• Only files under /ix-dev/ are modified

[mcdays94]

Updated to NAS Doctor v0.9.0. Key changes since the initial submission:

Version bump (v0.5.9 → v0.9.0)

• Multiple major features added: architecture hardening sprint, Top Processes with Docker container attribution, GPU monitoring, speed test scheduling, clickable process history charts.

Top Processes feature requires pid_mode: host
Added via c1.set_pid_mode("host") in the compose template. Without it, the container only sees its own processes (not all host processes) and cannot match them to Docker containers via cgroup inspection.

New mount toggles (default: true)

• mount_dev — mounts /dev read-only, required for SMART on most systems
• mount_sys — mounts /sys read-only, required for GPU telemetry (NVIDIA, Intel, AMD)

Other updates

• Default scan interval: 6h → 30m (matches v0.8.8+ upstream default)
• Updated description, keywords, README to reflect new capabilities

Full changelog: https://github.com/mcdays94/nas-doctor/releases/tag/v0.9.0