Saltar al contenido
Por plataforma

Windows y macOS

KumoYami en tu ordenador con Docker Desktop, para probarla o usarla en casa.

Con Docker Desktop, KumoYami funciona en Windows y en macOS igual que en un servidor. 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.

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. Sobre los Mac con Apple Silicon (M1, M2, M3…), mira el aviso de abajo.

ARM: próximamente

La imagen de KumoYami todavía es solo para procesadores x86_64 (Intel y AMD). La versión para ARM (arm64: Raspberry Pi, Mac con Apple Silicon, VPS y NAS con ARM) llegará en una próxima versión; esta guía se actualizará entonces.

En un Mac con Apple Silicon, Docker Desktop puede ejecutar la imagen x86_64 emulada, pero es más lento y no está soportado: espera a la versión para ARM.

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

Inicia sesión en el registro privado

Usuario: el identificador lic_…. Contraseña: la clave KY1.… entera.

docker login registry.kumoyami.com -u lic_xxxxxxxxxxxx

Arranca

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.

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 KumoYami solo en 127.0.0.1, es decir, en tu propio ordenador. Para abrirla desde el móvil u otro equipo de la red, cambia la línea de ports a "4890:3000" y ejecuta docker compose up -d; luego visita http://IP-DE-TU-ORDENADOR:4890. El cortafuegos de Windows o de macOS puede pedirte permiso la primera vez.

Mientras el ordenador está apagado…

…KumoYami tampoco está. Docker Desktop puede arrancar al iniciar sesión (en sus ajustes) y el contenedor vuelve solo gracias a restart: unless-stopped, pero el equipo debe estar encendido y sin suspender.

Actualizar con un clic

Watchtower, el actualizador de un clic, no puede leer la sesión de docker login cuando Docker la guarda en el gestor de credenciales del sistema, como hace Docker Desktop. Aquí, actualiza con docker compose pull && docker compose up -d.