selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

WatchYourLAN logo

Self-host WatchYourLAN

2.1.4

Lightweight Go LAN scanner with web GUI and new-host alerts

ReleaseOpen SourceMIT
docker run --name wyl -e "IFACES=$YOURIFACE" -e "TZ=$YOURTIMEZONE" --network="host" -v $DOCKERDATAPATH/wyl:/data/WatchYourLAN aceberg/watchyourlan
Updatedlast year
LanguageGo
Setup difficultyEasy
ThemeDark mode
Stars
7 654
Port
8840 (Web GUI)
Requires
Arp-scan, Tzdata
Docker
aceberg/watchyourlan
Main WatchYourLAN screen (first README screenshot)WatchYourLAN GUI, additional screenshot 2WatchYourLAN GUI, additional screenshot 3WatchYourLAN GUI, additional screenshot 4WatchYourLAN GUI, additional screenshot 5

What is WatchYourLAN?

WatchYourLAN is a lightweight, open-source LAN scanner written in Go that keeps an inventory of every device seen on your network and shows it in a web GUI. It runs arp-scan on the interfaces you choose, records which hosts came online or went offline (history is stored in the database and trimmed after a configurable number of hours), and can alert you the moment an unknown device appears. Notifications go out through the already-integrated Shoutrrr library, so one URL can point at Telegram, Slack, Discord, Gotify, Matrix, Ntfy, e-mail or a generic webhook. For dashboards it exports to InfluxDB2 or exposes a Prometheus /metrics endpoint, and the settings can be reached through a REST API. Self-hosting is a single Docker container that must run in host network mode (GUI on port 8840), with .deb, .rpm, .apk and .tar.gz packages plus an amd64 deb repository for Linux installs; AUR, Umbrel and YunoHost packages are also listed. There is no built-in login, so the README suggests putting it behind an SSO tool such as Authelia, and because host networking exposes the GUI port it warns you to restrict access by firewall. Themes and fonts are fetched from the internet unless you serve them from the companion node-bootstrap image. MIT-licensed, latest release 2.1.4 (September 2025).

WatchYourLAN alternatives

Should you self-host WatchYourLAN?

WatchYourLAN scores 68/100 on selfhost.directory (how scoring works) and ranks #4 of 48 in Network Monitoring. It has 7 654 GitHub stars, +24 in the last 30 days.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is mitmproxy (85/100, 46 734 stars). It scores higher overall, so compare the two before you pick. See WatchYourLAN vs mitmproxy side by side.

Features

  • Configuration via file, GUI or environment variables
  • External SSO / reverse-proxy authentication
  • Host inventory
  • LAN IP / device scanning (arp-scan)
  • Notifications
  • Online/offline history
  • REST API
  • Web GUI

WatchYourLAN README

WatchYourLAN


Docker Go Report Card Docker Image Size (latest semver) GitHub Discussions

aceberg%2FWatchYourLAN | Trendshift

Lightweight network IP scanner with web GUI. Features:

How to install WatchYourLAN

Install WatchYourLAN with Docker

host network mode
docker run --name wyl \
	-e "IFACES=$YOURIFACE" \
	-e "TZ=$YOURTIMEZONE" \
	--network="host" \
	-v $DOCKERDATAPATH/wyl:/data/WatchYourLAN \
    aceberg/watchyourlan

Network mode must be host; mount a data path at /data/WatchYourLAN. Web GUI at http://localhost:8840.

How to configure WatchYourLAN

  • TZSet your timezone for correct time
  • HOST0.0.0.0Listen address
  • PORT8840Port for web GUI
  • THEMEsandAny theme name from bootswatch.com in lowcase or additional themes
  • COLORdarkBackground color: light or dark

    values: light, dark

WatchYourLAN releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Network Monitoring

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…