Actualizar
Instala las versiones nuevas a mano, con el instalador o con un clic desde el panel.
El panel avisa en Actualizaciones cuando hay una versión nueva que tu licencia incluye. Tus datos, almacenamientos
y ajustes están en datos/ y se conservan al actualizar.
A mano
En la carpeta de la instalación (/opt/kumoyami con el instalador):
cd /opt/kumoyami
docker compose pull && docker compose up -dpull descarga la versión más reciente que cubre tu licencia y up -d vuelve a crear el contenedor con ella. La
sesión de docker login se conserva: solo hay que repetirlo si cambia la clave de la licencia.
Tras cambiar algo del .env, basta con docker compose up -d.
Con el instalador
Volver a ejecutar install.sh también actualiza: además de descargar la imagen nueva y reiniciar, pone al día el
docker-compose.yml (guardando el anterior como docker-compose.yml.bak-FECHA). Conserva el .env y los datos.
curl -fsSL https://kumoyami.com/install.sh | sudo bashSi has hecho cambios propios en el docker-compose.yml, añade -s -- --keep-compose para conservarlo.
Con un clic desde el panel
Con Watchtower, el botón de Actualizaciones del panel instala la versión nueva sin entrar al servidor.
Activa el servicio watchtower
En el docker-compose.yml, descomenta el bloque watchtower:
watchtower:
image: nickfedor/watchtower
restart: unless-stopped
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ${HOME}/.docker/config.json:/config.json:ro
command: --http-api-update --label-enable --cleanup
environment:
WATCHTOWER_HTTP_API_TOKEN: ${WATCHTOWER_TOKEN}Monta el config.json de docker login para poder descargar del registro privado. Si ejecutas Docker con sudo, la
sesión está en /root/.docker/config.json: pon esa ruta en lugar de ${HOME}/.docker/config.json.
Añade el token al .env
Una contraseña larga, que el panel usará para pedir la actualización:
openssl rand -hex 24WATCHTOWER_URL=http://watchtower:8080
WATCHTOWER_TOKEN=la-contraseña-generadaReinicia
docker compose up -dWatchtower solo actualiza los contenedores que lo piden con su etiqueta (el de KumoYami la lleva). Si la licencia
cambia de clave, repite docker login.
Docker Desktop y gestores de credenciales
Si tu Docker guarda las credenciales en un gestor del sistema (credsStore en config.json, lo normal en Docker
Desktop), Watchtower no puede leerlas. En un servidor Linux normal no pasa; en los demás casos, actualiza a mano.
Cuando termina tu periodo de actualizaciones
Tu licencia incluye las versiones publicadas hasta el final de su periodo de actualizaciones. Después, tu web sigue funcionando con todas las funciones de tu plan; solo dejas de recibir las versiones nuevas. Las correcciones de seguridad te siguen llegando.
docker compose pulldescarga solo versiones que tu licencia cubre. Para quedarte en una concreta, fíjala en el.env, por ejemploKUMOYAMI_VERSION=1.4.2, y ejecutadocker compose up -d.- Si instalas una versión posterior a tu periodo, el panel se bloquea y te dice a qué versión volver. Vuelve a ella con
KUMOYAMI_VERSION, o renueva las actualizaciones y pulsa Renovar ahora en la página Licencia.
Volver a una versión anterior
Añade la versión al .env (por ejemplo con sudo nano .env):
KUMOYAMI_VERSION=1.4.2Y vuelve a crear el contenedor:
docker compose pull && docker compose up -dPara volver a la última, quita la línea KUMOYAMI_VERSION y repite el comando.