Skip to content

Quick Start

Dennis Braun edited this page Mar 8, 2026 · 7 revisions

Quick Start

From zero to monitoring in 5 minutes.

1. Start DOCSight

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

New to Docker? See the Installation Guide for step-by-step instructions.

2. Connect Your Modem

Open http://localhost:8765 in your browser. The setup wizard asks for:

  • Your modem type (FRITZ!Box, Vodafone Station, Technicolor TC4400, Arris SURFboard/CM8200/SB6141, Sagemcom, Hitron, Compal, Netgear, or Generic Router for fiber/DSL/satellite). See Configuration for the full list.
  • Your modem's IP address (defaults are set automatically per modem type)
  • Your modem login credentials (not needed for Generic Router)

Click "Test Connection" to verify. That's it.

3. Sit Back

DOCSight monitors your connection around the clock. When something goes wrong, you'll see it immediately on the dashboard.

What You'll See

  • Health Assessment at the top: green (good), lime (tolerated), yellow (marginal), or red (critical)
  • Metric Cards for downstream power, upstream power, errors, and speed
  • Signal Trends showing your connection quality over time
  • Event Log tracking automatic anomaly detection

Optional Extras

Feature What it adds Setup
Speedtest Tracker Speed test history and charts Connect your STT instance in Settings
Home Assistant MQTT sensors for automations Enter MQTT broker in Settings
BQM Integration External latency graphs Enter BQM URL in Settings
Admin Password Protect the web UI Set in Settings under General

Updating

docker pull ghcr.io/itsdnns/docsight:latest
docker restart docsight

Your data is stored in the docsight_data volume and survives updates.

Compose Examples

Want to add Speedtest Tracker, BNetzA sidecar, or MQTT? See Example Compose Stacks for ready-made docker-compose.yml files.

Clone this wiki locally