Skip to content
machinemail

health

Liveness and readiness. The `machinemail health` commands: arguments, flags, examples and the API routes they call.

Liveness and readiness.

CommandSummary
health checkCheck that the API is up (liveness)
health readyCheck that the API can serve requests (readiness)

Every command also takes the global flags.

health check

Check that the API is up (liveness).

Always 200 {“status”: “ok”} while the process serves requests. No authentication.

shell
machinemail health check [flags]

Examples

shell
machinemail health check

API

health ready

Check that the API can serve requests (readiness).

Pings the storage backend: 200 with status: ready when it answers, 503 with status: unavailable when it does not. checks.transport names the mail transport and checks.notify reports cross-machine notifications (informational, never part of readiness). No authentication.

shell
machinemail health ready [flags]

Examples

shell
machinemail health ready

API