selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

docsight logo

Self-host docsight

v2026-10-14.1

DOCSIS signal monitoring and evidence for cable internet

ReleaseOpen SourceMIT
Updated12 hours ago
LanguagePython
Setup difficultyModerate
MobilePWA
Stars
290
Port
8765 (Web UI)
Docker
ghcr.io/itsdnns/docsight
Install with Docker
DOCSight home dashboard showing line status per channel, key figures, and latest speed testSignal trends with target bands for power, SNR, and uncorrectable errors per intervalCorrelation timeline showing signal, errors, speed tests, segment load, and reachabilityIncident journal with case cards and their evidence stateEvidence journey checking which evidence exists for a time window

What is docsight?

DOCSight is a self-hosted monitoring system for cable internet connections that records DOCSIS signal data, speed tests, latency, outages, and traceroutes around the clock. It supports 22 modem families including FRITZ!Box, Vodafone Station, Technicolor, Arris, Hitron, and Netgear models, plus a generic router mode for fiber, DSL, and satellite. The web interface shows signal trends with target bands, correlates signal quality with speed tests and segment load, and builds incident cases with evidence timelines. It can generate complaint letters and PDF reports for providers, including BNetzA measurements and TKG compensation calculations for Germany. Data stays local with optional integrations for Home Assistant, MQTT, Speedtest Tracker, ThinkBroadband BQM, and webhook notifications. The UI supports 24 languages, themes, backup/restore, and is installable as a PWA. Runs via Docker or Docker Compose on port 8765.

Should you self-host docsight?

docsight scores 51/100 on selfhost.directory (how scoring works) and ranks #21 of 48 in Network Monitoring. It has 290 GitHub stars.

It shipped 21 stable releases in the past year. The latest, v2026-10-14.1, came out on 14 October 2026. New versions land roughly every 7 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is mitmproxy (86/100, 46 448 stars). It scores higher overall, so compare the two before you pick. See docsight vs mitmproxy side by side.

Features

  • AI export with local redaction
  • Backup and Restore
  • BQM integration
  • Connection monitor with outages and traceroutes
  • DOCSIS Signal Monitoring
  • Evidence journey and complaint reports
  • Gaming quality monitoring
  • Home Assistant Integration
  • Incident journal and cases
  • Multi-language Support
  • Notifications with browser push
  • Signal correlation timeline
  • Smokeping integration
  • Themes

docsight README

How to install docsight

Install docsight with Docker

Environment variables
MODEM_TYPE, MODEM_URL, MODEM_USER, MODEM_PASSWORD, POLL_INTERVAL, HISTORY_DAYS, WEB_PORT, ADMIN_PASSWORD, SESSION_LIFETIME_DAYS, REVERSE_PROXY, BASE_PATH, REVERSE_PROXY_PREFIX, DEMO_MODE, LOG_LEVEL, DOCSIGHT_AUDIT_JSON, DATA_DIR, MQTT_HOST, MQTT_PORT, MQTT_USER, MQTT_PASSWORD, MQTT_TLS_INSECURE, MQTT_TOPIC_PREFIX, MQTT_DISCOVERY_PREFIX, PUBLIC_URL, SPEEDTEST_TRACKER_URL, SPEEDTEST_TRACKER_TOKEN, SPEEDTEST_TLS_INSECURE, BOOKED_DOWNLOAD, BOOKED_UPLOAD, BQM_URL, NOTIFY_WEBHOOK_URL, NOTIFY_WEBHOOK_TOKEN, NOTIFY_MIN_SEVERITY, NOTIFY_COOLDOWN, BNETZ_ENABLED, BNETZ_WATCH_ENABLED, BNETZ_WATCH_DIR, GAMING_QUALITY_ENABLED

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

Configuration and history stay in the docsight_data volume. stable follows releases; latest follows the main branch.

How to configure docsight

  • DATA_DIR/dataDOCSIGHT_AUDIT_JSON=1 # Emit audit log as structured JSON

    DOCSIGHT_AUDIT_JSON=1 # Emit audit log as structured JSON

  • HISTORY_DAYS0
  • LOG_LEVELADMIN_PASSWORD= # Web UI password (hashed with scrypt) SESSION_LIFETIME_DAYS=30 # Rolling login lifetime in days (bounded to 1-365) REVERSE_PROXY=1 # Exact client/proto proxy hops; enables Secure HTTPS-only session cookies BASE_PATH=/docsight # Explicit external URL mount already stripped by the proxy REVERSE_PROXY_PREFIX=1 # Exact trusted X-Forwarded-P

    ADMIN_PASSWORD= # Web UI password (hashed with scrypt) SESSION_LIFETIME_DAYS=30 # Rolling login lifetime in days (bounded to 1-365) REVERSE_PROXY=1 # Exact client/proto proxy hops; enables Secure HTTPS-only session cookies BASE_PATH=/docsight # Explicit external URL mount already stripped by the proxy REVERSE_PROXY_PREFIX=1 # Exact trusted X-Forwarded-P

  • MODEM_PASSWORD
  • MODEM_TYPEfritzbox── Modem ────────────────────────────────────────────────────────────────────

    ── Modem ────────────────────────────────────────────────────────────────────

  • MODEM_URLhttp://192.168.178.1
  • MODEM_USER
  • MQTT_DISCOVERY_PREFIX
  • MQTT_PASSWORD
  • MQTT_TOPIC_PREFIXMQTT_TLS_INSECURE=false # Disable TLS cert verification (self-signed certs)

    MQTT_TLS_INSECURE=false # Disable TLS cert verification (self-signed certs)

  • MQTT_USER── MQTT / Home Assistant ──────────────────────────────────────────────────── MQTT_HOST= # Enables HA integration when set MQTT_PORT=1883 # 8883 enables TLS automatically

    ── MQTT / Home Assistant ──────────────────────────────────────────────────── MQTT_HOST= # Enables HA integration when set MQTT_PORT=1883 # 8883 enables TLS automatically

  • POLL_INTERVAL900── General ──────────────────────────────────────────────────────────────────

    ── General ──────────────────────────────────────────────────────────────────

  • WEB_PORT8765

docsight releases & version history

More in Network Monitoring

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…