WatchYourLAN

Scan your local network to discover connected devices. Receive instant notifications for new hosts, track online/offline history, and visualize data in Grafana.

Keep a close watch on your local network with this lightweight IP scanner. Written in Go, it provides a simple web interface to see all connected devices, track their status, and maintain a comprehensive list of every host that has ever joined your network. It is designed for easy deployment, running efficiently as a Docker container.

This tool is particularly useful for monitoring network activity and identifying unauthorized devices. Its key capabilities include:

  • Instant Notifications: Get immediate alerts via services like Discord, Telegram, Slack, and more whenever a new device connects to your network.
  • Device History: Maintain a log of when each device was online or offline, with options to trim the history to save space.
  • Data Visualization: Export scan data directly to InfluxDB2 or Prometheus. This allows you to create detailed and powerful dashboards in Grafana to visualize network trends over time.
  • Flexible Configuration: Set up the scanner through its web GUI, a simple YAML config file, or environment variables to fit your workflow.
  • Broad Compatibility: Pre-built binaries are available for multiple architectures, including amd64, arm_v7, and arm64.

Directory Structure

watchyourlan
data
.env
docker-compose.yml

docker-compose.yml

services:
  watchyourlan:
    image: aceberg/watchyourlan
    container_name: watchyourlan
    network_mode: "host"
    restart: unless-stopped
    environment:
      - IFACE=eth0
      - TZ=UTC
      - GUIIP=0.0.0.0
      - GUIPORT=8840
      - SHOUTRRR_URL=${SHOUTRRR_URL}
    volumes:
      - ./data:/data/WatchYourLAN

.env

SHOUTRRR_URL=
Categories:

Share:

Ad
Favicon

 

  
 

Similar to WatchYourLAN

Favicon

 

  
  
Favicon

 

  
  
Favicon