Settings

Connection

Changes here are saved with Save in the bar at the bottom.

Modem Connection

Tip: Create a dedicated user for DOCSight instead of using your main admin account. Learn more

The last reading failed: Vodafone Station authentication failed. Could not detect hardware variant (tried CGA and TG flows). Check URL, username, and password.

Modem Type

URL

Username

Password

Provider and plan

Your provider and the speeds in your contract Learn more

Internet Provider

Booked Download (Mbps) Contracted download speed in Mbps for health calculation

Booked Upload (Mbps) Contracted upload speed in Mbps for health calculation

Polling

How often DOCSight reads the modem and when a health change counts Learn more

Interval (seconds) Min: 60s / Max: 14400s

Consecutive Polls Number of consecutive polls before confirming a health state change (0 = instant, recommended: 3)

Connection Monitor

Always-on latency monitoring for cable troubleshooting Learn more

Enable Connection Monitor Continuously probes configured targets and tracks latency, packet loss, and outages.

Probe interval (ms) Time between probes per target. Default: 5000ms (5s). Minimum: 1000ms.

Probe method Auto tries ICMP first, falls back to TCP if not available. TCP works everywhere.

TCP port Port used for TCP probes. Default: 443.

Outage threshold Consecutive timeouts before an outage event is triggered.

Loss warning (%) Packet loss percentage that triggers a warning event.

Targets

IP addresses or hostnames to monitor.

Speedtest Tracker

Optional Learn more

Speedtest Tracker URL Base URL of your Speedtest Tracker instance

API Token Bearer token from Speedtest Tracker settings

Insecure TLS Skip TLS certificate verification for self-signed HTTPS certificates

ThinkBroadband BQM

optional Learn more

BQM Share URL 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.

Daily collection time 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.

Smokeping

Module is off. Turn it on in Extensions.

Extensions

Weather

optional — correlate signal quality with outdoor temperature Learn more

Enable weather data collection Fetches hourly outdoor temperature from Open-Meteo (free, no API key). Historical data is backfilled automatically.

Latitude Your location coordinates (e.g. 52.52 / 13.41 for Berlin). Find yours at latlong.net

Longitude

Not configured

Learn more

Webhook URL HTTP POST endpoint (ntfy, Discord, Gotify, custom)

Webhook Token Optional Bearer token for authentication

Min. Severity Only send events at or above this severity

Default Cooldown (s) Min. seconds between same event type (0 = never send)

Disabled

Learn more

Apprise API URL Base URL of your Apprise API server, for example http://apprise:8000

Config Key Optional Apprise persistent config key; empty uses the stateless /notify endpoint

API Token Optional Bearer token for protected Apprise API servers

Tags Optional comma-separated tags configured in Apprise

Disabled

Learn more

VAPID Public Key Base64url public key used by browsers to subscribe

VAPID Private Key Private VAPID key used server-side to sign push requests

VAPID Subject Contact URI for the push service, for example mailto:admin@example.com

Checking browser status...

Save VAPID settings first, then use the button below to request browser permission explicitly.

Per-Event Cooldowns

Disable events or set individual cooldown timers

Learn more

Active	Event	Severity	Cooldown (s)
	Health Change	info
	Health Change	warning
	Health Change	critical
	Power Change	info
	Power Change	warning
	Power Change	critical
	SNR Change	info
	SNR Change	warning
	SNR Change	critical
	Modulation Change	info
	Modulation Change	warning
	Modulation Change	critical
	Channel Change	info
	Channel Change	warning
	Reboot	warning
	Software Update	info
	IP Change	info
	Packet Loss Warning	warning
	Error Spike	warning
	Monitoring Started	info

Disabled events will never be sent. Cooldown empty = use default.

Test Notification

Send a test event to verify your webhook configuration

Smart Capture

Automatically trigger measurements when signal degradation is detected Learn more

Modulation downgrade

Triggers when QAM level drops on any channel (e.g. 256QAM to 64QAM). Only downgrades with severity warning or critical.

Direction

Min QAM level

SNR degradation

Triggers when signal-to-noise ratio drops below warning threshold.

Error spike

Triggers when uncorrectable errors jump significantly between polls.

Min error delta

0 = trigger on any spike

Health change

Triggers when connection health degrades to marginal or critical.

Health level

Packet loss warning

Triggers when Connection Monitor detects high packet loss on any target

Min packet loss %

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

Global cooldown (seconds)

Per-trigger cooldown (seconds)

Max actions per hour

Speedtest min interval (seconds)

Blocks Smart Capture if Speedtest Tracker already ran recently, including its own schedule.

Smart Capture speedtests per day

Rolling 24h cap for extra Speedtest Tracker runs triggered by DOCSight. 0 disables this cap.

Speedtest result match window (seconds)

How long DOCSight waits to link a triggered Speedtest Tracker result before expiring it.

Execution History

Loading execution history...

Timestamp	Trigger	Status	Details

Customer details for reports

Save optional customer details as defaults for new reports. Learn more

Your name

Customer/contract number

Your address Stored encrypted on this DOCSight instance and used to prefill new reports. Changes in the report form apply only to that report. Demo mode hides these values.

BNetzA File Watcher

Automatic import of measurement files Learn more

Enabled Automatically imports BNetzA measurement PDFs and CSVs from a watched directory

Watch 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

History and snapshots

How long DOCSight keeps measurements and when it takes the daily snapshot Learn more

History (days) 0 = keep all snapshots

Connection Monitor · Keep samples (days) 0 = keep all data. Otherwise, delete samples older than this many days.

Daily Snapshot (time) Reference time for daily comparisons and trends

Backup & Restore

Download or schedule automatic backups of your DOCSight data Learn more

Automatic Backups

Periodically save backups to a server directory Learn more

Enabled

Backup Path

Server directory where backups are stored

Interval

Keep backups Number of backup files to keep

Existing Backups

Appearance

Learn more

Dark Mode Toggle between dark and light theme

Use system font Replace the theme font 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

Classic

The original DOCSight charcoal and purple design

Active

Amber Terminal

Warm amber on black — classic CRT monitor nostalgia

Catppuccin Mocha

Creamy mauves and blue-greens inspired by the popular Catppuccin palette

Doom

Dark reds, lava orange and brimstone — rip and tear

Dracula

Electric purples and candy accents inspired by the Dracula classic

GameBoy

The 4 iconic green shades of the original Game Boy LCD

Graphite

Calm graphite surfaces with a steel blue accent (default)

Gruvbox

Warm retro earth tones inspired by Gruvbox's wood-and-amber palette

Matrix

Phosphor green on black — enter the Matrix

Nord

Cool arctic blue palette — clean and calm

Ocean

Deep navy with teal and cyan accents

One Dark

Balanced charcoal blues inspired by the One Dark and One Light pair

SynthWave

Neon pink and cyan on deep violet — 80s retro futurism

Tokyo Night

Cool midnight blues with neon highlights inspired by Tokyo Night

Tribu

Glass-morphism design with void-dark palette and amethyst accents — inspired by Tribu

Available Themes

Browse and install themes from the community

Loading themes...

Localization

Language and timezone settings Learn more

Timezone Use an IANA timezone (e.g. Europe/Berlin) to ensure correct daylight saving time handling.

Language

Temperature Unit

Admin Password

Leave empty to disable authentication Learn more

Admin Password

MQTT Broker

optional - for Home Assistant Learn more

Host

Port

Username (optional)

Password (optional)

Topic Prefix

Discovery Prefix Default: homeassistant. Only change if you customized it in HA.

Insecure TLS Skip TLS certificate verification

About Project

Version, project notices, and privacy model

Version v2026-11-05.1467

Notice delivery Bundled with this release

Maintainer notices

Bundled project updates from the DOCSight maintainer

No active maintainer notices.

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.

Release update checks

Control outbound checks for new DOCSight releases Learn more

Check GitHub releases When enabled, DOCSight checks the public GitHub releases API for newer versions. This is disabled by default and does not upload modem data, logs, credentials, analytics, or an installation ID.

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

Star on GitHub to help others discover DOCSight GitHub