If you discover a security vulnerability, please do not open a public issue.
Report it privately via GitHub Security Advisories.
You will receive an acknowledgement within a few days. Once the issue is confirmed, a fix is released before the advisory goes public.
In scope:
- The
uptime-kuma-apiFastAPI application and its Docker image - API key validation (timing attacks, bypass) and IP allowlist enforcement
- Any potential SQL injection, read amplification or database escape paths
Out of scope:
- Vulnerabilities in Uptime Kuma itself — report those to louislam/uptime-kuma
- Misconfigurations in user deployments (exposed ports, missing
ALLOWED_RANGES, weak API keys)
- This service opens a read-only connection to the Kuma database. It does not issue any writes.
- The API key is compared using
hmac.compare_digestto prevent timing attacks. - Set
ALLOWED_RANGESto a narrow CIDR list whenever possible. - Put the service behind an HTTPS reverse proxy — it speaks plain HTTP inside the container.
Only the latest release on main is supported.