homelab-monitor
Panel unificado de monitorización para homelabs con soporte multi-host vía SSH, métricas de GPU (NVIDIA/AMD/Intel), costes energéticos, gestión de contenedores y servicios systemd sin agentes.
Ficha actualizada 22 sept 2026, 11:36 · upstream 22 sept 2026, 11:36 · release v0.36.1
Qué es homelab-monitor
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Homelab Monitor es una solución de monitorización autocontenida diseñada para entornos domésticos y servidores personales. Proporciona un panel único que gestiona múltiples hosts mediante SSH sin necesidad de instalar agentes en los nodos remotos, lo que simplifica significativamente el mantenimiento y la seguridad.
El sistema ofrece capacidades avanzadas de monitorización de hardware, incluyendo soporte nativo para GPUs NVIDIA, AMD e Intel (tanto en Linux como en Windows/WSL2). Proporciona métricas detalladas sobre consumo energético, costes económicos por hora, estado de contenedores Docker y servicios systemd. La arquitectura utiliza streams push para actualizaciones en tiempo real, optimizando el uso de recursos de red.
El proyecto incluye un servidor MCP integrado de solo lectura, permitiendo a agentes de IA explorar el estado del homelab. Los datos se persisten en SQLite y soportan exportación de métricas Prometheus. El despliegue es sencillo mediante docker-compose, con opciones para personalización avanzada de intervalos de muestreo y retención de datos.
- Monitorización centralizada de múltiples servidores Linux, Raspberry Pi y Windows sin agentes instalados en los nodos remotos
- Análisis detallado de consumo energético y costes económicos por componente (GPU, CPU, DRAM) y por proceso/contenedor
- Gestión y benchmarking de modelos de IA locales con soporte para Ollama, vLLM, llama.cpp y otras plataformas
- Detección temprana de cuellos de botella en GPUs mediante análisis de throttling, temperatura y ancho de banda de memoria
- Soporte nativo para GPUs NVIDIA, AMD e Intel en Linux y Windows sin necesidad de herramientas de terceros
- Cálculo preciso de costes energéticos basado en tarifas diurnas/nocturnas configurables por país
- Servidor MCP integrado de solo lectura que permite a agentes de IA interactuar con el estado del homelab
- Persistencia de datos en SQLite con exportación nativa de métricas Prometheus para integración con Grafana
- Requiere acceso SSH configurado a los hosts remotos para monitorización fuera del nodo principal
- Necesita acceso al socket Docker o interfaces del sistema (/proc, /sys) para obtener métricas precisas de contenedores y hardware
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Desplegar con docker compose up -d. Montar el volumen /data/gpu.db para persistencia de datos históricos. Configurar variables de entorno en docker-compose.yml según necesidades (SAMPLE_INTERVAL, RETENTION_DAYS, ENABLE_MCP). Asegurar acceso SSH a hosts remotos y montar HOST_ROOT=/rootfs para lectura del sistema anfitrión.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.