DSC-BRAIN USER GUIDE · REFERENCE

Addresses, ports and services

The Pi services and ports, the useful endpoints, and the file paths a maintainer needs. Shipped addresses and hotspot details are on the kit card, not on this page.

●  verified for 9.0.0 · firmware train 8.2.0.0

●  last verified 2026-09-17 · mirrored 2026-09-15

The kit's dashboard address, mDNS name, hotspot name and passphrase are printed on the kit card that ships with it and shown under Settings › Network on your own kit. They are deliberately not published here.

Addresses

  • Dashboard on the LAN: the kit's mDNS name (or the Pi's LAN IP) on port 8787.
  • Dashboard on the Pi hotspot: the hotspot address on the kit card, port 8787.
  • ESPHome dashboard: the same host on port 6052.
  • Hub setup portal: on the hub's own DSC-Setup-XXXX hotspot, at the address the portal prints on the panel.
  • Public demo: brain-demo.plausible-deniability.net.

Pi services

Service Port Role
brain (dsc-hub-brain) 8787 API + dashboard, fleet and settings
cannalib sidecar (optional, compose profile thin-catalog) 8790 (on the Pi only) Offline strain catalog (read-only; plants only)
mosquitto 1883 Internal MQTT (Zigbee2MQTT, the Bluetooth gateway and brain)
zigbee2mqtt — SkyConnect coordinator
ble (dsc-hub-ble) — Bluetooth LE gateway: listens on the Pi's Bluetooth radio and passes decoded sensors to the brain over MQTT
dsc-esphome-dashboard (host unit) 6052 Firmware compile, OTA, logs
Tuya devices 6668 on each device Local control

Useful endpoints

  • GET /health (also answers HEAD) — brain health (use it for an uptime monitor); mode=demo in demo mode.
  • GET /fleet — the raw fleet snapshot; GET /fleet/computed — the dashboard's computed view.
  • GET /docs — the brain's API browser.
  • GET /ingest/cadence — the poll-rate ladder, your pinned rates and what the brain is polling per device right now.
  • /ws/fleet on port 8787 (WebSocket) — live fleet updates.

Paths on the Pi

Path What
/opt/dsc-hub/ Compose file, .env, pi/ scripts, firmware/v4/secrets.yaml
/var/lib/dsc-hub/ Data: brain database, journals, media, camera frames, z2m/, cannalib/, ops/libs/ (DSC-KitLib and DSC-NuteLib files, current and previous)
/opt/dsc-esphome-venv/ The ESPHome toolchain (user dsc)
/etc/dsc-hub/dnsmasq.conf Fleet DHCP reservations on the hotspot

Pi user is dsc. Prefer docker stop -t 20 + docker start over restart.

Guide contents  ·  Reference  ·  Troubleshooting  ·  Digital Stealth Care

DSC-Brain user guide · Addresses, ports and services · this page is edited on the site; the Notion original was retired after the mirror