WatchYourLAN

WatchYourLAN is an open-source, self-hosted network IP scanner with a web GUI. It monitors local network activity by scanning for connected devices and maintaining a record of their status. The application is typically deployed as a Docker container using host network mode or installed as a binary package on Linux systems. It functions as a lightweight tool for network administrators to keep track of all active hardware within a specific environment.

The software tracks which hosts are online or offline and alerts administrators when new devices appear on the network. It provides a centralized interface to view a list of all discovered hosts and their connection history. Users can configure the scanning frequency and the specific network interfaces to be monitored via a config file, environment variables, or the graphical user interface. This allows for precise control over how often the network is polled for changes.

Key features

• Sends notifications when new hosts are detected
• Tracks online and offline history for network hosts
• Maintains a comprehensive list of all network devices
• Exports data to InfluxDB2 or Prometheus for Grafana dashboards
• Supports multiple database backends including SQLite and PostgreSQL
• Integrates with Shoutrrr for notifications via Discord, Telegram, and Slack
• Provides a web-based interface for configuration and monitoring

The application relies on arp-scan and tzdata as system dependencies to perform its network discovery. While it does not include built-in authentication, it is designed to be paired with SSO tools like Authelia or ForAuth to secure the web interface. It is intended for users who need visibility into their local network infrastructure and wish to integrate network availability data into broader monitoring stacks. The software supports a wide range of architectures, including amd64, i386, arm64, and several ARM v5 through v7 versions, ensuring compatibility across various hardware platforms from servers to single-board computers.

WatchYourLAN serves as a lightweight utility for local network monitoring and intrusion detection.