Homarr Docker Compose: Dashboard Moderno Para Homelab 2025

Homarr Docker Compose es la solución perfecta para gestionar tu homelab con un dashboard moderno y completamente personalizable. Si buscas una alternativa visual a Homer o Homepage con funciones avanzadas, esta herramienta es ideal para centralizar todos tus servicios self-hosted.

En esta guía completa aprenderás a instalar y configurar este potente dashboard que se integra perfectamente con tus contenedores Docker, servicios de media como Plex y Jellyfin, y herramientas de automatización como Sonarr y Radarr. Con Homarr Docker Compose tendrás el control total de tu infraestructura desde una interfaz elegante y funcional.

¿Qué es Homarr Docker Compose?

Homarr es un dashboard de código abierto diseñado específicamente para homelabs y entornos self-hosted. A diferencia de otros dashboards tradicionales, esta solución destaca por su interfaz drag-and-drop que no requiere editar archivos YAML o JSON manualmente.

El proyecto fue migrado recientemente a homarr-labs/homarr con la versión 1.0+, donde recibe actualizaciones activas de la comunidad. Está construido con React, Next.js y TypeScript, utilizando el framework Mantine UI para ofrecer una experiencia de usuario moderna y fluida.

Implementar Homarr Docker Compose en tu servidor te permite gestionar visualmente todos tus contenedores y aplicaciones desde un único punto de acceso, convirtiendo tu homelab en un entorno profesional y organizado.

Características principales de Homarr Docker Compose

Este dashboard se ha convertido en tendencia durante 2025 por sus características únicas que lo diferencian de alternativas como Homer y Homepage:

Sistema drag-and-drop altamente personalizable: organiza widgets y aplicaciones sin tocar código
Biblioteca de +10,000 iconos: personaliza visualmente cada servicio con iconos de alta calidad
Integraciones nativas: conecta con Docker, Plex, Jellyfin, Sonarr, Radarr, Lidarr, qBittorrent, Transmission, Pi-hole, AdGuard Home, Overseerr y más
Gestión avanzada de secretos: almacena credenciales de forma segura con cifrado
Búsqueda integrada: busca en la web y en tus aplicaciones desde un solo lugar
Monitoreo de estado en tiempo real: verifica si tus aplicaciones están funcionando correctamente
Autenticación y autorización robusta: soporta credenciales, OIDC y LDAP con permisos granulares
Soporte multiidioma: disponible en 26 idiomas gracias a la comunidad
Sistema de trabajos en segundo plano: permite manejar cientos de usuarios simultáneos eficientemente
Actualizaciones constantes: comunidad activa que mejora continuamente la plataforma

Requisitos previos para instalar Homarr

Antes de comenzar con la instalación del dashboard, asegúrate de cumplir con estos requisitos básicos:

Docker instalado en tu sistema (Linux, Windows o macOS)
Docker Compose instalado y configurado correctamente
Conocimientos básicos de terminal y línea de comandos
Puerto 7575 disponible en tu servidor (o la capacidad de cambiarlo)
Al menos 512MB de RAM disponible para el contenedor
Acceso a la documentación oficial para consultas avanzadas

Instalación de Homarr Docker Compose paso a paso

La documentación oficial de Homarr recomienda Docker como método de instalación tanto para principiantes como profesionales. Configurar Homarr Docker Compose es un proceso sencillo que completarás en pocos minutos siguiendo estos pasos:

Paso 1: Crear el directorio y archivo docker-compose.yml

Crea un directorio dedicado para tu instalación y dentro genera el archivo de configuración:

mkdir -p ~/homarr
cd ~/homarr
nano docker-compose.yml

Paso 2: Configurar el archivo Homarr Docker Compose

Copia esta configuración optimizada y lista para producción en el archivo:

services:
  homarr:
    container_name: homarr
    image: ghcr.io/homarr-labs/homarr:latest
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./homarr/appdata:/appdata
    environment:
      - SECRET_ENCRYPTION_KEY=
    ports:
      - '7575:7575'

Explicación detallada de la configuración:

image: ghcr.io/homarr-labs/homarr:latest – Usa la imagen oficial más reciente del repositorio actualizado
/var/run/docker.sock:/var/run/docker.sock – Permite la integración completa con Docker para gestionar contenedores directamente desde el dashboard
./homarr/appdata:/appdata – Almacena configuraciones, datos de usuario y preferencias de forma persistente
SECRET_ENCRYPTION_KEY – Clave de cifrado de 64 caracteres para proteger datos sensibles y credenciales
7575:7575 – Puerto de acceso web predeterminado (puedes modificarlo según tus necesidades)
restart: unless-stopped – Garantiza que el servicio se reinicie automáticamente tras reinicios del sistema

Paso 3: Generar la clave de cifrado segura

Genera una clave de cifrado robusta de 64 caracteres hexadecimales utilizando OpenSSL:

openssl rand -hex 32

Copia el resultado y pégalo en el valor de SECRET_ENCRYPTION_KEY en tu archivo docker-compose.yml:

environment:
  - SECRET_ENCRYPTION_KEY=a1b2c3d4e5f67890abcdef1234567890abcdef1234567890abcdef1234567890

Esta clave es fundamental para la seguridad de tu instalación, ya que cifra las credenciales y tokens que almacenes en el sistema.

Paso 4: Iniciar el servicio Homarr

Levanta el contenedor en segundo plano con este simple comando:

docker compose up -d

Verifica que el contenedor esté funcionando correctamente consultando los logs:

docker compose logs -f homarr

Si todo está correcto, verás mensajes indicando que el servidor web está escuchando en el puerto 7575.

Paso 5: Acceder a tu dashboard Homarr

Abre tu navegador favorito y accede a la interfaz web:

http://localhost:7575

O desde otro dispositivo en tu red local usando la IP de tu servidor:

http://IP-DE-TU-SERVIDOR:7575

¡Felicidades! Ya tienes Homarr Docker Compose funcionando en tu servidor.

Configuración inicial del dashboard

Al acceder por primera vez a tu instalación de Homarr Docker Compose, el sistema te guiará por un asistente de configuración inicial. Aquí algunos consejos clave para optimizar tu experiencia:

Crear tu primer usuario administrador

Configura un usuario administrador con una contraseña segura que incluya mayúsculas, minúsculas, números y caracteres especiales. La aplicación soporta múltiples métodos de autenticación: credenciales locales, OIDC para integración empresarial, y LDAP para entornos corporativos.

Añadir aplicaciones y widgets con drag-and-drop

Utiliza el potente sistema drag-and-drop para organizar tu espacio de trabajo de manera intuitiva:

Haz clic en el botón de edición (icono de lápiz en la esquina superior)
Arrastra widgets desde el panel lateral hacia tu dashboard
Configura cada widget con las URLs, puertos y credenciales de tus servicios
Elige iconos personalizados de la impresionante biblioteca de +10,000 opciones disponibles
Ajusta tamaños, posiciones y colores según tus preferencias estéticas

Integrar tus servicios populares de homelab

Una de las mayores ventajas de usar esta solución es su capacidad para conectarse nativamente con las aplicaciones más comunes en homelabs:

Servidores multimedia: Plex, Jellyfin, Emby
Gestores de contenido: Sonarr, Radarr, Lidarr, Readarr, Bazarr, Prowlarr
Clientes de descarga: qBittorrent, Transmission, Deluge, SABnzbd
Bloqueadores de anuncios: Pi-hole, AdGuard Home
Gestores de solicitudes: Overseerr, Jellyseerr
Gestión de contenedores: control directo de Docker desde el dashboard
Automatización del hogar: Home Assistant, Node-RED
Monitoreo: Uptime Kuma, Grafana, Prometheus

Cada integración se configura mediante un formulario simple donde introduces la URL base del servicio y, opcionalmente, una API key para funciones avanzadas de monitoreo.

Homarr Docker Compose vs Homepage vs Homer

Muchos usuarios de homelab se preguntan qué dashboard elegir entre las opciones más populares. Aquí una comparativa objetiva para ayudarte a decidir:

Ventajas exclusivas de Homarr

Interfaz drag-and-drop completamente visual sin necesidad de editar YAML
Integraciones nativas más completas y profundas con servicios populares
Sistema de autenticación robusto y seguro integrado nativamente
Biblioteca de iconos más extensa (+10,000 vs ~500 en Homer)
Diseño visual moderno y atractivo con tema oscuro optimizado
Monitoreo de estado de aplicaciones en tiempo real con notificaciones
Búsqueda global integrada que funciona incluso con tus aplicaciones
Sistema de permisos granular para entornos multi-usuario

Cuándo elegir Homepage en lugar de Homarr

Prefieres configuración declarativa mediante archivos YAML
Buscas una solución ultra-liviana en consumo de recursos
Necesitas configuración como código (GitOps) para versionado
Trabajas en un entorno con recursos muy limitados (Raspberry Pi Zero, por ejemplo)

Cuándo usar Homer como alternativa

Requieres el dashboard más simple y minimalista posible
No necesitas integraciones avanzadas con servicios
Trabajas con hardware extremadamente limitado
Solo necesitas una página estática de enlaces sin funcionalidad adicional

Para la mayoría de homelabs modernos en 2025, Homarr Docker Compose ofrece el mejor equilibrio entre funcionalidad avanzada y facilidad de uso, convirtiéndolo en la opción más completa del mercado.

Actualizar y mantener tu instalación

Mantener Homarr Docker Compose actualizado es fundamental para disfrutar de las últimas funciones de seguridad, correcciones de bugs y nuevas características:

# Detener el contenedor actual
docker compose down

# Descargar la última versión disponible
docker compose pull

# Reiniciar con la nueva imagen
docker compose up -d

El proceso es completamente seguro ya que todos tus datos, configuraciones y preferencias persisten en el volumen ./homarr/appdata, que no se modifica durante las actualizaciones.

Recomiendo configurar un recordatorio mensual para verificar actualizaciones, o implementar una herramienta como Watchtower que automatice este proceso para todos tus contenedores.

Solución de problemas comunes

El contenedor no arranca correctamente

Verifica que la clave de cifrado SECRET_ENCRYPTION_KEY esté correctamente configurada y tenga exactamente 64 caracteres hexadecimales válidos. Revisa los logs para identificar el error específico:

docker compose logs homarr

No se detectan los contenedores Docker

Asegúrate de haber montado correctamente el socket de Docker y que tu usuario tenga los permisos necesarios para acceder a él. En sistemas Linux, añade tu usuario al grupo docker o consulta la guía oficial sobre ejecutar como usuario diferente.

Puerto 7575 ya está en uso

Cambia el puerto externo en tu configuración docker-compose.yml sin modificar el puerto interno:

ports:
  - '8080:7575'  # Ahora accederás mediante el puerto 8080

Las integraciones no funcionan

Verifica que las URLs de tus servicios sean accesibles desde el contenedor. Si usas nombres de contenedor, asegúrate de que todos los servicios estén en la misma red Docker. Para servicios externos, usa IPs o dominios completos.

Configuración avanzada con Reverse Proxy

Para acceder a Homarr Docker Compose mediante un dominio personalizado con HTTPS automático, integra la aplicación con un reverse proxy como Caddy o Nginx Proxy Manager.

Ejemplo de configuración con Caddy (archivo Caddyfile):

dashboard.tudominio.com {
    reverse_proxy homarr:7575
}

Caddy gestionará automáticamente los certificados SSL mediante Let’s Encrypt, proporcionando una conexión segura sin configuración adicional.

Si prefieres Nginx Proxy Manager, simplemente crea un nuevo proxy host apuntando a homarr:7575 y habilita SSL con Let’s Encrypt desde la interfaz gráfica.

Recursos útiles y documentación oficial

Para sacar el máximo provecho de tu instalación y mantenerte actualizado con las últimas novedades, consulta estos recursos oficiales:

Repositorio oficial en GitHub – Reporta issues, contribuye código y sigue el desarrollo
Documentación oficial completa – Guías detalladas de configuración avanzada
Imagen Docker en Docker Hub – Descarga directa de imágenes
Documentación de Docker Compose – Aprende más sobre Docker Compose

La comunidad de usuarios también es muy activa en Discord y Reddit, donde puedes compartir configuraciones, resolver dudas y descubrir nuevas integraciones.

Preguntas frecuentes sobre Homarr Docker Compose

¿Homarr es completamente gratuito?

Sí, es completamente gratuito y de código abierto bajo licencia MIT. Puedes self-hostearlo sin ningún coste adicional. También existen opciones de hosting gestionado desde $2.30/mes en servicios como Pika Pods si prefieres no gestionar la infraestructura tú mismo.

¿Consume muchos recursos del servidor?

No, la aplicación es ligera y eficiente en el uso de recursos. Gracias a su arquitectura moderna con Next.js y su sistema optimizado de trabajos en segundo plano, puede manejar cientos de usuarios simultáneos sin problemas de rendimiento incluso en hardware modesto como una Raspberry Pi 4.

¿Puedo migrar desde Homer o Homepage?

Sí, aunque tendrás que reconfigurar tus aplicaciones manualmente ya que cada dashboard utiliza formatos de configuración incompatibles entre sí. El proceso drag-and-drop de Homarr Docker Compose hace que recrear tu setup sea rápido e incluso divertido, generalmente completándose en 15-30 minutos.

¿Funciona correctamente en Synology NAS?

Absolutamente. Puedes instalarlo en Synology utilizando Container Manager con una configuración específica para NAS que incluya las variables PUID, PGID y TZ para gestionar correctamente los permisos de archivos y la zona horaria.

¿Necesito conocimientos de programación?

No, gracias al innovador sistema drag-and-drop no necesitas editar código ni configurar archivos YAML complejos. Solo requieres conocimientos básicos de Docker y terminal para la instalación inicial, después todo se gestiona visualmente desde el navegador.

¿Puedo usarlo en producción con múltiples usuarios?

Sí, el sistema incluye autenticación robusta, gestión de permisos granular y un motor optimizado para manejar cargas de trabajo considerables. Muchas empresas pequeñas y equipos lo utilizan como dashboard central para sus operaciones DevOps.

Conclusión: el dashboard definitivo para 2025

Homarr Docker Compose representa la evolución definitiva de los dashboards para homelab en 2025. Su combinación única de interfaz visual intuitiva, integraciones nativas profundas y diseño moderno lo convierte en la opción ideal tanto para principiantes que dan sus primeros pasos en self-hosting como para profesionales experimentados que gestionan infraestructuras complejas.

Con esta guía completa ya tienes todo el conocimiento necesario para implementar tu propio dashboard personalizado que centralizará la gestión de todos tus servicios Docker. La comunidad activa, las actualizaciones constantes y el desarrollo transparente en GitHub garantizan que seguirá siendo una herramienta relevante, segura y mejorada continuamente.

Si buscabas una solución profesional, moderna y potente para organizar tu homelab, Homarr Docker Compose es sin duda la mejor elección disponible actualmente. La inversión de tiempo en su configuración se verá recompensada con años de productividad y una experiencia de usuario excepcional.

¿Ya instalaste tu dashboard? Comparte tu experiencia, capturas de pantalla y configuración en los comentarios para inspirar a otros usuarios de la comunidad.

Homarr Docker Compose: Dashboard Moderno para Homelab 2025