homelab-monitoring-webhook/README.md

homelab-health-monitor

Lightweight system health monitoring for homelab servers with Discord webhook notifications.

Features

• Hourly stats collection (CPU, RAM, load, disk)
• Daily Discord reports with min/avg/max values
• SSD SMART health checks
• Journal error summaries
• Color-coded status (OK/WARNING/CRITICAL)
• Zero dependencies beyond bash, cron, and curl

Installation

1. Copy scripts to ~/.local/bin/
2. Create data directory: mkdir -p ~/.local/share/health-monitor
3. Edit health-report.sh and set your WEBHOOK_URL
4. Make executable: chmod +x ~/.local/bin/health-*.sh
5. Add to crontab:

0 * * * * ~/.local/bin/health-collector.sh
0 9 * * * ~/.local/bin/health-report.sh

Usage

# Send report now
./health-report.sh

# Only report if warnings/errors
./health-report.sh --errors-only

License

MIT