homelab
Repositorio de infraestructura HomeLab con Proxmox, Kubernetes Talos y Terraform. Incluye gestión GitOps con ArgoCD, Docker vía Komodo y aplicaciones internas/externas para automatización, monitorización y productividad personal.
Ficha actualizada 22 sept 2026, 15:41 · upstream 22 sept 2026, 15:26 · release sin release detectada
Qué es homelab
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio documenta una infraestructura doméstica robusta basada en virtualización Proxmox y orquestación Kubernetes con Talos Linux como sistema operativo del nodo. La gestión de la infraestructura se realiza mediante Terraform para IaC y ArgoCD para GitOps, asegurando que el estado del clúster coincida con el código fuente almacenado en este repositorio.
La arquitectura integra múltiples capas: virtualización a nivel de hipervisor, red definida por software con Cilium, gestión de certificados con Cert-Manager y enrutamiento inverso con Traefik. Se distinguen aplicaciones ejecutadas directamente en Kubernetes (internas) y contenedores gestionados vía Komodo (Docker Compose), permitiendo una separación clara entre servicios críticos y herramientas de consumo personal.
El sistema incluye gestión segura de secretos mediante Sealed Secrets, observabilidad completa con Grafana Cloud o LGTM local, y despliegue automatizado de aplicaciones populares como Immich, Paperless-ngx, n8n y Open WebUI, facilitando la creación de un entorno digital personalizado sin depender de servicios externos.
- Automatización del hogar con Home Assistant OS gestionado desde Kubernetes
- Gestión documental y OCR con Paperless-ngx para escaneo y archivo de documentos
- Dashboard personalizado con Glance para monitorizar estado de servicios y clima
- Automatización de flujos de trabajo con n8n para integraciones entre aplicaciones
- Monitorización de infraestructura con Grafana Cloud o stack LGTM local
- Gestión de secretos seguros en Git usando Sealed Secrets para evitar exponer credenciales
- Arquitectura híbrida que combina Kubernetes (Talos) y Docker Compose gestionado por Komodo
- Implementación de GitOps con ArgoCD para despliegues declarativos y auto-sanadores
- Uso de Cilium para seguridad de red y observabilidad nativa en el clúster
- Gestión de certificados TLS automática mediante Cert-Manager con Traefik como proxy
- Infraestructura definida por código (IaC) usando Terraform para Proxmox y almacenamiento CSI
- Observabilidad escalable con opción de Grafana Cloud o stack LGTM autoalojado
- Complejidad alta (HIGH) que requiere conocimientos avanzados en Kubernetes, Terraform y redes
- Dependencia de hardware específico para Talos Linux y requisitos de recursos (4 núcleos CPU, 4GB RAM mínimo)
- Configuración manual inicial necesaria para componentes como Proxmox VE y almacenamiento CSI
- Requiere mantenimiento activo de la infraestructura virtualización y actualizaciones del clúster
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.
Requiere servidor con al menos 4 núcleos CPU, 4GB RAM y 10GB disco. Inicializar Proxmox con Talos Linux usando módulos Terraform. Configurar ArgoCD para sincronización automática desde este repositorio. Asegurar acceso a GitHub Runner o CI/CD externo si se desea automatizar despliegues. Verificar configuración de red y DNS antes de exponer servicios externos.
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.