Ga naar inhoud

📈 Uptime Kuma

Uptime Kuma is een self-hosted monitoring tool die de status van al je services bewaakt.

Algemene Info

Item Waarde
Container uptime-kuma
Image louislam/uptime-kuma:latest
Interne Poort 3001
URL status.hub
Status Page status.hub/status/hamming

Functies

  • ✅ HTTP(S) monitoring - Check of websites online zijn
  • ✅ TCP/Ping monitoring - Network services checken
  • ✅ Docker container monitoring - Container status
  • ✅ Notificaties - Alerts via Telegram, Discord, Email, etc.
  • ✅ Status page - Publieke status pagina
  • ✅ Certificaat monitoring - SSL certificaat expiratie

Geconfigureerde Monitors

Services (Mini PC 1)

Service Type URL/Host Interval
Pi-hole HTTP http://192.168.1.13:8080 60s
Homer HTTP http://192.168.1.13:8081 60s
Nginx Proxy Manager HTTP http://192.168.1.13:81 60s
Portainer HTTPS https://192.168.1.13:9443 60s
Guacamole HTTP http://192.168.1.13:8083 60s
Duplicati HTTP http://192.168.1.13:8200 60s
MkDocs HTTP http://192.168.1.13:8082 60s

Netwerk Apparatuur

Apparaat Type Host Interval
UDM Pro Ping 192.168.1.1 60s
Synology NAS HTTP http://192.168.1.12:5000 60s
Mini PC 2 (Proxmox) HTTPS https://192.168.1.14:8006 60s

Smart Home (VLAN 20)

Service Type Host Interval
Home Assistant HTTP http://192.168.20.10:8123 60s

Monitor Toevoegen

  1. Ga naar status.hub
  2. Klik op Add New Monitor
  3. Vul in:
  4. Monitor Type: HTTP(s), TCP, Ping, etc.
  5. Friendly Name: Naam voor display
  6. URL/Host: Het te monitoren adres
  7. Heartbeat Interval: Check frequentie (standaard 60s)
  8. Klik Save

Monitor Types

Type Gebruik voor
HTTP(s) Websites, API's, web interfaces
TCP Port Specifieke poorten checken
Ping Network apparaten
DNS DNS server responses
Docker Container status (via socket)
Push Externe services die zelf pushen

Notificaties Instellen

Telegram Bot

  1. Maak een bot via @BotFather
  2. Noteer de Bot Token
  3. Start een chat met je bot
  4. Haal je Chat ID op via https://api.telegram.org/bot<TOKEN>/getUpdates
  5. In Uptime Kuma: Settings → Notifications → Add → Telegram
  6. Vul Bot Token en Chat ID in
  7. Test de notificatie

Discord Webhook

  1. Discord Server Settings → Integrations → Webhooks
  2. Maak nieuwe webhook en kopieer URL
  3. In Uptime Kuma: Settings → Notifications → Add → Discord
  4. Plak Webhook URL
  5. Test de notificatie

Status Page

De publieke status pagina toont de status van alle services zonder login.

URL: status.hub/status/hamming

Status Page Aanpassen

  1. Ga naar Status Pages in de zijbalk
  2. Klik op je status page
  3. Pas aan:
  4. Titel en beschrijving
  5. Welke monitors getoond worden
  6. Groepen en volgorde
  7. Custom CSS/Branding

Troubleshooting

Monitor altijd DOWN

Symptomen

  • Monitor toont constant DOWN
  • Service werkt wel in browser

Mogelijke oorzaken:

  1. Verkeerde URL/poort: 

    # Check of service bereikbaar is
curl -I http://192.168.1.13:8080

  2. SSL certificaat problemen:

  3. Bij self-signed certs: zet "Accept Invalid Certs" aan

  4. Firewall blokkade:

  5. Check of Uptime Kuma bij de service kan

Te veel false positives

Korte onderbrekingen

Oplossing:

  1. Verhoog Retries (bijv. 3)
  2. Verhoog Retry Interval (bijv. 60s)
  3. Pas Heartbeat Interval aan

Notificaties komen niet aan

Checklist:

  1. Test de notificatie in Settings → Notifications
  2. Check API keys/tokens
  3. Check firewall voor uitgaand verkeer
  4. Bekijk Uptime Kuma logs: 
    docker logs uptime-kuma

Maintenance Mode

Om gepland onderhoud aan te kondigen zonder false alerts:

  1. Klik op een monitor
  2. Klik Maintenance
  3. Stel in:
  4. Start/eind tijd
  5. Beschrijving
  6. Tijdens maintenance: geen alerts

Docker Compose

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

Backup

Uptime Kuma data wordt gebackupt via Duplicati (onderdeel van ~/docker backup).

Handmatige export: 1. Settings → Backup → Export 2. Download JSON backup bestand

Gerelateerd