Simple Network Dashboard

What it touches

Platform

FastAPI and Uvicorn browser application installed as a systemd service on a Python 3.10+ Linux server, including Raspberry Pi OS, with a local Caddy server terminating HTTPS in front of it. Each monitored device needs Prometheus Node Exporter installed.

Storage

devices.json stores device names, hosts, usernames, Node Exporter ports, and command libraries; known_hosts pins SSH host keys. The dashboard password is kept only as a salted Argon2id hash. SSH passwords are held only in server memory for an active session and wiped on disconnect.

Network

It polls configured Node Exporters at http://device-ip:9100/metrics, opens SSH sessions on request, serves the browser over local HTTPS behind Caddy, and checks GitHub Releases for updates only when you press Check for updates. A single dashboard password gates access, and it must remain on a trusted private LAN.

Built for

Home-lab operators who manage Linux and Raspberry Pi devices on a trusted local network.

Poll CPU, memory, disk, temperature, and network metrics every ten seconds
Run saved or one-off SSH commands with live console output
Keep per-device command libraries with pinned actions, sudo, and confirmations
Push current metrics and console output to the browser over WebSocket
Require a single dashboard password and serve the browser over local HTTPS

Get it

Download the release tarball from GitHub Releases and run the included install.sh on the Linux host. It creates a dedicated service account, installs under /opt/simple-network-dashboard, sets your dashboard password, picks a free internal port, and configures systemd with a local Caddy server that serves HTTPS on port 443 by default.

GitHub Releases

Verify the download

You can check GitHub’s build-provenance record against the released file.

gh attestation verify simple-network-dashboard-vX.Y.Z.tar.gz --repo JDE-Projects/Simple-Network-Dashboard --signer-repo JDE-Projects/Build-Tools

License

PolyForm Noncommercial License 1.0.0. Personal use and evaluation are fine. Commercial use, including use by a business, is not permitted under this license yet.

If your team wants to use a tool at work, see commercial licensing on the support page.

Source repository