The default compose files put the backend on a bridge network, where ARP only ever reaches the Docker gateway — so scans report IPs, ports and services but never a MAC. NET_RAW does not help: it grants raw sockets, not a place on the LAN. Rescan matching prefers MAC over IP, so this also makes a DHCP device reappear as a new inventory entry when its lease changes. None of this was documented anywhere. Adds an INSTALLATION.md section covering the network_mode: host fix, the Docker Desktop macOS/Windows limitation and the macvlan alternative, a pointer from the README scanner section, and a commented-out network_mode: host in both compose files so it is a one-line change. Reported in discussion #368. ha-relevant: no
53 lines
1.2 KiB
YAML
53 lines
1.2 KiB
YAML
services:
|
|
backend:
|
|
image: ghcr.io/pouzor/homelable-backend:latest
|
|
restart: unless-stopped
|
|
env_file:
|
|
- .env
|
|
environment:
|
|
SQLITE_PATH: /app/data/homelab.db
|
|
CORS_ORIGINS: '["http://localhost:3000"]'
|
|
volumes:
|
|
- backend_data:/app/data
|
|
networks:
|
|
- homelable
|
|
cap_add:
|
|
- NET_RAW
|
|
# MAC addresses: on this bridge network the scanner can never see them —
|
|
# ARP is layer 2 and every LAN host is one hop away behind the Docker
|
|
# gateway. To collect MACs (and so keep DHCP devices matched across an IP
|
|
# change), put the backend on the LAN: comment out the `networks:` key
|
|
# above and uncomment the line below (Linux hosts only).
|
|
# network_mode: host
|
|
|
|
frontend:
|
|
image: ghcr.io/pouzor/homelable-frontend:latest
|
|
restart: unless-stopped
|
|
ports:
|
|
- "3000:80"
|
|
depends_on:
|
|
- backend
|
|
networks:
|
|
- homelable
|
|
|
|
mcp:
|
|
image: ghcr.io/pouzor/homelable-mcp:latest
|
|
restart: unless-stopped
|
|
ports:
|
|
- "8001:8001"
|
|
env_file:
|
|
- .env
|
|
environment:
|
|
BACKEND_URL: "http://backend:8000"
|
|
depends_on:
|
|
- backend
|
|
networks:
|
|
- homelable
|
|
|
|
volumes:
|
|
backend_data:
|
|
|
|
networks:
|
|
homelable:
|
|
driver: bridge
|