Works on your machine?
Let's find out why.
preboot runs YAML-defined checks against your local environment — tools, files, env vars, ports, services — and prints exactly what to fix.
Diagnose every local environment failure
preboot covers the full spectrum of local environment issues in a single deterministic run.
7 Built-in Check Types
Pinpoint missing tools, absent files, unset env vars, blocked ports, and unreachable endpoints — all in a single run.
Plain YAML Config
Commit preboot.yml with your code. Every contributor gets the same diagnostic, no tribal knowledge required.
Instant Fix Hints
Each failed check prints a Fix: message. The answer is in the terminal, not on Stack Overflow.
CI-Ready Exit Codes
Exit 0 on success, 1 on failure. Drop preboot check into any CI pipeline as a pre-run gate with zero config.
Auto-detect with init
Run preboot init and it scans your repo — Go modules, Makefiles, Docker Compose, .env templates — and writes checks for you.
Quick Mode
Use --quick to skip network checks and get instant local feedback. Full checks run in CI where latency is acceptable.
Reproduce the issue. Then fix it.
Clone the project, run preboot init, and you'll see exactly which local checks are failing — and why.
git clone https://github.com/allenbiji/preboot.gitcd preboot && make buildcd /your-project && preboot initpreboot check