Skip to main content

$ cat project.md

compose-homelab-starter

An opinionated docker-compose starter for a self-hosted homelab: reverse proxy, monitoring, backups.

shipping
homelabdocker
git clone

Batteries-included Compose stack: Caddy, Grafana, Prometheus, and a backup sidecar that actually tests restores.

The problem

A small, annoying task that was eating time and attention every week. We measured it before touching anything.

The approach

One focused change, reproducible, with a guardrail and an obvious way to turn it off. No magic, no vibes.

$ ./run --dry-run
[ ok ] plan looks sane
$ ./run --apply

The receipts

Before/after benchmarks, the failure modes we hit, and the tradeoffs we accepted. The repo has the full runbook.

Convinced? The repo is one command away.

git clone

$ related lab notes