Pouzor /homelable

Self-hosted homelab infrastructure visualizer — interactive network diagram with live status monitoring

★ 5,088⑂ 222👁 20⑃ 325● 255▤ 58
TypeScriptMITCreated 2026-03-06homelable.net
Download: v3.7.1v3.7.1 ↓3.7.12026-11-15
+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

Discussions

Latest release

v3.7.1 v3.7.1 2026-11-15
Homelable 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)

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON