Con Overseerr Docker Compose montas un portal web para que usuarios soliciten películas y series, descubran novedades y tú apruebes o rechaces peticiones sin entrar en Sonarr ni Radarr a mano. Está pensado para integrarse con Plex (y en muchos despliegues también con tus gestores de descarga vía Sonarr/Radarr), de modo que la biblioteca visible y las peticiones queden alineadas con lo que ya tienes en el servidor multimedia.
- Qué preparar: Docker Compose, volumen para
/app/configy acceso a tu Plex (o plan para conectarlo en el asistente inicial). - Qué obtienes: UI móvil-friendly, permisos por usuario y notificaciones opcionales a Discord/Telegram/etc.
- Puerto por defecto:
5055(ajústalo si choca con otros stacks).
Contenido
Overseerr Docker Compose: qué es y cuándo usarlo
Overseerr centraliza el ciclo “descubrir → solicitar → aprobar → despachar a Sonarr/Radarr”. Evita que familiares o compañeros de piso te escriban por chat con títulos sueltos: todo queda en una cola con reglas, límites por usuario y visibilidad de lo que ya está en biblioteca. Un despliegue Overseerr Docker Compose suele convivir con los tutoriales que ya tienes en el blog sobre Jellyfin Docker Compose o Plex Docker Compose: no sustituye al servidor multimedia, sino que actúa como capa social y de gobernanza sobre peticiones.
La imagen mantenida en Docker Hub como sctx/overseerr publica etiquetas versionadas además de latest; en entornos serios conviene fijar versión tras probar en un entorno de pruebas. El código y los releases oficiales están en el repositorio GitHub sct/overseerr.
Overseerr Docker Compose: requisitos y redes
Necesitas Docker Engine y el plugin Compose (referencia: documentación Docker Compose). Decide dónde persistirá la configuración: un volumen nombrado o un bind mount en un SSD con copia de seguridad. Overseerr guarda estado en /app/config dentro del contenedor; si pierdes ese directorio, repites el asistente y reconfiguras APIs.
Para integración completa prepara:
- Plex: cuenta de administrador y URL accesible desde el contenedor (LAN o tunel).
- Sonarr / Radarr (recomendado): API keys y URLs base; sin ellos Overseerr sirve como catálogo/discovery limitado.
- DNS o reverse proxy si publicarás HTTPS: puedes reutilizar patrones de Traefik Docker Compose o Caddy Docker Compose del blog.
Si además monitorizas Plex con Tautulli Docker Compose, mantendrás métricas de visionado independientes de Overseerr, pero complementarias para decidir qué contenido priorizar.
Overseerr Docker Compose: archivo YAML de producción
Crea un directorio (por ejemplo ~/overseerr) y un docker-compose.yml como el siguiente, basado en la convención de la imagen oficial sctx/overseerr y en una única red bridge para aislar el servicio:
services:
overseerr:
image: sctx/overseerr:1.35.0
container_name: overseerr
environment:
- TZ=Europe/Madrid
ports:
- "5055:5055"
volumes:
- overseerr_config:/app/config
restart: unless-stopped
networks:
- media
volumes:
overseerr_config:
networks:
media:
driver: bridge
Sustituye la etiqueta de imagen por la última estable que hayas validado en Docker Hub — tags. Usar pin de versión evita sorpresas en reinicios nocturnos. El mapeo 5055:5055 expone la UI; si ya usas ese puerto en el host, cambia el puerto izquierdo ("8085:5055").
Arranca con docker compose up -d y revisa logs con docker compose logs -f overseerr. Este flujo es el núcleo reproducible de cualquier guía Overseerr Docker Compose que quieras versionar en Git (sin secretos) para tus entornos.
Overseerr Docker Compose: primer arranque y asistente
Abre http://IP:5055 y completa el asistente: autenticación con Plex, permisos de biblioteca y —si aplica— conexión a Sonarr/Radarr. Usa URLs internas Docker si todo está en la misma red compose (por ejemplo http://sonarr:8989); si los servicios están en otro host, usa el FQDN o IP alcanzable desde el contenedor de Overseerr.
Tras el setup, crea usuarios locales o deja el login vía Plex según tu política. Ajusta cuotas de solicitudes y categorías permitidas antes de compartir el enlace público. Un Overseerr Docker Compose mal configurado en permisos suele generar más ruido que una instalación caída: todo el mundo pide, nadie filtra.
Explora la sección de discovery: listas basadas en tendencias, géneros y proveedores de metadatos ayudan a reducir la fatiga de “¿qué vemos hoy?”. Puedes combinar reglas automáticas (por ejemplo, no mostrar animación infantil en perfiles adultos) con listas manuales para estrenos que quieras promocionar en casa. Esta capa de curaduría es donde Overseerr aporta valor más allá de un simple formulario de peticiones: convierte tu biblioteca en experiencia de streaming coherente.
Si compartes el servidor con usuarios no técnicos, prepara una guía corta en tu wiki: enlace al panel, cómo crear una solicitud y qué esperar en tiempos de descarga. Reducir tickets improvisados por WhatsApp es uno de los retornos más rápidos de un despliegue Overseerr Docker Compose bien comunicado.
Overseerr Docker Compose: integraciones Plex, Sonarr y Radarr
Overseerr consume la API de Plex para saber qué tienes disponible y mostrar pósters sin duplicar metadatos a mano. Sonarr y Radarr son los actores que materializan la petición: enlaza cada perfil de calidad y rutas de biblioteca coherentes con tus volúmenes. Documentación de productos: Sonarr y Radarr.
En la práctica, valida que los contenedores resuelvan nombres entre sí (sonarr, radarr, overseerr en la misma red) o usa variables de entorno con hosts externos. Después de cualquier cambio de red, fuerza una sincronización en Overseerr y comprueba una petición de prueba end-to-end: aprobación → aparición en cola Sonarr/Radarr → archivo en biblioteca Plex.
Si tu stack mezcla Jellyfin en lugar de Plex para visionado, revisa la documentación vigente del proyecto: el ecosistema ha evolucionado y algunas instalaciones nuevas evalúan forks como Jellyseerr/Seerr; aquí nos centramos en Overseerr Docker Compose clásico con la imagen sctx/overseerr porque sigue siendo referencia para muchos homelabs Plex-first.
Los perfiles de calidad en Sonarr/Radarr determinan si una petición se traduce en archivo de 4 GB o de 20 GB: alinea expectativas con almacenamiento disponible y con el ancho de banda de subida si compartes fuera de casa. Es recomendable crear perfiles “ligero” y “máxima calidad” y asociarlos a grupos de usuarios en Overseerr para que nadie dispare descargas masivas sin revisión.
Cuando añadas nuevas rutas de biblioteca en Plex, fuerza una sincronización en Overseerr para que el catálogo “ya disponible” refleje carpetas recién montadas; de lo contrario los usuarios seguirán pidiendo títulos que en realidad acabas de ingerir por otro canal.
Overseerr Docker Compose detrás de HTTPS y buenas prácticas
No expongas el puerto 5055 crudo a Internet. Coloca Overseerr detrás de tu proxy con TLS, mismos certificados que el resto de servicios del blog, y restringe acceso administrativo. Si usas autenticación en el proxy, coordina con el login interno de Overseerr para no duplicar prompts confusos.
Backups: copia el volumen overseerr_config o el directorio bind montado; sin eso perderás API keys y mapeos. Actualiza imagen con docker compose pull && docker compose up -d tras leer notas de versión en GitHub.
Si publicas tras un dominio propio, configura cabeceras de seguridad estándar en el proxy (HSTS cuando toque, redirección HTTP→HTTPS) y evita mezclar contenido mixto en iframes embebidos. Para acceso remoto seguro, muchos administradores prefieren VPN o Zero Trust antes que exponer Overseerr directamente; el balance entre comodidad y riesgo depende de tu modelo de amenazas.
Monitoriza el tamaño del volumen de configuración: crece con logs de auditoría y metadatos cacheados. Una política de retención de backups (diaria incremental, semanal completa) encaja con el resto de tu stack de copias descrito en otros tutoriales del blog.
Para descubrir más stacks relacionados, navega la categoría Docker Compose del sitio y mantén un inventario de puertos para evitar solapamientos con Navidrome Docker Compose u otros frontends que también usen 505x en algunos ejemplos comunitarios.
Overseerr Docker Compose: notificaciones y gobernanza
Overseerr puede avisarte cuando alguien solicita contenido o cuando una aprobación queda pendiente. Conecta Discord, Telegram, Slack u otros agentes desde la UI de administración; evita canales públicos si no quieres filtrar títulos de estrenos antes de tiempo. En equipos familiares, conviene definir reglas claras: “máximo N películas por semana”, “solo HD” o “sin contenido no infantil en horario escolar”; Overseerr permite límites por usuario, pero la política humana sigue siendo obligatoria.
Un Overseerr Docker Compose estable también incluye rotación de credenciales: si regeneras API keys de Sonarr/Radarr, actualízalas en Overseerr antes de que fallen las solicitudes en silencio. Documenta en tu wiki interna qué perfil de calidad de Sonarr corresponde a cada tipo de petición para evitar que un usuario pida una serie en 4K cuando tu almacenamiento está dimensionado para 1080p.
Overseerr Docker Compose: seguridad y exposición
Trata el panel como superficie administrativa: fuerza HTTPS, deshabilita acceso anónimo si no lo necesitas y separa redes Docker si Plex y los *arr están en VLAN distinta. La imagen no sustituye un WAF; si publicas a Internet, combina autenticación en el proxy con cuentas de Overseerr de menor privilegio para invitados.
Revisa periódicamente qué usuarios tienen permiso de administración y elimina cuentas huérfanas tras pruebas. Un Overseerr Docker Compose expuesto sin mantenimiento acumula tokens de Plex y claves de APIs en el volumen de configuración; inclúyelo en tus copias cifradas y en tu plan de rotación de secretos.
Overseerr Docker Compose: solución de problemas frecuentes
Si Overseerr no ve la biblioteca Plex, comprueba conectividad DNS desde el contenedor (docker compose exec overseerr ping al host Plex), certificados SSL si usas HTTPS interno y que el token de Plex no haya expirado. Si Sonarr acepta la petición pero no descarga, el fallo casi nunca está en Overseerr sino en indexers, límites de disco o colas de descarga: sigue el flujo en Sonarr antes de reinstalar Overseerr.
Los problemas de “doble NAT” o CGNAT afectan a Plex y, por rebote, a la experiencia de login: soluciones habituales incluyen relay de Plex, túnel o VPN. Anota la versión de Overseerr y la de Plex cuando abras ticket en comunidad; acelera el diagnóstico. Mantener el compose en Git con comentarios de versión facilita rollback si una actualización de imagen rompe compatibilidad con tu pareja Sonarr.
Si tras un reinicio del host el contenedor arranca antes que Plex o que Sonarr, Overseerr puede mostrar errores transitorios de conexión; en la mayoría de los casos basta con esperar a que los dependientes estén sanos y pulsar “sincronizar” en la UI. Para evitar condiciones de carrera en arranques, puedes usar `depends_on` con healthchecks en los otros servicios si viven en el mismo compose orquestado, o scripts de systemd que ordenen el boot.
En entornos multiusuario, documenta quién puede aprobar peticiones “urgentes” fuera de horario y cómo se escala si el administrador principal no está disponible. Un procedimiento claro evita que el Overseerr Docker Compose se convierta en cuello de botella social cuando varias personas esperan el mismo estreno el viernes por la noche.
FAQ sobre Overseerr Docker Compose
¿Puedo usar solo Plex sin Sonarr?
Sí, pero perderás la automatización de descargas; Overseerr quedará más como catálogo y solicitudes manuales.
¿Qué pasa si cambio de IP del servidor Plex?
Actualiza la URL en Overseerr y vuelve a validar el token de Plex.
¿Es obligatorio publicarlo fuera de casa?
No; muchos usuarios lo sirven solo en VPN o Tailscale.
¿Dónde veo logs persistentes?
Usa docker compose logs y rota logs del daemon si necesitas trazabilidad larga.
¿Puedo ejecutar Overseerr en Raspberry Pi?
Sí, si la arquitectura está soportada por la imagen; valida tags multi-arq en Docker Hub y usa almacenamiento rápido para la base de datos embebida.
En conjunto, un Overseerr Docker Compose bien acotado reduce fricción social en tu homelab y profesionaliza las peticiones de contenido sin ceder el control de tus bibliotecas. Fija versiones, protege el acceso y mantén copias del volumen de configuración para recuperarte rápido ante migraciones o fallos de disco. Con el tiempo, este stack se convierte en el punto único donde negociais qué entrar en el servidor sin pelearos por hilos de mensajes dispersos. Revisa trimestralmente usuarios inactivos y permisos heredados de pruebas antiguas: la higiene de cuentas alarga la vida útil del servicio en meses y años.
