Available in 🇬🇧 🇩🇪 🇪🇸 🇫🇷
Your cable internet is slow and your provider says everything is fine?
DOCSight proves them wrong.
DOCSight monitors your cable internet connection 24/7 and collects the hard evidence you need to hold your ISP accountable. One click generates a complaint letter with real data your provider can't ignore.
Built for cable internet (DOCSIS/coax) — also works with fiber, DSL, and satellite via Generic Router mode.
DOCSight = DOCSIS + Insight (+ a quiet sigh from every cable internet user)
docker run -d --name docsight -p 8765:8765 -v docsight_data:/data ghcr.io/itsdnns/docsight:latestOpen http://localhost:8765, enter your router login, done. Full installation guide → · Example Compose Stacks →
Want to try DOCSight without a real router? Demo mode generates realistic DOCSIS data so you can explore the full dashboard, trends, event log, and incident journal.
docker run -d --name docsight-demo -p 8765:8765 -e DEMO_MODE=true ghcr.io/itsdnns/docsight:latestOpen http://localhost:8765 — no setup required.
What you get:
- 25 downstream + 4 upstream channels with realistic signal values
- 9 months of historical data with diurnal and seasonal patterns
- Pre-populated event log, journal entries (12), incident groups (3), and speedtest history
- Full trend charts, channel timeline, channel compare, and correlation analysis
- Switch to live mode anytime (Settings > Migrate) -- your own entries are preserved
- Works with MQTT (if configured)
| ✅ You have cable internet (coax/DOCSIS) | DOCSight is built for this — full signal monitoring |
| ✅ You have fiber, DSL, or satellite | Generic Router mode gives you speedtest tracking, incident journal, and more |
| ✅ Your internet drops out or is slower than what you're paying for | DOCSight documents it |
| ✅ Your ISP says "everything is fine on our end" | DOCSight gives you proof |
| 🏠 Runs 100% locally | No cloud, no external servers |
| 🔒 Nothing leaves your network | Your data is never uploaded anywhere |
| 📖 Open source | All code is public and verifiable |
| 🔐 Credentials encrypted | Router login encrypted at rest (AES-128) |
| Feature | Description |
|---|---|
| Live Dashboard | Real-time channel data with health assessment, metric cards, and compact mode with expandable channel details |
| Signal Trends | Interactive charts with DOCSIS reference zones (day/week/month) |
| Before/After Comparison | Compare two time periods side by side with presets, delta summaries, health distribution, and complaint-ready evidence |
| Correlation Analysis | Unified timeline combining signal, speedtest, and event data |
| Gaming Quality Index | NEW: A-F grade for gaming readiness based on latency, jitter, and signal health |
| Modulation Performance | NEW: Per-protocol-group modulation health index with intraday channel drill-down |
| In-App Glossary | Contextual help popovers explaining DOCSIS terminology directly on the dashboard |
| Cable Segment Utilization | FRITZ!Box cable segment load monitoring with downstream/upstream utilization charts |
| Connection Monitor | NEW: Always-on latency monitor with PingPlotter-style charts, outage detection, packet loss tracking, and CSV evidence export |
| Event Log | Automatic anomaly detection with modulation watchdog |
| Speedtest Integration | Speed test history from Speedtest Tracker |
| Incident Journal | Document ISP issues with icons, Excel/CSV import, search, attachments, incident groups, and export (CSV/JSON/Markdown) |
| Complaint Generator | Editable ISP letter + downloadable technical PDF with diagnostic notes and optional active comparison evidence |
| Channel Timeline | Per-channel power, SNR, error, and modulation history over time with multi-channel comparison overlay |
| Home Assistant | MQTT Auto-Discovery with per-channel sensors |
| BQM Integration | ThinkBroadband broadband quality graphs |
| BNetzA Measurements | NEW: Upload or auto-import official BNetzA broadband measurement protocols (PDF/CSV) with file watcher and sidecar support |
| Smokeping Integration | Optional external latency graphs from your Smokeping instance |
| Backup & Restore | One-click backup download, scheduled automatic backups, restore from setup wizard |
| Notifications | Alerts via webhook, ntfy, Discord, Gotify, and custom endpoints |
| LLM Export | Structured reports for AI analysis |
| Demo Mode | Try DOCSight without a router — 9 months of simulated data with live migration |
| Theme Engine | NEW: 3 built-in themes (Classic, Ocean, Tribu) with live preview, instant switching, and community theme registry |
| Community Modules | Extend DOCSight with community-built modules — data collectors, integrations, analysis tools, and themes |
4 languages (EN/DE/FR/ES) · Light/Dark mode · Themes · PWA/Offline · Setup wizard · Optional authentication · API token auth for external clients
Click to expand
| Dashboard (Dark) | Dashboard (Light) |
|---|---|
|
 |
| Signal Trends | Health Assessment |
|---|---|
 |
 |
| Speedtest Tracker | Incident Journal |
|---|---|
 |
 |
| Import (Excel/CSV) | Edit with Icon Picker |
|---|---|
 |
 |
| Channel Timeline | Event Log |
|---|---|
 |
 |
| Correlation Analysis | Settings |
|---|---|
 |
 |
| Theme Gallery | BQM Integration |
|---|---|
 |
 |
| Status | Notes | |
|---|---|---|
| Arris CM3500B | ✅ Fully supported | HTTPS enforced, mixed DOCSIS 3.0/3.1 |
| Arris SB6141 | ✅ Fully supported | DOCSIS 3.0 standalone |
| Arris SB6190 | ✅ Fully supported | DOCSIS 3.0 standalone |
| Arris SURFboard (S33, S34, SB8200) | ✅ Fully supported | HNAP1 API |
| Arris Touchstone CM8200A | ✅ Fully supported | ISP-branded DOCSIS 3.1 |
| AVM Fritz!Box Cable (6490, 6590, 6591, 6660, 6690) | ✅ Fully supported | |
| Hitron CODA-56 | ✅ Fully supported | DOCSIS 3.1 |
| Netgear CM3000 | ✅ Fully supported | DOCSIS 3.1 standalone, JS parsing, Login.htm fallback |
| Sagemcom F@st 3896 | ✅ Fully supported | JSON-RPC API |
| Unitymedia Connect Box (CH7465) | ✅ Fully supported | |
| Vodafone Station (CGA4233, TG3442DE) | ✅ Fully supported | Bridge mode compatible |
| Technicolor TC4400 | ✅ Fully supported | |
| Vodafone Ultra Hub 7 (Sercomm) | ✅ Fully supported | |
| Generic Router (fiber, DSL, satellite) | ✅ Fully supported | No DOCSIS data — speedtest, journal, BNetzA, and modules work |
| Other DOCSIS modems | Community driver modules or add your own |
Works with any DOCSIS cable provider: Vodafone, Pyur/Tele Columbus, eazy, Magenta (AT), UPC (CH), Virgin Media (UK), and others. Non-cable users can select Generic Router during setup.
Currently focused on the German cable market (BNetzA measurements, VFKD thresholds, complaint templates). The core monitoring works with any DOCSIS modem worldwide — community contributions for other markets are welcome!
DOCSight uses a modular collector-based architecture for reliable data gathering from multiple sources:
┌─────────────────────────────────────────────────────────────────────────────┐
│ Collector Registry │
│ │
│ ┌──────────┐┌──────────┐┌──────────┐┌──────────┐┌──────────┐┌──────────┐┌──────────┐│
│ │ Modem ││ Demo ││ Speedtest││ BQM ││Smokeping ││ BNetzA ││ Backup ││
│ │ Collector││ Collector││ Collector││ Collector││ (Proxy) ││ Watcher ││ Collector││
│ └────┬─────┘└────┬─────┘└────┬─────┘└────┬─────┘└────┬─────┘└────┬─────┘└────┬─────┘│
│ │ │ │ │ │ │ │ │
│ └───────────┴───────────┴───────────┴───────────┴───────────┴───────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Base Collector (Fail Safe) │ │
│ │ • Exponential backoff (30s → 3600s max) │ │
│ │ • Auto reset after 24h idle │ │
│ │ • Health status monitoring │ │
│ └──────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
│
▼
┌────────────────────────────────────┐
│ Event Detector │
│ (Anomaly detection & alerting) │
└────────────────┬───────────────────┘
│
▼
┌────────────────────────────────────┐
│ SQLite Storage + MQTT │
│ (Snapshots, trends, Home Assistant)│
└────────────────┬───────────────────┘
│
▼
┌────────────────────────────────────┐
│ Web UI (Flask) │
│ (Dashboard, charts, reports) │
└────────────────────────────────────┘
- Modular collectors: Each data source (modem, speedtest, BQM) is an independent collector with standardized interface
- Built-in fail-safe: Exponential backoff prevents hammering failing endpoints, with automatic recovery
- Config-driven: Collectors enable/disable based on configuration without code changes
- Separation of concerns: Data collection, analysis, storage, and presentation are cleanly separated
- Extensible: New data sources can be added by implementing the
Collectorbase class
See ARCHITECTURE.md for detailed technical documentation.
- Docker (or any OCI-compatible container runtime) — or see Running without Docker for a native Python setup
- A supported DOCSIS cable modem/router (see above), or any router via Generic Router mode
- MQTT broker (optional, for Home Assistant)
See CONTRIBUTING.md. Please open an issue before working on new features.
Released: v2.0 — Complete Platform Redesign
| Feature | Status | Issue |
|---|---|---|
| Unified Collector Architecture | ✅ Released | #23 |
| Modern UI Redesign | ✅ Released | — |
| Cross-Source Correlation | ✅ Released | — |
| FritzBox Event Log Integration | 🚫 Closed | #17 |
| OFDMA Channel Analysis | 🚫 Closed | #18 |
| Gaming Quality Index | ✅ Released | #20 |
| Modulation Watchdog & Power Drift | ✅ Released | #21 |
| Demo/Test Mode | ✅ Released | #30 |
| Smokeping Integration | ✅ Released | #22 |
| Incident Import, Icons & Search | ✅ Released | #58 |
| Incident Groups | ✅ Released | #66 |
| BNetzA Automated Measurements | ✅ Released | #63 |
| Vodafone Station Support | ✅ Released | #14 |
| Technicolor TC4400 Support | ✅ Released | #24 |
| Vodafone Ultra Hub 7 Support | ✅ Released | #29 |
| Arris CM3500B Support | ✅ Released | #77 |
| Unitymedia Connect Box (CH7465) | ✅ Released | |
| Speedtest Server Tracking | ✅ Released | #79 |
| Multi-Channel Comparison | ✅ Released | #80 |
| Upstream Bandwidth Display | ✅ Released | #81 |
| Notification System | ✅ Released | #19 |
| BQM Calendar View | ✅ Released | #65 |
| BQM Bulk Import | ✅ Released | #67 |
| Backup & Restore | ✅ Released | #64 |
| CM3500 Provisioned Speeds | ✅ Released | #84 |
| Module System | ✅ Released | #128 |
| Community Module Registry | ✅ Released | #127 |
| Regional Threshold Profiles | ✅ Released | #130 |
| Settings Redesign (Tribu Design) | ✅ Released | #104 |
| Theme Engine (Themes as Modules) | ✅ Released | — |
| Dashboard Redesign (Mobile-First PWA) | ✅ Released | #105 |
| Self-Hosted Dependencies (Offline) | ✅ Released | — |
| Community Modem Drivers | ✅ Released | #131 |
| Non-DOCSIS Router Support | ✅ Released | #129 |
| Modulation Performance | ✅ Released | #92 |
| In-App Glossary | ✅ Released | #158 |
| Health Hysteresis | ✅ Released | #169 |
| Compact Dashboard | ✅ Released | — |
| Diagnostic Notes in PDF | ✅ Released | — |
| Security Hardening | ✅ Released | #160 |
| Sagemcom F@st 3896 Support | ✅ Released | #163 |
| Hitron CODA-56 Support | ✅ Released | #172 |
| Arris SB6141 Support | ✅ Released | #174 |
| Cable Segment Utilization | ✅ Released | #188 |
| Arris SB6190 Support | ✅ Released | #192 |
| Before/After Comparison | Released | #50 |
See the full roadmap in the wiki for long-term goals and modem support plans.
See GitHub Releases.
If DOCSight helps you, you can support development here:
- Ko-fi: https://ko-fi.com/itsdnns ☕
- PayPal: https://paypal.me/itsDNNS 💙
Documentation current as of v2026-03-10.1.
| Document | Scope |
|---|---|
| Wiki | User guides, feature docs, setup instructions |
| ARCHITECTURE.md | Technical architecture and extension guide |
| CONTRIBUTING.md | Development and contribution guidelines |
