homelabops
Infraestructura GitOps para homelab con K3s, FluxCD y Terraform. Gestiona clúster de 3 nodos en Ubuntu 24.04 con observabilidad completa vía Prometheus/Grafana, acceso seguro mediante Cloudflare Tunnels y gestión de secretos con SOPS.
Ficha actualizada 26 sept 2026, 11:48 · upstream 26 sept 2026, 11:36 · release v1.2.0
Qué es homelabops
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio define una infraestructura de homelab de grado producción basada en GitOps. Utiliza K3s para orquestación de contenedores en un clúster de 3 nodos (1 master, 2 workers) sobre Ubuntu 24.04 LTS, gestionado mediante Terraform para la infraestructura subyacente y FluxCD para el despliegue continuo de aplicaciones desde Git. La arquitectura incluye observabilidad robusta con Prometheus y Grafana, gestión de red avanzada con Traefik y Cloudflare Tunnels, y seguridad reforzada con OIDC y SOPS.
Ofrece una suite completa de servicios auto-alojados como Immich para fotografía, ActualBudget para finanzas, n8n para automatización y qBittorrent, todos accesibles públicamente o vía Tailscale según corresponda. La configuración soporta hardware con GPU NVIDIA mediante plugins específicos, aunque actualmente no tiene consumidores activos en el clúster.
- Despliegue automatizado de aplicaciones en un clúster Kubernetes ligero (K3s).
- Gestión de infraestructura híbrida con Cloudflare Tunnels y Tailscale.
- Observabilidad centralizada para monitoreo de nodos y aplicaciones.
- Automatización de flujos de trabajo mediante n8n en entorno local.
- Gestión segura de secretos utilizando SOPS y age.
- Arquitectura GitOps con FluxCD v2.6.0 para reconciliación automática cada minuto.
- Clúster K3s multi-nodo (3/3 Ready) con soporte para arquitectura multi-arch.
- Integración de GPU NVIDIA GeForce MX130 con device plugin instalado.
- Seguridad implementada mediante OIDC para AWS y encriptación SOPS.
- Gestión de almacenamiento híbrida (local-path + NFS).
- No utiliza Docker Compose ni Dockerfiles nativos, requiriendo Helm/Kustomize.
- La GPU NVIDIA tiene el plugin instalado pero sin consumidores activos documentados en el clúster actual.
- Dependencia de SSH deploy key para la conexión del repositorio GitOps.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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 kubectl, flux y terraform instalados. Nodos Ubuntu 24.04 con acceso SSH. Clonación del repo y verificación de salud vía kubectl. Se recomienda revisar docs/k3s-deploy-summary.md para detalles específicos de instalación inicial.
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.