Docsight

<p align="center"> <img src="docs/docsight-logo-v2.svg" alt="DOCSight" width="128"> </p> <h1 align="center">DOCSight</h1> <p align="center"> <a href="LICENSE"><img src="https://img.shields.io/github/license/itsDNNS/docsight" alt="License"></a> <a href="https://github.com/itsDNNS/docsight/pkgs/container/docsight"><img src="https://img.shields.io/github/v/tag/itsDNNS/docsight?label=version" alt="Version"></a> <a href="https://github.com/itsDNNS/docsight/stargazers"><img src="https://img.shields.io/github/stars/itsDNNS/docsight?style=flat" alt="Stars"></a> <a href="https://github.com/itsDNNS/docsight/pkgs/container/docsight"><img src="https://ghcr-badge.egpl.dev/itsdnns/docsight/size" alt="Image Size"></a> <a href="https://selfh.st/weekly/2026-02-27/"><img src="https://img.shields.io/badge/selfh.st-Featured-blue" alt="Featured in selfh.st Weekly"></a> </p> <p align="center"> <strong>Your ISP says everything is fine. DOCSight gives you the proof that it isn't.</strong> </p> <p align="center"> DOCSight monitors your cable internet 24/7, documents every signal issue, and generates complaint letters with hard evidence your provider can't dismiss. </p> <p align="center"> Available in 🇬🇧 🇩🇪 🇪🇸 🇫🇷 </p>

---

Try It Now

No router needed. Demo mode generates 9 months of realistic DOCSIS data so you can explore everything.

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

Open http://localhost:8765 and see what DOCSight can do.

---

What DOCSight Does

<table> <tr> <td width="33%" valign="top">

Monitor

Tracks every DOCSIS signal metric around the clock: downstream power, upstream power, SNR, modulation, error rates, latency, and speed. Detects anomalies automatically.

</td> <td width="33%" valign="top">

Document

Builds a timeline of evidence: signal trends, event log, incident journal, before/after comparisons, correlation analysis. Every issue is recorded with timestamps and data.

</td> <td width="33%" valign="top">

Act

Generates ISP complaint letters backed by real measurements. One click creates a technical PDF with diagnostic data your provider has to take seriously.

</td> </tr> </table>

---

Quick Start

docker run -d --name docsight -p 8765:8765 -v docsight_data:/data ghcr.io/itsdnns/docsight:latest

Open http://localhost:8765, enter your router login, done.

Full installation guide | Example Compose Stacks

---

From Suspicion to Evidence

Most connection problems aren't one-time events. They come and go, making them nearly impossible to prove when you call your ISP.

DOCSight runs in the background and builds your case over time:

• Hour 1 - You see your current signal health and any active issues
• Week 1 - Trend charts reveal patterns your ISP can't see from a single snapshot
• Month 1 - The event log, incident journal, and correlation analysis paint a complete picture
• When you call your ISP - The complaint generator turns weeks of evidence into a professional letter with attached diagnostics

The longer DOCSight runs, the stronger your evidence gets.

---

Is This For Me?

| | | |---|---| | ✅ 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 |

---

Your Data Stays With You

| | | |---|---| | 🏠 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) |

---

Features

Core Evidence Workflow

| Feature | Description | |---|---| | Live Dashboard | Real-time channel data with health assessment, actionable insights, and 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, and complaint-ready evidence | | Correlation Analysis | Unified timeline combining signal, speedtest, and event data | | Connection Monitor | Always-on latency monitor with outage detection, packet loss tracking, traceroute burst capture, and CSV evidence export | | Event Log | Automatic anomaly detection with modulation watchdog and modem restart detection | | Incident Journal | Document ISP issues with icons, Excel/CSV import, attachments, incident groups, and export | | Complaint Generator | Editable ISP letter + downloadable technical PDF with diagnostic notes and comparison evidence |

Monitoring And Analysis

| Feature | Description | |---|---| | Gaming Quality Index | A-F grade for gaming readiness based on latency, jitter, and signal health | | Modulation Performance | Per-protocol-group modulation health index with intraday channel drill-down | | Cable Segment Utilization | FRITZ!Box cable segment load monitoring with downstream/upstream utilization charts | | Channel Timeline | Per-channel power, SNR, error, and modulation history with multi-channel comparison overlay | | Speedtest Integration | Speed test history from Speedtest Tracker with manual trigger button | | Smart Capture | Automatically triggers speedtests when signal degradation is detected, with configurable triggers and guardrails | | BNetzA Measurements | Upload or auto-import official BNetzA broadband measurement protocols (PDF/CSV) | | BQM Integration | ThinkBroadband CSV data with native interactive charts and daily collection | | Smokeping Integration | External latency graphs from your Smokeping instance | | In-App Glossary | Contextual help explaining DOCSIS terminology directly on the dashboard |

Platform And Ecosystem

| Feature | Description | |---|---| | Home Assistant | MQTT Auto-Discovery with per-channel sensors | | Backup & Restore | One-click backup, scheduled 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 | Built-in themes with live preview, instant switching, and community theme registry | | Community Modules | Extend DOCSight with community-built modules |

4 languages (EN/DE/FR/ES) | Light/Dark mode | Themes | PWA/Offline | Setup wizard | Optional authentication | API tokens | System font toggle

---

Screenshots

<details> <summary>Click to expand</summary>

| 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 | |---|---| | | |

</details>

---

Supported Hardware

16 modem families supported out of the box.

Common Setups

| | Status | Notes | |---|---|---| | Vodafone Station (CGA4233, TG3442DE) | ✅ Supported | Bridge mode compatible | | AVM Fritz!Box Cable