Repolode
Submit
291-Group

291-Group/LAN-Orangutan

Self-hosted network discovery tool that finds devices on your LAN, labels and groups them, and flags changes over time, with Tailscale support.

Open-source alternative to:Fing

View on GitHubWebsite
Stars
1,150
Forks
64
Open issues
3
Last commit
7 days ago

What is it?

LAN Orangutan scans your local networks to find every connected device, then lets you label, group, and add notes to each one. It runs as a single Go binary and is operated through a web dashboard or a CLI with JSON output. Device discovery uses nmap, so nmap must be installed on the host.

You can save snapshots of your network and compare them later to see what changed. Devices you mark as expected trigger a notification when something new appears or something goes missing. Backups, restores, and shareable HTML reports are available from the dashboard.

Tailscale peers are read directly from the Tailscale CLI and listed alongside local devices, and you can connect or disconnect Tailscale from inside the app. The dashboard is protected by a password set on first run. Docker support is limited to Linux with host networking; on macOS and Windows the binary must be run directly.

Key features

  • 01Discovers devices on local networks using nmap
  • 02Labels, groups, and annotates devices with custom group names
  • 03Saves network snapshots and compares them to show changes
  • 04Alerts when expected devices are missing or unknown devices appear
  • 05Shows Tailscale peers and lets you connect or disconnect from the app
  • 06Provides a web dashboard and a CLI with JSON output

Use cases

  • Homelab operators who want an inventory of every device on their network
  • Checking for unexpected or unknown devices joining a home or office LAN
  • Viewing Tailscale peers alongside local devices in one list
  • Exporting a shareable HTML report of the current network state

Quick start

  1. 1

    Install nmap, which is required (macOS shown)

    brew install nmap
  2. 2

    Install LAN Orangutan with Homebrew (macOS)

    brew install 291-group/tap/lan-orangutan
  3. 3

    Start the server with sudo for full device info, then create a password in the browser at http://localhost:291

    sudo ./orangutan serve

Things to know

  • Requires nmap to be installed separately.
  • Docker is only supported on Linux; Docker Desktop on macOS and Windows cannot scan your real network.
  • Full device info (MAC addresses, vendors) needs sudo or Administrator rights.
  • There is no built-in HTTPS, so a reverse proxy is needed for encrypted access.

In collections

Self-hosted appsCLI & terminal tools

Topics

#network-discovery#network-monitoring#homelab#self-hosted#nmap#tailscale#golang#lan#cli#device-discovery

FAQ

What is LAN-Orangutan?
Self-hosted network discovery tool that finds devices on your LAN, labels and groups them, and flags changes over time, with Tailscale support. LAN Orangutan scans your local networks to find every connected device, then lets you label, group, and add notes to each one. It runs as a single Go binary and is operated through a web dashboard or a CLI with JSON output. Device discovery uses nmap, so nmap must be installed on the host.
Is LAN-Orangutan free to use? What license does it have?
LAN-Orangutan is open source under the MIT license. Check the license terms before using it in commercial products.
Is LAN-Orangutan still maintained?
Actively maintained. The last commit to LAN-Orangutan was on Oct 31, 2026.
What can I use LAN-Orangutan for?
Homelab operators who want an inventory of every device on their network Checking for unexpected or unknown devices joining a home or office LAN Viewing Tailscale peers alongside local devices in one list Exporting a shareable HTML report of the current network state
How do I install LAN-Orangutan?
Install nmap, which is required (macOS shown): brew install nmap Install LAN Orangutan with Homebrew (macOS): brew install 291-group/tap/lan-orangutan Start the server with sudo for full device info, then create a password in the browser at http://localhost:291: sudo ./orangutan serve
Where can I get LAN-Orangutan?
The source code and installation instructions are on GitHub: https://github.com/291-Group/LAN-Orangutan

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects