homelab/uptime-kuma-setup.md

Uptime Kuma Setup Guide

Access Uptime Kuma at https://kuma.zea.lt (use Traefik auth: your-username / your-password).

Why Internal URLs?

Public URLs (https://zea.lt, etc.) are behind Traefik basic auth. Uptime Kuma's health checks get 401 Unauthorized when using those. Use internal container URLs instead—no auth, same reliability.

---

First-Time Setup

1. Open https://kuma.zea.lt
2. Create your Uptime Kuma admin account (username + password)
3. Click Add New Monitor for each service below

---

Recommended Monitors (Internal URLs – No Auth)

#	Monitor Name	Type	URL/Target	Heartbeat
1	Dashboard	HTTP(s)	http://dashboard:8080	60
2	Gitea	HTTP(s)	http://gitea:3000	60
3	Docker Registry	HTTP(s)	http://registry:5000	60
4	Drone CI	HTTP(s)	http://drone:80	60
5	CUPS Printer	HTTP(s)	http://cups:631	300
6	WOL API	HTTP(s)	http://host.docker.internal:5000/health	60
7	Pi-hole DNS	TCP Port	host.docker.internal / 53	60
8	Traefik HTTP	TCP Port	traefik / 80	60
9	Traefik HTTPS	TCP Port	traefik / 443	60
10	HomeLab Server	Ping	192.168.1.100	60
11	Desktop PC	Ping	192.168.1.10	60

Note: For TCP Port monitors (#8, #9), use Monitor Type: TCP Port, Host: traefik, Port: 80 or 443.

---

Step-by-Step (Add Monitor)

1. Click + Add New Monitor
2. Monitor Type: HTTP(s) (or TCP Port / Ping)
3. Friendly Name: e.g. "Gitea"
4. URL: e.g. http://gitea:3000
5. Heartbeat Interval: 60 (or 300 for CUPS)
6. Retries: 2
7. For HTTP(s): Accepted Status Codes 200–299 (default)
8. Click Save

---

Optional: Notifications

Settings → Notifications → Add:

• Email – for downtime alerts
• Telegram – if you use Telegram
• Webhook – for custom integrations