aceberg/watchyourlan

WatchYourLAN is a self-hosted network scanner with a web interface. It continuously scans your local network using ARP, a standard method for discovering which devices are connected to a network, and keeps a list of every device it finds by its IP address and MAC address. When a new device appears on the network that it has not seen before, it can send you a notification. The web interface shows you which hosts are currently online and which are offline, along with a history of when each device was last seen. If you want to track this data over time with charts, WatchYourLAN can send its data to InfluxDB2 or expose it as a Prometheus metrics endpoint, both of which work with Grafana, a popular dashboarding tool. You can also choose to store data in either SQLite (a simple local database file) or PostgreSQL. Notifications can be sent to a wide range of services via a library called Shoutrrr, which supports Discord, Telegram, Slack, email, Gotify, Ntfy, Matrix, Pushover, and generic webhooks. You configure the notification destination through a single URL string. The easiest way to run it is with Docker. You specify which network interface to scan and your timezone as environment variables, and the web interface becomes available at port 8840. Binary packages for Debian, RPM-based, and Alpine Linux systems are also available, supporting a range of processor architectures including various ARM variants, which means it can run on a Raspberry Pi or similar small device. Configuration can be done through environment variables, a YAML config file, or directly through the web GUI. The app does not include built-in login or authentication, but the README notes that you can place it behind tools like Authelia for single sign-on access control. There is also an option to run it entirely without internet access by serving its frontend assets from a local container.