NetWatcher is an open-source distributed network monitoring platform built for developers, sysadmins, and MSPs who need powerful, real-time visibility into their network infrastructure.
Deploy lightweight agents across your infrastructure and get instant insights through beautiful dashboards — all self-hosted and under your control.
| Repository | Description |
|---|---|
| oss | 🏠 Full Platform — Controller (Go backend), Panel (Vue 3 frontend), and Agent in one monorepo. Start here for self-hosting! |
| agent | 🤖 Standalone Agent — Lightweight Go daemon for running network probes. Auto-updates from GitHub releases. |
- MTR Checks — Multi-hop traceroute with per-hop latency and packet loss analysis
- Ping Monitoring — ICMP latency monitoring with detailed RTT statistics
- Traffic Simulation — Synthetic traffic generation between agents using rPerf
- System Metrics — CPU, memory, disk, and OS information collection
- Network Info — Public IP, gateway, ISP, and interface data
- Real-time Dashboards — Live WebSocket updates with interactive visualizations
- Role-Based Access — Owner, Admin, User, and Viewer permission levels
- Auto-Updates — Agents automatically update from GitHub releases
| Component | Technology |
|---|---|
| Backend | Go (Iris framework), REST API, WebSocket |
| Frontend | Vue 3, Vite, TailwindCSS |
| Databases | PostgreSQL (metadata), ClickHouse (time-series) |
| Deployment | Docker, Docker Compose, Caddy |
# Clone the OSS repository
git clone https://github.com/netwatcherio/oss.git
cd oss
# Start with Docker Compose
docker-compose up -d📖 See our documentation for detailed setup guides.
We welcome contributions! Whether it's bug fixes, new features, or documentation improvements:
- Check out our open issues
- Fork the repo and create a feature branch
- Submit a pull request
- 📧 Email: [email protected]
- 🐛 Issues: GitHub Issues
Built with ❤️ by the NetWatcher Team
Shaun Agostinho & Contributors