⌕
AnmeldenDabei sein ↗

Tippe mindestens zwei Buchstaben. Pfeiltasten wählen, Enter öffnet.

ANLEITUNG⌂ Homelab & Server

Uptime Kuma: Server und Dienste überwachen, mit Alarm aufs Handy

Merkst du erst, dass dein Server down ist, wenn Freunde fragen? Uptime Kuma prüft Webseiten, Server und Gameserver rund um die Uhr und meldet Ausfälle per Telegram, Discord oder ntfy.

Server neben einer Übersicht mit grünen und einem roten Statusbalken, davor ein Smartphone mit roter Benachrichtigung
Illustration: Spawnpunkt

Ein Homeserver läuft monatelang problemlos, bis eines Nachts der Strom kurz weg ist, ein Container nicht wieder hochkommt oder die SD-Karte aufgibt. Ohne Überwachung merkst du das erst, wenn du den Dienst brauchst. Uptime Kuma prüft deine Dienste im Minutentakt und schickt dir eine Nachricht, sobald etwas nicht antwortet, und noch eine, wenn es wieder läuft.

Uptime Kuma ist kostenlos, quelloffen, läuft als einzelner Docker-Container und hat eine aufgeräumte Weboberfläche. Bonus: Du kannst daraus eine öffentliche Statusseite für deinen Gameserver machen.

Du brauchst: einen Rechner mit Docker. Ideal ist ein anderes Gerät als das, das du überwachst, denn ein ausgefallener Server kann sich nicht selbst melden. Zeitaufwand: etwa 20 Minuten.

Schritt 1: Uptime Kuma mit Docker starten

bash
mkdir -p ~/uptime-kuma && cd ~/uptime-kuma

Lege die Datei compose.yaml an:

yaml
services:
  uptime-kuma:
    image: louislam/uptime-kuma:2
    container_name: uptime-kuma
    restart: unless-stopped
    ports:
      - "3001:3001"
    volumes:
      - ./daten:/app/data
bash
docker compose up -d

Öffne http://192.168.1.50:3001 im Browser. Beim ersten Start fragt Uptime Kuma nach der Datenbank. Für zu Hause ist SQLite die richtige Wahl, es braucht keinen eigenen Datenbankserver. Danach legst du dein Administratorkonto an.

Läuft bei dir schon Caddy aus https://spawnpunkt.de/magazin/caddy-reverse-proxy-docker-https, hänge den Container ins Netzwerk proxy und lass ports: weg. Dann erreichst du Uptime Kuma unter https://kuma.beispiel.de.

Schritt 2: Den ersten Monitor anlegen

Klicke auf „Neuen Monitor hinzufügen“. Die wichtigsten Monitor-Typen:

TypPrüftBeispiel
HTTP(s)ob eine Webseite mit Status 200 antwortethttps://nas.beispiel.de
HTTP(s) – Keywordob ein bestimmter Text auf der Seite stehtLogin-Seite enthält „Anmelden“
Pingob ein Gerät im Netz antwortetRouter, Drucker, NAS
TCP Portob ein Port offen istMinecraft-Server auf 25565
DNSob ein Name richtig aufgelöst wirdAdGuard Home
Pushob sich ein Skript regelmäßig meldetBackup-Job, Cronjob

Für den Anfang: Typ HTTP(s), ein Anzeigename, die URL und ein Intervall von 60 Sekunden. Unter „Wiederholungen“ stellst du 2 ein, dann löst ein einzelner Aussetzer noch keinen Alarm aus.

Raspberry Pi in der Mitte prüft drei Server über gestrichelte Linien, ein roter Pfeil führt zu einem Smartphone
Uptime Kuma fragt die Dienste regelmäßig ab. Antwortet einer nicht, geht eine Nachricht an Handy oder Discord.

Schritt 3: Benachrichtigungen aufs Handy

Unter Einstellungen → Benachrichtigungen findest du über 90 Dienste. Drei bewährte Wege:

ntfy (am einfachsten): Installiere die App „ntfy“ aus dem Play Store, dem App Store oder F-Droid und abonniere ein Thema mit einem schwer zu erratenden Namen, zum Beispiel homelab-a7k29x. In Uptime Kuma wählst du „ntfy“, Server https://ntfy.sh und dasselbe Thema. Wichtig: Wer den Themennamen kennt, kann mitlesen. Nimm deshalb einen zufälligen Namen.

Discord: In deinem Discord-Server öffnest du die Kanaleinstellungen → Integrationen → Webhooks → Neuer Webhook, kopierst die Webhook-URL und trägst sie in Uptime Kuma beim Typ „Discord“ ein. Praktisch, wenn ihr einen Gameserver gemeinsam betreibt.

Telegram: Mit dem Bot @BotFather legst du einen Bot an und bekommst ein Token. Uptime Kuma hilft dir beim Ermitteln der Chat-ID direkt im Formular.

Mit „Test“ schickst du eine Probenachricht. Setze den Haken bei „Standardmäßig aktiviert“, dann gilt die Benachrichtigung für alle neuen Monitore.

Schritt 4: Backups und Cronjobs mit Push-Monitoren überwachen

Ein Backup, das still nicht mehr läuft, ist der Klassiker. Der Monitor-Typ Push dreht den Spieß um: Uptime Kuma wartet darauf, dass sich dein Skript meldet. Bleibt die Meldung aus, gibt es Alarm.

Lege einen Push-Monitor an, setze das Intervall auf die Laufzeit deines Jobs plus Puffer (für ein tägliches Backup zum Beispiel 90000 Sekunden, also 25 Stunden) und kopiere die angezeigte Push-URL. Am Ende deines Skripts rufst du sie auf, nur wenn alles geklappt hat:

bash
restic backup /etc /home && curl -fsS -m 10 "https://kuma.beispiel.de/api/push/DEIN_TOKEN?status=up&msg=OK" > /dev/null

Das && sorgt dafür, dass der Aufruf nur nach einem erfolgreichen Backup passiert.

Schritt 5: Eine Statusseite für deine Community

Unter Statusseiten → „Neue Statusseite“ baust du eine öffentliche Übersicht, etwa für den Minecraft- oder Valheim-Server deiner Gruppe. Du wählst aus, welche Monitore erscheinen, kannst ein Logo hochladen und Wartungsfenster ankündigen. Die Statusseite zeigt nur den Zustand, keine IP-Adressen oder Einstellungen.

Wenn es hakt

  • Monitor ist rot, Dienst läuft aber: Bei HTTPS mit tls internal kennt Uptime Kuma das Zertifikat nicht. Setze im Monitor den Haken bei „TLS/SSL-Fehler ignorieren“ oder prüfe intern per HTTP.
  • Ping geht nicht: Manche Geräte und Windows-PCs beantworten keine Pings. Prüfe dann einen offenen Port per TCP.
  • Zu viele Fehlalarme: Erhöhe die Wiederholungen auf 3 und das Wiederholungsintervall auf 60 Sekunden.
UmfrageEine Antwort

Was überwachst du zuerst?

Wird geladen …
✓ Fazit
  • Uptime Kuma 2 als Container starten, beim ersten Start SQLite wählen
  • HTTP-, Ping- und TCP-Monitore für deine Dienste anlegen, 2 Wiederholungen gegen Fehlalarme
  • Benachrichtigung über ntfy, Discord oder Telegram einrichten und testen
  • Backups mit Push-Monitoren absichern
  • Optional eine Statusseite für die Community

Zeig deine Statusseite gern in der Community. Und wenn ein Monitor rot wird und du nicht weißt, warum: Frag einfach nach.

Quellen

Kommentare

Noch keine Kommentare. Was meinst du dazu?

Mitreden? Melde dich an, um zu kommentieren.

Frage stellen

Spawnpunkt bindet keine Dienste von Drittanbietern ein. Alles, was du hier erlaubst, bleibt auf meinem eigenen Server.