Demo mode and the public demo

What demo mode simulates, what it refuses, how to run it locally, and where the public demo lives.

Demo mode is a fully simulated kit: a software room with plants, climate and a ladder, no hardware and no LAN writes. The dashboard shows a Simulated room banner. Demo never starts ESPHome, MQTT, Zigbee, Bluetooth, Sonoff ingest, Tuya, camera capture or library updates; writes that would touch hardware are blocked and say so.

brain-demo.plausible-deniability.net runs the current release in demo mode. It reports the running brain's real version on About. Use it to learn the desks before your kit arrives.

The demo twin's replay has something to show: in demo mode only, the brain fills the last 48 hours once with a labelled synthetic day and then records the simulator as it runs. Replay is stamped SYNTHETIC · DEMO, never RECORDED.

On any machine with Python:

cd brain
python -m pip install -r requirements.txt
set DSC_DEMO_MODE=1
python -m dsc_brain.api

or with Docker: docker compose -f services/dsc-hub/docker-compose.demo.yml up -d --build and open port 8788.

If a kit's dashboard shows the simulated banner, the brain was started with demo mode on. Check the Pi's environment file and restart the brain. Nothing the demo shows is your room.

Guide contents  ·  Maintenance & updates  ·  Troubleshooting  ·  Digital Stealth Care

DSC-Brain user guide · Demo mode and the public demo · this page is edited on the site; the Notion original was retired after the mirror