Map. Monitor. Master your homelab.
Self-hosted visual canvas for your network. Drag, document and watch every device live — now native in Home Assistant.
Every device. One canvas.
14 native node types covering routers, hypervisors, containers, IoT, Zigbee/Z-Wave and more. Nest VMs and LXC inside Proxmox hosts.
Network scan, then live status.
nmap-powered discovery sweeps your subnets, fingerprints services and queues unknown devices for review. Approve to add them to the canvas — instantly.
- ping ICMP reachability
- http HTTP 2xx / 3xx
- https TLS endpoint
- ssh TCP/22 banner
- tcp Custom port
- prometheus Scrape /metrics
APScheduler · 60s default · WebSocket push to UI
Zigbee mesh, fully mapped.
Import your entire Zigbee network from zigbee2mqtt in one click. Coordinator, routers and end devices appear on the canvas with their real mesh links — no manual wiring.
- Coordinator Central Zigbee controller
- Router Mesh signal repeater
- End Device Sensor, bulb, switch…
- Links Dashed mesh topology edges
zigbee2mqtt · auto-layout · coordinator → router → end device
Native in Home Assistant.
Same canvas, same nodes, inside your HA sidebar. Uses HA auth — no extra Docker, no extra login. Install in three clicks via HACS.
- 1 Open HACS → Custom repositories
- 2 Add https://github.com/Pouzor/homelable-hacs
- 3 Restart Home Assistant. Find Homelable in sidebar.
Deploy your way.
Three install paths. Pick the one that fits your stack.
Docker
recommendedOne compose file. Frontend + backend + SQLite.
docker compose up -d LXC (Proxmox)
Community ScriptsOne-line bootstrap for a fresh Proxmox container.
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/homelable.sh)" HACS
Home AssistantNative integration. Uses HA auth. No Docker required.
HACS → Custom repository Built for homelabbers.
All local
Self-hosted, zero telemetry. Your topology never leaves your network.
Auto-layout
Dagre hierarchical layout. One click, clean topology.
Live status
WebSocket push. Green / red / pending pulses on the canvas.
Auto discover
More time for beautiful schemas. Devices found automatically.
Pending review
Approve / hide / delete each discovered device.
PNG / SVG export
Document your network in tickets, wikis, runbooks.
Simple auth
Single user, .env-driven. Standalone only.
MCP server
Optional AI-driven topology operations.
Custom style
Tweak colors, icons and node looks — make it yours.
Free forever. Built solo.
Homelable is open source under MIT. No telemetry. No SaaS. Coffee fuels commits — if it's useful in your homelab, consider supporting the project.