Saltar al contenido
Por plataforma

Docker Compose a mano

Instala KumoYami paso a paso en cualquier sistema con Docker, sin el instalador.

Esta es la instalación de referencia: la que hace el instalador, a mano. Sirve en cualquier sistema con Docker y el plugin Compose (docker compose version debe responder), y es la base de las guías de NAS.

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 la carpeta y descarga los archivos

sudo mkdir -p /opt/kumoyami && cd /opt/kumoyami
sudo curl -fsSL https://kumoyami.com/install/docker-compose.yml -o docker-compose.yml
sudo curl -fsSL https://kumoyami.com/install/env.example -o .env

Son los mismos archivos que acompañan a tu licencia en el correo de compra. La carpeta puede ser otra: todo lo que necesita KumoYami está dentro de ella.

La imagen es pública: se descarga sin iniciar sesión. La licencia se activa en el panel de KumoYami (Licencia).

Revisa el .env

Todo es opcional. Lo más habitual:

# Contraseña del panel. Sin ella, la primera visita a /admin abre el asistente, que te deja elegirla.
ADMIN_PASSWORD=

# Puerto local de KumoYami (por defecto 4890)
# KUMOYAMI_PORT=4890

# Fijar una versión concreta (por defecto, la última)
# KUMOYAMI_VERSION=

Los almacenamientos (OneDrive, carpetas…) y sus credenciales no van aquí: se configuran en el panel.

Crea la carpeta de datos

Debe poder escribir en ella el usuario del contenedor, que es el uid 1000:

sudo mkdir -p datos && sudo chown 1000:1000 datos

Arranca

sudo docker compose up -d
sudo docker compose logs -f web     # Ctrl+C para salir de los registros; la web sigue

En los registros aparece el código de configuración inicial que pedirá el asistente de /admin. Para volver a verlo:

sudo docker compose logs web | grep -i código

KumoYami queda escuchando en el propio equipo: el lanzador y el panel en http://127.0.0.1:4890, la Biblioteca en :4891 y Archivos en :4892. Para entrar desde fuera, ponle un dominio con un proxy inverso o, mientras tanto, usa un túnel SSH con los tres puertos:

ssh -L 4890:127.0.0.1:4890 -L 4891:127.0.0.1:4891 -L 4892:127.0.0.1:4892 usuario@IP-DEL-SERVIDOR
# y abre http://localhost:4890/admin

El docker-compose.yml

El archivo que descargas tiene un servicio, web, y otros dos opcionales comentados:

  • web: la imagen registry.kumoyami.com/kumoyami, con ./datos montada en /app/datos y sus tres puertos (4890, 4891 y 4892) publicados solo en 127.0.0.1.
  • watchtower (comentado): para actualizar con un clic desde el panel.
  • clamav (comentado): el antivirus para lo que suben los visitantes a los buzones. Se activa en el panel (Buzones → Antivirus, servidor clamav, puerto 3310) y usa unos 1,5 GB de RAM.

Para publicar carpetas del servidor, añade sus volúmenes al servicio web: lo explica Carpetas locales.

Una versión autónoma, sin .env

Algunas interfaces de NAS no permiten subir un .env junto al archivo de Compose. Esta variante lleva todo dentro y usa rutas absolutas; cambia las rutas por las de tu equipo:

docker-compose.yml
services:
  web:
    image: registry.kumoyami.com/kumoyami:latest
    restart: unless-stopped
    environment:
      DATA_DIR: /app/datos
      PORT: "4890"
      # ADMIN_PASSWORD: una-contraseña-larga
    volumes:
      - /ruta/a/kumoyami/datos:/app/datos
      # - /ruta/a/tus/fotos:/data/fotos:ro
    ports:
      # 4890: el lanzador y el panel; 4891: la Biblioteca; 4892: Archivos
      - "4890-4892:4890-4892"

Escuchar en toda la red

"4890-4892:4890-4892", sin 127.0.0.1: delante, deja KumoYami accesible desde tu red local: el panel en http://IP-DEL-EQUIPO:4890/admin, la Biblioteca en :4891 y Archivos en :4892. Es lo cómodo en un NAS de casa. En un servidor con IP pública, mantén 127.0.0.1: delante y entra por el proxy inverso: mira Docker y Linux.

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.