🦧 LAN Orangutan

Self-hosted network discovery for homelabbers.

Scan your networks, discover devices, label and track them - all from a clean web UI or CLI.

By 291 Group

Features

• 🔍 Auto-discover devices using nmap
• 🏷️ Label, group, and add notes to devices
• 🌐 Multi-network support
• 🔗 Tailscale integration
• 💻 Modern web dashboard with light/dark mode
• ⌨️ Full CLI with JSON output
• 🍎 Cross-platform (Linux, macOS, Windows)
• 📦 Single binary, no dependencies

Quick Start

Download

Grab the latest release for your platform from GitHub Releases.

Run

# Linux/macOS - Run with sudo for full device info (MAC addresses, vendors)
sudo ./orangutan serve

# Windows (run as Administrator for full device info)
orangutan.exe serve

Open http://localhost:291 in your browser.

Requirements

• nmap must be installed:
• macOS: brew install nmap
• Ubuntu/Debian: sudo apt install nmap
• Windows: Download from nmap.org

CLI Usage

# Scan network (use sudo for MAC addresses and vendor info)
sudo orangutan scan                    # Scan default network
sudo orangutan scan 192.168.1.0/24     # Scan specific network
sudo orangutan scan all                # Scan all detected networks

# Start web server
sudo orangutan serve                   # Default port 291
sudo orangutan serve --port 8080       # Custom port

# List devices
orangutan list                         # List all devices
orangutan list --online                # List online devices only
orangutan list --format json           # JSON output

# Export
orangutan export devices.csv           # Export to CSV

# Check status
orangutan status                       # Show system status
orangutan version                      # Show version info

Why sudo?

Running with sudo (or as Administrator on Windows) allows nmap to: - Read the ARP table to get MAC addresses - Look up device vendors from MAC addresses - Get more accurate hostname resolution

Without elevated privileges, you'll still see device IPs but MAC addresses and vendors will be missing.

Web Dashboard

The web dashboard provides: - Real-time device status (online/offline) - Device grouping (Server, Desktop, Laptop, Mobile, IoT, etc.) - Labels and notes for each device - Search and filter devices - Export to CSV/JSON - Auto-refresh option - Keyboard shortcuts (/ to search, R to refresh, T to toggle theme)

Configuration

Config file location: - Linux: ~/.config/lan-orangutan/config.ini or /etc/lan-orangutan/config.ini (as root) - macOS: ~/Library/Application Support/lan-orangutan/config.ini - Windows: %APPDATA%\lan-orangutan\config.ini

See config.example.ini for available options.

Building from Source

git clone https://github.com/291-Group/LAN-Orangutan.git
cd LAN-Orangutan
go build -o orangutan ./cmd/orangutan

License

MIT License

Built with ❤️ by 291 Group