homelab
Un repositorio de GitOps que gestiona un homelab Kubernetes con k3s, FluxCD y Prometheus/Grafana.
Ficha actualizada 22 sept 2026, 21:21 · upstream 22 sept 2026, 21:19 · 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 proyecto es un homelab self-hosted basado en Kubernetes utilizando la arquitectura GitOps. Se basa en una infraestructura NixOS-managed sobre hardware bare metal (2 nodos: control plane y worker). La gestión de aplicaciones e infraestructura se realiza mediante un modelo de base → staging, donde el mismo código es validado en staging antes de su promoción a producción. El repositorio actúa como la única fuente de verdad para el estado del cluster, reconciliado continuamente por FluxCD.
La arquitectura incluye componentes como AdGuard Home (DNS ad-blocking), Homarr (dashboard unificada), Linkding (manager de enlaces), Mealie (gestor de recetas) y Plex (servidor de medios). Para la seguridad de entrada se utiliza Cloudflare Tunnel, que permite ingress sin exponer puertos directamente al internet. El monitoreo se realiza con kube-prometheus-stack, incluyendo Prometheus y Grafana con TLS.
Las secretas se almacenan encriptadas mediante SOPS + age, decodificándose solo durante el proceso de reconciliación, nunca en texto plano.
- Gestionar un homelab completo con servicios autónomos (DNS, media server, dashboard) sin necesidad de conocimientos avanzados de Kubernetes
- Implementar un pipeline CI/CD GitOps donde cada cambio se valida en staging antes del despliegue a producción
- Monitoreo y observabilidad centralizada mediante Prometheus y Grafana integrados con la infraestructura
- Seguridad reforzada mediante Cloudflare Tunnel que evita exponer puertos directamente al internet
- Gestión de secretos encriptados en el repositorio, decodificados solo durante el despliegue
- Arquitectura GitOps con FluxCD como único punto de control del estado del cluster
- Modelo de base → staging que valida cambios antes de su promoción a producción
- Infraestructura NixOS-managed sobre bare metal, reduciendo la complejidad operativa
- AdGuard Home proporciona DNS ad-blocking en red para todos los dispositivos
- Cloudflare Tunnel ofrece un ingress seguro sin necesidad de exponer puertos directamente
- Homarr es una dashboard unificada que centraliza el control del homelab
- La infraestructura requiere hardware bare metal (2 nodos) y configuración manual en NixOS
- El estado de las aplicaciones se monitorea mediante ping interno, lo que puede dar falsas alertas si el nodo es inactivo
- No incluye un sistema de backup automático del repositorio GitOps
- La promoción a producción requiere revisión manual por parte del usuario
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.
Para desplegar este homelab, se recomienda configurar una máquina virtual con NixOS como base. Instalar k3s en el control plane y worker nodes, luego aplicar los repositorios de apps (base y staging) mediante FluxCD. Se debe habilitar la validación de seguridad antes del despliegue, asegurando que todos los puertos tengan nombres consistentes según el patrón s-p-<app> y c-p-<app>. Se recomienda configurar Cloudflare Tunnel para cada servicio para evitar exponer puertos directamente al internet. El monitoreo debe configurarse con Prometheus y Grafana en modo TLS. Para la seguridad, se deben usar SOPS + age para encriptar los secretos antes de commitarlos.
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.