DSC-BRAIN USER GUIDE · REFERENCE

Addresses, ports and services

The Pi services and ports, the useful endpoints, and the on-kit folders an owner needs. Shipped addresses and hotspot details are on the kit card, not on this page.

●  verified for 9.0.0 · corrected for 9.8.0 on 2026-09-30

●  first mirrored 2026-09-15

On this page
  1. Addresses
  2. Pi services
  3. Useful endpoints
  4. Paths on the Pi

The kit's 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: dsc-brain-XXXX.local (or the Pi's LAN IP; cards made before 9.9.0 use dsc-brain.local) on port 8787.
  • Dashboard on the Pi hotspot: the hotspot address on the kit card (or 10.42.0.1), port 8787.
  • ESPHome dashboard: the same host on port 6052.
  • Hub factory setup portal (parked; a Pi kit is set up from the dashboard): on a factory-build hub's DSC-Setup-XXXX hotspot, browse to 192.168.4.1. An automatic pop-up is not guaranteed. A hub built for the Pi kit that cannot join the Pi's own Wi-Fi network, DSC-Brain-XXXX (XXXX is unique to your card; setup shows the full name. Cards made before 9.9.0 use DSC-Brain), opens DSC-HUB Fallback Hotspot with a captive portal at the same address, for recovery only.
  • Public demo: brain-demo.plausible-deniability.net.

Pi services

Port Service Role
1883 mosquitto Internal MQTT (Zigbee2MQTT, the Bluetooth gateway and brain)
6052 dsc-esphome-dashboard (host unit) Firmware compile, OTA, logs
6668 on each device Tuya devices Local control
8787 brain (dsc-hub-brain) API + dashboard, fleet and settings
8790 (on the Pi only) cannalib sidecar (optional, compose profile thin-catalog) Offline strain catalog (read-only; plants only)
— 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

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 and the firmware secrets file
/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