Home-Server-Lab
Repositorio de homelab con dos stacks paralelos: Docker Compose para prototipado rápido y k3s+ArgoCD para producción GitOps. Incluye 28 servicios en Docker y 19 en Kubernetes, optimizado para Raspberry Pi 5 y servidores x86_64 con enfoque zero-trust (Twingate).
Ficha actualizada 22 sept 2026, 18:06 · upstream 22 sept 2026, 17:12 · release sin release detectada
Qué es Home-Server-Lab
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Home-Server-Lab es un repositorio completo para montar un homelab autocontenido en un solo servidor Linux. Su propuesta única es ofrecer dos stacks de despliegue simultáneos: Docker Compose para experimentación rápida y k3s con ArgoCD para una infraestructura de producción declarativa y GitOps. Ambos stacks comparten los mismos servicios, permitiendo migrar configuraciones probadas desde el entorno de desarrollo al de producción sin duplicar la lógica de negocio.
El proyecto está diseñado para funcionar detrás de un router doméstico estándar sin necesidad de hacer forwarding de puertos hacia el exterior. Utiliza Twingate para acceso remoto seguro y Pi-hole para resolución DNS interna con bloqueo de anuncios. La arquitectura soporta múltiples arquitecturas (amd64, arm64) y se ha benchmarkeado en servidores de 8 GB de RAM, siendo compatible con Raspberry Pi 5 y mini-PCs x86_64.
- Prototipado rápido de servicios autohospedados sin configurar Kubernetes
- Despliegue de producción estable con GitOps y reconciliación automática mediante ArgoCD
- Acceso remoto seguro a través de Twingate sin abrir puertos en el router
- Gestión centralizada de múltiples servicios (media, desarrollo, monitorización) en un solo nodo
- Soporte dual Docker Compose y k3s con la misma base de servicios
- Arquitectura zero-trust mediante Twingate Edge para acceso remoto seguro
- Uso de SealedSecrets para gestión segura de secretos en el stack Kubernetes
- Optimización para hardware limitado (Raspberry Pi 5, 8 GB RAM)
- Requiere conocimientos básicos de Linux y Docker/Kubernetes para la configuración inicial del stack k3s
- El acceso remoto depende de una cuenta activa en Twingate Edge
- La migración de servicios entre stacks requiere validación manual de compatibilidad
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.
Instalar k3s primero, luego aplicar manifests base y SealedSecrets. Para Docker, usar setup.sh por servicio. Configurar DNS externo (Cloudflare) y Twingate antes de exponer servicios. Verificar multi-arch en README específico del servicio.
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.