Skip to content
itsDNNSPublic

About

Self-hosted DOCSIS evidence system for proving cable signal problems and bad ISP performance. Tracks incidents, signal health, and complaint-ready exports.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

285 stars

Watchers

2 watching

Forks

Latest commit

 

History

1,960 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DOCSight

DOCSight

Your ISP says everything is fine. DOCSight shows the timeline.

Self-hosted monitoring for your internet connection. DOCSight keeps DOCSIS signal history, speed tests, latency, events and notes together, so you can find out what is wrong and prove it to your provider.

Get started  •   Product page  •   Wiki  •   Supported hardware  •   Releases  •   Code signing

License Latest release Stars Image size Featured in selfh.st Weekly

DOCSight Home with the line status per channel, key figures and the latest speed test

The real interface with synthetic demo data.

Get started

Try the demo, no modem required:

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

Connect your own modem or router:

docker run -d --name docsight --restart unless-stopped -p 8765:8765 -v docsight_data:/data ghcr.io/itsdnns/docsight:stable

Open http://localhost:8765 and follow the setup. It asks for your connection type, finds the modem on request and tests the connection. Configuration and history stay in the docsight_data volume. stable follows releases; latest follows the main branch.

Installation guide · Docker Compose · Windows quick start · Windows Desktop Preview · Running without Docker

Detect, understand, prove

Find the pattern Connect the signals
Signal Trends with target bands for power and SNR and uncorrectable errors per interval Correlation with signal, errors, speed tests, segment load and reachability on one timeline
Signal history with target bands. Step back in time, or click a point to open the full snapshot. Signal, errors, speed tests, segment load and reachability on one timeline.
Collect it in a case Bring it to your provider
Incident Journal with case cards and their evidence state Evidence Journey checking which evidence exists for a time window
Cases gather events, notes and snapshots, and show which evidence is ready. The Evidence Journey checks a window and builds the report, letter and PDF.

Features

See the sample complaint report and the proof pack for an example with synthetic data.

Your data stays with you

History and reports stay on your own hardware. Optional integrations only talk to the services you configure. Review exports before you share them: they can contain connection details and notes. See the data contract and the security policy.

Supported hardware

DOCSight has drivers for 22 modem families, among them AVM FRITZ!Box Cable, Vodafone Station (CGA4233, TG3442DE), Sercomm Ultra Hub 7, Connect Box (CH7465), Sagemcom F@st 3896 and F3896LG, PYUR FAST3896-15 (experimental), Technicolor TC4400, Arris SURFboard, Hitron CODA and Netgear CM1000/CM3000. See supported modems for the full list and setup notes.

Not on cable? Generic Router mode works with fiber, DSL and satellite: speed tests, latency monitoring, notes and reports, without DOCSIS signal data. Community drivers live in docsight-modules; you can also add your own modem.

Community and support

Ask questions in GitHub Discussions, and see SUPPORT.md for troubleshooting and bug reports. Contributions are welcome; please read CONTRIBUTING.md and open an issue or idea discussion before you start on a new feature.

If DOCSight helps you, you can support its development through GitHub Sponsors, Ko-fi or PayPal.

License and brand

The code is MIT-licensed. The DOCSight name and logo are covered by the brand policy: forks may say they are "based on DOCSight", but not present themselves as the official project.

DOCSight = DOCSIS + Insight (+ a quiet sigh from every cable internet user)

About

Self-hosted DOCSIS evidence system for proving cable signal problems and bad ISP performance. Tracks incidents, signal health, and complaint-ready exports.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

285 stars

Watchers

2 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages