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.

LAN Sheriff logo

Self-host LAN Sheriff

v1.0.2

Network monitor mapping outbound traffic, flagging threats

ReleaseOpen SourceAGPL-3.0
Updatedlast week
LanguageGo
Setup difficultyModerate
MobileResponsive
Stars
156
CPU
~6% of one core (Raspberry Pi 3 Model B+)
RAM
64 MB (Raspberry Pi 3 Model B+)
Storage
512 MB maximum database size
Ports
2911 (Dashboard and JSON API), 2912 (Paired peers (Dispatch))
Docker
ghcr.io/291-group/lan-sheriff
The Watchtower outbound map in Deputy modeWalkthrough of all views including Watchtower, Precinct Map, Wanted List, and Dispatch pairingWatchtower live map with arcsWatchtower with destinations panelRadio Chatter DNS feedRoster device inventoryWanted List suspicion enginePairing code screen

What is LAN Sheriff?

LAN Sheriff is a self-hosted network monitoring tool that watches outbound traffic from devices on your network. It operates in two modes: Deputy Mode reads OS socket tables without special privileges to identify which application made each connection, while Patrol Mode captures packets with elevated access to see all devices at a vantage point and provide DNS visibility. Key features include a live world map showing connections, a DNS lookup stream, an auto-generated network diagram, a device inventory, and a suspicion engine with eight detection rules. Multiple instances can pair to share hourly summaries across machines. Alerts can be sent via webhook, ntfy, Discord, or Slack. The software runs on major desktop and server platforms including Raspberry Pi, and is licensed under AGPL-3.0.

Should you self-host LAN Sheriff?

LAN Sheriff scores 47/100 on selfhost.directory (how scoring works) and ranks #31 of 48 in Network Monitoring. It has 156 GitHub stars.

It shipped 3 stable releases in the past year. The latest, v1.0.2, came out on 19 October 2026. New versions land roughly every 4 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Go.

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

Features

  • Alerts (webhook, ntfy, Discord, Slack)Configured via CLI flags only, not in dashboard
  • Bounded self-pruning database
  • CSV/JSON Export
  • Device inventory (The Roster)
  • DNS feed (Radio Chatter)Requires Patrol Mode or machine acting as resolver
  • Live egress map (The Watchtower)
  • Multi-language Support
  • Network diagram (The Precinct Map)
  • No account/cloud/telemetry
  • Offline database viewer
  • Passive capture (never blocks)
  • Peer sharing (The Dispatch)Off by default; manual pairing via code
  • Suspicion engine (The Wanted List)
  • Two capture modes (Deputy/Patrol)Auto-detected based on privileges

LAN Sheriff README

How to configure LAN Sheriff

  • --city-dbtrueEnable city-level GeoIP database download

    Enable city-level GeoIP database download

  • --data-dirOverride data directory path (CLI flag)

    Override data directory path (CLI flag)

  • --dispatchfalseEnable peer sharing (The Dispatch)

    Enable peer sharing (The Dispatch)

  • --dispatch-allow-publicfalseAllow Dispatch listener on globally routable address

    Allow Dispatch listener on globally routable address

  • --interfaceauto-detectedNetwork interface to capture on (Patrol Mode)

    Network interface to capture on (Patrol Mode)

  • LAN_SHERIFF_DATA_DIROverride data directory path

    Override data directory path

  • --listen127.0.0.1:2911Bind address for dashboard (default: localhost only)

    Bind address for dashboard (default: localhost only)

  • --locatetrueEnable public IP lookup via api.ipify.org

    Enable public IP lookup via api.ipify.org

  • --notify-discordDiscord webhook URL for alerts

    Discord webhook URL for alerts

  • --notify-min-score0.6Minimum score threshold for alerts (0-1)

    Minimum score threshold for alerts (0-1)

  • --notify-ntfyntfy.sh webhook URL for alerts

    ntfy.sh webhook URL for alerts

  • --notify-slackSlack webhook URL for alerts

    Slack webhook URL for alerts

  • --notify-webhookGeneric webhook URL for alerts (plain JSON)

    Generic webhook URL for alerts (plain JSON)

  • --require-passwordfalseRequire password authentication for dashboard access

    Require password authentication for dashboard access

  • --sweeptrueEnable local address sweep for device discovery

    Enable local address sweep for device discovery

LAN Sheriff releases & version history

More in Network Monitoring

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…