Get DOCSight running in under 10 minutes. No programming knowledge required.
- Step 1: Install Docker
- Step 2: Start DOCSight
- Step 3: First-Time Setup
- Updating DOCSight
- Troubleshooting
- Uninstalling
Docker runs applications in isolated "containers" — think of it as a lightweight virtual machine. DOCSight runs inside one of these containers.
Already have Docker? Skip to Step 2 →
- Download Docker Desktop for Windows
- Run the installer and follow the prompts
- When asked, enable WSL 2 (recommended) or Hyper-V
- Restart your computer when prompted
- Open Docker Desktop — wait until the status indicator turns green ("Engine running")
Requirements: Windows 10 (64-bit, version 2004+) or Windows 11. Docker Desktop is free for personal use.
To verify: Open PowerShell or Command Prompt and type:
docker --version
You should see something like Docker version 27.x.x.
- Download Docker Desktop for Mac
- Apple Silicon (M1/M2/M3/M4): Download the "Apple Silicon" version
- Intel Mac: Download the "Intel chip" version
- Open the
.dmgfile and drag Docker to your Applications folder - Open Docker from Applications — allow it when macOS asks for permissions
- Wait until the whale icon in the menu bar stops animating ("Engine running")
To verify: Open Terminal and type:
docker --version
Most Linux distributions have Docker in their package manager.
Ubuntu / Debian:
sudo apt update
sudo apt install docker.io docker-compose-plugin
sudo systemctl enable --now docker
sudo usermod -aG docker $USERLog out and back in for the group change to take effect.
Arch / CachyOS / Manjaro:
sudo pacman -S docker docker-compose
sudo systemctl enable --now docker
sudo usermod -aG docker $USERLog out and back in.
Fedora:
sudo dnf install docker docker-compose-plugin
sudo systemctl enable --now docker
sudo usermod -aG docker $USERLog out and back in.
To verify:
docker --version- Open Package Center on your Synology NAS
- Search for Container Manager and click Install
- Once installed, open Container Manager from the main menu
That's it! You'll use Container Manager in Step 2.
Older DSM (< 7.2)? Look for "Docker" instead of "Container Manager" in Package Center.
Docker is built into Unraid. To enable it:
- Go to Settings → Docker in the Unraid WebGUI
- Set Enable Docker to Yes
- Click Apply
You'll use the Unraid Docker UI in Step 2.
Choose the method that fits your setup. All methods create the same container.
Open a terminal:
- Windows: PowerShell or Command Prompt
- Mac: Terminal (Applications → Utilities)
- Linux: Your terminal emulator
Run this command:
docker run -d \
--name docsight \
--restart unless-stopped \
-p 8765:8765 \
-v docsight_data:/data \
ghcr.io/itsdnns/docsight:latestWindows PowerShell? Replace the backslashes
\with backticks`or put everything on one line:docker run -d --name docsight --restart unless-stopped -p 8765:8765 -v docsight_data:/data ghcr.io/itsdnns/docsight:latest
What these flags mean:
| Flag | What it does |
|---|---|
-d |
Runs in the background |
--name docsight |
Names the container "docsight" |
--restart unless-stopped |
Auto-starts after reboot |
-p 8765:8765 |
Makes the web UI available on port 8765 |
-v docsight_data:/data |
Stores your config and history permanently |
Open DOCSight: Go to http://localhost:8765 in your browser.
Create a docker-compose.yml file:
services:
docsight:
image: ghcr.io/itsdnns/docsight:latest
container_name: docsight
restart: unless-stopped
ports:
- "8765:8765"
volumes:
- docsight_data:/data
environment:
- TZ=Europe/Berlin # optional: set your timezone
volumes:
docsight_data:Start it:
docker compose up -dOpen DOCSight: Go to http://localhost:8765 in your browser.
- Open Container Manager on your Synology NAS
- Go to Project in the left sidebar
- Click Create
- Set Project name to
docsight - Set Source to "Create compose.yml"
- Paste this into the editor:
services:
docsight:
image: ghcr.io/itsdnns/docsight:latest
container_name: docsight
restart: unless-stopped
ports:
- "8765:8765"
volumes:
- docsight_data:/data
environment:
- TZ=Europe/Berlin # optional: set your timezone
volumes:
docsight_data:- Click Next, then Done
The container will download and start automatically.
Open DOCSight: Go to http://YOUR-NAS-IP:8765 in your browser (e.g. http://192.168.178.15:8765).
Tip: You can find your NAS IP address in Control Panel → Network → Network Interface.
Older DSM versions don't have the Project feature. Use the Container UI instead:
- Open Docker (or Container Manager) on your NAS
- Go to Registry → Search for
ghcr.io/itsdnns/docsight→ Download thelatesttag - Go to Image → Select
ghcr.io/itsdnns/docsight:latest→ Click Launch - Set Container Name to
docsight - Check Enable auto-restart
- Click Advanced Settings:
- Port Settings: Add Local Port
8765→ Container Port8765(TCP) - Volume: Add folder or volume mapped to
/data
- Port Settings: Add Local Port
- Click Apply, then Next, then Done
Open DOCSight: Go to http://YOUR-NAS-IP:8765 in your browser.
- Go to the Docker tab in the Unraid WebGUI
- At the bottom, click Add Container
- Fill in:
| Field | Value |
|---|---|
| Name | docsight |
| Repository | ghcr.io/itsdnns/docsight:latest |
| Network Type | bridge |
- Click Add another Path, Port, Variable, Label or Device and add:
Port mapping:
| Field | Value |
|---|---|
| Config Type | Port |
| Container Port | 8765 |
| Host Port | 8765 |
| Connection Type | TCP |
Volume mapping:
| Field | Value |
|---|---|
| Config Type | Path |
| Container Path | /data |
| Host Path | /mnt/user/appdata/docsight |
- Click Apply
Open DOCSight: Go to http://YOUR-UNRAID-IP:8765 in your browser.
- Open your Portainer web UI
- Go to Stacks → Add stack
- Name it
docsight - In the Web editor, paste:
services:
docsight:
image: ghcr.io/itsdnns/docsight:latest
container_name: docsight
restart: unless-stopped
ports:
- "8765:8765"
volumes:
- docsight_data:/data
volumes:
docsight_data:- Click Deploy the stack
Open DOCSight: Go to http://YOUR-HOST-IP:8765 in your browser.
When you open DOCSight for the first time, a setup wizard guides you through the configuration.
| Field | What to enter |
|---|---|
| Modem URL | Your router's web address (e.g. http://192.168.178.1 for FRITZ!Box) |
| Username | Your router login username |
| Password | Your router login password |
Click Test Connection to verify. If it works, you're almost done.
💡 Tip: Create a dedicated user for DOCSight
Instead of your main admin account, create a separate user on your router. This is more secure and lets you revoke access without changing your admin password.
How to do this on a FRITZ!Box
- Open
http://fritz.boxand log in as admin- Go to System → FRITZ!Box Users → Add User
- Set username (e.g.
docsight) and a password- Enable only "Access to FRITZ!Box settings" (disable everything else)
- Click Apply
Use this new username and password in DOCSight. DOCSight only reads data and never modifies any router settings.
| Field | Description | Default |
|---|---|---|
| ISP Name | Your internet provider (shown in reports) | — |
| Poll Interval | How often to read data (in seconds) | 900 (15 min) |
| History Days | How long to keep data (0 = forever) | 0 |
If you use Home Assistant, DOCSight can send per-channel sensor data via MQTT:
| Field | Description |
|---|---|
| MQTT Host | Your broker address (e.g. 192.168.178.15) |
| MQTT Port | 1883 (default) |
| MQTT User/Password | If your broker requires authentication |
If you run a self-hosted Speedtest Tracker, DOCSight can pull your speed test results and display them alongside your DOCSIS data:
| Field | Description |
|---|---|
| Speedtest Tracker URL | Your instance URL (e.g. http://192.168.178.15:8999) |
| API Token | Generate one in Speedtest Tracker under Settings → API |
Click Complete Setup. DOCSight starts monitoring immediately. Your dashboard will show data after the first poll (default: 15 minutes).
Your configuration and history are stored in a Docker volume and always survive updates.
docker pull ghcr.io/itsdnns/docsight:latest
docker stop docsight
docker rm docsight
docker run -d --name docsight --restart unless-stopped -p 8765:8765 -v docsight_data:/data ghcr.io/itsdnns/docsight:latestdocker compose pull
docker compose up -d- Go to Project → select docsight
- Click Action → Build
- The container restarts with the new image
- Go to the Docker tab
- Click the docsight icon → Check for Updates
- If an update is available, click Update
- Open the docsight stack
- Click Editor → Update the stack
- Enable Re-pull image and redeploy
- Click Update
"I can't open http://localhost:8765"
- Is the container running? Open a terminal and run
docker ps. You should see a container nameddocsightwith status "Up". - On a NAS or remote machine? Use the machine's IP address instead of
localhost(e.g.http://192.168.178.15:8765). - Firewall blocking the port? On Linux, check
sudo ufw statusorsudo firewall-cmd --list-ports. - Docker Desktop not running? On Windows/Mac, make sure Docker Desktop is open and the engine is running (green indicator).
"Test Connection fails in setup"
- Can you open the router URL yourself? Try opening
http://192.168.178.1(or your modem URL) in your browser. If that doesn't work either, the URL is wrong. - Credentials correct? Use the exact same username and password you use to log into your router's web interface.
- Docker on a different network? If DOCSight runs on a remote server or VPN, it might not be able to reach your router. DOCSight must be on the same local network as your modem.
"Port 8765 is already in use"
Change the host port to any free port (e.g. 9876):
Docker CLI:
docker run -d --name docsight --restart unless-stopped -p 9876:8765 -v docsight_data:/data ghcr.io/itsdnns/docsight:latestDocker Compose / Portainer:
ports:
- "9876:8765" # change only the first numberThen open http://localhost:9876 instead.
"Container keeps restarting"
Check the logs:
docker logs docsight --tail 30Common causes:
- Port conflict (see above)
- Corrupt config: remove the volume and start fresh with
docker volume rm docsight_data(this deletes all stored data!)
"Dashboard shows no data"
- Just installed? Wait for the first poll cycle (default: 15 minutes). Check the timer in the top bar.
- Poll manually: Click the refresh button (🔄) on the dashboard to trigger an immediate data fetch.
- Check logs:
docker logs docsight --tail 10should show successful poll entries.
"My modem/router is not supported"
DOCSight currently supports AVM FRITZ!Box Cable models. Support for other DOCSIS modems (Arris, Technicolor, Sagemcom, Vodafone Station) is on the roadmap. If you'd like to help add support for your device, see CONTRIBUTING.md.
docker stop docsight
docker rm docsightdocker volume rm docsight_dataClick the docsight icon → Remove. Check Also remove image if you want to free disk space.
Go to Container Manager → Project → select docsight → Action → Delete.
Open the docsight stack → Delete this stack.
