gnacho/netpulse
DevOps & Self-hostingSelf-hosted dashboard for OpenWrt and GL.iNet home networks with live health, devices, WireGuard and AdGuard stats.
What it does
NetPulse is a self-hosted PWA for watching a home or small-office network built around OpenWrt/GL.iNet routers. A Go server collects data from an agent on each router, stores it in SQLite, and serves a React dashboard over SSE so fleet status, per-router health, connected devices, WireGuard peers, AdGuard Home statistics and alerts update live. It is aimed at people who own their network hardware and want monitoring without sending data to a cloud service.
Beyond status cards, the dashboard infers a topology from bridge FDB, LLDP and SNMP data, classifies devices, scores network health on a 0-100 scale, and can schedule WAN speed tests. Alerts can be delivered through Web Push, ntfy, Telegram or an outgoing webhook. Optional MQTT publishing lets Home Assistant discover fleet entities. Vendor support for MikroTik, Asuswrt/Merlin, OPNsense and UniFi comes through separate pusher integrations, which keeps platform-specific code off the routers.
Install and start
The documented path assumes a Linux machine with systemd (x86_64, arm64 or armv7) and OpenWrt/GL.iNet routers on the LAN. Install the server by running the published installer; the README recommends downloading it first so it can be read before running it install the server.
curl -fsSL --retry 3 -o /tmp/netpulse-install.sh https://raw.githubusercontent.com/gnacho/netpulse/main/install.sh && sh /tmp/netpulse-install.sh
The installer creates a netpulse systemd service and prints an initial admin password. Open http://<server-ip>:3000, log in, and authorize the SSH key the server generated on first boot by appending its public key to each router's /etc/dropbear/authorized_keys. Then use Routers → Install agent in the UI; the server pushes the correct binary for the router architecture, writes the config and starts the service.
Installing the PWA from the browser and enabling Web Push in Settings lets alerts reach a phone. To explore without hardware, the README documents a demo mode with a 67-device sample network, and a read-only hosted demo is available at live demo.
Constraints
OpenWrt/GL.iNet routers are connected through the native agent; MikroTik, Asuswrt/Merlin, OPNsense and UniFi require the separate pusher integrations described in the external integrations guide. SNMP-managed switches are supported. The server runs on Linux with systemd, or on an OpenWrt router with a separately documented on-box mode. LAN discovery can find the gateway, but monitoring other routers depends on SSH access or the pairing-token flow.
The embedded MCP server is off by default; when enabled with NETPULSE_MCP_ENABLED=1, it uses API tokens over HTTP and grants read access to the whole network state, so the README advises keeping it on the LAN. MQTT and the rack preview are also opt-in. The software is licensed AGPL-3.0, and the install scripts, manual and changelog live in the repository.
HotRepo's take
On the Go daily list for 2026-11-16, NetPulse recorded 332 stars and 22 forks, with 36 stars gained and a best position of 7 for that day. That is a single daily snapshot, so it does not establish a longer trend, but it shows the project attracting attention in the Go ecosystem. The design decision worth noting is that platform integrations stay outside the server, so the core remains a single Go binary and a router only carries the agent for its own platform; that structure keeps the self-hosted footprint small while support for non-OpenWrt devices grows independently.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- bnlqn/overlookRead-only homelab status page that aggregates checks, server health, app stats, and chores from tools you already run.
- netbirdio/netbirdBuilds identity-based private networks that connect devices peer-to-peer over WireGuard, with central access control.
- vernesong/OpenClashRuns and manages a Mihomo proxy client on OpenWrt routers with rule-based transparent routing.
- TwiN/gatusSelf-hosted health dashboard that monitors endpoints and sends alerts when services degrade.
- tailscale/tailscaleA WireGuard-based mesh VPN daemon and CLI for connecting servers, laptops and remote devices into one private network.