58 lines
2.2 KiB
Markdown
58 lines
2.2 KiB
Markdown
# 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
|