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-Orangutan logo

Self-host LAN-Orangutan

v3.4.2

Network discovery with persistent labels and Tailscale

ReleaseOpen SourceMIT
Updated11 hours ago
LanguageGo
Setup difficultyEasy
ThemeDark mode
Stars
1 137
Port
291 (Web dashboard and API)
Requires
Nmap
Docker
291group/lan-orangutan
Install with Docker
LAN Orangutan dashboard in light mode showing network cards and device tableLAN Orangutan dashboard in dark mode showing the same network cards and device table

What is LAN-Orangutan?

LAN Orangutan is a lightweight network discovery tool for homelabbers. It scans local networks using nmap to find every device, then lets you organize devices with custom labels and groups that persist across scans. It supports multiple networks simultaneously, integrates with Tailscale to show tailnet peers, and provides both a web dashboard with theme options and a full CLI with JSON output. The app runs as a single Go binary with no dependencies on Linux, macOS, and Windows, or via Docker on Linux with host networking. It stores data locally in files, requires nmap for MAC address and vendor lookup, and uses a simple password-protected web interface. No cloud, no telemetry, no account system.

Should you self-host LAN-Orangutan?

LAN-Orangutan scores 58/100 on selfhost.directory (how scoring works) and ranks #15 of 48 in Network Monitoring. It has 1 137 GitHub stars.

It shipped 7 stable releases in the past year. The latest, v3.4.2, came out on 18 October 2026. New versions land roughly every 2 weeks.

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 (86/100, 46 441 stars). It scores higher overall, so compare the two before you pick. See LAN-Orangutan vs mitmproxy side by side.

Features

  • Backup and Restore
  • CLI with JSON output
  • Continuous scanning
  • Cross-platform single binary
  • CSV/JSON Export
  • Device monitoring and alerts
  • Multi-network support
  • Network device discovery
  • Network snapshots and comparison
  • Password-protected web UI
  • Persistent device labeling
  • REST API
  • Tailscale IntegrationRequires Tailscale CLI on host; not available in Docker
  • Web Dashboard

LAN-Orangutan README

How to install LAN-Orangutan

Install LAN-Orangutan with Docker

Linux host, nmap, Docker with host networking, NET_RAW/NET_ADMIN/NET_BIND_SERVICE capabilities
Environment variables
ORANGUTAN_PORT, ORANGUTAN_BIND_ADDRESS, ORANGUTAN_PASSWORD, ORANGUTAN_PASSWORD_FILE, ORANGUTAN_SESSION_HOURS, ORANGUTAN_ALLOW_INSECURE, ORANGUTAN_DATA_DIR, ORANGUTAN_SCAN_INTERVAL, ORANGUTAN_NETWORKS, ORANGUTAN_THEME, ORANGUTAN_EXCLUDE_NETWORKS, ORANGUTAN_ONLY_CONFIGURED_NETWORKS, ORANGUTAN_ENABLE_SERVICE_DETECTION

Requires Linux with host networking. Does not work on Docker Desktop for macOS/Windows.

How to configure LAN-Orangutan

  • ORANGUTAN_ALLOW_INSECUREfalseSkip password protection

    Skip password protection

    values: true, false

  • ORANGUTAN_BIND_ADDRESS0.0.0.0Address to bind to

    Address to bind to

  • ORANGUTAN_DATA_DIRWhere devices and settings are stored

    Where devices and settings are stored

  • ORANGUTAN_ENABLE_SERVICE_DETECTIONfalseEnable service detection for deeper device typing

    Enable service detection for deeper device typing

    values: true, false

  • ORANGUTAN_EXCLUDE_NETWORKSNetworks to hide from auto-detected list

    Networks to hide from auto-detected list

  • ORANGUTAN_NETWORKSExtra networks to scan, comma separated

    Extra networks to scan, comma separated

  • ORANGUTAN_ONLY_CONFIGURED_NETWORKSfalseScan only configured networks, ignore auto-detection

    Scan only configured networks, ignore auto-detection

    values: true, false

  • ORANGUTAN_PASSWORDSet the password directly

    Set the password directly

  • ORANGUTAN_PASSWORD_FILERead the password from a file

    Read the password from a file

  • ORANGUTAN_PORT291Port to listen on

    Port to listen on

  • ORANGUTAN_SCAN_INTERVAL300Auto-scan interval in seconds

    Auto-scan interval in seconds

  • ORANGUTAN_SESSION_HOURS168How long a login lasts

    How long a login lasts

  • ORANGUTAN_THEMEautoTheme: light, dark, or auto

    Theme: light, dark, or auto

    values: light, dark, auto

LAN-Orangutan releases & version history

More in Homelab

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…