homelab-gitops
Repositorio GitOps para homelab auto-alojado con Docker Compose y Terraform. Arquitectura basada en Traefik como único punto de entrada, TLS automático vía Let's Encrypt DNS-01, y gestión centralizada mediante Portainer stacks.
Ficha actualizada 25 sept 2026, 14:29 · upstream 25 sept 2026, 13:59 · release sin release detectada
Qué es homelab-gitops
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
El repositorio homelab-gitops implementa una arquitectura GitOps para gestionar servicios auto-alojados con principios de infraestructura como código. Utiliza Docker Compose para orquestación de contenedores y Terraform para provisionamiento de infraestructura en ScaleComputing HCI y Proxmox VE.
La arquitectura se centra en Traefik v3.7.5 como único punto de entrada (ingress), eliminando puertos expuestos directamente en el host. Todos los servicios comparten la red externa proxynet, con TLS automático gestionado por Let's Encrypt mediante desafío DNS-01 a través de CloudNS. Los servicios siguen un patrón estandarizado con variables de entorno centralizadas y gestión de volúmenes.
La infraestructura está diseñada para resiliencia con arquitectura de dos nodos: una VM principal en ScaleComputing (Ubuntu 26.04) y una secundaria en Proxmox VE con GPU dedicada para servicios que requieren aceleración gráfica como Plex, HandBrake, Open-WebUI y Webtop.
- Auto-alojamiento de servicios web con TLS automático y gestión centralizada vía Portainer
- Monitorización unificada del homelab con Beszel Hub/Agent y Netdata en tiempo real
- Automatización de backups multi-protocolo con Zerobyte y Restic sobre almacenamiento local o Storj
- Desarrollo en navegador con Code-Server y herramientas IT offline-first para entornos sin internet
- Servicio de medios completo con Plex, Ombi, HandBrake y MeTube para gestión y descarga de contenido
- Provisionamiento de infraestructura resiliente con Terraform para VMs en ScaleComputing y Proxmox
- Arquitectura de dos nodos con estrategia de failover documentada en docs/resilience-planning.md
- Gestión centralizada de stacks Docker mediante Portainer con integración GitOps para despliegues automatizados
- TLS automático con Let's Encrypt DNS-01 vía CloudNS sin intervención manual en certificados
- Patrones de servicio estandarizados con variables de entorno compartidas y red externa proxynet
- Automatización de actualizaciones de imágenes con Watchtower integrado en la arquitectura
- Documentación completa con diagramas Mermaid, ejemplos de configuración y guías paso a paso
- Dependencia crítica de Traefik como único punto de entrada; su fallo afecta todos los servicios
- Requiere configuración manual inicial de la red proxynet antes de desplegar cualquier servicio
- Algunos servicios (Plex, Netdata) usan network_mode: host, lo que complica el aislamiento de red
- Certificados TLS requieren dominio gestionado por CloudNS para desafío DNS-01
- Complejidad media-alta para usuarios sin experiencia previa en GitOps y Docker Compose avanzado
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.
Crear la red proxynet antes de cualquier despliegue. Desplegar Traefik primero como capa de entrada. Configurar variables de entorno en cada servicio desde .env.example. Usar Portainer para gestión centralizada con integración Git. Seguir docs/resilience-planning.md para arquitectura HA. Asegurar acceso a CloudNS para certificados TLS.
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.