LAN-Orangutan is a self-hosted network discovery tool. Find every device on your LAN, label and group them, snapshot your network and compare it later, and get flagged when something unexpected shows up. Single binary, no setup, Tailscale built in. Built by 291 Group.
Troubleshooting
No MAC addresses or vendor info
MAC addresses and vendor information require elevated privileges to read the ARP table.
Solution: Run with sudo (or as Administrator on Windows):
# Linux/macOS
sudo orangutan scan
sudo orangutan serve
# Windows - run Command Prompt as Administrator
orangutan.exe scan
Service won't start
# Check service status
sudo systemctl status lan-orangutan
# View logs
sudo journalctl -u lan-orangutan -n 50
# Check if binary exists and is executable
ls -la /usr/local/bin/orangutan
Port already in use
# Check what's using the port
sudo ss -tulnp | grep :291
# Use a different port
orangutan serve --port 8080
Or change the port in your config file.
No devices found
Check nmap is installed:
which nmap nmap --versionTest nmap directly:
sudo nmap -sn 192.168.1.0/24Check network detection:
orangutan statusScan a specific network:
sudo orangutan scan 192.168.1.0/24
Can't access web UI
Check if server is running:
orangutan status # or curl http://localhost:291/Check firewall:
# Linux (ufw) sudo ufw status sudo ufw allow 291/tcp # Linux (firewalld) sudo firewall-cmd --list-ports sudo firewall-cmd --add-port=291/tcp --permanentCheck if binding to correct address:
# Allow external access orangutan serve --bind 0.0.0.0This is the default. The first visit asks you to create a password, so the dashboard is not left open on your network.
Tailscale not detected
Check Tailscale is installed and running:
tailscale statusOn macOS, ensure CLI is available:
# If using Tailscale app from App Store /Applications/Tailscale.app/Contents/MacOS/Tailscale statusRunning in Docker? Tailscale will read as "Not Installed." The container has its own filesystem and cannot see the host's Tailscale, so the status and the connect/disconnect controls are unavailable there even when the host is on your tailnet. Run the binary directly on the host to use Tailscale with LAN Orangutan.
Connect or disconnect button does nothing
The connect and disconnect buttons run the Tailscale CLI on the machine hosting LAN Orangutan, so they need that CLI reachable, the same requirement as detection above.
- Confirm the CLI works from that machine:
tailscale status. If it is not found, the buttons cannot work either. - Connecting shows a sign-in link instead of connecting. That is expected when the machine is not signed in yet. Open the link, finish signing in, then refresh the page.
- The disconnect warning is deliberate. If you reach the dashboard over Tailscale, disconnecting cuts your own connection and you will need local access to bring it back.
Rate limiting errors
If you see "Rate limited" errors when scanning, wait 30 seconds between scans. This prevents overloading your network.
Data not persisting
Check that the data directory exists and is writable:
# Linux
ls -la ~/.local/share/lan-orangutan/
# or as root
ls -la /var/lib/lan-orangutan/
# macOS
ls -la ~/Library/Application\ Support/lan-orangutan/
View debug output
# Run with verbose output
orangutan scan -v
# Check version
orangutan version
Still having issues?
- Check the GitHub Issues
- Open a new issue with:
- Your OS and version
- Output of
orangutan version - Output of
orangutan status - Steps to reproduce the problem