LAN-Orangutan
★ 1.2kAbout
Community Ratings
No ratings yetNew this week
Read recap →Features
- Auto-discover devices using nmap
- Password protection
- Label, group, and notes for devices
- Multi-network support
- Tailscale peer discovery
- Connect/disconnect Tailscale
- Live scan progress
- Modern web dashboard
- Full CLI with JSON output
- CSV export
Details
- Last Updated
- Nov 12, 2026
- Created
- Dec 29, 2025
- Install Methods
- dockerdocker-composebinarypackage-manager
- Requirements
- nmapTailscale CLI on the host for Tailscale features
- Default Port
- 291web dashboard
- Authentication
- local
- Backup & Export
- file-backupnative-export
- Privacy & Independence
- Cloud: OptionalOffline Capable
- Theming
- Dark mode
- Deployment
Deployment: Docker Compose ✓Single Container — minimal hosting footprintsingle container
Run LAN-Orangutan yourself
Pick how much you want to manage.
netcupBest match
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
Hetzner
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
DigitalOcean
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
1 more way to host
Some links earn us a commission. netcup pays us one and is our preferred VPS host.
Is this your project? Sponsor a listing
Run LAN-Orangutan with Docker Compose
Compose file from the LAN-Orangutan project repository.
1 service
no resource limits declared
needs persistent storage (1 volume)
docker-compose.yml · @ 61bce70 · scanned Nov 3, 2026
# LAN Orangutan - Docker Compose
#
# SUPPORTED ON LINUX ONLY.
#
# Docker Desktop on macOS and Windows runs Linux inside a virtual machine. The
# container never reaches your real network, and the virtual machine's gateway
# answers probes for addresses that do not exist, so a scan looks successful
# while reporting devices that were never there. No setting changes this.
# On macOS and Windows, download the binary and run it directly instead.
#
# LAN Orangutan detects this and warns at startup and on the dashboard, but it
# is better not to get there in the first place.
services:
lan-orangutan:
image: ghcr.io/291-group/lan-orangutan:latest
container_name: lan-orangutan
restart: unless-stopped
# Scanning needs to see your real network, not Docker's private one. On a
# bridge network the container only ever discovers other containers
# (172.17.0.0/16), never the devices on your LAN. Host networking is what
# makes discovery work, and it means the port below is taken directly from
# the host.
#
# This requires Linux. Docker Desktop on macOS and Windows runs Linux inside
# a virtual machine, so "host" is that VM rather than your computer: the
# dashboard is unreachable and scanning sees only the VM's network. Run
# LAN Orangutan natively on those platforms instead.
network_mode: host
# nmap needs raw sockets to read the ARP table, which is what supplies MAC
# addresses and manufacturer names. NET_RAW is granted to a root container
# by default, but Docker's default set is easy to restrict, so it is listed
# explicitly. NET_ADMIN is not in the default set and helps some scan modes;
# NET_BIND_SERVICE covers the privileged port 291 under host networking.
cap_add:
- NET_RAW
- NET_ADMIN
- NET_BIND_SERVICE
environment:
# Leave the password unset and you will be asked to create one the first
# time you open the dashboard. Set it here instead if you would rather
# decide up front.
# - ORANGUTAN_PASSWORD=change-me
- ORANGUTAN_PORT=291
- TZ=UTC
volumes:
# Your device list, labels and password live here. Without this, they are
# lost every time the container is recreated.
- ./data:/var/lib/lan-orangutan
healthcheck:
# A static asset over 127.0.0.1: public, always 200, and IPv4 (the server
# binds IPv4, and localhost can resolve to IPv6 ::1).
test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://127.0.0.1:291/static/orangutan.svg"]
interval: 30s
timeout: 3s
start_period: 5s
retries: 3
This file may be out of date. Check the LAN-Orangutan website for current setup steps.
Track your self-hosted stack
Bookmark software to try, rate tools you've used, and keep your collection in one place.