DSC-BRAIN USER GUIDE · TROUBLESHOOTING
Cannot reach the dashboard
Address checks, hotspot vs LAN, .local resolution, the two-minute restart window, and SSH checks.
● verified for 9.0.0 · firmware train 8.2.0.0
● last verified 2026-09-17 · mirrored 2026-09-15
Check the address
| You are on | Try |
|---|---|
| Home LAN, Pi on Ethernet | The mDNS name on the kit card with :8787, then the Pi's LAN IP with :8787 (find it on your router) |
| The Pi hotspot | The hotspot dashboard address printed on the kit card |
Some phones refuse .local names or fall back to mobile data on a hotspot with no internet. Use the IP form and turn mobile data off.
Timing
- A fresh card needs 3–5 minutes on first boot.
- Every brain restart (an update, a deploy) drops the hotspot briefly; fleet devices rejoin within about two minutes. Wait, then reload.
Still nothing
- Ethernet link light on the Pi? Power light steady?
- Over SSH (user
dsc):curl -s http://127.0.0.1:8787/healthshould answer. If not:docker psshould listdsc-hub-brain;docker logs --tail 100 dsc-hub-brainshows why it is not up. - If the container is up but the page is blank, hard-reload the browser (Ctrl+Shift+R); a stale bundle after an update is the usual cause.
The ESPHome dashboard instead
Port 6052 on the same host is a separate service; it answering while 8787 does not means the brain container is the problem, not the Pi.
DSC-Brain user guide · Cannot reach the dashboard · this page is edited on the site; the Notion original was retired after the mirror