Features Demo Mode

Demo Mode

Demo Mode lets you explore the full DOCSight dashboard without a real cable modem. It generates 9 months of realistic DOCSIS data so you can evaluate the UI, test integrations, or use it for development.

Quick Start

docker run -d --name docsight-demo -p 8765:8765 -e DEMO_MODE=true ghcr.io/itsdnns/docsight:latest

Open http://localhost:8765. No setup wizard, no credentials needed.

What Gets Generated

Demo Mode seeds the database with comprehensive synthetic data on first start:

Signal Data (270 days, 15-min intervals)

• 25 downstream + 4 upstream channels (DOCSIS 3.0 + 3.1 mix)
• Diurnal cycle: Power drifts by about 0.5 dBmV over 12-hour periods (simulating temperature effects on cable attenuation)
• Seasonal drift: Slow 0.3 dBmV variation over ~45-day cycles
• Bad periods: Every 10 days, a 2-8 AM window with SNR drops (2-5 dB), elevated power, and uncorrectable error spikes
• Error accumulation: Correctable errors grow slowly (0-5 per poll), uncorrectable errors are rare (2% chance per poll) but spike during bad periods

Speedtest Results (~600 results over 270 days)

About 3 tests per day with realistic patterns:

• Normal: 220-265 Mbps download, 35-42 Mbps upload, 8-15 ms ping
• Bad periods: 150-200 Mbps download, 15-35 ms ping
• Server rotation: Results cycle through 3 Ookla servers

BNetzA Campaigns (9 campaigns)

Monthly measurement campaigns over 270 days. 3 campaigns intentionally show "deviation" verdicts (download below 200 Mbps, upload below 30 Mbps) to demonstrate the complaint workflow.

Incident Journal (12 entries, 3 incident groups)

Pre-written entries covering common scenarios: initial setup notes, seasonal drift observations, ISP upgrade, channel drops, noise issues, maintenance windows, firmware updates, speed complaints. Organized into 3 incident containers ("Seasonal Signal Drift", "Upstream Noise Issue", "Firmware Update Issues").

BQM Quality Graphs (30 days)

Procedurally generated PNG quality graphs with green/yellow/red latency bands.

Events (30+ entries)

Health changes, power shifts, SNR drops, channel changes, and error spikes spread across the 270-day history.

Integrations in Demo Mode

• MQTT: If configured, demo data is published to your broker with Home Assistant auto-discovery. Useful for testing HA dashboards.
• Speedtest/BQM/Smokeping: Simulated, no external services needed.
• All features work: Correlation Analysis, LLM Export, Filing a Complaint, Backup & Restore.

Device Info

The demo modem reports itself as:

Field	Value
Manufacturer	DOCSight
Model	Demo Router
Software	Demo v2.0
Connection	250/40 Mbit/s Cable

Switching to Real Monitoring

When you connect a real modem in Settings, demo data is kept separate (marked with is_demo=1 in the database). Use Settings > Purge Demo Data to clean it up, or call POST /api/demo/migrate to transition cleanly.