Netcheck refers to two distinct open-source network monitoring tools, each serving different use cases in the Linux DevOps ecosystem. Neither is a full-featured status page platform like Uptime Kuma or Cachet, but both provide valuable network availability monitoring with Prometheus metrics export.
βNetcheckβ encompasses two separate projects:
| Project |
Type |
Language |
Best For |
| m1/netcheck |
Network availability monitor with Prometheus metrics |
Rust |
Kubernetes, cloud-native environments, Prometheus/Grafana stacks |
| TristanBrotherton/netcheck |
Internet connectivity logger |
Shell (Bash) |
Home networks, ISP monitoring, simple uptime logging |
- Multi-target monitoring β Check multiple network connections simultaneously
- Prometheus metrics export β Native
/metrics endpoint for Grafana integration
- Configurable thresholds β Timeout, connect timeout, failure threshold, wait time
- Kubernetes-ready β Helm chart included, Docker container support
- Dual network testing β External (internet) and internal (cluster) connectivity checks
- Lightweight β Written in Rust for minimal resource usage
- Alertmanager integration β Works with Prometheus Alertmanager for notifications
- Simple connectivity logging β Logs downtime with timestamps and duration
- Speedtest integration β Optional speedtest on reconnection
- Event hooks β Custom scripts on disconnect, reconnect, or every check
- Web interface β Optional lightweight web UI for log viewing
- Systemd service β Can run as a background service
- Activity chart β GitHub-style contribution chart for downtime visualization
- Zero dependencies β Pure bash script, works on any Linux system
- ISP uptime monitoring β Track home/office internet stability over time
- Kubernetes network checks β Verify cluster can reach external services
- Prometheus monitoring stack β Add network availability metrics to existing Grafana dashboards
- Simple connectivity logging β Log outages without complex setup
- Lightweight alternative β When full status page tools are overkill
Netcheck is not a full status page solution. Consider alternatives if you need:
- β Public-facing status pages with incident management
- β Multi-protocol monitoring (HTTP, TCP, DNS, Docker, SSL)
- β Subscriber notifications and email digests
- β Scheduled maintenance windows
- β Component grouping and service dependencies
- β Multi-user access control and authentication
- β Rich web-based configuration UI
For full status page features, see: Uptime Kuma, Cachet, Gatus, or Vigil.
| Component |
m1/netcheck |
TristanBrotherton/netcheck |
| Language |
Rust (95%+) |
Bash/Shell |
| Deployment |
Docker, Kubernetes, Binary |
Shell script, Systemd service |
| Storage |
In-memory metrics |
Flat file logs |
| Metrics |
Prometheus /metrics endpoint |
Custom log parsing |
| Web UI |
None (metrics only) |
Optional simple web interface |
| Resource Usage |
~10-20 MB RAM |
~5 MB RAM |
- m1/netcheck: GPL-3.0
- TristanBrotherton/netcheck: MIT
- Both projects are active and maintained
- m1/netcheck v0.0.1 released March 2024 (latest stable)
- TristanBrotherton/netcheck actively maintained since 2014
- Neither project provides a full status page solution β they are network monitoring utilities
docker run -d \
--name netcheck \
-p 8080:8080 \
ghcr.io/m1/netcheck:latest \
run --target external=https://one.one.one.one,https://dns.google
git clone https://github.com/TristanBrotherton/netcheck
cd netcheck
./netcheck.sh -i # Install as systemd service
ΒΆ History and References
For status page solutions with incident management, consider:
| Tool |
Best For |
Complexity |
| Uptime Kuma |
All-in-one monitoring with beautiful UI |
β Easy |
| Gatus |
Configuration-as-code, GitOps workflows |
ββ Medium |
| Cachet |
Enterprise status pages with incident management |
βββ Advanced |
| Vigil |
High-performance Rust-based monitoring |
ββ Medium |
| Statping-ng |
Go-based lightweight status page |
ββ Medium |
Any questions?
Feel free to contact us. Find all contact information on our contact page.