Saltar al contenido
Mantenimiento

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 -d

pull 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 bash

Si 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 24
.env
WATCHTOWER_URL=http://watchtower:8080
WATCHTOWER_TOKEN=la-contraseña-generada

Reinicia

docker compose up -d

Watchtower 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 pull descarga solo versiones que tu licencia cubre. Para quedarte en una concreta, fíjala en el .env, por ejemplo KUMOYAMI_VERSION=1.4.2, y ejecuta docker 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):

.env
KUMOYAMI_VERSION=1.4.2

Y vuelve a crear el contenedor:

docker compose pull && docker compose up -d

Para volver a la última, quita la línea KUMOYAMI_VERSION y repite el comando.