homelab-gitops
Cluster Kubernetes gestionado con GitOps (ArgoCD) para homelab. Infraestructura NixOS con k0s, automatización de despliegues Helm, cert-manager para TLS y observabilidad completa con Prometheus/Grafana/Loki.
Ficha actualizada 22 sept 2026, 15:39 · upstream 22 sept 2026, 10:33 · 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.
Repositorio que gestiona un clúster Kubernetes desplegado con k0s sobre hardware Lenovo ThinkCentre M75q-2 (Ryzen 5 Pro 5650GE, 24GB RAM, 2TB SSD) ejecutando NixOS. Utiliza GitOps con ArgoCD y Helm para despliegues declarativos, con estructura plana que permite añadir/eliminar aplicaciones mediante ApplicationSet.
La infraestructura incluye automatización completa de HTTPS con cert-manager, external-dns y traefik como controlador de ingress. Gestión de secretos mediante external-secrets, OpenBao y sops. Observabilidad con Prometheus, Grafana, Loki y OpenTelemetry Collector. Alertas vía Alertmanager con integración Telegram.
Múltiples aplicaciones desplegadas incluyendo Nextcloud, Immich, Paperless-ngx, Home Assistant, Vaultwarden (Rust), PostgreSQL con CloudNativePG. Workbench permite desarrollo de imágenes personalizadas con Dockerfile y build.yaml, compiladas por Kaniko Job en commits.
- Gestión centralizada de múltiples aplicaciones self-hosted mediante GitOps con ArgoCD
- Infraestructura segura con WAF ModSecurity, autenticación OIDC passkey-only vía PocketID y gestión de secretos cifrados
- Automatización de despliegues y actualizaciones con Renovate incluso para imágenes linuxserver
- Observabilidad completa con métricas, logs y trazas centralizadas en Prometheus/Grafana/Loki
- Despliegue de aplicaciones personalizadas mediante workbench con compilación automática por Kaniko
- Estructura plana simplificada: añadir app = crear appset.yaml en directorio, eliminar = mover a archive/
- HTTPS automático completo con cert-manager, external-dns y traefik sin configuración manual
- Gestión de secretos robusta con external-secrets, OpenBao y sops integrados
- Observabilidad completa: Prometheus + Grafana + Loki + OpenTelemetry Collector + Alertmanager
- Automatización de actualizaciones con Renovate incluso para imágenes linuxserver
- Workbench integrado para desarrollo de imágenes personalizadas con Kaniko CI/CD
- Complejidad HIGH: requiere conocimientos avanzados de Kubernetes, GitOps y NixOS
- Hardware específico: Lenovo ThinkCentre M75q-2 con 4 cores CPU y 4GB RAM dedicados a k8s
- Dependencia de Backblaze B2 para backups offsite (velero + Kopia)
- No soporta despliegue one-click, requiere configuración manual inicial
- Requiere mantenimiento activo de Helm charts y ApplicationSets
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.
Recomendado para equipos con conocimientos avanzados de Kubernetes. Hardware mínimo: 4 cores CPU, 8GB RAM total (4096MB dedicados a k8s), 20GB+ disco. Inicializar cluster con k0s sobre NixOS o Linux compatible. Configurar external-dns para DNS dinámico. Provisionar secrets con OpenBao antes de aplicar manifests. Verificar backups Velero hacia Backblaze B2. Usar renovate.json5 para automatizar actualizaciones.
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.