Skip to content

Diagnose your setup with repro health

This page shows how to find out why reprobuild is not working as you expect on your machine, and how to fix what it finds.

Before you start

Steps

1. Run the check

Run the check from inside your project or workspace:

repro health

Each line names one check and its result. Every failed check names the command that fixes it.

2. Apply the remedies

Run the remedy each failure names, then run repro health again.

3. Apply the safe fixes in one step

To apply the fixes that cannot lose work in one step, run:

repro health --fix

--fix applies only the safe remedies. A failure whose remedy could discard work stays failed, with its remedy printed, for you to decide.

Use it in CI

repro health exits with status 1 when any check fails, so a CI step can stop on an unhealthy environment:

repro health --json

--json prints the same results as JSON for a script or an agent to read. --offline skips the checks that need the network.

The checks

<!-- generated:begin cli-reference health checks --> <!-- generated:end -->