homelab
Repositorio GitOps declarativo para homelab basado en Kubernetes con Talos Linux y Proxmox VE, usando Flux CD para sincronización de configuración desde Git.
Ficha actualizada 22 sept 2026, 15:34 · upstream 22 sept 2026, 14:28 · 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 define una infraestructura de homelab mediante prácticas GitOps, utilizando Kubernetes orquestado sobre nodos virtualizados con Talos Linux en un entorno Proxmox VE. La configuración se gestiona declarativamente a través de Flux CD, que reconcilia el estado del clúster con los manifiestos almacenados en este repositorio Git.
La arquitectura incluye componentes clave como MetalLB y external-dns para la exposición de servicios con IPs externas y DNS dinámico, Envoy Gateway para enrutamiento HTTP con certificados Let's Encrypt automáticos, y drivers CSI (NFS y Synology) para almacenamiento persistente. El monitoreo se realiza mediante kube-prometheus-stack.
El despliegue requiere un entorno x86_64, gestor de paquetes Nix, token GitHub personal y clave GPG para cifrado de secretos con Mozilla SOPS. Se recomienda comenzar con una configuración mínima comentando aplicaciones específicas antes de activar todo el stack.
- Orquestación declarativa de servicios en clúster Kubernetes gestionado por GitOps
- Gestión segura de secretos mediante cifrado con GPG y Mozilla SOPS
- Exposición pública de servicios internos con DNS dinámico y certificados TLS automáticos
- Monitoreo detallado del clúster con Prometheus y componentes asociados
- Arquitectura GitOps pura con Flux CD para sincronización automática de configuración
- Soporte nativo para almacenamiento persistente vía CSI drivers (NFS/Synology)
- Infraestructura definida como código con Talos Linux y Proxmox VE
- Gestión de certificados TLS automatizada con cert-manager y Let's Encrypt
- Requiere entorno Nix para gestión de dependencias, aumentando la complejidad inicial
- Dependencia de hardware x86_64 y configuración manual de variables de entorno
- Curva de aprendizaje pronunciada por el uso de Talos Linux y Kubernetes 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.
Configurar .envrc con IP del control plane, token GitHub, usuario y huella GPG. Inicializar clúster con nodos mínimos (1 control + 2 workers). Comentar manifiestos en kustomization.yaml hasta tener el entorno listo. Usar letsencrypt-staging inicialmente para evitar límites de tasa.
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.