Si alguna vez has intentado explicarle a alguien cómo está montada tu red doméstica —qué VLAN cuelga de qué switch, qué LXC vive en qué nodo de Proxmox— sabrás que un diagrama vale más que quinientas líneas de ip a. Homelable nace para resolver justo eso, y lo hace sin pedirte que subas nada a la nube.
Homelable convierte tu red en un lienzo interactivo: la escanea, la dibuja, y la mantiene vigilada en tiempo real.
Es un proyecto MIT, con código en GitHub (Pouzor/homelable, cerca de 1.800 estrellas) y desarrollo que no se ha parado. La instalación es la típica de un fin de semana con café: curl del script, docker compose up -d, y listo. También hay LXC vía community-scripts para quien prefiera Proxmox nativo. Eso sí, cambia el usuario y contraseña por defecto (admin/admin) antes de exponerlo a nada.
Qué mapea
La lista de tipos de nodo sorprende para el tamaño del proyecto: routers, firewalls, switches, servidores, nodos Proxmox, VMs, LXC, NAS, cámaras, impresoras, portátiles, móviles, hosts y contenedores Docker, más tres tipos para dispositivos Zigbee. La versión 1.13 añadió un nodo de firewall con icono propio, para que un pfSense deje de perderse entre los routers genéricos.
Lo que más uso le veo es la importación desde Proxmox: con una clave de solo lectura trae tus VMs y LXC, sincroniza sus datos, y si ya tenías algo detectado por escaneo IP, lo fusiona en vez de duplicarlo. Si además usas Home Assistant con Zigbee2MQTT, puede leer tu malla Zigbee entera desde el broker MQTT y colocarla en el lienzo de un clic.
Vigilancia, no solo dibujo
Cada nodo admite su propio método de comprobación —ping, TCP, un endpoint /health, Prometheus, SSH— así que el mapa sigue siendo útil dentro de seis meses, cuando ya no recuerdes qué IP tenía cada máquina.
Un detalle curioso: trae un servidor MCP pensado para que un asistente de IA pueda consultar el estado de tu infraestructura. Es una línea más en la lista de características, pero para quien ya usa agentes de IA en su homelab, abre la puerta a preguntar "qué está caído ahora mismo" sin montar nada a medida.
La parte floja está en el escaneo estándar, que depende de nmap; la alternativa sin nmap, en Python puro, solo llega si instalas la integración de Home Assistant. Y con infraestructuras grandes, el lienzo pide organización manual en varios canvases tarde o temprano.
