docker-stack
Repositorio de Docker Compose stacks para homelab en TrueNAS, incluyendo DNS, media server, backup, autenticación y herramientas de desarrollo.
Ficha actualizada 23 sept 2026, 12:06 · upstream 23 sept 2026, 11:46 · release sin release detectada
Qué es docker-stack
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
docker-stack es un proyecto open source que proporciona múltiples servicios Docker Compose preconfigurados para uso en homelabs. Los servicios se despliegan a través de Dockhand sobre TrueNAS, con backups centralizados en un stack separado. El repositorio no incluye código de aplicación ni build steps; todo está compuesto por archivos de configuración de Compose, archivos .env.example y scripts de validación. Se utiliza mediante Make para gestionar el despliegue, validación y ejecución de servicios.
- Servidor DNS con bloqueo de anuncios (AdGuard Home)
- Servidor de audiobooks y podcasts (Audiobookshelf)
- Gestión de impresoras 3D Bambu Lab (Bambu Buddy)
- Manager de subtítulos para Sonarr/Radarr
- Stack manager de Docker Compose (Dockhand)
- Gestor financiero personal (Firefly III)
- Servidor Git autocontenido (Gitea)
- Automatización de hogar con Home Assistant
- Estructura modular con stacks separados por namespace, facilitando mantenimiento y escalabilidad
- Validación exhaustiva mediante Make targets: lint, validate, conventions y pre-commit hooks
- Soporte de autenticación OIDC a través de Pocket ID con integración segura
- Backup automático con detección de contenedores inestables y persistencia en TrueNAS
- Herramientas de agente para revisión de consistencia entre stacks y generación de scaffolds
- Composición de servicios complejos (LLM, media server, autenticación) en un solo repositorio
- No incluye código fuente ni scripts de aplicación; todo depende de archivos de configuración externos
- Dependencia estricta de Dockhand para el despliegue y gestión del stack principal
- Los backups requieren una instancia separada en TrueNAS con configuración manual
- La validación de seguridad (CVE sweep) no es obligatoria por defecto y se recomienda ejecutarla manualmente
- No incluye documentación completa sobre la arquitectura o los scripts de validación
- El repositorio está enfocado en homelabs, lo que limita su utilidad para entornos de producción
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.
Instala las herramientas con `make tools`, luego despliega cada stack individualmente con `make up STACK=<name>`. Para validar la configuración antes del merge, ejecuta `make check` en el repositorio. Los archivos `.env.example` son obligatorios y deben ser replicados a cada entorno de producción. El archivo `mise.toml` define las versiones de herramientas requeridas y se usa como fuente única para CI/CD. Se recomienda crear un stack dedicado para backups con la etiqueta `docker-volume-backup.stop-during-backup`. Para añadir un nuevo stack, crea el directorio `eggenberg-services/<stack>/`, añade un servicio de backup en `infrastructure/volume-backup/docker-compose.yaml` y define una red dedicada `<stack>_network`. El repositorio está licenciado bajo MIT.
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.