Synology
KumoYami en un NAS Synology, con el paquete nativo o, si prefieres Docker, en Container Manager.
En un Synology hay dos formas de instalar KumoYami:

KumoYami Server, el paquete nativo (recomendado): un paquete del Centro de paquetes,
como Plex, que se instala con un asistente, sin SSH ni terminal, y funciona directamente en DSM, sin Container
Manager. Lleva dentro Node.js y ffmpeg y, en los modelos con gráfica Intel, convierte el vídeo con ella.- Con Container Manager, con tu propio proyecto de Docker Compose, si prefieres Docker. Preferimos el nativo: no necesita Container Manager y recibe las actualizaciones en el Centro de paquetes.
Las dos usan los mismos datos y puedes pasar de una a otra.
Qué paquete elegir
| Tu NAS | El paquete |
|---|---|
| Intel o AMD de 64 bits (DS920+, DS720+, DS224+, DS923+…) | kumoyami-X.Y.Z-x86_64.spk. Con un Celeron J4125 o similar, convierte el vídeo con la gráfica Intel (VA-API / Quick Sync). |
| ARM de 64 bits (DS218, DS223, DS423, DS124…) | kumoyami-X.Y.Z-armv8.spk, en beta: convierte solo con el procesador. |
Pide DSM 7.2 o posterior. Los NAS con ARM de 32 bits no pueden ejecutar KumoYami. El procesador de tu NAS sale en Centro de información → General → Nombre de CPU, y en Descargas puedes comprobar tu modelo.
ARM de 64 bits: el paquete nativo, en beta
En los Synology con ARM de 64 bits (Realtek RTD1296, RTD1619B…), el paquete nativo convierte el vídeo solo con el procesador y aún no lo hemos probado en un NAS de verdad: por eso es beta. Recomendamos al menos 1 GB de RAM; en los modelos de 512 MB va justo. Los ARM de 32 bits no sirven.
Instalar el paquete
Desde el Centro de paquetes
Si añades el origen de paquetes de KumoYami, el Centro de paquetes muestra KumoYami como cualquier otro paquete, sin
descargar el .spk, y te avisa de cada versión nueva:
- En DSM, abre Centro de paquetes → Configuración → Orígenes de paquetes y pulsa Añadir.
- Nombre:
KumoYami. Ubicación:https://kumoyami.com/synology. Pulsa Aceptar. - En Configuración → General, pon el Nivel de confianza en Cualquier editor. Los paquetes no van firmados por Synology (desde DSM 7, ninguno de terceros lo va) y, con el nivel de siempre, DSM no deja instalarlos.
- Cierra la configuración. En la pestaña Comunidad aparece KumoYami Server: pulsa Instalar y sigue su asistente.
El Centro de paquetes ofrece la versión de tu procesador, en los Intel, AMD y ARM de 64 bits. En otros modelos no aparece.
Instalación manual
Descarga el paquete
En Descargas, elige tu NAS y descarga el paquete.
El paquete
(kumoyami-X.Y.Z-x86_64.spk o kumoyami-X.Y.Z-armv8.spk) ocupa entre 150 y 280 MB, porque lleva KumoYami dentro.
Instálalo
En DSM, Centro de paquetes → Instalación manual → Examinar, elige el .spk y pulsa Siguiente. Tiene que ser
el de tu procesador: el de otro no se instala.
DSM avisa de que el paquete no es de Synology: desde DSM 7, los paquetes de terceros no van firmados y DSM lo dice siempre. Acepta para seguir y sigue el asistente.
El asistente del paquete nativo
Carpetas
- Carpeta compartida de los datos:
kumoyamipor defecto; se crea si no existe. Ahí van los ajustes, las cuentas y las cachés de KumoYami. - Subcarpeta (opcional): solo si vienes de un proyecto de Container Manager, para seguir con sus datos (mira Pasar de una forma a otra).
- Carpeta compartida con tu contenido (opcional): una que ya exista, como
video. El instalador le da a KumoYami permiso de solo lectura. Las demás las añades después.
Red
- Puerto: 4890 por defecto, entre 1025 y 65535. Los de DSM (5000, 5001, 5005 y 5006) no valen.
- Zona horaria:
Europe/Madridpor defecto, o la tuya (America/Mexico_City,UTC…).
Antes de instalar
Solo informa: el paquete lleva dentro Node.js y ffmpeg (hasta unos 600 MB instalado). La licencia no se pide aquí, sino en KumoYami, la primera vez que lo abres.
Si algo no cuadra (el puerto está ocupado, la carpeta de tu contenido no existe, el NAS no puede ejecutar el paquete), la instalación se cancela con el motivo y no queda nada instalado.
Ábrelo y vincula tu licencia
Al terminar, el Centro de paquetes dice la dirección: http://IP-DEL-NAS:4890. KumoYami también está en el menú
principal de DSM (el botón de arriba a la izquierda), como «KumoYami Server», y en Abrir del Centro de paquetes.
DSM no pone iconos en el escritorio al instalar un paquete: para tenerlo ahí, en el menú principal, clic derecho en
KumoYami Server → Añadir al escritorio.
La primera vez, KumoYami pide un código de configuración: está en File Station → la carpeta compartida de los datos →
logs → kumoyami.log (busca «Código de configuración»). Luego eliges la contraseña del panel y vinculas el
servidor con tu cuenta, con un código en kumoyami.com/activate; también vale pegar tu clave de licencia.
Mira el asistente.
Tus carpetas del NAS
KumoYami lee las carpetas compartidas que su usuario de DSM, kumoyami, puede leer. La que escribiste en el asistente
ya la puede leer. Para otra: Panel de control → Carpeta compartida → la carpeta → Editar → Permisos, desplegable
Usuario interno del sistema, kumoyami, Solo lectura (o Lectura/Escritura si quieres subir archivos desde
la web), y guarda. KumoYami la ve al momento, sin reiniciar.
Después, en el panel de KumoYami: Almacenamientos → Añadir almacenamiento → Carpeta local → Examinar → volume1 (NAS)
y la carpeta (/volume1/video). Las que aún no puede leer salen con un candado. El nativo ve también las carpetas
cifradas (mientras están montadas) y los discos USB (volumeUSB1).
La GPU
En los modelos Intel con gráfica (Celeron J4125 y similares) no hay nada que configurar: el paquete da a su usuario acceso a la gráfica y KumoYami la usa sola. Para comprobarlo, en el panel: Apariencia → Reproducción → Aceleración por hardware → Probar. Si justo después de instalar falla, en el Centro de paquetes pulsa Detener y Ejecutar en KumoYami Server y prueba otra vez. En los modelos sin gráfica Intel (AMD Ryzen, ARM), convierte con el procesador.
El puerto
El puerto del asistente (4890) es el del lanzador y el panel. Cada módulo escucha además en el suyo, para entrar desde
tu red sin dominio: la Biblioteca en http://IP-DEL-NAS:4891 y Archivos en http://IP-DEL-NAS:4892. Para cambiar el
4890, desinstala sin borrar los datos y vuelve a instalar con otro: los datos se quedan.
El paquete declara los tres puertos (4890 a 4892) en DSM, así que su cortafuegos ya los conoce: si lo tienes activado, en Panel de control → Seguridad → Cortafuegos → Editar reglas → Crear, elige Seleccionar de una lista de aplicaciones integradas, marca KumoYami Server y permite el acceso desde tu red local. Para entrar desde fuera con HTTPS, usa el proxy inverso de DSM.
Actualizar un paquete
Con el origen de paquetes, la versión nueva aparece en Centro de paquetes → Instalado con el botón Actualizar.
Sin él, instala el .spk de la versión nueva igual, con Instalación manual. Las dos formas conservan las respuestas
del asistente y los datos.
El aviso de Actualizaciones del panel de KumoYami habla de docker compose pull; en el paquete, la forma de
actualizar es esta. Todos los planes reciben todas las versiones.
Desinstalar un paquete
Centro de paquetes → KumoYami Server → Desinstalar. Tus carpetas de contenido no se tocan nunca, y los datos de KumoYami se quedan en su carpeta compartida, salvo que marques Borrar también los datos de KumoYami (no se puede deshacer). Aun así, la carpeta compartida sigue en DSM: si ya no la quieres, bórrala en Panel de control → Carpeta compartida.
Si no vas a volver a instalarlo en este NAS, desactiva antes la licencia en el panel (Licencia → Desactivar en este servidor) para usarla en otro equipo.
Pasar de una forma a otra
Si tenías el paquete de antes (hasta la 0.1.5)
Hasta la 0.1.5, «KumoYami Server» era un paquete que funcionaba en Container Manager. Ahora ese nombre es el del
nativo, y el Centro de paquetes te lo ofrece como actualización: actualiza sin desinstalar. DSM retira el proyecto y
el contenedor kumoyami, y se conservan los datos, el puerto y la zona horaria. Los almacenamientos «Carpeta local»
(/data/volume1/…) siguen funcionando. La imagen registry.kumoyami.com/kumoyami puede quedarse en Container
Manager → Imagen: bórrala si quieres. Si prefieres seguir con Docker, desinstálalo sin marcar «Borrar también los
datos» y usa tu propio proyecto con esa carpeta de datos.
Si instalaste «KumoYami Server (Docker)» (la 0.1.6)
Ese paquete, un proyecto de Container Manager, ya no se publica: el Centro de paquetes no le ofrecerá versiones
nuevas. Pásate al nativo: desinstálalo sin marcar «Borrar también los datos» e instala el nativo con la misma
carpeta compartida de los datos (y la misma subcarpeta, si usabas una). Los dos usan el usuario kumoyami, así que
los permisos de tus carpetas siguen valiendo, y los almacenamientos «Carpeta local» (/data/volume1/…) funcionan en
el nativo. Si KumoYami no arranca, da a kumoyami Lectura/Escritura en la carpeta compartida de los datos (en sus
Permisos, como arriba) y pulsa Ejecutar. Si prefieres seguir con Docker, usa
tu propio proyecto.
De tu propio proyecto de Container Manager al paquete: haz antes una copia de datos. Detén el proyecto y
bórralo, sin borrar su carpeta: si queda un proyecto o un contenedor llamado kumoyami, la instalación falla. Instala el
paquete con la carpeta compartida donde está (docker, por ejemplo) y, como subcarpeta, la ruta de sus datos
(kumoyami/datos). El paquete funciona con el usuario kumoyami, no con el uid 1000 del contenedor: si KumoYami no
puede escribir sus datos, da a kumoyami Lectura/Escritura en esa carpeta compartida. Los almacenamientos que
usaban las rutas de tu docker-compose.yml (/data/fotos), cámbialos por la ruta del NAS (/volume1/fotos).
Con Container Manager
Tu propio proyecto de Docker Compose, sin paquete, para DSM 7.2 o posterior con Container Manager: la forma de usar Docker en un Synology. Preferimos el paquete nativo: no necesita Container Manager y recibe las actualizaciones en el Centro de paquetes.
Prepara las carpetas
En File Station, crea una carpeta para KumoYami dentro de la carpeta compartida docker (Container Manager la crea
al instalarse), por ejemplo docker/kumoyami, y dentro de ella otra llamada datos.
Da permiso a la carpeta datos
La imagen es pública: Container Manager la descarga él solo, sin iniciar sesión. La licencia se activa después en el panel de KumoYami (Licencia).
Lo que sí hace falta, una vez y como root, es dejar la carpeta datos escribible para el usuario del contenedor
(uid 1000).
Sin SSH, con una tarea de root: Panel de control → Programador de tareas → Crear → Tarea programada → Script
definido por el usuario. En General, usuario root; en Configuración de tareas, este script:
chown 1000:1000 /volume1/docker/kumoyami/datosGuárdala, selecciónala y pulsa Ejecutar. Después puedes borrarla.
Con SSH (actívalo en Panel de control → Terminal y SNMP y entra con un administrador), lo mismo con sudo:
sudo chown 1000:1000 /volume1/docker/kumoyami/datosCambia volume1 si tu carpeta docker está en otro volumen.
Crea el proyecto
En Container Manager → Proyecto → Crear:
- Nombre:
kumoyami. - Ruta: la carpeta
docker/kumoyami. - Origen: crear un
docker-compose.ymly pegar este contenido (la versión autónoma, con las rutas del NAS):
services:
web:
image: registry.kumoyami.com/kumoyami:latest
restart: unless-stopped
environment:
DATA_DIR: /app/datos
PORT: "4890"
volumes:
- /volume1/docker/kumoyami/datos:/app/datos
# Carpetas compartidas que quieras publicar (:ro = solo lectura):
# - /volume1/fotos:/data/fotos:ro
ports:
# 4890: el lanzador y el panel; 4891: la Biblioteca; 4892: Archivos
- "4890-4892:4890-4892"
# Convertir vídeo con la gráfica Intel, en los modelos que la tienen (937 es el grupo de /dev/dri en DSM):
# devices:
# - /dev/dri:/dev/dri
# group_add:
# - "937"Si el asistente ofrece configurar un portal web (Web Station), puedes omitirlo. Container Manager descarga la imagen y arranca el proyecto.
Por SSH también vale, siempre con sudo y desde la carpeta del proyecto (después aparece igualmente en Container
Manager, para ver los registros, parar y arrancar):
cd /volume1/docker/kumoyami
sudo docker compose up -dAbre el panel
Visita http://IP-DEL-NAS:4890/admin (la Biblioteca está en :4891 y Archivos en :4892). El asistente pide el
código de configuración: está en los registros del contenedor (Container Manager → Contenedor → kumoyami-web-1 → Registro, busca «Código») o por SSH:
sudo docker logs kumoyami-web-1 2>&1 | grep -i códigoSigue con el asistente.
HTTPS con el proxy inverso de DSM
DSM incluye DDNS, un proxy inverso y certificados de Let's Encrypt, así que no necesitas Caddy ni Nginx. En resumen:
- Un nombre para cada módulo (tu dominio o el DDNS de Synology) y el puerto 443 (y el 80) abierto en el router hacia el NAS.
- El certificado, en Panel de control → Seguridad → Certificado.
- Una regla de proxy inverso por cada dirección (Portal de inicio de sesión → Avanzado → Proxy inverso): origen
HTTPS, tu dominio,443; destinoHTTP,localhost,4890; y el encabezado personalizado WebSocket. - El certificado asignado a cada regla, en Seguridad → Certificado → Configuración.
- Las direcciones, en el panel de KumoYami: Sistema → Módulos.
Paso a paso, con los menús de DSM y qué hacer si algo falla, en Dominio propio en Synology. Si tu conexión no permite abrir puertos (CGNAT, router del operador), usa un túnel de Cloudflare o Tailscale.
Actualizar en Container Manager
La imagen es pública, así que Container Manager descarga la versión nueva sin iniciar sesión: puedes actualizar desde él, como cualquier otro contenedor.
Si prefieres que se actualice sola (por ejemplo, cada día a las 4:00), usa una tarea de root: Programador de tareas →
Crear → Tarea programada → Script definido por el usuario, usuario root, con:
cd /volume1/docker/kumoyami && /usr/local/bin/docker compose pull && /usr/local/bin/docker compose up -d && /usr/local/bin/docker image prune -fPor SSH es lo mismo: cd /volume1/docker/kumoyami && sudo docker compose pull && sudo docker compose up -d. La web se
reinicia unos segundos y tus datos no cambian. Para quedarte en una versión concreta, mira
Volver a una versión anterior.
El nombre del contenedor
Container Manager nombra el contenedor a partir del proyecto y el servicio: con el proyecto kumoyami será
kumoyami-web-1. Si eliges otro nombre, cámbialo en los comandos.
Todas las marcas y logotipos pertenecen a sus respectivos propietarios. Su uso solo indica compatibilidad, no patrocinio ni asociación. El logotipo de Synology es una marca de Synology Inc.; Google Drive, Google Cast y Android son marcas de Google LLC, y el robot de Android es obra de Google, compartida con la licencia Creative Commons Reconocimiento 3.0. Microsoft, Windows y OneDrive son marcas de Microsoft; Amazon S3, de Amazon.com, Inc. o sus filiales; Apple, AirPlay, macOS e iPhone, de Apple Inc.; Raspberry Pi, de Raspberry Pi Ltd; Ubuntu, de Canonical Ltd.; Debian, de Software in the Public Interest, Inc.; Linux, de Linus Torvalds. Este producto usa la API de TMDB, pero TMDB no lo respalda ni certifica.