Initial homelab infrastructure

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-13 19:41:46 +02:00
commit 5014d55d62
31 changed files with 1594 additions and 0 deletions
@@ -0,0 +1,57 @@
+# 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