--- title: Homepage Dashboard type: systems status: degraded created: 2026-07-26 updated: 2026-10-30 verified_on: 2026-10-30 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 (re-verified 2026-10-30) ``` 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) — HOST process, proxies 8085 → 8082, currently 502 ├── manager.py (python3) — runs INSIDE the homepage-manager container (see below) └── 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. > **Corrected 2026-10-30:** the old diagram implied `manager.py` also ran directly on the CT201 host. > Live `docker inspect homepage-manager` shows its command is > `["sh","-c","pip install --quiet --no-cache-dir PyYAML && python3 /opt/homepage/manager.py"]` > with `/opt/homepage` bind-mounted — so **`manager.py` runs inside the `homepage-manager` container** > (`MANAGER_PORT=8084`). Only **`asset_proxy.py` is a host process**: live `ss -ltnp` on CT201 shows > `0.0.0.0:8085 users:(("python3",pid=4038))` — a bare `/usr/bin/python3 /opt/homepage/asset_proxy.py` > with no container owning it. The host-side `:8084` listener is `docker-proxy`, not python. ## Tabs > **Re-verified 2026-10-30 against the live manager API** (`GET http://127.0.0.1:8084/api/groups` on CT201), > the served `/dash.js` and the served `/dash.css`. The old table below was wrong in several ways — the > live **tab bar is built from the service *groups*** (`renderTabs()` in `dash.js` iterates `state.groups`), > not from the `layout:` block in `settings.yaml`. That `layout:` block — and its `tab:`/`columns:` keys — > is **inert**: `grep -c "Overview" /dash.js` returns **0**, and `grep -c "columns" /dash.js` returns **0**. > There is **no "Overview" tab** and the `columns: N` values are never read. The live tab bar is: **`☆ Pinned`**, **`All (123)`**, then the **14 service groups** in order — each with a live count badge: | Tab | Live count | Apps | |---|---|---| | ☆ Pinned | — | pinned apps only (19 pinned in `dash_prefs.json`) | | All (123) | 123 | every app, deduped by `(name, normalised href)` — **corrected from 114** | | AI Quotas | 3 | Claude, Codex, Ollama | | Infrastructure | 13 | Gitea, Grafana, Guacamole, LAN watcher, PVE, Portainer docker, Portainer openweb, Runtipi, SFTPGO, Syncthing Runtipi, Theme Studio, cloudreve, filebrowser runtipi | | Everyday | 8 | Homelab dashboard, Investbrain, Linkwarden, Mealie, NextCloud, cardholder, homebox, read later | | Agents | 20 | AISBF Dashboard, Agent Dashboard, Agent zero, Camofox VNC chaos, Camofox VNC rhino, Chaos webUI, Herdr omarchy, Hermes Control, Hermes web UI (rhino), Hindsight chaos, Honcho memory dashboard, Mausbot ×2, Octoagent, PAN Hermes, Zeroclaw dash, herdr omarchybook, hermes desktop rhino, hermes workspace, nanobot dashboard | | Media | 11 | Audio bookshelf, Flaresolverr, FreshRSS, Jellyfin, MeTube, NewsKu, Prowlarr, RSS-Bridge, Transmission, YouTube, qBitTorrent | | AI & LLM | 17 | Agent estate wiki, Cliproxy api, FreeLLMAPI, Khoj ADMIN, Khoj SH, LiteLLM, Lobe chat (docker), Manifest router, Omniroute gateway, Opencode server, Openweb, Reasonix, Searxng, Simple chat ai, Vercel ai cloud, Voice Studio, World monitor | | Tools | 20 | 8mb video compression, Cobalt, Convert to it, Cyber chef, Dockage, Element synapse, Excaldraw, IT tools, Matermost, Quiet thanks, Retroarch, Social dashboard (communities), Stirling PDF, Subscription tracker, T3 code frontend, Wordpress, code-server debian, compose craft, convert anything?, subtitle generator | | Storage | 6 | Obsidian agent vault, filebrowser Debby, filebrowser DebianVM, filebrowser DebianVM NEW, filebrowser Docker, guacano | | More | 13 | Cloudfare apps, GitHub, Kubuntu desktop, N8n, Next step, Omni tools, Reactive resume, Sunshine Ubuntu's-server, Yeah koko tts, hermes desktop, hermes desktop chaos, home assistant, jupyter server | | Resources | 6 | Communities reporting - socials, Dashboard Manager, Helper Scripts, Homelab Docs, RADAR, Self-Hosted Directory | | System Health | 0 | *empty* — the tab renders but holds no app cards (the health panel is separate, widget-driven) | | Subscriptions | 1 | Renewals | | Quick Launch | 2 | Paseo, Portainer | | Uncategorised | 3 | Hermes desktop ui, Openchamber, Vaultwarden | **App-count reconciliation (two different numbers, both correct in context):** - **123** — the live count the UI shows on the `All (123)` tab. `get_all_apps_flat()` walks every group except `All Apps` and `AI Quotas & Rate Limits`, then **dedupes by `(name, normalised href)`** — so an app defined in two groups collapses to one card (e.g. `Mausbot` appears in both `Agents` and `Tools`). - **122** — the literal `All Apps` group in `/opt/homepage/config/services.yaml`, a generated roll-up that is **not** what the tab bar counts. The old page's "114" was simply wrong. **Grid layout (corrected):** the served `/dash.css` (385 121 bytes, = `/opt/homepage/config/dashboard.css`) sets `.app-grid` at **line 3640** to `grid-template-columns: repeat(auto-fill, minmax(230px, 1fr))` — a **responsive auto-fill**, not a fixed 5-column grid. Narrower breakpoints override it to `repeat(auto-fill, minmax(160px, 1fr))` (line 5001) and then `1fr 1fr` (line 5010). The `columns:` figures in `settings.yaml` are dead config. ## 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 - **Corrected 2026-10-30:** the live saved theme is **`{"pair":"Boarding Pass","mode":"light"}`** — read from `/opt/homepage/config/dash_prefs.json` key `dash.theme`. The previous "Dark base with warm amber (#d4a04a) accents" claim is **wrong on both counts**: the mode is **light**, not dark, and `#d4a04a` is not this theme's amber at all. **Boarding Pass** (`chassis: boarding`, "Boarding pass desk — perforated stubs, gate codes, seat and route labels") is one of **59 theme pairs** in `/opt/homepage/config/themes.json` under `dashboard.pairs`; in its **light** mode the amber accent is **`#795000`** (dark mode would be `#f5c96a`). The dashboard also ships 26 legacy `homepage:` themes (`obsidian-midnight`, `nord-frost`, `cyberpunk-terminal`, …) and three saved `custom:` themes in `dash.customThemes` (E2E Test Theme, Whiteboard Ops 1, Evidence Wall 1), each with its own chassis and palette. - 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 **process** runs on CT201 (`ps aux` returns nothing for `traefik`), and `ss -ltnp` shows `tailscaled` bound to `100.96.244.39:443`. Corrected on 2026-10-25. > **Evidence corrected 2026-10-30:** the old wording said `docker ps -a` "returns nothing for > `traefik`". That was **not accurate** — live `docker ps -a` on CT201 does list > `runtipi-reverse-proxy | traefik:v3.2 | Exited (255) 2 months ago`. The **conclusion is unchanged** > (Traefik is not running and does not occupy 443; `tailscaled` is bound to `100.96.244.39:443`), > but the container is *stopped*, not absent. ## 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 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 **process** runs on CT201 (the `runtipi-reverse-proxy` Traefik container exists but is **stopped** — `Exited (255) 2 months ago` — re-verified 2026-10-30), 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