After running a headless Mac mini M4 for my Plex and *arr stack (Sonarr, Radarr, Prowlarr, and Transmission), I kept hitting the same annoying reliability trap: macOS Activity Monitor would show an app as "running," while its internal web server was completely frozen.
When that happens, API connections drop, Helmarr and Ruddar on iOS lose sync, and I'd have to remote in via Screens 5 over Tailscale just to force-quit and relaunch a hung app.
To eliminate manual babysitting, I put together a lightweight, dual-layer monitoring daemon using native macOS launchd and Bash—and open-sourced it on GitHub for anyone else running a native (non-Docker) macOS media server:
GitHub Repo: https://github.com/JJDigitalLLC/arr_monitor
How the Stack is Wired
Zero-Trust Remote Access (Tailscale + Screens 5): Tailscale runs on the Mac mini M4, iPhone, and iPad mini—configured to auto-launch on boot so the mesh stays alive 24/7 without opening any ports on my router. I use Screens 5 on iOS/iPadOS whenever I need full GUI VNC access, and Helmarr / Ruddar over Tailscale for day-to-day queue management.
VPN Isolation (ExpressVPN Split-Tunneling): Running a full-tunnel privacy VPN alongside Tailscale creates nasty routing and firewall conflicts. I configured ExpressVPN's split-tunneling (WireGuard) in inclusions-only mode so only Transmission and Safari route through the VPN, leaving Plex, the *arr apps, and Tailscale on the native interface.
How arr_monitor Works
Standard process monitors only check if a PID exists—which misses silent web server hangs. This script runs a two-stage check across ports 8989, 7878, 9696, and 9091:
Process Verification (pgrep): Confirms the application process is actually active at the OS level.
HTTP API Health Check (curl --max-time 5): Pings each service's local API endpoint and checks for healthy HTTP status codes (200, 301, 302, 401).
Auto-Recovery & Native Alerts: If either check fails or times out, the script force-quits the zombie instance (killall -9), relaunches it cleanly (open -a), logs the timestamped event, and triggers a native macOS desktop notification via osascript.
Hands-Off Orchestration (launchd): Managed via a custom LaunchAgent plist (~/Library/LaunchAgents/com.user.arrmonitor.plist) with RunAtLoad enabled and StartInterval set to 3600 seconds (easily adjustable down to 5–15 minutes).
(Note for other headless Mac mini users: since LaunchAgents run in the user GUI domain, make sure Automatic Login is enabled and bash/scripts are allowed under Login Items & Extensions so everything recovers cleanly after a reboot or power blip.)
Links & Stack
GitHub (arr_monitor): https://github.com/JJDigitalLLC/arr_monitor
Remote & Mobile Apps: Tailscale | Screens 5 | Helmarr | Ruddarr
Media Stack: Plex | Sonarr | Radarr | Prowlarr
Curious how other native macOS self-hosters are handling service health checks and VPN split-tunneling—especially if you're avoiding Docker Desktop overhead on Apple Silicon.