Skip to content

quox kuma

Documented Checked against the CLI's current help and source. Not run end to end. CLI 0.4.0, checked 2026-11-05.

All commands

Uptime Kuma. Bare quox kuma runs status. Verbs: status, down, uptime, refresh, monitors, incidents, diagnose, coverage, sla, maintenance, status-incident, hooks

CommandWhat it does
quox kuma status [options] [slug]Every monitor, grouped, with state, ping and 24h/30d uptime
quox kuma down [options] [slug]Only monitors that are not up. Exit code 0 when all up, 3 when any is not up
quox kuma uptime [options] [slug]Per-monitor 24h/30d uptime, worst first
quox kuma refresh [slug]Bust the live-state cache and show fresh monitor state (also re-scrapes any configured public status pages)
quox kuma monitorsList, inspect and (org admin, human approved) change Uptime Kuma monitors
quox kuma incidents [options]Kuma alerts that became Quox incidents: when down, when back, how long
quox kuma diagnose [options] [incidentId]Why is it down: outside-in checks (DNS, TCP, HTTP, TLS, keyword) plus read-only host checks when the target is a managed fleet host
quox kuma coverage [options]What is not watched: fleet hosts, verified domains and the Quox URL against your Kuma monitors (“9 of 14 watched”)
quox kuma sla [options]Signed, verifiable uptime (SLA) report from Kuma heartbeats; sla verify <id|file> checks one
quox kuma maintenanceMaintenance windows: planned work does not page people (open and end are org admin, human approved)
quox kuma status-incidentCustomer-safe status-page comms for an outage: draft, publish, resolve (publish and resolve are org admin, human approved)
quox kuma hooksThe per-org signed hook Uptime Kuma posts alerts to (list, create, delete; org admin)