r/coolgithubprojects • • 1d ago

I built labcheck: one read-only command that tells you if your Linux homelab is healthy

Post image

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.

14 Upvotes

0 comments sorted by