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. The mobile-first PWA interface with themeable design works on any device -- install it to your home screen for instant access, even offline.
| 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 -- Mobile-first PWA with hero card, health rings, metric cards, and responsive channel tables
- Connection Monitor -- Always-on latency, packet loss, and outage tracking 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)
- 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 (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
- 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 15 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 | 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.
- 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.