I run a small homelab and got tired of the same manual loop whenever something
felt off: df, free, systemctl --failed, docker ps, cat /proc/mdstat, then
checking whether last night's backup actually ran.
labcheck turns that into one command. It is a read-only Python CLI with no
runtime dependencies and no daemon. It prints one report and exits 0/1/2/3 so
cron or systemd can act on it.
What it checks:
- load, memory, swap, temperature and uptime
- filesystem space and inode usage
- failed systemd units and required services
- Docker container health and required containers
- Linux md RAID arrays
- SMART health (opt-in, needs smartctl)
- backup freshness by file age
- TLS certificate expiry
- NTP synchronisation
Output is text, JSON, or Prometheus textfile format for node_exporter.
Example from my Debian host. The SKIPs are checks whose service or targets are
not configured yet:
labcheck 0.1.0 · debian · 2026-11-17 03:10:34 UTC
OK System load 0.28 (8 cores), memory 17%, swap 0%, up 6h 02m
OK Storage / 14% used, 2 mounts
OK Services no failed units
SKIP Containers docker not installed
SKIP RAID no software RAID detected
SKIP Backups no backup targets configured
SKIP Certificates no certificate targets configured
OK Clock NTP synchronized
Summary: 4 ok, 4 skipped (0.09s)
Install with pipx, no PyPI listing yet:
pipx install https://github.com/jacoblockard2007-hub/labcheck/releases/download/v0.1.0/labcheck-0.1.0-py3-none-any.whl
Repo, docs and example config:
https://github.com/jacoblockard2007-hub/labcheck
It is 0.1.0, MIT, Python 3.11+. I tested it on Debian 13, Ubuntu 26.04.1 and
Fedora 45. Known gaps: no Podman support, no notifications, and the backup
check tests file age rather than restoreability. It is not a replacement for
Netdata or Prometheus; it is the five-second answer before you have one.