Saltar al contenido

Configura KumoYami desde cero

De la cuenta en kumoyami.com a tu primera película en la Biblioteca, paso a paso y en orden.

Esta guía recorre todo el camino, en el orden en que conviene hacerlo: la cuenta, el plan, la instalación, el asistente, tus carpetas y nubes, el acceso desde fuera y las personas con las que compartes. Cada paso es corto y enlaza a su página con todos los detalles. Calcula una media hora, más lo que tarde en leer tu biblioteca.

Lo que vas a necesitar

Un correo (o una cuenta de Google, GitHub o Apple), un equipo donde instalarlo (un servidor Linux, un NAS o un ordenador con Docker) y, para entrar desde fuera de casa, un dominio, un túnel de Cloudflare o Tailscale. Mira los requisitos.

1. Crea tu cuenta en kumoyami.com

Entra en Mi cuenta con Google, GitHub, Apple o con tu correo: te mandamos un enlace de un solo uso y, al abrirlo, ya estás dentro. No hay contraseñas que recordar.

La primera vez que entras se crea tu cuenta con una licencia Gratis, sin tarjeta y sin caducidad. Es la cuenta a la que vincularás tus servidores y donde verás tus licencias, tus servidores, tus pedidos y tus facturas.

2. Elige tu plan (Gratis también vale)

Con el plan Gratis ya tienes Archivos y la Biblioteca básica, sin límite de almacenamientos ni de cuentas. Los planes de pago añaden lo mejor de cada lado:

PlanPara qué
GratisArchivos y la Biblioteca básica, en 1 servidor.
PassLo mejor de la Biblioteca: tu cine en casa (GPU, perfiles, Ver juntos, saltar intro…).
ProLo mejor de Archivos: compartir y crear (buzones, álbumes, Patreon, marca de agua…).
TotalPass y Pro juntos.

Cada plan de pago se paga al mes, al año o una vez, de por vida. Compáralos en Precios y en Planes y funciones. Puedes empezar con Gratis y mejorar, cambiar de plan o de periodo cuando quieras desde Mi cuenta: la licencia y tus servidores siguen siendo los mismos.

3. Instala el servidor

Elige tu plataforma. En todas, KumoYami escucha en el puerto 4890 (el lanzador y el panel), además del 4891 (la Biblioteca) y el 4892 (Archivos), y guarda todo lo que configuras en su carpeta de datos.

Synology: el paquete del Centro de paquetes

El paquete nativo de KumoYami Server funciona directamente en DSM, sin Container Manager: Node.js y ffmpeg van dentro, con los controladores de la gráfica Intel para convertir vídeo. Necesita DSM 7.2 o posterior en un NAS con procesador Intel o AMD de 64 bits; el de los modelos ARM de 64 bits está en beta y convierte solo con el procesador (mejor con 1 GB de RAM o más). Si prefieres Docker, puedes montarlo tú con Docker Compose en Container Manager, aunque preferimos el nativo. Cuál elegir y cómo pasar de uno a otro, en la página de Synology.

Para que las actualizaciones lleguen al Centro de paquetes como las de cualquier otro paquete, añade KumoYami como origen de paquetes:

  1. Centro de paquetes → Configuración → General → Nivel de confianza: elige Cualquier editor (el paquete es de un tercero, no de Synology).
  2. Centro de paquetes → Configuración → Orígenes de paquetes → Añadir: nombre KumoYami, ubicación https://kumoyami.com/synology.
  3. Busca KumoYami Server en el Centro de paquetes, instálalo y sigue su asistente: la carpeta compartida de los datos, la carpeta con tu contenido (opcional), el puerto y la zona horaria.

El resto de plataformas

En un servidor o VPS con Linux, por SSH:

curl -fsSL https://kumoyami.com/install.sh | sudo bash

La imagen es pública: Docker la descarga sin docker login y sin licencia. La licencia se vincula después, en el paso 4.

En Windows y macOS, con su instalador

En tu PC o tu Mac, KumoYami se instala como cualquier programa, sin Docker: descárgalo en Descargas y sigue Windows y macOS.

4. El asistente: tu acceso y tu licencia

Abre http://IP-DEL-EQUIPO:4890/admin (o la dirección que te dio el instalador). La primera vez se abre el asistente, en tres pasos.

El código de configuración

Para que nadie más configure tu servidor antes que tú, el asistente pide un código que KumoYami escribe en sus registros al arrancar. El propio asistente te dice dónde mirar en tu plataforma:

Dónde instalasteDónde está el código
Linux, con el instaladorAl terminar, el instalador muestra la contraseña del panel y te ahorras este paso. Si lo ejecutaste con --no-admin-password, muestra el código.
Docker Compose (también QNAP y TrueNAS)docker compose logs web | grep -i código, o en los registros (logs) del contenedor.
Synology, paquete nativoFile Station → la carpeta compartida de los datos → logs → kumoyami.log.
Synology, Container ManagerContainer Manager → Contenedor → el de KumoYami → Detalles → Registro.
UnraidPestaña Docker → icono de KumoYami → Logs.

Busca la línea «Código de configuración».

La contraseña del panel

Elige la contraseña de /admin (que sea larga) y el nombre de tu web. Después podrás añadir un segundo paso con una app de autenticación o passkeys.

Vincula el servidor con tu cuenta

El asistente muestra un código corto, como BCDF-GHJK, y un botón que abre kumoyami.com/activate con el código ya puesto. Entra con tu cuenta, comprueba el nombre, la dirección y la versión del servidor, elige la licencia y confirma. El asistente termina solo: no hay claves que copiar.

El código dura 15 minutos; si caduca, pide otro. En un servidor sin navegador a mano, Tengo una clave de licencia deja pegar la clave (KY1.…) que ves en Mi cuenta.

Si entraste con la contraseña del instalador (o con ADMIN_PASSWORD en el .env), no hay asistente: el panel abre la página Licencia, donde vinculas el servidor igual, con Vincular con kumoyami.com.

30 días sin conexión

El servidor confirma la licencia cada hora con licenses.kumoyami.com (una conexión de salida por HTTPS). Si se queda sin internet, sigue funcionando 30 días; al volver la conexión, se pone al día solo. Más detalles en el asistente y la licencia y en Tu licencia.

5. Elige tus módulos: Biblioteca, Archivos o los dos

KumoYami tiene dos caras, cada una en su dirección:

  • La Biblioteca: tus películas, series, música, libros y fotos como una plataforma de streaming.
  • Archivos: tus carpetas y tus nubes en un índice web, con enlaces para compartir, buzones y unidad de red.

Próximamente, en el asistente

El asistente te preguntará qué quieres usar: la Biblioteca, Archivos o los dos (al menos uno). Cada uno tendrá su dirección por defecto, app.tudominio.com para la Biblioteca y drive.tudominio.com para Archivos, y podrás cambiarlas.

Hoy, cada parte se enciende y se apaga en Sistema → Módulos (Módulos), y ahí mismo va la dirección de cada módulo, cuando tengas un dominio (paso 7).

Mientras, en tu red, la dirección del servidor (http://IP-DEL-EQUIPO:4890) abre un lanzador con una tarjeta para cada módulo, y cada uno tiene además su propio puerto: la Biblioteca el 4891 y Archivos el 4892.

6. Añade tus almacenamientos

En el panel, Almacenamientos → Añadir almacenamiento. Puedes juntar varios en un solo índice.

Carpetas del servidor o del NAS

Elige Carpeta local y su ruta dentro de KumoYami (/data/<nombre>). KumoYami solo ve las carpetas que le das, y con el permiso que les das: solo lectura basta para mostrarlas y para la Biblioteca; para subir, renombrar o borrar desde la web (subidas, buzones, pedir archivos) la carpeta necesita lectura y escritura.

  • Synology, paquete: Panel de control → Carpeta compartida → la carpeta → Editar → Permisos → desplegable Usuario interno del sistema → kumoyami: Solo lectura, o Lectura/Escritura para las de subidas. KumoYami la ve al momento, sin reiniciar (ruta /volume1/<carpeta>).
  • Synology, Container Manager: monta la carpeta en el docker-compose.yml, con :ro si es solo de lectura; para escribir, el usuario del contenedor (uid 1000) necesita permiso de escritura en ella.
  • Unraid: en la plantilla, cada ruta (Add another Path…) tiene su Access Mode: Read Only para mostrar, Read/Write para subir. El contenedor usa 99:100 (nobody:users), el dueño habitual de los shares de Unraid.
  • TrueNAS SCALE: el uid 1000 necesita lectura en el dataset, y escritura para subir; revísalo en sus permisos (ACL).
  • Linux, QNAP y Docker Compose: monta la carpeta con :ro o sin él; para escribir, debe poder hacerlo el uid 1000.

Paso a paso en Carpetas locales.

Nubes

KumoYami lee tus nubes al vuelo, sin copiarlas al servidor: OneDrive (personal, de empresa o un enlace compartido), Google Drive, Dropbox, MEGA, Yandex Disk, PikPak, TeraBox, almacenamientos S3 compatibles, Azure Blob Storage, Bunny Storage, WebDAV, SFTP, FTP/FTPS, Seafile, el File Station de otro Synology y más. Para OneDrive, mira Conectar OneDrive.

7. Tu dominio y HTTPS

Para entrar desde fuera de casa hace falta algo delante de KumoYami que lo publique con HTTPS. Elige una:

La Biblioteca y Archivos van cada uno en su dirección, y el proxy manda las dos al puerto 4890. Después, en Sistema → Módulos, guarda la dirección de cada módulo: mira Guarda las direcciones en Módulos y, para elegir, Dominio propio. Para usarlo solo en casa, basta la IP del equipo.

8. Las personas: cuentas e invitaciones

En Personas → Ajustes, enciende las cuentas. Después, quien entra en tu web puede hacerlo de varias formas:

  • Cuentas locales: créalas o invítalas en Personas → Cuentas. Con el correo configurado, reciben la invitación y sus códigos por correo; sin él, les pasas tú el enlace.
  • Patreon (planes Pro y Total): quien apoya tu campaña entra con su cuenta de Patreon, y su nivel decide qué carpetas y bibliotecas ve.
  • Entrar con KumoYami (próximamente): invitarás por correo desde kumoyami.com, y quien recibe la invitación entra con una cuenta gratuita de kumoyami.com, sin contraseñas nuevas para tu servidor.

Cada biblioteca se comparte con todas las cuentas o solo con los grupos, niveles de Patreon o cuentas que elijas. Los perfiles y el control parental están en Perfiles.

9. El código de servidor, para quien te visita

En Sistema → Acceso desde fuera, enciende el Código de servidor. Tu servidor recibe un código corto: quien lo escribe en kumoyami.com/link llega a tu web sin saber su dirección, y las apps de KumoYami encontrarán tu servidor con él. Compártelo, o su enlace y su QR, con tus cuentas. Mira Código de servidor.

/link no es /activate

kumoyami.com/activate es para ti: vincula tu servidor con tu licencia (paso 4), una sola vez. kumoyami.com/link es para quien te visita: lleva a tu servidor con su código. Son códigos distintos.

10. Si vienes de Plex

No empiezas de cero: Biblioteca → Importar desde Plex trae, de cada usuario de tu Plex Home, lo que ha visto, dónde dejó cada vídeo, su lista y las portadas que pusiste, sin tocar Plex ni mover un archivo. Mira Importar desde Plex. Para el cambio completo, con lo que se parece y lo que cambia, sigue la guía Pásate desde Plex.

11. Copias de seguridad y actualizaciones

  • Copias: todo lo que configuras está en la carpeta de datos, junto al docker-compose.yml y el .env. Guárdalos y lo tienes todo: Copias de seguridad.
  • Actualizaciones: con el instalador, Docker Compose, Unraid o el Centro de paquetes de Synology, en Actualizar.
  • Cambiar de equipo: en Cambiar de servidor.

Si algo no sale como aquí, mira Problemas frecuentes.

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.