Skip to content

bugrauluyurt/homelab

v3.5.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 SMART health, temperature and, in a USB enclosure, the link of the media drive and of the backup drive when there is one. Use when asked about the hard drives, 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) and the optional nightly mirror of the whole media drive onto a backup drive. Use when asked whether backups or the mirror are working, to take a backup or mirror now, to list snapshots, to restore an app's settings, or to get back a deleted media file.

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; check the UPS and run its power-cut tests. Use only when the user explicitly asks to turn off, unplug or restart the drive or the whole stack, or asks about the UPS, a power cut or a UPS test.

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.