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. It is a self-hosted evidence system first, not just another dashboard, with live diagnostics, long-term trends, incident documentation, and complaint-ready workflows.
Self-hosted • Demo mode • Complaint-ready exports • 16 modem families • Home Assistant + MQTT • MIT licensed
| 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 |
| Want the latest packaged version | Releases |
After setup: Configuration for fine-tuning, integrations, and admin password.
- Dashboard -- Mobile-first PWA with hero card, health rings, metric cards, and responsive channel tables
- Connection Monitor -- Always-on latency, packet loss, outage tracking, and traceroute burst capture with ICMP or TCP probes, sample aggregation, and pinned days
- Signal Trends -- Historical charts with DOCSIS reference zones
- Before/After Comparison -- Side-by-side period comparison with presets, deltas, and health distribution
- Channel Timeline & Compare -- Per-channel history and multi-channel overlay with URL-persistent state
- Event Log -- Automatic anomaly detection (power drift, SNR drops, error spikes, modem restarts)
- Smart Capture -- Auto-triggers speedtests on signal degradation events
- Gaming Quality Index -- A-F grade for gaming readiness
- Modulation Performance -- Per-protocol-group health index with intraday channel drill-down
- Cable Segment Utilization -- FRITZ!Box cable segment load monitoring with correlation integration
- In-App Glossary -- Contextual DOCSIS terminology help
- 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, including active comparison results
- LLM Export -- Structured report for AI-assisted analysis
- Speedtest Tracker -- Speed test history alongside signal data with manual trigger button (Setup)
- BNetzA Breitbandmessung -- Official German measurement protocols with legal weight
- ThinkBroadband BQM -- Native interactive charts from daily CSV data with calendar view
- Smokeping -- Live latency graphs from your Smokeping instance
- Weather -- Weather data overlay for signal correlation
- Home Assistant -- MQTT sensors with auto-discovery
-
Prometheus Metrics -- Native
/metricsendpoint for Prometheus and Grafana
- Module System -- Modular architecture with enable/disable, theme modules, community modules via volume mount, build your own
- Themes -- Switchable UI themes (Classic, Ocean, Tribu) with live preview. Community themes supported.
- Backup & Restore -- Scheduled backups, one-click download, restore from setup wizard
- Demo Mode -- 9 months of realistic synthetic data for evaluation
DOCSight supports 16 modem types across multiple manufacturers. Select your modem in the setup wizard or set MODEM_TYPE in your environment. See Configuration for details.
| Manufacturer | Models | DOCSIS |
|---|---|---|
| AVM | FRITZ!Box Cable | 3.0 / 3.1 |
| Arris/CommScope | SURFboard S33, S34, SB8200, CM8200A, CM3500B, SB6141, SB6190 | 3.0 / 3.1 |
| Technicolor | TC4400, CGM4981COM (Cox) | 3.1 |
| Compal | CH7465 Connect Box, CH7465 Play/UPC | 3.0 |
| Sagemcom | F@st 3896 (Tele2, DNA, Ziggo) | 3.0 / 3.1 |
| Vodafone | Station CGA/TG, Ultra Hub 7 | 3.0 / 3.1 |
| Hitron | CODA-56 | 3.1 |
| Netgear | CM3000 | 3.1 |
Your modem not listed? See Requesting Modem Support.
"My internet is slow and I want proof" -- Start with Before/After Comparison or 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.
"I want to see real DOCSight setups before I deploy" -- Start with Show and tell and the thread Share your DOCSight setup and what it helped you prove.
| Need | Best place |
|---|---|
| Setup help and troubleshooting | GitHub Discussions: Q&A |
| Feature ideas and roadmap feedback | GitHub Discussions: Ideas |
| Share your setup, exports, or evidence workflow | GitHub Discussions: Show and tell |
| Confirmed bugs and regressions | Bug report issue form |
| New modem support requests | Modem support request form |
| Security vulnerabilities | Private security advisory |
Useful starting points:
- Where to ask what in DOCSight -- Maintainer routing guide for support, ideas, bug reports, and security
- Share your DOCSight setup and what it helped you prove -- Real-world setups, dashboards, exports, and evidence workflows
- Community Apps -- Third-party apps built on DOCSight (DOCSIOS for iOS/iPadOS)
- 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
- Building Modules -- Build and share your own DOCSight modules
- Adding Modem Support -- Contribute a driver for your modem
- Translating -- Add or improve language translations
- Contributing -- Development setup and guidelines
- Roadmap -- What's done, what's planned
DOCSight is open source (MIT) and runs entirely on your local network. It works offline as a PWA -- no cloud dependency.