← Zurueck zu Monitoring
📊

Uptime Kuma einrichten

Professionelles Uptime-Monitoring selbst gehostet. Ueberwache Websites, APIs und Services mit schoener Oberflaeche.

⏱️ 25 Minuten 📊 Einfach
🤔 Schritt 1: Was ist Uptime Kuma? +

Uptime Kuma ist ein Open-Source Monitoring-Tool das du selbst hosten kannst. Es prueft regelmaessig ob deine Services erreichbar sind und benachrichtigt dich bei Problemen.

Features

  • • HTTP(S), TCP, DNS, Ping Checks
  • • Schoene Status-Seiten
  • • 90+ Benachrichtigungs-Kanaele
  • • Multi-User Support
  • • Docker-Container Monitoring

Vorteile

  • • Komplett kostenlos
  • • Daten bleiben bei dir
  • • Einfache Einrichtung
  • • Aktive Entwicklung
  • • Moderne UI
🐳 Schritt 2: Installation mit Docker +

Die einfachste Methode ist Docker Compose:

docker-compose.yml
bash 
version: '3'
services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    restart: unless-stopped
    ports:
      - "3001:3001"
    volumes:
      - ./data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock:ro

Starten mit:

bash 
docker compose up -d
💡

Docker Socket

Das Einbinden von /var/run/docker.sock ermoeglicht das Monitoring von Docker-Containern. Kann weggelassen werden wenn nicht benoetigt.

Nach dem Start erreichst du Uptime Kuma unter http://server-ip:3001

🔑 Schritt 3: Erster Login und Setup +

Beim ersten Aufruf erstellst du deinen Admin-Account:

  1. Oeffne http://dein-server:3001
  2. Vergib einen Benutzernamen
  3. Waehle ein sicheres Passwort
  4. Klicke auf Create
⚠️

Sicherer Zugang

Stelle Uptime Kuma nicht ungeschuetzt ins Internet! Nutze einen Reverse Proxy mit HTTPS und ggf. zusaetzliche Authentifizierung.
➕ Schritt 4: Ersten Monitor anlegen +

Klicke auf Add New Monitor und konfiguriere:

HTTP(S) Monitor (Website)

Monitor Type HTTP(s)
Friendly Name z.B. "Meine Website"
URL https://meine-domain.de
Heartbeat Interval 60 Sekunden (Standard)
Retries 3 (vor Alert)

Erweiterte Optionen:

  • Accepted Status Codes: Standard 200-299, kann angepasst werden
  • Max Redirects: Wie viele Weiterleitungen erlaubt
  • Certificate Expiry: Warnen X Tage vor SSL-Ablauf
  • Keyword: Pruefe ob bestimmter Text auf der Seite ist
📋 Schritt 5: Monitor-Typen im Ueberblick +

Uptime Kuma unterstuetzt verschiedene Check-Arten:

HTTP(S)

Fuer Websites und APIs. Prueft Status-Code und optional Inhalt.

TCP Port

Prueft ob ein Port offen ist. Fuer Datenbanken, SSH, etc.

Ping (ICMP)

Einfacher Erreichbarkeitstest. Fuer Server und Netzwerkgeraete.

DNS

Prueft DNS-Aufloesung. Erkennt DNS-Probleme frueh.

Docker Container

Prueft ob Container laufen. Benoetigt Docker Socket.

Push

Dein Service meldet sich bei Kuma. Fuer Cronjobs/Backups.

💡

Push Monitoring

Push ist perfekt fuer Backup-Jobs: Am Ende des Scripts ein curl an Uptime Kuma. Kommt kein Push, ist das Backup fehlgeschlagen.
🔔 Schritt 6: Benachrichtigungen einrichten +

Gehe zu Settings → Notifications und richte einen Kanal ein:

Telegram (empfohlen)

  1. Erstelle einen Bot via @BotFather
  2. Kopiere den Bot Token
  3. Starte Chat mit dem Bot
  4. Hole deine Chat ID (via @userinfobot)
  5. Trage beides in Uptime Kuma ein

E-Mail (SMTP)

  1. SMTP-Server eintragen
  2. Port (587 oder 465)
  3. Benutzername und Passwort
  4. Absender und Empfaenger-Adresse

Weitere Optionen

Discord, Slack, Matrix, Gotify, Pushover, ntfy, Webhook, und 80+ weitere...

✅

Test nicht vergessen

Nach dem Einrichten: Klicke auf "Test" um sicherzustellen dass Benachrichtigungen ankommen.
📄 Schritt 7: Status-Seite erstellen +

Erstelle eine oeffentliche Status-Seite fuer deine Nutzer:

  1. Gehe zu Status Pages im Menue
  2. Klicke New Status Page
  3. Vergib einen Namen und Slug (URL-Pfad)
  4. Fuege Monitore hinzu die angezeigt werden sollen
  5. Optional: Logo, Beschreibung, Custom CSS

Status-Seiten Features

  • • Gruppen fuer verschiedene Service-Kategorien
  • • Uptime-Prozent der letzten 24h/7d/30d
  • • Incident-Historie
  • • Geplante Wartungen ankuendigen
  • • Domain-Mapping moeglich
💡

Vertrauensbildung

Eine Status-Seite zeigt Professionalitaet und spart Support-Anfragen. Kunden sehen selbst ob ein Problem bekannt ist.
📁 Schritt 8: Monitoring-Gruppen +

Organisiere deine Monitore in Gruppen fuer besseren Ueberblick:

  1. Klicke auf Add New Monitor
  2. Waehle als Typ Group
  3. Vergib einen Namen (z.B. "Produktiv-Server")
  4. Ziehe bestehende Monitore per Drag & Drop in die Gruppe

Sinnvolle Gruppierung

  • • Nach Umgebung: Produktion, Staging, Dev
  • • Nach Service: Web, Mail, Datenbank
  • • Nach Kunde: Kunde A, Kunde B, Intern
  • • Nach Wichtigkeit: Kritisch, Normal, Nice-to-have
💡 Schritt 9: Best Practices +

Tipps fuer effektives Monitoring:

Do's

  • ✓ SSL-Ablauf ueberwachen (mindestens 14 Tage vorher warnen)
  • ✓ Retries nutzen (3x fehlgeschlagen = echter Ausfall)
  • ✓ Keyword-Check fuer wichtige Seiten
  • ✓ Push-Monitoring fuer Backup-Jobs
  • ✓ Status-Seite fuer Kunden einrichten

Don'ts

  • ✗ Zu kurze Intervalle (unter 30 Sekunden)
  • ✗ Zu viele Benachrichtigungen (Alert Fatigue)
  • ✗ Monitoring ohne Backup-Check von extern
  • ✗ Nur HTTP Status pruefen (auch Inhalt checken)
⚠️

Monitoring das Monitoring

Uptime Kuma selbst sollte von extern ueberwacht werden. Wenn der Server ausfaellt, faellt auch das Monitoring aus!

Haeufige Fragen

Wie viel Ressourcen braucht Uptime Kuma? ▸
Sehr wenig. Fuer 50 Monitore reichen 256MB RAM und minimale CPU. Kann problemlos auf einem Raspberry Pi laufen.
Kann ich Uptime Kuma hinter einem Reverse Proxy betreiben? ▸
Ja! Nginx, Traefik, Caddy - alle funktionieren. WebSocket-Support muss aktiviert sein fuer Live-Updates im Dashboard.
Wie sichere ich meine Monitoring-Daten? ▸
Die SQLite-Datenbank liegt im data-Ordner. Einfach den Ordner sichern. Oder: Settings → Backup → Download Database.
Kann ich Monitore von anderen importieren? ▸
Ja, Uptime Kuma kann JSON-Backups importieren. Es gibt auch Community-Tools um von UptimeRobot und anderen zu migrieren.
← Zurueck: Warum Monitoring? Weiter: Monitoring mit n8n →