Modem
Modem Connection
Tip: Create a dedicated user for DOCSight instead of using your main admin account.
Internet Provider
Shown in LLM export report
Data Collection
Configure polling interval, data retention and daily snapshots
Min: 60s / Max: 14400s
0 = keep all snapshots
Reference time for daily comparisons and trends
Localization
Language and timezone settings
Use an IANA timezone (e.g. Europe/Berlin) to ensure correct daylight saving time handling.
Notifications
Webhook notifications (ntfy, Discord, Gotify, custom)
HTTP POST endpoint (ntfy, Discord, Gotify, custom)
Optional Bearer token for authentication
Only send events at or above this severity
Min. seconds between same event type (0 = never send)
Health Hysteresis
Prevent health status flapping near threshold boundaries
Number of consecutive polls before confirming a health state change (0 = instant, recommended: 3)
Test Notification
Send a test event to verify your webhook configuration
Smart Capture
Automatically trigger measurements when signal degradation is detected
Modulation downgrade
Triggers when QAM level drops on any channel (e.g. 256QAM to 64QAM). Only downgrades with severity warning or critical.
SNR degradation
Triggers when signal-to-noise ratio drops below warning threshold.
Error spike
Triggers when uncorrectable errors jump significantly between polls.
0 = trigger on any spike
Health change
Triggers when connection health degrades to marginal or critical.
Packet loss warning
Triggers when Connection Monitor detects high packet loss on any target
Requires Connection Monitor module. Only fires when packet loss exceeds both this threshold and the Connection Monitor warning threshold.
Guardrails
Rate limiting to prevent excessive test triggers
No action adapter configured. Enable Speedtest Tracker to use Smart Capture.
Execution History
Loading execution history...
Color Mode
Switch between dark and light mode
Dark Mode Toggle between dark and light theme
Font
Choose the interface font
Use system font Replace Outfit with your operating system's default font. Can improve readability on remote desktop (RDP) connections.
Installed Themes
Select a theme to apply across the entire app
Available Themes
Browse and install themes from the community
Admin Password
Leave empty to disable authentication
Extensions
Toggle optional dashboard sections
Features
Broadband Measurement (BNetzA) PDF from the official BNetzA broadband measurement tool
Gaming Quality Index Show a gaming quality badge in the dashboard hero card based on latency, jitter, and signal health.
Segment Utilization Requires FRITZ!Box
Modules
Backup & Restore Scheduled backups and one-click restore for DOCSight data
Before/After Comparison Compare signal quality between two arbitrary time periods
BNetzA Broadband Measurement BNetzA Breitbandmessung protocol parsing and file watcher
Connection Monitor Always-on latency monitoring with ICMP/TCP probing for cable troubleshooting
Incident Journal Document connection issues, attach evidence, and group entries into incidents for ISP complaints
Modulation Performance Daily modulation distribution, low-QAM exposure, and health index
MQTT / Home Assistant Publish DOCSIS data to MQTT with Home Assistant Auto-Discovery
Reports & Complaints Generate PDF incident reports and ISP complaint letters
Smokeping Smokeping latency monitoring graph integration
Speedtest Tracker Speed test results from Speedtest Tracker with health classification
ThinkBroadband BQM Broadband Quality Monitor graph collection from ThinkBroadband
VFKD Thresholds Signal thresholds based on the official Vodafone pNTP Interface Specification v1.06
Weather Integration Correlate signal quality with outdoor temperature via Open-Meteo
Community Modules
Browse and install modules from the community registry
Loading community modules...
About Project
Version, project notices, and privacy model
Version v2026-05-09.953
Notice delivery Bundled with this release
Maintainer notices
Bundled project updates from the DOCSight maintainer

Maintainer notices are now local-first

Info

DOCSight can show bundled project notices without contacting a remote feed or sending telemetry. Dismissals are stored only in your local DOCSight configuration.

View release notes
Privacy model
Maintainer notices are bundled with DOCSight and evaluated locally. DOCSight does not fetch a remote notices feed, render remote HTML, or send telemetry when showing or dismissing notices.
Support DOCSight
Help keep this project alive and growing

DOCSight began as a personal fight with unstable cable internet and support replies that never matched reality. I wanted a tool that turns frustration into clear technical proof people can actually use. If you want to support that mission, thank you. It really helps.

— Dennis
GitHub Sponsors
Monthly sponsorship
PayPal
One-time donation
Ko-fi
Buy me a coffee
Star on GitHub to help others discover DOCSight GitHub
Backup & Restore
Download or schedule automatic backups of your DOCSight data
Automatic Backups
Periodically save backups to a server directory
Enabled
Server directory where backups are stored
Number of backup files to keep
Existing Backups
BNetzA File Watcher
Automatic import of measurement files
Enabled Automatically imports BNetzA measurement PDFs and CSVs from a watched directory
Path where measurement files are placed (e.g., by a sidecar container)
See the wiki for a Docker Compose example with the official BNetzA Desktop App sidecar
ThinkBroadband BQM
optional
Paste the ThinkBroadband CSV Yesterday share link for daily collection. CSV Live is for live spot checks only. DOCSight fetches once immediately after setup, then daily at the configured time. PNG links are supported only for legacy image mode. For history, use the CSV bulk import to load up to 12 months of history before relying on daily collection.
Time of day to fetch CSV Yesterday data (configured timezone). Missed days are not backfilled automatically; import historical CSV files when a longer gap exists.
Connection Monitor
Always-on latency monitoring for cable troubleshooting
Enable Connection Monitor Continuously probes configured targets and tracks latency, packet loss, and outages.
Time between probes per target. Default: 5000ms (5s). Minimum: 1000ms.
Auto tries ICMP first, falls back to TCP if not available. TCP works everywhere.
Port used for TCP probes. Default: 443.
0 = keep all data. Otherwise, delete samples older than this many days.
Consecutive timeouts before an outage event is triggered.
Packet loss percentage that triggers a warning event.
Targets
IP addresses or hostnames to monitor.
MQTT Broker
optional - for Home Assistant
Default: homeassistant. Only change if you customized it in HA.
Insecure TLS Skip TLS certificate verification
Speedtest Tracker
Optional
Base URL of your Speedtest Tracker instance
Bearer token from Speedtest Tracker settings
Contracted download speed in Mbps for health calculation
Contracted upload speed in Mbps for health calculation
Weather
optional — correlate signal quality with outdoor temperature
Enable weather data collection Fetches hourly outdoor temperature from Open-Meteo (free, no API key). Historical data is backfilled automatically.
Your location coordinates (e.g. 52.52 / 13.41 for Berlin). Find yours at latlong.net