WatchYourLAN

A lightweight network IP scanner with a web GUI. Detects devices via ARP scanning, keeps discovery history, and sends alerts for new hosts.

Note: ARP-based network scanning requires host network mode, which is not available in containerized cloud environments. The web UI and history features will function, but live scanning of your local network requires running on bare metal or a VM with host networking.

What You Can Do After Deployment

1. Visit your domain — open the web dashboard to view scanned hosts
2. Configure network interfaces — set the IFACES environment variable to your target interfaces
3. Adjust scan interval — change TIMEOUT to control how often scans run (default: 120 seconds)
4. Switch themes — set THEME to any Bootstrap theme name and COLOR to light or dark
5. Enable notifications — configure SHOUTRRR_URL for alerts when new devices are found
6. Export metrics — enable Prometheus or InfluxDB export for monitoring dashboards

Key Features

• ARP-based network scanning
• Web GUI with device history
• Configurable scan intervals
• New device notifications via Shoutrrr
• Prometheus and InfluxDB metrics export
• Light and dark themes
• SQLite storage (no external database needed)

License

MIT — GitHub