Repolode
Submit
Pouzor

Pouzor/homelable

Self-hosted homelab visualizer that maps your devices, scans the network, imports Zigbee, Z-Wave and Proxmox, and monitors live status.

Open-source alternative to:Lucidchartdraw.io

View on GitHubWebsite
Stars
4,509
Forks
204
Open issues
34
Last commit
5 days ago

What is it?

Homelable is a self-hosted tool for drawing and documenting a homelab. It runs an nmap-based network scan that places discovered machines and services into a pending queue, from which they can be approved onto an interactive canvas. It can also import device topology from Zigbee2MQTT and Z-Wave JS UI over MQTT, and inventory from Proxmox VE over its REST API.

Each node on the canvas can be checked for status using ping, HTTP/HTTPS, TCP, SSH, Prometheus metrics or a /health endpoint, with results shown live on the diagram. Beyond the network map, the project includes a rack canvas for mounting devices in U positions and patching ports, and a markdown documentation space where each device gets a generated document alongside user-written pages.

The app exposes a REST API with Swagger docs, a read-only Live View and documentation view protected by keys, a stats endpoint for gethomepage, and an MCP server so AI assistants can read and modify the topology.

Key features

  • 01Network scanning with nmap that queues discovered devices for approval
  • 02Live status checks per node via ping, HTTP, TCP, SSH, Prometheus or /health
  • 03Zigbee2MQTT and Z-Wave JS UI import over MQTT
  • 04Proxmox VE import of hosts, VMs and LXC containers
  • 05Rack canvas with U-height placement and port-to-port patching
  • 06Markdown documentation space with version history and device documents
  • 07REST API with Swagger UI and an MCP server for AI assistants

Use cases

  • Mapping a home lab's machines, switches and services on one diagram
  • Monitoring which self-hosted services are online from a dashboard
  • Tracking physical rack layout and cabling for a small server room
  • Importing smart-home Zigbee and Z-Wave devices into the same network map

Quick start

  1. 1

    Install with Docker using the pre-built GHCR images (see INSTALLATION.md)

  2. 2

    Or install bare metal on a Debian/Ubuntu host with the included script

    sudo bash scripts/install-baremetal.sh

Things to know

  • The scanner reports no MAC addresses when the backend runs on a Docker bridge network.
  • Some nmap scan types such as SYN scan and OS detection require root privileges.
  • Zigbee and Z-Wave imports need a separate running MQTT broker.

In collections

Self-hosted apps

Topics

#homelab#network-diagram#self-hosted#monitoring#network-scanner#proxmox#zigbee#mqtt#diagram#homelab-infrastructure-observability

FAQ

What is homelable?
Self-hosted homelab visualizer that maps your devices, scans the network, imports Zigbee, Z-Wave and Proxmox, and monitors live status. Homelable is a self-hosted tool for drawing and documenting a homelab. It runs an nmap-based network scan that places discovered machines and services into a pending queue, from which they can be approved onto an interactive canvas. It can also import device topology from Zigbee2MQTT and Z-Wave JS UI over MQTT, and inventory from Proxmox VE over its REST API.
Is homelable free to use? What license does it have?
homelable is open source under the MIT license. Check the license terms before using it in commercial products.
Is homelable still maintained?
Actively maintained. The last commit to homelable was on Oct 19, 2026.
What can I use homelable for?
Mapping a home lab's machines, switches and services on one diagram Monitoring which self-hosted services are online from a dashboard Tracking physical rack layout and cabling for a small server room Importing smart-home Zigbee and Z-Wave devices into the same network map
How do I install homelable?
Install with Docker using the pre-built GHCR images (see INSTALLATION.md) Or install bare metal on a Debian/Ubuntu host with the included script: sudo bash scripts/install-baremetal.sh
Where can I get homelable?
The source code and installation instructions are on GitHub: https://github.com/Pouzor/homelable

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects