Instala Oulim en un NAS (beta)

Oulim Player NAS es un servidor de Oulim sin pantalla que funciona en tu NAS las 24 horas. Hace lo mismo que Oulim Desktop en “Usa tu PC como NAS”: organiza tus vídeos, busca pósteres e información, registra dispositivos y te da acceso desde fuera de casa. Solo tienes que pegar un archivo compose y cambiar dos líneas.

Importante Oulim Player NAS aún no se ha lanzado, así que todavía no se puede instalar. La imagen se publicará junto con la app; entonces podrás seguir esta guía.

Importante Esto es una beta. Todavía lo estamos probando en distintos modelos de NAS, así que puede haber problemas inesperados. Si algo falla, avísanos con Informar de un problema, abajo a la izquierda en la página de administración. Con el informe se envía el registro del servidor del NAS, lo que ayuda a encontrar la causa (las direcciones y rutas van ocultas).

Qué necesitas

  • Un NAS que pueda usar Docker (contenedores): Container Manager en Synology, Container Station en QNAP o un equipo Linux con Docker instalado
  • Una CPU de 64 bits: Intel/AMD (x64) o ARM64. No funciona en NAS ARM de 32 bits
  • Al menos 1 GB de memoria libre (se recomiendan 2 GB o más)
  • Un móvil, tablet o TV en la misma Wi-Fi y con Oulim Player instalado

Consejo Si tienes un PC siempre encendido, también puedes instalar Oulim Desktop en él en lugar del NAS: hace lo mismo. Consulta la guía “Usa tu PC como NAS”.

1. Prepara el archivo compose

Copia el texto de abajo. Solo tienes que adaptar a tu NAS las dos líneas marcadas con <-.

compose.yaml
services:
  oulim-player:
    image: <published at app launch>
    container_name: oulim-player
    network_mode: host
    user: "1000:1000"              # <- your NAS user id (id -u : id -g)
    environment:
      - OULIM_NAME=Oulim NAS
      - OULIM_MEDIA=/volume1       # folders you can add in the admin page (several: /volume1:/volume2)
    volumes:
      - ./config:/config
      - ./cache:/cache
      - /volume1:/volume1:ro       # <- your video storage, read-only
    restart: unless-stopped
LíneaQué poner
userEl número de tu usuario en el NAS. Conéctate al NAS por SSH y escribe id: verás algo como uid=1026(…) gid=100(…). Pon esos números, por ejemplo "1026:100"
/volume1:/volume1:roLa carpeta superior del almacenamiento donde están tus vídeos. Escribe la misma ruta del NAS a ambos lados. :ro significa solo lectura, así que Oulim no puede borrar ni modificar tus vídeos
OULIM_MEDIADónde puedes elegir las carpetas de la biblioteca en la página de administración. Pon la misma ruta que montaste arriba
OULIM_NAMEEl nombre que se verá en el móvil y la TV (puedes dejarlo tal cual)
NASEjemplos de ruta de almacenamiento
Synology/volume1 · /volume2 … (discos USB: /volumeUSB1/usbshare)
QNAP/share/CACHEDEV1_DATA · /share/CACHEDEV2_DATA …
Otro LinuxDonde está montado el disco de vídeos (p. ej. /mnt/media)

Consejo ¿Tienes varios volúmenes de almacenamiento? Añade una línea más en volumes por cada uno y únelos en OULIM_MEDIA con :. Por ejemplo: OULIM_MEDIA=/volume1:/volume2

Importante No montes todo el NAS (/): también aparecerían las carpetas del sistema. Monta solo el almacenamiento donde están tus vídeos.

2. Ponlo en marcha

Crea en el NAS una carpeta donde Oulim guardará sus ajustes (por ejemplo, docker/oulim). Al ejecutar compose desde esa carpeta, se crean dentro las carpetas config y cache.

NASCómo ejecutarlo
SynologyContainer Manager › Project › Create → elige la carpeta como ruta → pega el texto copiado en Create docker-compose.yml → Done
QNAPContainer Station › Applications › Create → pega el texto copiado como YAML → Create
Otro LinuxGuárdalo como compose.yaml en la carpeta y ejecuta docker compose up -d

Consejo Los nombres de los menús del NAS pueden variar un poco según la versión de DSM o QTS, y también según el idioma. Consulta las capturas en las guías oficiales de arriba.

3. Configuración inicial

  1. En un PC conectado a la misma Wi-Fi, abre http://dirección-del-NAS:45800 en el navegador. Verás la pantalla Configuración inicial.
  2. Busca el Código de configuración en el registro del contenedor: en Synology, en Container Manager › Container › oulim-player › Log; en Linux, con docker logs oulim-player.
  3. Escribe el código de configuración, elige una contraseña de administrador (8 caracteres como mínimo) y selecciona Empezar.
Configuración inicial: el Código de configuración del registro del contenedor y la contraseña de administrador
Configuración inicial: el Código de configuración del registro del contenedor y la contraseña de administrador

Consejo La página de administración solo se abre desde tu red de casa. La contraseña se guarda únicamente en este NAS.

4. Añade las carpetas de la biblioteca

  1. En la pestaña Biblioteca, selecciona Añadir carpeta.
  2. Si tienes varios volúmenes, elige uno arriba, entra en tu carpeta de vídeos y selecciona Añadir esta carpeta.
  3. Oulim empieza a organizar al momento. Los pósteres y las sinopsis van apareciendo a medida que termina con cada título.
Añadir carpeta: elige dentro del almacenamiento que montaste en compose
Añadir carpeta: elige dentro del almacenamiento que montaste en compose

Los consejos para nombrar carpetas son los mismos que en la guía “Cómo organizar tus archivos y carpetas”. Si añades o borras vídeos en la carpeta, Oulim lo detecta solo.

5. Añade tu móvil, tablet o TV

  1. Página de administración: en la pestaña Dispositivos, selecciona Añadir dispositivo. Aparecen un código QR y un Código de vinculación.
  2. Móvil: en la pestaña Red, toca el icono de QR de arriba (Añadir mi PC) y escanea el código. En la TV, escribe el código de vinculación en esa misma pantalla.
  3. Página de administración: cuando llegue la solicitud, comprueba que el código de confirmación coincide en las dos pantallas y selecciona Aprobar.
Añadir dispositivo: QR y código de vinculación; cuando llegue una solicitud, revisa el código y pulsa Aprobar
Añadir dispositivo: QR y código de vinculación; cuando llegue una solicitud, revisa el código y pulsa Aprobar

El NAS aparece en la pestaña Red del dispositivo que añadiste, y sus vídeos se ven en Inicio y Biblioteca.

Consejo Si también usas Oulim Desktop en un PC, no añadas además esta carpeta del NAS a la biblioteca del PC por SMB. Para verla en el PC, registra el PC en este NAS igual que un móvil. Si ya la añadiste, el PC no retransmite esa carpeta a tus dispositivos, para que los mismos vídeos no aparezcan dos veces.

Mira tus vídeos fuera de casa (Pro)

Elige cómo conectarte en la pestaña Acceso remoto de la página de administración. Si tu router admite la apertura automática de puertos (UPnP), Oulim abre el puerto por ti. Encontrarás más detalles en la guía “NAS y conexión en red”.

Consejo El acceso remoto está desactivado al principio (solo red de casa). Aunque lo actives, en el router solo se abre el puerto al que se conectan tus dispositivos; la página de administración nunca se abre a internet.

Consejo Si usas a la vez un NAS y un PC con Oulim Desktop, cada uno necesita su propio puerto externo en el router. Con la apertura automática, Oulim elige un número libre (45810 · 45811 …). Si abres los puertos tú mismo en el router, usa el Puerto externo que aparece en la pestaña Acceso remoto; por ejemplo, PC 45810 y NAS 45811.

Actualizar y detener

  • Para actualizar, descarga la nueva imagen y vuelve a ponerlo en marcha. En Synology, haz Stop → Build (descarga la imagen) → Start en el proyecto; en Linux, ejecuta docker compose pull y luego docker compose up -d.
  • Los ajustes, los dispositivos registrados y la biblioteca organizada se guardan en la carpeta config, así que no se pierden al actualizar.
  • Oulim vuelve a arrancar solo cuando se reinicia el NAS, salvo que lo hayas detenido tú: en ese caso se queda apagado.

Transcodificación por hardware (opcional)

Un NAS con gráficos integrados Intel (Quick Sync) o AMD puede convertir vídeos 4K a 1080p mientras los envía. Oulim comprueba si es posible cada vez que arranca: lo verás en la línea de transcodificación de Estado, en la página de administración.

Eso sí, Docker no da acceso por defecto a la gráfica del NAS desde el contenedor. Añade las dos líneas de abajo encima de la línea restart del compose para permitirlo. En un NAS sin gráfica, estas líneas impiden que arranque el contenedor; en ese caso, bórralas y los vídeos se reproducirán tal cual.

    devices:
      - /dev/dri:/dev/dri

Solución de problemas

ProblemaQué comprobar
El móvil no ve el NASQue estén en la misma Wi-Fi, que el compose tenga network_mode: host y que el firewall del NAS no bloquee UDP 45809 ni TCP/UDP 45810
La carpeta que quiero no sale en Añadir carpetaQue ese almacenamiento esté montado en volumes del compose y que la misma ruta esté en OULIM_MEDIA
Los vídeos no aparecen o no se organizanQue la cuenta del NAS pueda leer la carpeta de vídeos: es la cuenta cuyo número pusiste en user del compose. En el gestor de archivos del NAS, esa cuenta (o su grupo) necesita permiso de “lectura” en la carpeta
El contenedor no arranca tras añadir la transcodificación por hardwareEl NAS no tiene gráfica (/dev/dri). Borra las dos líneas de devices y vuelve a ponerlo en marcha
Tengo dos servidores Oulim NAS en el mismo equipo y la segunda página de administración no abreEl puerto de la página de administración (45800) está ocupado. En el segundo compose, añade otro número en environment, como OULIM_ADMIN_PORT=45801, y abre http://dirección-del-NAS:45801
He perdido el código de configuraciónReinicia el contenedor y volverá a aparecer en el registro (hasta que termines la configuración inicial)