Introducción

KumoYami es una web de archivos que instalas en tu propio servidor: une OneDrive, las carpetas del servidor y el resto de tus almacenamientos en un solo índice, con visores, reproductor, enlaces para compartir y buzones. Funciona con Docker, en un solo contenedor, y se configura desde su panel de administración en /admin.

Esta guía cubre la instalación en cada tipo de equipo, el dominio con HTTPS, la primera configuración y el mantenimiento (actualizar, copias de seguridad, cambiar de servidor).

Qué necesitas

Tu licencia. Al comprar recibes por correo su identificador (lic_ seguido de 12 caracteres) y la clave (empieza por KY1.). Con ellos se descarga la imagen privada de registry.kumoyami.com y se activa el panel.
Un equipo con Docker y Docker Compose. Un servidor o VPS con Linux es lo más sencillo: el instalador pone Docker si falta. También sirve un NAS (Synology, QNAP, Unraid, TrueNAS) o un ordenador con Docker Desktop.
Un procesador x86_64 (Intel o AMD). Para los procesadores ARM, mira antes Raspberry Pi y ARM.
Conexión a internet saliente. El servidor descarga la imagen de registry.kumoyami.com y confirma la licencia cada día con licencias.kumoyami.com (por HTTPS, puerto 443).
Un dominio con HTTPS (recomendado). Para usarla solo en casa basta la IP del equipo, pero para compartir enlaces, conectar OneDrive desde fuera o usar passkeys necesitas un dominio con certificado. Mira Dominio y HTTPS.

Recursos

	Mínimo	Recomendado
Memoria	1 GB de RAM	2 GB (4 GB si activas el antivirus ClamAV)
Disco	5 GB libres para Docker y la imagen	Lo que ocupen tus archivos locales, aparte

Los archivos de OneDrive y del resto de almacenamientos en la nube no se copian al servidor: KumoYami los lee al vuelo.

Tu web sigue funcionando sin conexión

La licencia se confirma una vez al día y vale 14 días sin contacto con el servidor de licencias. Si dejara de valer, solo se bloquea el panel de administración: los visitantes no notan nada.

Elige cómo instalar

Instalación rápida

Un comando en un servidor Linux: Docker, la licencia, HTTPS con Caddy y el arranque.

Docker Compose a mano

En cualquier sistema con Docker, paso a paso, sin el instalador.

Synology

En Container Manager, con un proyecto de Compose.

QNAP

En Container Station, como aplicación de Compose.

Unraid

Con el plugin Compose Manager o desde el terminal.

TrueNAS SCALE

Como app personalizada con un archivo de Compose.

Windows y macOS

Con Docker Desktop, para probarla o usarla en casa.

Raspberry Pi y ARM

Raspberry Pi, VPS y NAS con procesador ARM.

Cómo funciona

Navegador
   │  HTTPS (puertos 80 y 443)
   ▼
Proxy inverso: Caddy, Nginx…
   │
   ▼
KumoYami en 127.0.0.1:4890
   ├──▶ OneDrive, carpetas del servidor, otras nubes…
   └──▶ datos/  (configuración, tokens, licencia)

KumoYami escucha solo en el propio servidor, en el puerto 4890. Delante va un proxy inverso que pone el dominio y el HTTPS (el instalador puede configurar Caddy por ti). Todo lo que configuras en el panel se guarda en la carpeta datos/, junto al docker-compose.yml y el .env: son los tres elementos que hay que guardar en las copias de seguridad.

El puerto 4890

Puedes cambiarlo con KUMOYAMI_PORT en el .env (por ejemplo KUMOYAMI_PORT=8080) y docker compose up -d. Las instalaciones hechas antes de este cambio escuchan en el 3000: mira la línea ports de tu docker-compose.yml para saber cuál usa la tuya.

Qué necesitasCopiar el enlace a este apartado

RecursosCopiar el enlace a este apartado

Elige cómo instalarCopiar el enlace a este apartado