Files
agent-estate-wiki/systems/homepage-dashboard.md
T
Tony0410andHermes 677bb0c959 docs(wiki): correct Steel Browser references across 15 pages — Steel fully removed, Camofox is sole backend
Root cause of the long-standing cloud_provider: steel residue: the 2026-07-30
rollback disabled the browser-steel plugin and set browser.engine: camofox but
left browser.cloud_provider: steel in config.yaml. The split config was
inert-but-wrong, so it survived ~3 months of audits unnoticed.

Corrects pages that still described Steel as present, running or configured:
- systems/browser-backend.md (incl. gateway-restart env-var note)
- comparisons/steel-vs-camoufox.md, comparisons/camoufox-vs-chrome.md
- decisions/rollback-steel-to-camofox.md, decisions/index.md
- infrastructure/docker-services.md, infrastructure/tailscale.md, infrastructure/hosts.md
- systems/homepage-dashboard.md, systems/scheduled-tasks.md
- concepts/browser-automation.md, runbooks/recover-docker-service.md
- current-state.md, index.md, agents/nanobot.md
- log.md (dated entry; supersedes the 00:3x audit's 'endpoint dark' wording)

Also restores the Ignis compose row in infrastructure/docker-services.md, which
the 2026-10-11 revision dropped (verified: /home/hermes/docker/ignis/docker-compose.yml
exists and the ignis container is Up on CT460).

Co-Authored-By: Hermes <hermes@local>
2026-10-29 02:02:49 +08:00

154 lines
8.4 KiB
Markdown

---
title: Homepage Dashboard
type: systems
status: degraded
created: 2026-07-26
updated: 2026-10-29
verified_on: 2026-10-29
confidence: high
tags: [dashboard, homepage, homelab, proxmox, monitoring]
---
# Homepage Dashboard
## Purpose
Central dashboard for all homelab services, with Proxmox integration, per-VM stats, and a management UI.
## ⚠ 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**.
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)
├── 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 (ports 443 AND 8443) — / → 8085, /mgr → 8084 on both ports
(the former /steel and /steel-api routes were
removed 2026-10-29)
```
No container is listening on **8082** — `docker ps` on CT201 lists no `homepage` container at all.
## Tabs
| Tab | Content |
|---|---|
| Overview | Infrastructure (2 cols) + Everyday (4 cols) + Resources |
| Media | Jellyfin, arr stack, RSS |
| AI | OmniRoute, LiteLLM, Lobe Chat, SearXNG |
| Agents | Hermes, OpenClaw, Nanobot, Camofox |
| Tools | IT tools, Cyber Chef, etc. + Storage |
| More | Home Assistant, N8n, Jupyter |
| All Apps | 114 apps in 5-column grid (alphabetical) |
## Proxmox Integration
- **Node widget:** Shows live VM/LXC counts, CPU, memory for PVE node
- **Per-VM stats:** Click "View Proxmox stats" on mapped services
- **API token:** `homepage@pve!homepage` (privsep=0)
- **proxmox.yaml:** Config at `/opt/homepage/config/proxmox.yaml`
### VM/LXC Mapping
> **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.
## Configuration Files
`/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.
- **Add:** Name, Category (dropdown), URL, optional Icon
- **Delete:** Search apps, click Delete
- **Auto-restart:** Homepage restarts after each change
## Quick Launch Search
Type anywhere on the dashboard to search services by name/description. Google search disabled — only searches your apps.
## Theme
- Dark base with warm amber (#d4a04a) accents
- Bigger tiles (68px min-height, 40px icons)
- Custom CSS in `custom.css`
## Tailscale Serve
**CT201 serves Tailscale on BOTH `:443` and `:8443`** (verified live 2026-10-25 via `pct exec 201 -- tailscale serve status`).
The earlier note on this page — "Port 443 occupied by Traefik on CT201 — Tailscale uses port 8443 instead" — was **wrong**:
no Traefik container or process exists on CT201 (`docker ps -a` and `ps aux` both return nothing for `traefik`), and
`ss -ltnp` shows `tailscaled` bound to `100.96.244.39:443`. Corrected on 2026-10-25.
## Maintenance
- **Restart Manager:** `docker restart homepage-manager`
- **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 and `/mgr` → 8084 on **both** `:443` and `:8443`.
The former `/steel` (5173) and `/steel-api` (3000) routes were **deleted on 2026-10-29** when
Steel was removed from CT201 — there are no other paths. → [[infrastructure/tailscale]]
## Recent Changes
- **2026-10-29 (Steel removal):** the `/steel` (5173) and `/steel-api` (3000) Serve routes on CT201 were
**deleted** with `tailscale serve --set-path <path> off` when the Steel Browser deployment was removed.
CT201's remaining routes are only `/` → 8085 and `/mgr` → 8084 on both `:443` and `:8443`.
→ [[infrastructure/tailscale]], [[comparisons/steel-vs-camoufox]]
- **2026-10-25 (live probe, stocktake):** the "Port 443 occupied by Traefik on CT201" note was **false** — no Traefik
container or process exists on CT201, and `tailscaled` owns **both** `:443` and `:8443` there. Serve tables corrected:
`/` → 8085 and `/mgr` → 8084 on both ports *(the `/steel` and `/steel-api` routes listed at the time were
deleted on 2026-10-29 — see above)*. Re-confirmed live: 8084 → **200**, 8085 → **502**,
8082 → **no listener**, `homepage-manager` up. → [[infrastructure/tailscale]]
- **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.
## Related
- [[infrastructure/tailscale]] — Tailscale Serve routes on CT201 and CT460
- [[infrastructure/docker-services]] — container inventory for CT201 and CT333
- [[comparisons/steel-vs-camoufox]] — why the `/steel` routes were removed on 2026-10-29