WatchYourLAN

Open source

WatchYourLAN is a small Go network scanner with a web interface that tracks which hosts appear on a local network and when they come and go.

hub.docker.com
WatchYourLAN homepage screenshot
GitHub stars
7.7k
Last 30 days
+36(+0%)
Last commit
1 yr ago
Repository age
4 years
Version
2.1.4
Licence
MIT
Self-hosted
Yes

About WatchYourLAN

WatchYourLAN scans a network interface at a set interval and builds a list of every host it sees. It is written in Go, ships a web interface on port 8840 by default, and keeps a history of when each host was online or offline.

When a host shows up that it has not seen before, it can send a notification through Shoutrrr, which covers services such as Discord, Email, Gotify, Matrix, Ntfy, Pushover, Slack and Telegram. Data can also be pushed to InfluxDB2 or Prometheus so the results can be charted in Grafana.

It is distributed as a Docker image that must run in host network mode, and as .deb, .rpm, .apk and .tar.gz packages for several CPU architectures. Settings come from a config file, the web interface or environment variables, and data lives in SQLite or PostgreSQL.

Key features

  • Notification when a new host appears
  • Online and offline history for each host
  • Maintains a list of every host on the network
  • Exports data to InfluxDB2 or Prometheus for Grafana
  • Configured by file, web interface or environment variables
  • Packages for deb, rpm, apk and tarball

Good fit for

  • Spotting unknown devices on a home network
  • Tracking device uptime history
  • Feeding network presence data into Grafana
Built with
Go tools
Tags
network scanner
lan
monitoring
docker
grafana
self-hosted
go

WatchYourLAN: questions and answers

What is WatchYourLAN used for?
WatchYourLAN is a small Go network scanner with a web interface that tracks which hosts appear on a local network and when they come and go. It is a good fit for spotting unknown devices on a home network, tracking device uptime history and feeding network presence data into Grafana.
Is WatchYourLAN open source?
Yes. WatchYourLAN is open source under the MIT licence. Its source code is on GitHub at aceberg/WatchYourLAN and is written mainly in Go.
Is WatchYourLAN free?
Yes. WatchYourLAN is open source, so the software itself is free to use.
Can I self-host WatchYourLAN?
Yes. WatchYourLAN can be self-hosted on your own server or infrastructure.
What are some alternatives to WatchYourLAN?
Similar open-source tools in the Networking & VPN category include LAN Orangutan, Nginx Proxy Manager and wg-easy. SaaS products in the same category include Aruba Central, Pelion Device Management and Akamai.
Is WatchYourLAN actively maintained?
The most recent commit to WatchYourLAN was on 10 September 2025, and the latest release is 2.1.4, published on 10 September 2025. The project has 7.7k stars on GitHub, with 36 added in the last 30 days.

Open-source alternatives to WatchYourLAN

See all

SaaS alternatives to WatchYourLAN

See all