Quick Start

Quick Start

Requirements

• Docker 20.10+
• Docker Compose v2
• Linux host recommended for direct ARP/MAC discovery

1. Download The Compose File

curl -O https://raw.githubusercontent.com/AlexRosbach/LanLens/main/docker-compose.yml

2. Generate A Secret Key

python3 -c "import secrets; print(secrets.token_hex(32))"

Replace CHANGE_THIS_TO_A_LONG_RANDOM_STRING in docker-compose.yml with the generated value.

3. Start LanLens

docker compose up -d

Open:

http://<your-host-ip>:7765

Default first-run credentials:

admin / admin

LanLens forces a password change after the first login.

Important Deployment Note

LanLens uses network_mode: host by default because local ARP discovery needs raw network access on the host interface. Bridge mode can serve the UI, but direct ARP/MAC discovery will not work the same way.

For HTTPS, external databases, Scan Nodes, deep scan permissions, CMDB/i-doit, SNMP, backups, and troubleshooting, continue with Technical Documentation.