See every device on your network, what it is, and what it's running. One binary, a web dashboard, and nothing ever leaves your network.
Only scan networks you own or are authorized to administer.
- Finds devices with the ARP table, mDNS/Bonjour, SSDP/UPnP, NetBIOS and LLMNR, plus raw ARP and ICMP sweeps when run as admin/root
- Light port scan with banner grabbing (rate limited,
-no-port-scanto skip) - Vendor lookup from the embedded IEEE registry (MA-L, MA-M, MA-S); randomized MACs are labeled as such
- Guesses device type (router, printer, TV, phone...) and shows why and how sure
- Remembers first/last seen, IP and hostname history
- Alerts for new devices, newly opened ports, and an IP moving to a new MAC
- Rename, tag and mark devices as trusted; export to CSV/JSON
- Fully offline: no telemetry, no background update checks, no CDN
- One-click updates from Settings: downloads the latest release, checks it
against
SHA256SUMSand restarts
Download the binary for your OS from Releases, or build it (below).
Release files are named LocalLanView-<version>-<os>-<arch>. On Linux
and macOS, check the download against SHA256SUMS, make it executable
and run it:
sha256sum -c --ignore-missing SHA256SUMS # macOS: shasum -a 256 -c --ignore-missing SHA256SUMS
chmod +x LocalLanView-v*-linux-amd64
./LocalLanView-v*-linux-amd64It opens http://127.0.0.1:8787. The first run prints a random password
once. Log in as admin and change it under Settings.
Windows: the exe isn't code-signed, so SmartScreen will say "Windows
protected your PC". Click More info, then Run anyway. Check the
file against SHA256SUMS first if you want to be sure it's the real one:
Get-FileHash .\LocalLanView-*.exe.
macOS: same story with Gatekeeper. Run
xattr -d com.apple.quarantine ./LocalLanView-* once, or right-click the
file and choose Open.
-mode |
Behavior |
|---|---|
auto (default) |
Uses elevated features if already running as admin/root, otherwise standard |
std |
Never uses elevated features |
elv |
Requires admin/root, exits with instructions otherwise |
Elevated mode adds the raw ARP sweep and ICMP, which find devices that ignore everything else. It never asks for elevation itself. On Linux you can skip root with:
sudo setcap cap_net_raw+ep ./LocalLanViewWhen started with sudo, doas or pkexec, it drops back to your user
after opening its sockets. If root starts it directly (a service, say),
name the account to switch to with -run-as; otherwise it warns that it is
staying root. The Capabilities page shows which features are on and why.
| Flag | Default | |
|---|---|---|
-addr |
127.0.0.1:8787 |
host:port, :port or port (the last two bind to loopback) |
-lan |
off | Open the console to other devices on this network and remember it (-lan=false turns it off) |
-addr-fallback |
off | Use a free port if the chosen one is taken |
-allow-host |
Extra names the console answers to off loopback, comma-separated | |
-user |
admin |
Console username |
-password-file |
Read the password from a file | |
-set-password |
Prompt for a new password (or take it from the file/env) | |
-mode |
auto |
auto, std or elv |
-run-as |
Account to switch to when started as root without sudo | |
-data-dir |
per-user config dir | Database location |
-scan-interval |
5m |
Time between scans |
-interface, -subnet |
auto | Override detection (subnet must be on the interface). Auto-detection skips VPN tunnels and Docker/VM bridges |
-probe-rate |
100 |
Max probe packets per second |
-no-port-scan |
off | Skip TCP probes |
-tls-cert, -tls-key |
Serve HTTPS with your certificate | |
-tls-self-signed |
off | Serve HTTPS with a generated certificate |
-webhook |
POST alerts to a local/private URL | |
-notify |
off | Desktop notifications for alerts |
-no-open-browser, -version |
The password can also come from LOCALLANVIEW_PASSWORD. There's no
-password flag on purpose: it would show up in ps and shell history.
A password from -password-file or the variable is applied when it's new;
starting again with the same one keeps any change made on the Settings page.
-set-password always applies it.
LAN access is off by default. To turn it on, set your own password first
(Settings, or -set-password), then either:
- tick Open LocalLanView to devices on this network under Settings, or
- start it with
-lan.
The console restarts on every network interface, on the same port, over
HTTPS with a self-signed certificate (browsers warn about it once). Typing
the address without https:// works too; you're sent to the HTTPS page. The
address to use, such as https://192.168.1.50:8787, is shown under
Settings, in the sidebar's Network card and in the terminal. The choice is
remembered across restarts; untick the box or run with -lan=false to go
back to this machine only. If other devices can't connect, allow the port
through this computer's firewall.
For full control, -addr still works and overrides the setting:
LOCALLANVIEW_PASSWORD='a long passphrase' ./LocalLanView -addr 0.0.0.0:8787 -tls-self-signedBinding to anything other than loopback is refused until you've set your own strong password. Without TLS you'll get a warning, since logins would travel in plain text.
To block DNS rebinding, the console only answers to IP addresses, this
machine's name (also as name.local) and the names in your TLS
certificate. If you reach it through another name, such as a DNS entry on
your router, add it with -allow-host nas.lan.
- It sees only the subnet it's attached to. VLANs and guest networks need their own instance.
- Sleeping devices and ones that ignore probes look offline. That's why devices show "last seen" instead of up/down.
- Randomized (private) MACs hide the vendor and can make one phone look like several devices over time. Names and services still help.
Needs Go only.
make build # this machine
make dist # all OS/arch combinations into dist/, with SHA256SUMS
make testOn Windows: .\build.ps1 or .\build.ps1 -Dist. Builds are static
(CGO_ENABLED=0) and reproducible.
MIT
