Troubleshooting

Troubleshooting / FAQ

The sidebar still says "Dashboard", not "Glance"

The panel title is set in addon/config.yaml (panel_title: Glance), but HA registers the sidebar panel once and caches it. A config change won't show until the panel re-registers. Fix, in order — stop at the first that works:

1. Update the add-on to the latest version. If it still shows an old version, the new title isn't installed yet.
2. On the add-on's Info page, toggle "Show in sidebar" OFF, then ON.
3. Hard-refresh the browser (Cmd/Ctrl+Shift+R) — the sidebar is browser-cached.
4. Settings → System → Restart → Restart Home Assistant (Core restart).

"Add to Home Assistant" opened the store but didn't add anything

The button only opens the Add repository dialog (you still click Add), and on some HA/browser versions it just lands on the Add-on Store without the dialog. Use the manual steps in Installation.

Add-on install takes a long time

First install builds from source on your device (clones the repo + npm run build). Several minutes is normal; it needs internet access.

Can I run this without the add-on / Supervisor?

Yes — run it locally with npm run dev (see Installation Option 2). Add-ons require a Supervisor (HA OS or Supervised); HA Container/Core have no add-on store.

Where is my layout stored? Will I lose it on update?

• Local/dev: layouts.json at the project root.
• Add-on: /data/layouts.json (persistent — survives restarts and updates).

Back it up anytime via Settings → Dashboard data → Export layout. See Layout: Backup & Restore.

Is my token safe?

The token is stored only in the browser's localStorage. It is never written to disk by the add-on or baked into the image.

What happens if I set a direct port instead of Ingress-only?

You get a stable http://<ha-ip>:<port> URL that's great for kiosks/tablets, but that port has no Home Assistant login in front of it — anyone on your network who reaches it sees the dashboard UI. Your HA data is still protected by the token (a fresh device sees an unconfigured dashboard until a token is entered). Keep the port on your LAN only — don't expose it to the internet. Both Ingress and the direct port can run at once. See Installation → Ingress vs. direct port.

The dashboard can't connect to HA

The browser connects to HA directly over WebSocket. Make sure the Server URL you entered in Settings is reachable from the device viewing the dashboard, and that the long-lived token is valid. Use Test connection in Settings.