# 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