Skip to content

bugrauluyurt/homelab

v3.2.0

Operate the arr media stack on your server: health checks, VPN leak checks, drive health, logs, safe updates with rollback, backups and power.

drive-health

Check the media drive's SMART health, temperature and, in a USB enclosure, its link. Use when asked about the hard drive, disk failure risk, disk temperature, or slow disk performance.

stack-backup

Check, run or restore the media stack's settings backups (restic snapshots of app configs and databases, never media). Use when asked whether backups are working, to take a backup now, to list snapshots, or to restore an app's settings.

stack-health

Check whether the home media stack (Jellyfin, Seerr, Radarr, Sonarr, Lidarr, Prowlarr, Bazarr, qBittorrent behind the ProtonVPN tunnel, Navidrome, monitoring, backups) is healthy, and explain any failures. Use when asked if everything is working, after a reboot or change, or when something seems broken.

stack-logs

Troubleshoot a misbehaving media-stack service (Jellyfin, Seerr, Radarr, Sonarr, Lidarr, Prowlarr, Bazarr, qBittorrent, gluetun, slskd, Questarr, SFTPGo, Navidrome, Homepage, Glance, Scrutiny, ChangeDetection) by reading its logs and matching them against known issues. Use when a download, request, subtitle, playback or app problem needs diagnosing.

stack-power

Safely stop the media stack and unmount the media drive before it is powered off or unplugged, or bring the stack back up. Use only when the user explicitly asks to turn off, unplug or restart the drive or the whole stack.

stack-update

Check for and apply Docker image updates to the media stack safely, with a settings snapshot first and rollback if something breaks. Use only when the user explicitly asks to check for updates, update services, or roll back an update.

vpn-check

Verify that all torrent and Soulseek traffic goes through the ProtonVPN tunnel and cannot leak to the home IP, including the kill switch. Use when asked whether the VPN is working, whether torrents are safe or private, or after any change to gluetun, qBittorrent or slskd.