homelab
Colección de servicios para home lab gestionada mediante Docker Compose con perfiles modulares, autenticación OAuth centralizada y soporte para medios, productividad y LLMs locales.
Ficha actualizada 22 sept 2026, 11:39 · upstream 22 sept 2026, 11:39 · release v1.13.0
Qué es homelab
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
homelab es un proyecto modular diseñado para desplegar múltiples servicios en un entorno doméstico utilizando Docker Compose. La arquitectura se basa en perfiles que agrupan funcionalidades: core (traefik como proxy inverso con OAuth), media (plex, sonarr, radarr, ombi), utilities (watchtower, portainer) y miscellaneous/llm (chatgpt next web, libreoffice online). Todos los servicios se configuran centralmente mediante un archivo .env y directorio secrets.
El proyecto utiliza un docker-compose.yaml principal que incluye archivos individuales del directorio apps, facilitando la gestión escalable. Incluye Makefile para tareas comunes y documentación en Material for MkDocs. Los requisitos mínimos son 2 núcleos CPU, 2GB RAM y 20GB de disco, con soporte para actualizaciones automáticas vía watchtower.
La configuración se realiza copiando ejemplos desde docs/example.env y docs/example-secrets/, permitiendo personalización sin modificar archivos de imagen. Traefik gestiona HTTPS y redirecciones, mientras que OAuth centraliza el acceso seguro a todos los servicios mediante Google OAuth.
- Desplegar servidor multimedia completo con Plex, Sonarr, Radarr y Ombi para gestión de contenido
- Implementar autenticación única segura con Traefik y OAuth para acceder a todos los servicios desde un dominio único
- Mantener contenedores actualizados automáticamente mediante Watchtower sin intervención manual
- Ejecutar modelos LLM locales como ChatGPT Next Web para experimentación privada en home lab
- Arquitectura modular con perfiles Docker Compose que permiten activar/desactivar servicios por categorías
- Traefik como proxy inverso integrado con reglas de redirección y certificados TLS automatizados
- Configuración centralizada en .env y directorio secrets para credenciales y variables de entorno
- Makefile simplifica tareas comunes como reinicio, actualización o despliegue completo del homelab
- Requiere conocimientos básicos de Docker Compose y gestión de perfiles para activar servicios específicos
- Los secretos se almacenan en archivos planos dentro del repositorio (secrets/), lo que exige protección adecuada en entornos compartidos
- Algunos servicios como ChatGPT Next Web o LibreOffice Online están deshabilitados por defecto y deben activarse manualmente
- No incluye scripts de backup automático; el usuario debe gestionar copias de seguridad de appdata externamente
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.
Despliegue recomendado: clonar repositorio, copiar docs/example.env a .env y docs/example-secrets/ a secrets/. Activar perfiles necesarios en docker-compose.yaml (ej. --profile media --profile core). Ejecutar make up o docker compose -f docker-compose.yaml up -d para iniciar servicios. Verificar logs con make logs. Asegurar que los puertos de Traefik estén abiertos y DNS configurado para el dominio principal.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.