Health and uptime monitoring
Prompy exposes a public GET /api/health endpoint for uptime monitoring. It checks database liveness, required configuration, and whether Pip is configured without returning secret values or calling Gemini.
Gatus deployment
Section titled “Gatus deployment”The repository’s monitoring/ directory contains a pinned Gatus container, a Caddy HTTPS reverse proxy, and the endpoint configuration.
- Use an always-on Docker host; Gatus cannot run as a Vercel function.
- Point
status.<your-domain>at the host. - Copy
monitoring/.env.exampleto.envand set the health token and alert credentials. - Run
docker compose up -d.
Gatus stores uptime history in the gatus-data volume. Keep this volume when updating the containers.
Health endpoint
Section titled “Health endpoint”Unauthenticated requests return the overall status and boolean check results. Requests with Authorization: Bearer <HEALTH_CHECK_TOKEN> also receive latency and configuration booleans. The endpoint returns 200 when healthy and 503 when the database is unavailable or required configuration is missing.
Set NEXT_PUBLIC_STATUS_URL in the web deployment to link the public status page from the app footer and admin dashboard.