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.

The logo / image didn't update on GitHub

GitHub caches images via its camo proxy and serves the old file from the same URL. The fix is to change the file's URL (we renamed logo.png → logo-glance.png). If you still see the old one, hard-refresh your browser.

Add-on build fails: "base name (${BUILD_FROM}) should not be blank"

ARG BUILD_FROM must be declared before the first FROM in the Dockerfile (global scope) so the runtime stage can use it. This is fixed in current versions.

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.

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.