Si alguna vez has intentado configurar un homelab completo, sabes que puede convertirse en una pesadilla de configuraciones, archivos YAML dispersos y horas de troubleshooting. Deployrr Docker Compose revoluciona este proceso automatizando completamente el despliegue de más de 150 aplicaciones con un solo comando. En este artículo descubrirás cómo esta herramienta transforma la configuración de tu servidor casero de compleja a simple.
Qué es Deployrr Docker Compose
Deployrr es una plataforma de automatización diseñada específicamente para simplificar el despliegue de aplicaciones mediante contenedores. A diferencia de otras soluciones que requieren configuración manual extensa, esta herramienta detecta automáticamente tu sistema operativo, instala todas las dependencias necesarias y configura servicios complejos como Traefik, Authentik o Portainer con solo unos clics.
Lo que hace especial a esta solución es su enfoque en la automatización inteligente. No solo instala aplicaciones, sino que también configura redes, gestiona certificados SSL automáticamente, implementa sistemas de autenticación y establece proxies inversos sin intervención manual. Todo el proceso que normalmente tomaría días o semanas se reduce a minutos.
Características Principales de Deployrr
Más de 150 Aplicaciones Preconfiguradas
La biblioteca de aplicaciones incluye prácticamente todo lo que necesitas para un homelab profesional:
- Proxies inversos: Traefik con generación automática de certificados SSL mediante Let’s Encrypt
- Autenticación: Authentik, Authelia, TinyAuth y Google OAuth preconfigurados
- Servidores multimedia: Plex, Jellyfin y toda la suite de aplicaciones Starr (Sonarr, Radarr, Lidarr)
- Monitoreo: Uptime Kuma, Dozzle, Homepage para dashboards personalizados
- Gestión de contenedores: Portainer con configuración optimizada
- Seguridad: CrowdSec, Socket-Proxy, Gluetun para VPN
- Almacenamiento remoto: Soporte nativo para SMB, NFS y Rclone
Automatización Inteligente del Entorno
El sistema realiza validaciones automáticas antes de cada despliegue, verificando que tu servidor cumple con todos los requisitos necesarios. Gestiona variables de entorno, configura redes Docker personalizadas y establece dependencias entre servicios sin que tengas que editar manualmente archivos de configuración.
Soporte Multi-Dominio y Multi-Servidor
Puedes gestionar múltiples dominios desde una sola instalación y coordinar despliegues en varios servidores simultáneamente. La plataforma ofrece tres modos de exposición: interno (solo red local), externo (acceso público) e híbrido, permitiéndote controlar exactamente qué servicios son accesibles desde internet.
Instalación de Deployrr Docker Compose
Requisitos Previos del Sistema
Antes de comenzar, asegúrate de cumplir con estos requisitos:
- Sistema operativo: Ubuntu 20.04/22.04/24.04 o Debian 11/12 (también compatible con derivados)
- Entorno de despliegue: Bare metal, máquinas virtuales, WSL en Windows o contenedores LXC
- Puertos de red: 80 y 443 disponibles y redirigidos en tu router
- Dominio: Uno o más dominios configurados (recomendado usar Cloudflare como DNS)
- Acceso root: Privilegios de superusuario en el sistema
Instalación en Un Solo Comando
La instalación completa se realiza ejecutando este script automatizado:
bash -c "$(curl -fsSL https://www.deployrr.app/install.sh)"
Este comando descarga el script de instalación oficial, detecta automáticamente tu distribución Linux, añade los repositorios necesarios de Docker, instala Docker Engine y Docker Compose con todas las dependencias, y configura el entorno base de la herramienta.
El proceso completo tarda entre 5 y 15 minutos dependiendo de la velocidad de tu conexión y las especificaciones del servidor. Una vez finalizado, tendrás acceso a la interfaz web de gestión.
Configuración Inicial
Después de la instalación, accede a la interfaz web usando la IP de tu servidor en el puerto configurado. El asistente de configuración inicial te guiará por estos pasos:
- Creación de cuenta: Establece tus credenciales de administrador
- Configuración de dominios: Añade tus dominios y configura las API keys de Cloudflare
- Selección de servicios base: Elige qué infraestructura deseas (Traefik, autenticación, etc.)
- Configuración de almacenamiento: Define rutas locales o monta almacenamiento remoto
- Parámetros de red: Establece rangos de IP y configuración de red Docker
Ejemplo Práctico: Stack Multimedia Completo
Vamos a configurar un stack multimedia completo con Plex, Sonarr, Radarr y Jellyfin, protegido con Traefik y autenticación mediante Authelia. Este ejemplo demuestra el poder de automatización que ofrece la plataforma.
Paso 1: Configurar Traefik como Proxy Inverso
Desde el panel de aplicaciones, selecciona Traefik en la sección de proxies inversos. El sistema automáticamente generará esta configuración:
version: '3.8'
services:
traefik:
image: traefik:v3.0
container_name: traefik
restart: unless-stopped
security_opt:
- no-new-privileges:true
networks:
- proxy
ports:
- 80:80
- 443:443
environment:
- CF_API_EMAIL=${CF_API_EMAIL}
- CF_DNS_API_TOKEN=${CF_DNS_API_TOKEN}
volumes:
- /etc/localtime:/etc/localtime:ro
- /var/run/docker.sock:/var/run/docker.sock:ro
- ./traefik/traefik.yml:/traefik.yml:ro
- ./traefik/acme.json:/acme.json
- ./traefik/config.yml:/config.yml:ro
labels:
- "traefik.enable=true"
- "traefik.http.routers.traefik.entrypoints=http"
- "traefik.http.routers.traefik.rule=Host(`traefik.tudominio.com`)"
- "traefik.http.middlewares.traefik-https-redirect.redirectscheme.scheme=https"
- "traefik.http.routers.traefik-secure.entrypoints=https"
- "traefik.http.routers.traefik-secure.rule=Host(`traefik.tudominio.com`)"
- "traefik.http.routers.traefik-secure.tls=true"
- "traefik.http.routers.traefik-secure.tls.certresolver=cloudflare"
- "traefik.http.routers.traefik-secure.service=api@internal"
networks:
proxy:
external: true
La aplicación genera automáticamente el archivo de configuración de Traefik con las mejores prácticas de seguridad, incluyendo redirecciones HTTPS automáticas y renovación de certificados.
Paso 2: Implementar Authelia para Autenticación
Selecciona Authelia en la sección de autenticación. El sistema configurará automáticamente la integración con Traefik, estableciendo reglas de acceso y middleware de autenticación. Solo necesitas definir qué aplicaciones requieren autenticación mediante la interfaz visual.
Paso 3: Desplegar Aplicaciones Multimedia
En el catálogo de aplicaciones, selecciona Plex, Jellyfin, Sonarr y Radarr. Para cada aplicación, simplemente especifica:
- Subdominio deseado (por ejemplo, plex.tudominio.com)
- Rutas de almacenamiento para medios
- Modo de exposición (interno/externo/híbrido)
- Si requiere autenticación mediante Authelia
El sistema generará automáticamente todos los archivos docker-compose.yml necesarios, configurará las redes compartidas, establecerá las dependencias correctas y aplicará las labels de Traefik para enrutamiento y SSL.
Gestión Avanzada con Deployrr Docker Compose
Sistema de Backups Automatizados
Una de las funcionalidades más valiosas es el sistema de backups integrado. Puedes configurar copias de seguridad automáticas de:
- Archivos de configuración de todas las aplicaciones
- Volúmenes de datos de contenedores
- Configuraciones de red y variables de entorno
- Base de datos de la propia aplicación
Los backups pueden almacenarse localmente o enviarse a almacenamiento remoto mediante Rclone, compatible con prácticamente cualquier proveedor cloud (Google Drive, Dropbox, S3, etc.). Configura la frecuencia (diaria, semanal, mensual) y la retención de copias antiguas desde la interfaz web.
Monitoreo y Logging Centralizado
La plataforma integra herramientas de monitoreo que permiten supervisar el estado de todos tus servicios desde un único dashboard. Uptime Kuma monitorea la disponibilidad de aplicaciones, Dozzle proporciona acceso en tiempo real a logs de contenedores sin necesidad de SSH, y Homepage genera un dashboard personalizado con accesos directos a todas tus aplicaciones.
Puedes configurar alertas que te notifiquen vía email, Telegram, Discord o Slack cuando algún servicio experimenta problemas, se queda sin espacio en disco o falla la renovación de certificados SSL.
Actualización Masiva de Contenedores
Mantener actualizadas decenas de aplicaciones puede ser tedioso. La herramienta simplifica este proceso permitiéndote actualizar todas las aplicaciones con un solo clic, programar actualizaciones automáticas durante ventanas de mantenimiento, o excluir aplicaciones críticas de actualizaciones automáticas.
El sistema verifica automáticamente si hay nuevas versiones disponibles y te notifica, mostrando los changelogs correspondientes para que decidas si actualizar inmediatamente o posponer.
Comparativa: Deployrr vs Otras Soluciones
Deployrr vs Portainer
Portainer es excelente para gestionar contenedores existentes, pero requiere que configures manualmente cada stack. La principal diferencia es que Portainer es una herramienta de gestión, mientras que Deployrr es una plataforma de automatización de despliegues. Con Portainer sigues necesitando crear tus propios archivos docker-compose.yml, configurar redes y establecer variables de entorno. Esta solución elimina todo ese trabajo manual proporcionando configuraciones predefinidas y optimizadas.
Ambas herramientas pueden coexistir perfectamente: usa Deployrr para desplegar aplicaciones automáticamente y Portainer para gestión granular de contenedores individuales.
Deployrr vs Dokploy/Coolify
Dokploy y Coolify son alternativas PaaS enfocadas en desarrolladores que despliegan aplicaciones web. Están diseñados para CI/CD y despliegues desde repositorios Git. La diferencia fundamental es el caso de uso: Dokploy/Coolify son para desarrollo y staging de aplicaciones web, mientras que esta herramienta está diseñada específicamente para homelabs y self-hosting de aplicaciones existentes.
Si tu objetivo es desplegar tus propias aplicaciones desarrolladas, elige Dokploy o Coolify. Si quieres montar un homelab con aplicaciones populares ya existentes, esta es la mejor opción.
Deployrr vs Configuración Manual
Configurar manualmente cada servicio con Docker Compose te da control total pero implica:
- Horas de lectura de documentación oficial de cada aplicación
- Debugging de conflictos de puertos y redes
- Configuración manual de Traefik para cada nuevo servicio
- Gestión dispersa de backups y actualizaciones
- Mayor probabilidad de errores de configuración
La automatización que proporciona esta plataforma reduce semanas de trabajo a minutos, manteniendo las mejores prácticas de seguridad y permitiéndote personalizar configuraciones avanzadas cuando lo necesites.
Casos de Uso Reales de Deployrr Docker Compose
Homelab Personal Completo
Un usuario típico puede desplegar en menos de una hora: servidor multimedia (Plex/Jellyfin), gestión de descargas (Sonarr/Radarr/Transmission), almacenamiento personal (Nextcloud), gestión de contraseñas (Vaultwarden), monitoreo (Uptime Kuma + Grafana), backups automáticos (Duplicati), y dashboard unificado (Homepage).
Todo esto protegido con SSL automático mediante Traefik y autenticación de doble factor con Authelia, accesible desde cualquier lugar mediante subdominios personalizados.
Entorno de Desarrollo para Equipos Pequeños
Empresas pequeñas y startups pueden usar esta herramienta para desplegar rápidamente infraestructura de desarrollo: Gitea para repositorios Git privados, n8n para automatización de workflows, bases de datos (PostgreSQL, MySQL, Redis), herramientas de CI/CD, y entornos de staging aislados.
La capacidad multi-servidor permite separar producción de desarrollo fácilmente, y el sistema de backups automatizados garantiza que los datos críticos estén protegidos.
Sistema de Monitoreo de Red Empresarial
Para administradores de sistemas que necesitan monitorear múltiples servicios y servidores, la plataforma permite desplegar rápidamente: Prometheus y Grafana para métricas, Uptime Kuma para checks de disponibilidad, Dozzle para logging centralizado, y alerting mediante ntfy o Gotify.
La integración con CrowdSec proporciona protección proactiva contra ataques, bloqueando automáticamente IPs maliciosas que intentan acceder a tus servicios.
Solución de Problemas Comunes
Error de Puertos en Uso
Si durante la instalación recibes errores sobre puertos 80 o 443 ya en uso, probablemente tengas Apache o Nginx ejecutándose. Detén estos servicios antes de desplegar Traefik:
sudo systemctl stop apache2 nginx
sudo systemctl disable apache2 nginx
Traefik manejará todo el tráfico HTTP/HTTPS, eliminando la necesidad de otros servidores web.
Certificados SSL No se Generan
Si Traefik no puede obtener certificados SSL, verifica estos puntos:
- Los puertos 80 y 443 están correctamente redirigidos en tu router hacia el servidor
- Las API keys de Cloudflare tienen permisos de edición de DNS
- Los registros DNS en Cloudflare apuntan a tu IP pública
- El archivo acme.json tiene permisos 600:
chmod 600 ./traefik/acme.json
Consulta los logs de Traefik con docker logs traefik para identificar el error específico.
Aplicación No Accesible Tras Despliegue
Si una aplicación aparece como desplegada pero no puedes acceder, verifica:
- El contenedor está ejecutándose:
docker ps | grep nombre-app - El subdominio DNS está configurado correctamente en Cloudflare
- La aplicación está conectada a la red de Traefik
- Las labels de Traefik en el docker-compose.yml son correctas
- Si requiere autenticación, Authelia está funcionando correctamente
La interfaz web de gestión proporciona logs en tiempo real que te ayudarán a diagnosticar problemas rápidamente.
Mejores Prácticas de Seguridad
Aunque la plataforma implementa configuraciones seguras por defecto, sigue estas recomendaciones adicionales:
Implementa Autenticación en Dos Pasos
Configura Authelia con TOTP (Time-based One-Time Password) para todas las aplicaciones críticas. Esto añade una capa extra de seguridad incluso si tus contraseñas se ven comprometidas. Authelia soporta aplicaciones como Google Authenticator, Authy o cualquier generador compatible con TOTP.
Utiliza Socket Proxy para Proteger Docker
El socket de Docker (/var/run/docker.sock) proporciona control total sobre el sistema. Usa Socket Proxy para limitar qué contenedores pueden acceder a qué funcionalidades del socket. La aplicación puede configurarlo automáticamente, restringiendo el acceso según el principio de mínimo privilegio.
Configura Fail2Ban o CrowdSec
Integra CrowdSec para protección proactiva contra ataques de fuerza bruta. CrowdSec analiza logs de Traefik y Authelia, bloqueando automáticamente IPs maliciosas y compartiendo inteligencia de amenazas con la comunidad.
Mantén Backups Fuera del Servidor
Aunque la plataforma facilita los backups locales, siempre mantén copias en ubicaciones remotas. Configura Rclone para enviar backups cifrados a almacenamiento cloud. Si tu servidor sufre un fallo de hardware o ransomware, tendrás copias seguras para restaurar rápidamente.
Actualiza Regularmente
Configura actualizaciones automáticas para contenedores que no afecten servicios críticos. Para aplicaciones importantes, programa ventanas de mantenimiento y revisa changelogs antes de actualizar. La herramienta te notifica de actualizaciones disponibles y permite aprobarlas individualmente.
Futuro y Roadmap de Deployrr
El proyecto está en desarrollo activo con nuevas funcionalidades planificadas para 2025. Entre las mejoras anunciadas están: soporte para más proveedores de DNS además de Cloudflare (incluirá Route53, DigitalOcean, etc.), marketplace de plantillas comunitarias donde usuarios pueden compartir configuraciones personalizadas, integración con Kubernetes para usuarios que requieren orquestación más avanzada, y sistema de alta disponibilidad con failover automático entre múltiples servidores.
La comunidad activa en Discord y el repositorio de GitHub garantizan desarrollo continuo y soporte comunitario. La transparencia del proyecto open-source permite auditar el código y contribuir con mejoras.
Preguntas Frecuentes (FAQ)
¿Deployrr Docker Compose es gratuito?
Sí, existe una versión gratuita con funcionalidades esenciales suficientes para la mayoría de homelabs personales. Las versiones de pago (Basic, Plus, Pro) añaden funciones avanzadas como soporte prioritario, mayor número de aplicaciones simultáneas y características empresariales.
¿Puedo usar Deployrr sin Cloudflare?
Actualmente Cloudflare es el único proveedor DNS soportado para DNS challenge en certificados SSL. Esto está en el roadmap para futuras versiones. Alternativamente, puedes usar HTTP challenge si tus puertos 80/443 son accesibles públicamente, aunque DNS challenge es más versátil y seguro.
¿Es compatible con Raspberry Pi?
Sí, funciona en Raspberry Pi 4 con al menos 4GB de RAM ejecutando Raspberry Pi OS (basado en Debian). El rendimiento dependerá del número de aplicaciones desplegadas, pero homelabs básicos funcionan perfectamente. Para setups más exigentes considera hardware más potente.
¿Puedo personalizar las configuraciones generadas?
Absolutamente. Aunque la plataforma genera configuraciones optimizadas automáticamente, puedes editar los archivos docker-compose.yml generados para añadir variables de entorno personalizadas, modificar volúmenes o ajustar configuraciones específicas. Los cambios se preservan en actualizaciones.
¿Qué pasa si la aplicación deja de desarrollarse?
Dado que genera archivos docker-compose.yml estándar, tus aplicaciones seguirán funcionando independientemente. Puedes exportar todas las configuraciones y gestionarlas manualmente con Docker Compose o migrar a otras herramientas de gestión como Portainer. No existe vendor lock-in.
Conclusión
Deployrr Docker Compose representa un cambio paradigmático en cómo configuramos y gestionamos homelabs. Lo que antes requería días de aprendizaje, troubleshooting y configuración manual ahora se logra en minutos con solo unos clics. La automatización inteligente no solo ahorra tiempo, sino que implementa mejores prácticas de seguridad y configuración que muchos usuarios pasarían por alto haciendo todo manualmente.
Para principiantes que quieren comenzar en el mundo del self-hosting sin ahogarse en documentación técnica, esta herramienta elimina la barrera de entrada. Para usuarios avanzados que gestionan docenas de servicios, la automatización y gestión centralizada reduce drásticamente el tiempo de mantenimiento.
Si estás considerando montar un homelab o ya tienes uno y quieres simplificar su gestión, esta solución merece definitivamente una prueba. La inversión de tiempo para instalarlo se recupera en la primera hora de uso, y la tranquilidad de tener backups automatizados, SSL configurado correctamente y actualizaciones gestionadas centralmente no tiene precio.
El futuro del self-hosting es la automatización inteligente, y esta plataforma está liderando ese camino en 2025.
