Uptime Kuma

Damit man nicht erst durch Beschwerden merkt, dass etwas ausgefallen ist. Uptime Kuma prüft alle Dienste rund um die Uhr und meldet sich, sobald etwas nicht antwortet oder ein Zertifikat bald abläuft.

Was ist Uptime Kuma?

Uptime Kuma ist ein schlankes Open-Source-Werkzeug zur Überwachung. Man legt Monitore an, etwa „Ist docs.meinverein.de erreichbar?“, und Uptime Kuma fragt sie in festen Abständen ab. Fällt etwas aus, kommt eine Nachricht per E-Mail, Signal, Matrix, Telegram oder ntfy. Auf Wunsch gibt es eine öffentliche Statusseite, auf der Mitglieder selbst sehen, ob alles läuft.

Der Container

# auf dem Proxmox-Knoten
pct clone 9000 102 --hostname status --full
pct set 102 --cores 1 --memory 512 --onboot 1 --features nesting=1,keyctl=1 \
  --net0 name=eth0,bridge=vmbr0,ip=192.168.178.32/24,gw=192.168.178.1
pct start 102
pct exec 102 -- dpkg-reconfigure openssh-server

Docker installieren wie im Kapitel Paperless beschrieben.

Installation

# /opt/uptime-kuma/compose.yaml
services:
  uptime-kuma:
    image: louislam/uptime-kuma:1      # aktuelle Hauptversion auf Docker Hub prüfen
    restart: unless-stopped
    ports:
      - "3001:3001"
    volumes:
      - ./data:/app/data

sudo mkdir -p /opt/uptime-kuma && sudo chown admin: /opt/uptime-kuma
cd /opt/uptime-kuma
docker compose up -d

Im Reverse Proxy status.meinverein.de auf http://192.168.178.32:3001 zeigen lassen (mit den Zeilen für Upgrade und Connection). Beim ersten Aufruf legt man das Administrator-Konto an.

Was ich überwache

Monitor	Typ	Warum
jede öffentliche Adresse	HTTP(s), alle 60 s	sieht, was Mitglieder sehen, inklusive Proxy und Zertifikat
jeder Container	Ping	unterscheidet „Dienst hängt“ von „Container ist aus“
Proxmox	HTTP(s) auf Port 8006, Zertifikatsfehler ignorieren	meldet, wenn der Host selbst Probleme hat
Zertifikate	Option „Zertifikatsablauf melden“	Warnung, falls die automatische Erneuerung einmal hakt
nächtliches Backup	Push-Monitor	das Backup-Skript meldet sich am Ende, bleibt die Meldung aus, gibt es Alarm

Der Push-Monitor ist besonders praktisch: Uptime Kuma zeigt eine URL an, die am Ende eines Cron-Jobs mit curl -fsS "https://status.meinverein.de/api/push/…" aufgerufen wird. So merkt man auch, wenn ein Backup still und heimlich ausfällt.

Benachrichtigungen

Unter Einstellungen → Benachrichtigungen mindestens zwei Wege einrichten, z. B. E-Mail an technik@ und eine Push-Nachricht aufs Handy. Und an mindestens zwei Personen, damit im Urlaub jemand reagieren kann.