Saltar al contenido
Por plataforma

Unraid

KumoYami en Unraid, con el plugin Compose Manager o desde el terminal.

Unraid trae Docker de serie. Como KumoYami se distribuye como un proyecto de Docker Compose, lo más cómodo es el plugin Docker Compose Manager de Community Applications, que añade Compose y lo gestiona desde la pestaña Docker.

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.

Instalar

Instala Compose Manager

En Apps (Community Applications), busca Docker Compose Manager e instálalo.

Prepara las carpetas e inicia sesión en el registro

Abre el terminal de Unraid (el icono >_ de la barra superior) y ejecuta:

mkdir -p /mnt/user/appdata/kumoyami/datos
chown 1000:1000 /mnt/user/appdata/kumoyami/datos
docker login registry.kumoyami.com -u lic_xxxxxxxxxxxx    # contraseña: la clave KY1.… entera

El contenedor de KumoYami se ejecuta con el uid 1000 (no con nobody:users como muchas apps de Unraid), por eso la carpeta datos debe ser suya.

Crea el proyecto

En la pestaña Docker, en la sección de Compose, añade un proyecto nuevo llamado kumoyami, edita su archivo de Compose y pega:

docker-compose.yml
services:
  web:
    image: registry.kumoyami.com/kumoyami:latest
    restart: unless-stopped
    environment:
      DATA_DIR: /app/datos
    volumes:
      - /mnt/user/appdata/kumoyami/datos:/app/datos
      # Shares que quieras publicar (:ro = solo lectura):
      # - /mnt/user/Fotos:/data/fotos:ro
    ports:
      - "4890:3000"

Guarda y pulsa Compose Up.

Abre el panel

Visita http://IP-DE-UNRAID:4890/admin. Para ver el código de configuración, en el terminal:

docker logs kumoyami-web-1 2>&1 | grep -i código

Sigue con el asistente.

Permisos de los shares

KumoYami lee tus shares como uid 1000. Los shares de Unraid suelen permitir la lectura a todos los usuarios, así que con :ro funciona sin más. Si quieres que KumoYami pueda subir, renombrar o borrar en un share, monta el volumen sin :ro y asegúrate de que el uid 1000 puede escribir en esa carpeta.

HTTPS

Si ya usas un proxy inverso en Unraid (Nginx Proxy Manager, SWAG, Traefik…), crea una entrada hacia IP-DE-UNRAID:4890. Si no, Cloudflare Tunnel evita abrir puertos en el router. Más opciones en Dominio y HTTPS.

Actualizar

En la sección de Compose de la pestaña Docker, usa Update Stack (o Compose Pull y luego Compose Up), o en el terminal, en la carpeta del proyecto, docker compose pull && docker compose up -d. Más detalles en Actualizar.