Servidor o VPS Linux
La forma recomendada de alojar KumoYami, con el instalador o a mano.
Un servidor o VPS con Linux es donde KumoYami funciona mejor: siempre encendido, con una IP pública para el dominio y sin capas intermedias. Sirve cualquier distribución con Docker: Debian, Ubuntu, Rocky Linux, AlmaLinux, Fedora…
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.
Elegir el servidor
- Memoria: 1 GB de RAM como mínimo, 2 GB recomendados. Si vas a activar el antivirus de las subidas (ClamAV), cuenta con 4 GB: ClamAV usa por sí solo alrededor de 1,5 GB.
- Disco: 5 GB libres para Docker y la imagen, más lo que ocupen las carpetas locales que publiques. Lo que está en OneDrive u otras nubes no ocupa espacio en el servidor.
- Red: salida a internet por HTTPS (para el registro y la licencia) y, si vas a usar un dominio, los puertos 80 y 443 abiertos hacia el servidor.
Con el instalador
Es lo más rápido: un comando que instala Docker, inicia sesión con tu licencia, prepara los archivos y pone HTTPS con Caddy. Sigue la instalación rápida.
curl -fsSL https://kumoyami.com/install.sh | sudo bashA mano
Si prefieres ver cada paso, o ya tienes Docker y un proxy inverso funcionando, sigue Docker Compose a mano. El resultado es el mismo que con el instalador.
Cortafuegos
KumoYami escucha solo en 127.0.0.1:4890, así que ese puerto nunca debe abrirse hacia fuera: el tráfico entra por el
proxy inverso. Abre únicamente los puertos del proxy. Por ejemplo, con ufw:
sudo ufw allow 22/tcp # SSH, para no quedarte fuera
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enableSi tu proveedor tiene un cortafuegos en su panel (grupos de seguridad, firewall de red…), abre ahí también el 80 y el 443. Con Cloudflare Tunnel no hace falta abrir ninguno.
Docker y ufw
Docker publica los puertos de los contenedores saltándose las reglas de ufw. Por eso el docker-compose.yml de
KumoYami publica el 4890 solo en 127.0.0.1: no lo cambies a 4890:3000 en un servidor con IP pública.