Pouzor /homelable
Self-hosted homelab infrastructure visualizer — interactive network diagram with live status monitoring
★ 5,088⑂ 222👁 20⑃ 325● 255▤ 58
+25
Daily
5,088
stars
222
forks
20
watchers
325
prs
255
issues
58
releases
README
Homelable Self-hosted homelab infrastructure visualization, documentation, scanning & live monitoring Screenshots · Features · Installation · Documentation · Rack Canvas · Network Scanner · Zigbee / Z-Wave · Proxmox · Live View · REST API · MCP Server About Homelable is a self-hosted infrastructure visualization solution. It provides a network/zigbee/zwave scanning feature to accelerate the identification of machines, devices and services deployed on your local infrastructure. Homelable also offers a healthcheck system through multiple methods (ping/TCP, /health API, etc.) to get a global overview of online/offline services. Every device also gets a document — written for you from what the scan found, and yours to maintain from there — next to a Library of pages you write yourself: runbooks, incidents, a network overview. Your homelab stops being documented in a wiki somewhere else. You can also select some pre-built design styles, or personalize each device in your diagram. If you just like the design, you can only run the frontend and export your design as PNG. If you are running Homeassistant, check the Homelable HA version (via HACS) --- Screenshots --- Features From one-click network scans and Proxmox / Zigbee / Z-Wave imports to live status monitoring, floor plans, rack canvases with port-to-port patching, a markdown documentation space for the whole lab, multi-canvas layouts and an MCP server for AI assistants — Homelable maps, documents and watches your whole homelab. Every feature, with how to turn it on and use it, is described in FEATURES.md. --- Installation Docker (from the pre-built GHCR images), Proxmox LXC, bare metal without Docker (sudo bash scripts/install-baremetal.sh — systemd unit plus nginx on a Debian/Ubuntu host), build from source, configuration, and development setup are all covered in INSTALLATION.md. ☁️ One-Click Cloud Deploy --- Rack Canvas Next to the network diagram, Homelable draws the physical side of your lab: racks, the gear mounted in them, and the patch cables between their ports. It is a canvas kind of its own — create it from the canvas switcher, New Canvas → Kind → Rack. Usage 1. Add Rack in the header drops a rack; double-click its frame to set U height, 19"/10" width, numbering direction and colours 2. + Device in the sidebar mounts something — an entry from your Device Inventory, a new device (which joins the inventory), or an accessory (blank, shelf, cable manager) 3. Pick a faceplate from the visual catalog: servers, switches, routers, patch panels, UPS and PDUs, desktop NAS towers, shelves and blanks 4. Click Patch, then drag from one port to another to cable them — across racks if you need to. Click a cable and press Delete to unplug it 5. Save Rack when you're happy; nothing is written behind your back Gear sits in a U range and part of a 12-column width grid, so half- and third-widt
Top issues
#415[Feature Request] TP-link Controller Omada import3 comments · 2026-09-04#330[Feature Request] Kubernetes Support3 comments · 2026-08-11#518[Feature request] Dockhand support2 comments · 2026-09-23#461[feature request] add a feature to allow reorder of the canvas list2 comments · 2026-09-10#59[Feature Request] Push Notification when detecting new device2 comments · 2026-04-11#578[Feature Request] Documentation: Programatic Exports1 comments · 2026-10-29#573[Feature Request]: Identifying Subnet IP Usage1 comments · 2026-10-24#569[Feature request] Click a node to open another design (drill-down)1 comments · 2026-10-20
Discussions
#604NetPulse as an import source: real port-to-port links from OpenWrt routers0 comments · 2026-11-14#575PDU/UPS Connections1 comments · 2026-10-25#571Deep scan doesnt add services despite them being found according to logfiles3 comments · 2026-10-22#564'Documentation - Group By: Type' not grouping after editing a device2 comments · 2026-10-14#552Unraid + Truenas0 comments · 2026-10-03#531Visualizing connections from nested Docker containers (inside Proxmox LXC)3 comments · 2026-09-25#510how to act in environment with changing IP's because of DHCP?1 comments · 2026-09-21#438Unifi API integration!1 comments · 2026-09-09
Latest release
v3.7.1 v3.7.1 2026-11-15Homelable 3.7.1 - Rack cable labels can now be moved off the cable, hidden all at once with a header toggle, and the port editor zooms. - Fixes double-counted devices in the stats summary and truncated canvas names in the canvas switcher. Also fix the Tag mismatch as the branch version was not merged (oups :D ) Full changelog Features - Movable rack cable labels, a Labels toggle and port editor zoom (606) Fixes - Count each device once in /stats/summary (603, fixes 562) — thanks @officialasishkumar - Stop canvas switcher row actions from truncating names (605)