--- title: Homepage Dashboard type: systems status: degraded created: 2026-07-26 updated: 2026-10-20 verified_on: 2026-10-20 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 (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 | |---|---| | 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 Port 443 occupied by Traefik on CT201 — Tailscale uses port 8443 instead. ## 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, `/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.