Saltar al contenido
Por plataforma

Windows y macOS

KumoYami en tu ordenador con su instalador, sin Docker, o con Docker Desktop.

KumoYami tiene instalador para Windows y para macOS: se instala como cualquier programa, sin Docker ni terminal, y queda funcionando en tu ordenador. Es ideal para probarla, publicar las carpetas de tu ordenador en casa o preparar la configuración antes de llevarla a un servidor. Para una web pública, siempre encendida y con dominio, es mejor un servidor Linux.

Descárgalos en Descargas: la página te da el de tu sistema y, en un Mac, el de tu procesador.

Aún sin firmar

Los instaladores todavía no están firmados, así que Windows y macOS te avisan la primera vez que los abres. Los pasos de abajo te dicen cómo seguir; solo hace falta una vez.

Con el instalador

Windows

Windows 10 (versión 1809 o posterior) u 11, de 64 bits. No hace falta ser administrador: se instala para tu usuario.

Abre el instalador

KumoYami-Server-X.Y.Z-windows-x64.exe. La primera vez, Windows SmartScreen avisa con «Windows protegió su PC»: pulsa Más información y luego Ejecutar de todas formas.

Instálalo

El programa va a %LOCALAPPDATA%\Programs\KumoYami y tus datos a %LOCALAPPDATA%\KumoYami. Al terminar, KumoYami arranca y se abre en tu navegador, en http://localhost:4890.

Entra en el panel

Sigue el asistente. El código que te pide está en Registros, en el menú del icono de KumoYami junto al reloj. Ahí activas también tu licencia.

El icono junto al reloj abre KumoYami, lo detiene o lo inicia, abre la carpeta de datos y los registros, y decide si arranca con Windows. Salir lo para del todo.

KumoYami escucha en tres puertos: el 4890 (el lanzador y el panel), el 4891 (la Biblioteca) y el 4892 (Archivos). Desde el móvil u otro equipo de tu red, http://IP-DE-TU-PC:4890, :4891 y :4892. La primera vez que arranca, Windows pregunta si permites las conexiones (hace falta un administrador para las redes privadas); sin ese permiso, solo se llega desde el propio PC. La regla es del programa, así que vale para los tres puertos.

macOS

macOS 13.5 Ventura o posterior, en un Mac con Apple silicon (M1 o posterior) o con Intel: cada uno tiene su descarga.

Arrástralo a Aplicaciones

Abre KumoYami-Server-X.Y.Z-macos-arm64.dmg (o -x64, en un Mac con Intel) y arrastra KumoYami Server a la carpeta Aplicaciones. Ábrelo siempre desde ahí. También hay un .zip con la app, si lo prefieres.

Ábrelo la primera vez

La app aún no está firmada por Apple. Haz clic derecho (o Control-clic) en KumoYami Server → Abrir, y otra vez Abrir. Si no aparece esa opción (macOS 15 Sequoia o posterior), intenta abrirla una vez y ve a Ajustes del Sistema → Privacidad y seguridad: abajo, pulsa Abrir igualmente.

Entra en el panel

KumoYami arranca en segundo plano (sin icono en el Dock) y se abre en tu navegador, en http://localhost:4890. Sigue el asistente: te dice dónde está el código que te pide. Tus datos están en ~/Library/Application Support/KumoYami y el registro, en su carpeta logs.

KumoYami vuelve a arrancar solo cada vez que inicias sesión. Para pararlo, desde el Terminal:

"/Applications/KumoYami Server.app/Contents/MacOS/KumoYami" --stop

Con --uninstall en lugar de --stop, deja además de arrancar al iniciar sesión.

Con Docker Desktop

Con Docker Desktop, KumoYami funciona en Windows y en macOS igual que en un servidor, con la misma imagen. Es la opción si ya usas Docker o quieres el mismo docker-compose.yml que llevarás después a un servidor.

El instalador no sirve aquí

install.sh es solo para Linux. En Windows y macOS sigue estos pasos, que son la instalación con Docker Compose adaptada.

Requisitos

  • Windows 10 u 11 de 64 bits con WSL 2 (Docker Desktop lo activa al instalarse), o macOS reciente.
  • Docker Desktop instalado y en marcha.
  • Un PC con Intel o AMD, o un Mac con Intel o con Apple Silicon (M1, M2, M3…).

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.

Instalar

Crea una carpeta y descarga los archivos

Abre PowerShell (Windows) o Terminal (macOS):

mkdir $HOME\kumoyami; cd $HOME\kumoyami
curl.exe -fsSL https://kumoyami.com/install/docker-compose.yml -o docker-compose.yml
curl.exe -fsSL https://kumoyami.com/install/env.example -o .env
mkdir datos

Arranca

La imagen es pública: se descarga sin iniciar sesión.

docker compose up -d
docker compose logs web    # busca la línea del «Código de configuración inicial»

Abre http://localhost:4890/admin y sigue el asistente: ahí activas la licencia. La Biblioteca está en http://localhost:4891 y Archivos en http://localhost:4892.

Publicar carpetas del ordenador

Añade los volúmenes al servicio web del docker-compose.yml y vuelve a ejecutar docker compose up -d. En el panel, usa la ruta de la derecha (/data/…):

    volumes:
      - ./datos:/app/datos
      - C:/Users/tu-usuario/Pictures:/data/fotos:ro      # Windows
      # - /Users/tu-usuario/Pictures:/data/fotos:ro      # macOS

En macOS, si Docker Desktop no puede leer la carpeta, revisa en sus ajustes (Resources → File sharing) que la ruta está compartida.

Verla desde otros dispositivos de casa

El docker-compose.yml publica los tres puertos de KumoYami solo en 127.0.0.1, es decir, en tu propio ordenador. Para abrirlos desde el móvil u otro equipo de la red, quita 127.0.0.1: de las tres líneas de ports:

docker-compose.yml
    ports:
      - "${KUMOYAMI_PORT:-4890}:4890"
      - "4891:4891"
      - "4892:4892"

Ejecuta docker compose up -d y visita http://IP-DE-TU-ORDENADOR:4890 (el lanzador), :4891 (la Biblioteca) y :4892 (Archivos). El cortafuegos de Windows o de macOS puede pedirte permiso la primera vez.

Mientras el ordenador está apagado…

…KumoYami tampoco está. Con el instalador, KumoYami arranca solo al iniciar sesión; con Docker Desktop, Docker puede arrancar al iniciar sesión (en sus ajustes) y el contenedor vuelve solo gracias a restart: unless-stopped. En los dos casos, el equipo debe estar encendido, con tu sesión iniciada y sin suspender.

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.