> ## Documentation Index
> Fetch the complete documentation index at: https://site.aspect.build/llms.txt
> Use this file to discover all available pages before exploring further.

# aspect ci runner-health-check

> Run the Aspect Workflows runner health check on demand: wait for warming, print the last check, and probe the runner's Bazel server.

`aspect ci runner-health-check` runs the runner health check by itself, without a build. Every Bazel task already runs this check during its setup phase; this command is for a pipeline step or a debugging session that wants only the check.

```shell theme={null}
aspect ci runner-health-check
```

On an Aspect Workflows runner it:

1. Waits for cache warming to finish.
2. Prints the last runner health check and the warming status.
3. Probes the runner's Bazel server, and marks the runner unhealthy if the server is stuck.

It exits non-zero when the Bazel server is unhealthy. Off a Workflows runner there's no runner to check, so it prints a line saying so and exits 0.

## Options

The check starts Bazel on the runner's own output base, so it takes the same Bazel flag options as the build tasks and no `--output-base` of its own.

| Flag                          | Default | What it does                                                                     |
| ----------------------------- | ------- | -------------------------------------------------------------------------------- |
| `--bazel-flag <flag>`         | none    | Extra Bazel flag. Repeatable                                                     |
| `--bazel-startup-flag <flag>` | none    | Extra Bazel startup flag. Repeatable                                             |
| `--announce-bazel-rc`         | `auto`  | Print the resolved `.bazelrc` flags. `auto` prints on CI and stays quiet locally |
| `--announce-bazel-version`    | `auto`  | Print the detected Bazel version                                                 |
| `--announce-bazel-command`    | `auto`  | Print the exact `bazel` command line                                             |

## Related

* [`aspect ci runner-metadata`](/docs/cli/tasks/ci_runner_metadata): print the runner metadata table.
* [`aspect ci warming`](/docs/cli/tasks/ci_warming): fill the runner's caches.