Saltar al contenido
Por plataforma

Servidor o VPS Linux

La forma recomendada de alojar KumoYami, con el instalador, a mano o con el paquete .deb.

Un servidor o VPS con Linux es donde KumoYami funciona mejor: siempre encendido, con una IP pública para el dominio y sin capas intermedias. Sirve cualquier distribución con Docker: Debian, Ubuntu, Rocky Linux, AlmaLinux, Fedora… Y en Debian y Ubuntu, también un paquete .deb que no necesita Docker.

Compatible con ARM

Desde la versión 0.1.3, la imagen de KumoYami es multiplataforma (amd64 y arm64): Docker descarga sola la variante de tu equipo, sin cambiar nada en el docker-compose.yml. Hace falta un sistema de 64 bits; los ARM de 32 bits no sirven.

Elegir el servidor

  • Memoria: 1 GB de RAM como mínimo, 2 GB recomendados. Si vas a activar el antivirus de las subidas (ClamAV), cuenta con 4 GB: ClamAV usa por sí solo alrededor de 1,5 GB.
  • Disco: 5 GB libres para Docker y la imagen, más lo que ocupen las carpetas locales que publiques. Lo que está en OneDrive u otras nubes no ocupa espacio en el servidor.
  • Red: salida a internet por HTTPS (para el registro y la licencia) y, si vas a usar un dominio, los puertos 80 y 443 abiertos hacia el servidor.

Con el instalador

Es lo más rápido: un comando que instala Docker, prepara los archivos y pone HTTPS con Caddy. Sigue la instalación rápida.

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

A mano

Si prefieres ver cada paso, o ya tienes Docker y un proxy inverso funcionando, sigue Docker Compose a mano. El resultado es el mismo que con el instalador.

Sin Docker: el paquete .deb o el .tar.gz

En Debian 12, Ubuntu 22.04 o posterior, con un procesador Intel o AMD de 64 bits (x86_64), un paquete instala KumoYami directamente en el sistema, sin Docker, con su propio Node.js, ffmpeg y los controladores de la GPU. Descárgalo en Descargas e instálalo desde su carpeta:

sudo apt install ./kumoyami_X.Y.Z_amd64.deb

El paquete crea el usuario de sistema kumoyami y el servicio kumoyami de systemd, que arranca enseguida y en cada inicio. KumoYami queda en http://IP-DEL-SERVIDOR:4890 (el lanzador y el panel), con la Biblioteca en :4891 y Archivos en :4892, y el código que pide el asistente está en el registro del servicio:

sudo journalctl -u kumoyami | grep -i código
  • Ajustes: en /etc/default/kumoyami (el puerto, la dirección en la que escucha, la zona horaria). Trae solo PORT=4890, pero el servicio lee el archivo entero: los puertos de los módulos se cambian añadiendo KUMOYAMI_LIBRARY_PORT=4891 y KUMOYAMI_FILES_PORT=4892 (0 deja el módulo sin puerto propio). Después de cambiarlos, sudo systemctl restart kumoyami.
  • Cortafuegos: el paquete no lo toca. Con ufw activado, abre los tres puertos solo a tu red local (cambia la red por la tuya): sudo ufw allow from 192.168.1.0/24 to any port 4890:4892 proto tcp.
  • Datos: en /var/lib/kumoyami. El usuario kumoyami necesita permiso de lectura en las carpetas que publiques.
  • Actualizar: instala el .deb nuevo de la misma forma. sudo apt remove kumoyami lo desinstala y conserva los datos; sudo apt purge kumoyami los borra también.

En otras distribuciones (con glibc 2.28 o posterior), el .tar.gz trae lo mismo. Descomprímelo en /opt y arráncalo en primer plano, con los datos en ~/.local/share/kumoyami; para dejarlo como servicio de systemd, sigue el README.md que trae, junto a kumoyami.service:

sudo tar -xzf kumoyami-X.Y.Z-linux-x64.tar.gz -C /opt
/opt/kumoyami/kumoyami-server

Sin Docker no hay Caddy: KumoYami escucha en los puertos 4890, 4891 y 4892 de todas las direcciones del equipo. Para tu dominio con HTTPS, ponle delante un proxy inverso y pon HOSTNAME=127.0.0.1 en /etc/default/kumoyami, para que ninguno de los tres quede abierto hacia fuera.

Cortafuegos

Con Docker, KumoYami escucha solo en 127.0.0.1 (4890, 4891 y 4892), así que esos puertos nunca deben abrirse hacia fuera: el tráfico entra por el proxy inverso. Abre únicamente los puertos del proxy. Por ejemplo, con ufw:

sudo ufw allow 22/tcp     # SSH, para no quedarte fuera
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

Si tu proveedor tiene un cortafuegos en su panel (grupos de seguridad, firewall de red…), abre ahí también el 80 y el 443. Con un túnel de Cloudflare no hace falta abrir ninguno.

Docker y ufw

Docker publica los puertos de los contenedores saltándose las reglas de ufw. Por eso el docker-compose.yml de KumoYami publica el 4890, el 4891 y el 4892 solo en 127.0.0.1: no quites el 127.0.0.1: en un servidor con IP pública.

Siguientes pasos

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.