wiki: publish pending edits (2026-10-20)
This commit is contained in:
@@ -1,9 +1,10 @@
|
||||
---
|
||||
title: Homepage Dashboard
|
||||
type: systems
|
||||
status: active
|
||||
status: degraded
|
||||
created: 2026-07-26
|
||||
updated: 2026-07-26
|
||||
updated: 2026-10-20
|
||||
verified_on: 2026-10-20
|
||||
confidence: high
|
||||
tags: [dashboard, homepage, homelab, proxmox, monitoring]
|
||||
---
|
||||
@@ -13,18 +14,35 @@ tags: [dashboard, homepage, homelab, proxmox, monitoring]
|
||||
## Purpose
|
||||
Central dashboard for all homelab services, with Proxmox integration, per-VM stats, and a management UI.
|
||||
|
||||
## URLs
|
||||
- **Tailscale:** `https://runtipi.kangaroo-eel.ts.net:8443/`
|
||||
- **Local:** `http://runtipi.kangaroo-eel.ts.net:8082/`
|
||||
- **Manager UI:** `http://runtipi.kangaroo-eel.ts.net:8084/`
|
||||
## ⚠ Status: DEGRADED (verified 2026-10-20)
|
||||
The stock **`homepage` container is not running** on CT201. Only `homepage-manager` (port 8084)
|
||||
and `homebox` are up; `homebridge` exited two months ago. **Port 8082 has no listener**, and the
|
||||
`asset_proxy.py` front door on port 8085 proxies to 8082 — so it answers **502 Connection refused**.
|
||||
|
||||
## Architecture
|
||||
The dashboard that *is* live and serving **200** is **Homarr** on port **8102**
|
||||
(`homar.martinwa.org` in the Cloudflare tunnel ingress, and `homarr` in the Runtipi app list).
|
||||
The dashboard content itself is now **custom Python tooling** under `/opt/homepage/`
|
||||
(`manager.py`, `asset_proxy.py`, `dashboard.html/js/css`), not the upstream Homepage image.
|
||||
|
||||
**Two independent dashboards are therefore in play — do not assume "the dashboard" means Homepage.**
|
||||
|
||||
## URLs
|
||||
- **Homarr (live, 200):** `http://100.96.244.39:8102/` — public via `https://homar.martinwa.org`
|
||||
- **Tailscale:** `https://runtipi.kangaroo-eel.ts.net:8443/` → proxies to 8085 → **currently 502**
|
||||
- **Local:** `http://100.96.244.39:8082/` → **no listener**
|
||||
- **Manager UI:** `http://runtipi.kangaroo-eel.ts.net:8084/` → `homepage-manager`, up
|
||||
|
||||
## Architecture (verified 2026-10-20)
|
||||
```
|
||||
CT201 (runtipi)
|
||||
├── Homepage container (port 8082) — main dashboard
|
||||
├── Manager container (port 8084) — web UI for adding/removing apps
|
||||
└── Tailscale serve (port 8443) — HTTPS proxy to Homepage
|
||||
├── homarr container (port 8102) — live dashboard, HTTP 200
|
||||
├── homepage-manager container (8084) — web UI for adding/removing apps, up
|
||||
├── homebox container (7745) — up
|
||||
├── asset_proxy.py (python3, port 8085) — proxies 8085 → 8082, currently 502
|
||||
├── manager.py (python3) — dashboard management service, up
|
||||
└── Tailscale serve (port 8443) — / → 8085, /mgr → 8084, /steel → 5173, /steel-api → 3000
|
||||
```
|
||||
No container is listening on **8082** — `docker ps` on CT201 lists no `homepage` container at all.
|
||||
|
||||
## Tabs
|
||||
| Tab | Content |
|
||||
@@ -44,39 +62,43 @@ CT201 (runtipi)
|
||||
- **proxmox.yaml:** Config at `/opt/homepage/config/proxmox.yaml`
|
||||
|
||||
### VM/LXC Mapping
|
||||
| Service | VMID | Type |
|
||||
|---|---|---|
|
||||
| PVE | (node) | — |
|
||||
| Portainer docker | 200 | lxc |
|
||||
| Portainer debianVM | 101 | qemu |
|
||||
| Portainer openweb | 245 | lxc |
|
||||
> **Two Proxmox hosts exist and guest IDs collide** — always qualify with a host.
|
||||
> `ct460` = PVE `100.96.100.82`; `m93p` = PVE `100.104.51.98`. The mapping below was re-read from
|
||||
> `pct list` on **both** hosts on 2026-10-20; several rows previously listed bare IDs now live on
|
||||
> `m93p`, and one row no longer exists at all.
|
||||
|
||||
| Service | Host | VMID | Type | Live state |
|
||||
|---|---|---|---|---|
|
||||
| PVE | both | (node) | — | — |
|
||||
| Portainer docker | ct460 | 200 | lxc | running (8000, 9443) |
|
||||
| Portainer debianVM | ct460 | 101 | qemu | running |
|
||||
| Portainer openweb | **m93p** | 245 | lxc | running |
|
||||
| Runtipi | ct460 | 201 | lxc | running |
|
||||
| Gitea | **m93p** | 221 | lxc | running |
|
||||
| FreshRSS | **m93p** | **1260** | lxc | running |
|
||||
| NextCloud | ct460 | 270 | lxc | running |
|
||||
| LiteLLM | **m93p** | 500 | lxc | running |
|
||||
| OmniRoute | ct460 | 600 | lxc | running (also `Omniroute:20128` on m93p 101) |
|
||||
| Ntfy | **m93p** | **1241** | lxc | running |
|
||||
| Home Assistant | ct460 | 100 | qemu | running |
|
||||
| N8n | ct460 | 215 | lxc | running |
|
||||
| Mattermost | ct460 | 255 | lxc | **stopped** |
|
||||
| SFTPGo | ct460 | 299 | lxc | running |
|
||||
| Cliproxy API | ct460 | 103 | lxc | running |
|
||||
| OpenClaw | — | — | qemu | **absent — no VM 403 on either host** |
|
||||
| Zeroclaw | ct460 | 333 | lxc | running |
|
||||
| Hermes | ct460 | 460 | lxc | running |
|
||||
| Hindsight | ct460 | 450 | lxc | running |
|
||||
|
||||
> Portainer on CT245 (`openweb.kangaroo-eel.ts.net:9443`) now uses a Tailscale/Let's Encrypt cert (installed 2026-08-09). Files: `/root/portainer-certs/portainer.{crt,key}` mounted into the container, `--sslcert/--sslkey`. Renewal: `/root/renew-portainer-cert.sh` via crontab (04:00 on the 1st monthly) — `tailscale cert --min-validity=20d` then `docker restart portainer`. Cert validity ~90 days.
|
||||
| Runtipi | 201 | lxc |
|
||||
| Gitea | 221 | lxc |
|
||||
| FreshRSS | 260 | lxc |
|
||||
| NextCloud | 270 | lxc |
|
||||
| LiteLLM | 500 | lxc |
|
||||
| OmniRoute | 600 | lxc |
|
||||
| Ntfy | 241 | lxc |
|
||||
| Home Assistant | 100 | qemu |
|
||||
| N8n | 215 | lxc |
|
||||
| Mattermost | 255 | lxc |
|
||||
| SFTPGo | 299 | lxc |
|
||||
| Cliproxy API | 103 | lxc |
|
||||
| OpenClaw | 403 | qemu |
|
||||
| Zeroclaw | 333 | lxc |
|
||||
| Hermes | 460 | lxc |
|
||||
| Hindsight | 450 | lxc |
|
||||
|
||||
## Configuration Files
|
||||
All at `/opt/homepage/config/` on CT201:
|
||||
- `services.yaml` — All apps, groups, and Proxmox mappings
|
||||
- `settings.yaml` — Theme, layout, tabs
|
||||
- `custom.css` — Warm amber accent overrides
|
||||
- `widgets.yaml` — System health, clock
|
||||
- `proxmox.yaml` — PVE API token
|
||||
- `docker.yaml` — Docker socket integration
|
||||
`/opt/homepage/` on CT201 now holds **custom Python tooling**, not the upstream Homepage bundle:
|
||||
- `manager.py` — dashboard management service (running)
|
||||
- `asset_proxy.py` — port 8085 → 8082 front door (running, currently 502 upstream)
|
||||
- `dashboard.html` / `dashboard.js` / `dashboard.css` — the custom dashboard frontend
|
||||
- `config/` — legacy Homepage config directory (still present, upstream `homepage` container not running)
|
||||
- `manager.py.bak.*` — a long tail of dated manager backups (brand, chat2, cookie, hp, motion, owtools …)
|
||||
|
||||
## Manager UI
|
||||
Web form at port 8084 for adding/removing apps without SSH.
|
||||
@@ -96,7 +118,15 @@ Type anywhere on the dashboard to search services by name/description. Google se
|
||||
Port 443 occupied by Traefik on CT201 — Tailscale uses port 8443 instead.
|
||||
|
||||
## Maintenance
|
||||
- **Restart Homepage:** `docker restart homepage`
|
||||
- **Restart Manager:** `docker restart homepage-manager`
|
||||
- **Edit apps manually:** Edit `/opt/homepage/config/services.yaml` then restart
|
||||
- **Docker auto-discovery:** Add `homepage.group`, `homepage.name`, `homepage.href` labels to containers
|
||||
- **Restart Homarr:** `docker restart homarr`
|
||||
- **Restart the custom dashboard:** the `manager.py` / `asset_proxy.py` processes run directly on CT201
|
||||
(not in Docker) — restart via whatever supervises them; check `ps aux | grep -E 'manager.py|asset_proxy'`
|
||||
- **Recover the upstream Homepage (8082):** the image `ghcr.io/gethomepage/homepage` is still present on
|
||||
CT201 (4 months old) but no container uses it — recreate it to restore 8082 and the 8085 proxy path
|
||||
- **Tailscale serve on CT201:** `/` → 8085, `/mgr` → 8084, `/steel` → 5173, `/steel-api` → 3000
|
||||
|
||||
## Recent Changes
|
||||
- **2026-10-20 (live probe):** `homepage` container absent, 8082 dead, 8085 → 502, Homarr on 8102 → 200.
|
||||
Status changed `active` → `degraded`. VM/LXC table re-read from both PVE hosts; corrected IDs and
|
||||
host assignments, dropped the non-existent OpenClaw VM 403, marked Mattermost CT255 stopped.
|
||||
|
||||
Reference in New Issue
Block a user