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.
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
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 .envSon 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.
Inicia sesión en el registro privado
Una sola vez, con tu licencia: el usuario es el identificador lic_… y, cuando pida la contraseña, pega la clave
KY1.… entera.
sudo docker login registry.kumoyami.com -u lic_xxxxxxxxxxxxdocker login guarda la sesión en ~/.docker/config.json del usuario que lo ejecuta (con sudo, en
/root/.docker/config.json). Usa el mismo usuario para los comandos de docker compose.
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 que cubre tu licencia)
# 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 datosArranca
sudo docker compose up -d
sudo docker compose logs -f web # Ctrl+C para salir de los registros; la web sigueEn 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ódigoKumoYami queda escuchando en http://127.0.0.1:4890. Para entrar desde fuera, ponle un dominio con
un proxy inverso o, mientras tanto, usa un túnel SSH:
ssh -L 4890:127.0.0.1:4890 usuario@IP-DEL-SERVIDOR # y abre http://localhost:4890/adminEl docker-compose.yml
El archivo que descargas tiene un servicio, web, y otros dos opcionales comentados:
- web: la imagen
registry.kumoyami.com/kumoyami, con./datosmontada en/app/datosy el puerto publicado solo en127.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, puerto3310) 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:
services:
web:
image: registry.kumoyami.com/kumoyami:latest
restart: unless-stopped
environment:
DATA_DIR: /app/datos
# ADMIN_PASSWORD: una-contraseña-larga
volumes:
- /ruta/a/kumoyami/datos:/app/datos
# - /ruta/a/tus/fotos:/data/fotos:ro
ports:
- "4890:3000"Escuchar en toda la red
"4890:3000", sin 127.0.0.1: delante, deja KumoYami accesible en http://IP-DEL-EQUIPO:4890 desde tu red local.
Es lo cómodo en un NAS de casa. En un servidor con IP pública, mantén 127.0.0.1:4890:3000 y entra por el proxy
inverso.