Uptime Kuma

Uptime Kuma watches services. This shows each monitor as up or down, warns about certificates that are expiring, and the assistant can read its history.

Set it up

integrations:
  uptimekuma:
    type: uptimekuma
    url: http://uptime-kuma:3001
    username: ${UPTIMEKUMA_USER}
    password: ${UPTIMEKUMA_PASSWORD}
    certWarnDays: 14

layout:
  - title: Infrastructure
    widgets:
      - uptimekuma.monitors

Option	Type	Default	What it does
`url`	URL	required	Where the service answers, from Valet’s side.
`href`	string	optional	Where the card links to, when that differs from `url`.
`username`	string	“	with an API key: username empty, password = the key
`password`	string	required	with an API key: username empty, password = the key
`certWarnDays`	number	`14`	Warn when a certificate has this many days left or fewer.

Widgets

One widget. Its key is uptimekuma.monitors, using the instance name from your config.

Uptime

uptimekuma.monitors · status card · refreshes every minute while the page is open.

Uptime Kuma, Uptime, medium size — Medium

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

States

Uptime Kuma Uptime: A certificate expiring — A certificate expiring

Uptime Kuma Uptime: Pending and in maintenance — Pending and in maintenance

Uptime Kuma Uptime: Can't reach it — Can't reach it

Assistant tools

What the assistant can use, once its access level allows it. Read tools run freely. Everything else asks first.

Tool	Access	What it does
`uptime_history`	read	Uptime Kuma: each monitored service, whether it is up now, and its uptime over the last day and 30 days; also certificates close to expiry.

Year in review

Slides this integration adds to the recap.

Recap slide: Your homelab stayed up 99.93% . Across the 7 things Uptime Kuma watches. The ones that kept you busiest: — Your homelab stayed up 99.93%