helpyourneighbour/docs/healthcheck.md
OpenClaw eb7909219f
Some checks are pending
Docker Test / test (push) Waiting to run
fix(#10): Add Docker HEALTHCHECK on /health endpoint and document healthy/unhealthy criteria
2026-03-06 22:07:51 +00:00

35 lines
No EOL
850 B
Markdown

# Healthcheck
## Endpoint
The application exposes a `/health` endpoint at the root level which returns a JSON response indicating the health status of the application.
### Example Response
```json
{
"status": "ok"
}
```
## Docker HEALTHCHECK
The Docker image includes a `HEALTHCHECK` instruction that verifies the application's health by making an HTTP request to the `/health` endpoint.
### Healthcheck Configuration
- **Interval**: 30 seconds
- **Timeout**: 10 seconds
- **Start Period**: 5 seconds
- **Retries**: 3 attempts
### Healthy Status
The container is considered healthy if the `/health` endpoint returns a successful HTTP response (status code 2xx).
### Unhealthy Status
The container is considered unhealthy if:
1. The `/health` endpoint is unreachable.
2. The `/health` endpoint returns an error status code (4xx or 5xx).