Setting up Uptime Kuma

Run the container

Everything (monitors, history, notification settings) lives in the one mounted data volume.

services:
  uptime-kuma:
    image: louislam/uptime-kuma:latest
    container_name: uptime-kuma
    restart: unless-stopped
    ports:
      - "3001:3001"
    volumes:
      - ./data:/app/data

Create the admin account

The first visit to port 3001 runs a short setup wizard that creates the one admin account for this instance.

Add a monitor

Point it at another self-hosted service by URL, IP and port, or hostname; HTTP(s), TCP, DNS, and several other check types are supported.

Connect notifications

Under Settings → Notifications, Uptime Kuma can push through Gotify or ntfy (their own guides in this Library) so a service going down actually reaches a phone, not just a dashboard nobody's looking at.