Home
DOCSight monitors your DOCSIS cable connection around the clock, detects problems before you notice them, and helps you build evidence when your ISP falls short.
| Your situation | Where to go |
|---|---|
| First time, just want it running | Quick Start -- 5 minutes with Docker |
| Need step-by-step for your platform | Installation -- Docker, Synology, Unraid, Podman, Portainer |
| No Docker / bare metal | Running without Docker |
| Want to try it first | docker run -d -p 8765:8765 -e DEMO_MODE=true ghcr.io/itsdnns/docsight:latest |
After setup: Configuration for fine-tuning, integrations, and admin password.
- Dashboard -- Live health assessment, metric cards, per-channel details
- Signal Trends -- Historical charts with DOCSIS reference zones
- Channel Timeline & Compare -- Per-channel history and multi-channel overlay
- Event Log -- Automatic anomaly detection (power drift, SNR drops, error spikes)
- Gaming Quality Index -- A-F grade for gaming readiness
- Incident Journal -- Track ISP issues with attachments and Excel/CSV import
- Correlation Analysis -- Signal, speed, and events on one timeline
- Filing a Complaint -- Generate ISP complaint letters with your data as evidence
- LLM Export -- Structured report for AI-assisted analysis
- Speedtest Tracker -- Speed test history alongside signal data (Setup)
- BNetzA Breitbandmessung -- Official German measurement protocols with legal weight
- ThinkBroadband BQM -- Daily quality graphs with calendar view
- Smokeping -- Live latency graphs from your Smokeping instance
- Home Assistant -- MQTT sensors with auto-discovery
- Backup & Restore -- Scheduled backups, one-click download, restore from setup wizard
- Demo Mode -- 9 months of realistic synthetic data for evaluation
"My internet is slow and I want proof" -- Start with Correlation Analysis, upload your BNetzA measurement, then file a complaint.
"I want my Home Assistant to know about my connection" -- See Home Assistant Integration for MQTT setup and sensor list.
"I game and want to know if my connection is stable" -- Check the Gaming Quality Index and Signal Trends for jitter and latency patterns.
- DOCSIS Glossary -- All terms explained in plain language
- Reference Values -- VFKD thresholds for power, SNR, and errors
- Bridge Mode Compatibility -- Modem access behind a separate router
- API Reference -- REST endpoints for automation
- Adding Modem Support -- Contribute a driver for your modem
- Contributing -- Development setup and guidelines
- Roadmap -- What's done, what's planned
DOCSight is open source (MIT) and runs entirely on your local network.