Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

homelab

Repositorio de documentación personal para un entorno homelab complejo basado en Proxmox VE, Kubernetes y Docker. Incluye configuraciones de servicios, observabilidad y proyectos de hardware.

Ficha actualizada 23 sept 2026, 19:56 · upstream 23 sept 2026, 19:26 · release sin release detectada

Ver códigoProblemas y ayudaRepositorio ↗Sitio oficial
00

Qué es homelab

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Este repositorio alberga la configuración y documentación de una infraestructura homelab avanzada gestionada sobre un clúster de Proxmox VE con soporte de alta disponibilidad mediante Ceph. La arquitectura combina múltiples capas de virtualización: máquinas virtuales para el núcleo del sistema, Kubernetes para orquestación de aplicaciones y hosts Docker independientes para servicios específicos.

El entorno incluye una suite completa de observabilidad (Grafana, Prometheus, Loki, InfluxDB) y gestión de red con MetalLB y Traefik. Se destacan proyectos de hardware como configuraciones versionadas para ESPHome y proxies multimedia con Jellyfin a través de Tailscale. La infraestructura está diseñada tanto para experimentación tecnológica como para alojar aplicaciones personales.

Es importante notar que este repositorio funciona principalmente como referencia o punto de partida, no como una plantilla lista para usar directamente. Las configuraciones contienen referencias específicas al entorno del autor (direcciones IP, dominios y secretos), por lo que requieren adaptación significativa antes de su implementación en otro sistema.

CASOS DE USO
  • Referencia técnica para arquitecturas de homelab basadas en Proxmox VE con Ceph
  • Documentación de gestión de microcontroladores ESP32 mediante ESPHome
  • Ejemplo de despliegue de stack de observabilidad auto-alojado (Prometheus/Grafana)
  • Configuración de almacenamiento S3 compatible utilizando MinIO
  • Guía para implementación de NVR con detección de objetos usando Frigate
PUNTOS DESTACADOS
  • Soporte nativo para clústeres de Proxmox VE con alta disponibilidad y migración en vivo
  • Integración completa de Kubernetes con MetalLB para balanceo de carga en bare-metal
  • Gestión versionada de configuraciones de hardware (ESPHome) excluyendo secretos
  • Arquitectura híbrida que combina Docker Compose, VMs y contenedores Kubernetes
  • Implementación de Ingress controlado por Traefik para gestión de tráfico web
PRECAUCIONES
  • No apto para despliegue directo debido a referencias específicas de IPs y dominios del autor
  • Alta complejidad operativa que requiere conocimientos avanzados en virtualización y orquestación
  • Dependencia de hardware específico (4 nodos Proxmox, 4 núcleos CPU, 4GB RAM por nodo mínimo)
  • Configuraciones personalizadas que no son directamente transferibles sin ajustes manuales
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA4 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADhighnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Requiere un clúster de Proxmox VE con Ceph para almacenamiento distribuido. No es una plantilla 'copiar y pegar'; las IPs, dominios y secretos deben reemplazarse manualmente. Se recomienda leer la documentación en jasongodson.com antes de intentar replicar la infraestructura debido a su complejidad HIGH.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.js
SERVICIOS
S3/MinIO
BASES DE DATOS
No detectadas
PUERTOS
No detectados
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.