Saltar al contenido

Autoalojamiento

Actualizar a una nueva versión

Lleva un Notifuse autoalojado a una nueva versión con Docker Compose, comprueba el resultado y vuelve atrás si hace falta.

Una actualización sustituye la imagen de Notifuse y la reinicia. Notifuse actualiza sus bases de datos por sí mismo al arrancar con la nueva versión.

Lee primero el changelog

Abre el changelog y lee todas las versiones entre la tuya y la nueva. Algunas versiones tienen una nota Antes de actualizar con un cambio que hay que hacer junto con la actualización, como un nuevo valor de SECRET_KEY para 42.0 o WEBHOOK_DELIVERY_ALLOW_PRIVATE_HOSTS para los webhooks en tu propia red.

Cuando Buscar actualizaciones está activado, el usuario root y los propietarios de espacios de trabajo ven una tarjeta en la lista de espacios de trabajo cuando sale una nueva versión. Su botón Ver las novedades abre todas las versiones desde la tuya, cada una con sus notas Antes de actualizar: y un enlace Registro de cambios completo.

Haz una copia de seguridad

Haz una copia de seguridad de todas las bases de datos y guarda SECRET_KEY junto a los volcados, como explica Copias de seguridad. Volver a una versión mayor anterior requiere esta copia (consulta Volver atrás).

Define DB_EXPECT_EXISTING=true en .env si todavía no está. Si la actualización dejara alguna vez a Notifuse ante una base de datos vacía, se detendría en lugar de iniciar una nueva instalación.

Actualizar con Docker Compose

compose.yaml toma la versión de NOTIFUSE_VERSION:

image: notifuse/notifuse:${NOTIFUSE_VERSION:-v44.0}

El valor por defecto después de :- es la versión con la que se publicó el archivo. Elige una de las dos formas de cambiarlo, desde el directorio que contiene compose.yaml.

Fijar la versión en .env

Define la nueva versión en .env, luego descarga la imagen y reinicia:

# In .env: NOTIFUSE_VERSION=v44.0
docker compose pull
docker compose up -d

Descargar el nuevo compose.yaml

Sustituye tu compose.yaml por el más reciente, luego descarga la imagen y reinicia. Tu .env se queda como está. Copia en el nuevo archivo cualquier cambio que hubieras hecho en compose.yaml.

curl -fsSL https://raw.githubusercontent.com/Notifuse/notifuse/main/compose.yaml -o compose.yaml
docker compose pull
docker compose up -d

Si .env define NOTIFUSE_VERSION, ese valor prevalece sobre el valor por defecto del archivo: actualízalo también.

docker compose pull descarga la nueva imagen mientras la antigua sigue funcionando. Después, docker compose up -d sustituye el contenedor. Notifuse dispone de hasta 70 segundos para detenerse: antes terminan el paso de automatización en curso y los correos que se están enviando.

Para comprobar qué versión ejecutará Compose antes de reiniciar, mira la imagen resuelta:

docker compose config | grep 'image: notifuse'

Nota

Hasta 43.0, compose.yaml compila Notifuse a partir del clon del repositorio en el que se encuentra. En un clon así, cambia a la nueva versión (git fetch --tags && git checkout v44.0) y ejecuta docker compose up -d. Desde 44.0, el archivo ejecuta la imagen publicada, salvo que pases --build.

Qué pasa al arrancar

Cuando la nueva versión arranca, Notifuse ejecuta sus migraciones de base de datos antes de atender ninguna solicitud:

  1. Comprueba la versión de PostgreSQL. Desde 44.0, se niega a arrancar con un PostgreSQL anterior a 17 e indica qué versión encontró.
  2. Compara la versión mayor registrada en la base de datos del sistema (43 para 43.0) con la suya.
  3. Aplica cada migración intermedia a la base de datos del sistema y luego a cada base de datos de espacio de trabajo.
  4. Registra la nueva versión. Algunas migraciones hacen después que Notifuse termine una vez, y Docker lo vuelve a arrancar (restart: unless-stopped).

Con varias instancias sobre la misma base de datos, una aplica las migraciones y las demás la esperan (42.2 y posteriores). Sigue el progreso en el log:

docker compose logs -f api

El log cierra este paso con Migration process completed successfully, o con Database is up to date, no migrations needed cuando la versión mayor no cambió. Si una migración falla, Notifuse no arranca y el log la nombra: migration failed for version ….

Comprobar la versión

Inicia sesión y abre la lista de espacios de trabajo. Su pie muestra la versión en ejecución, como Notifuse v44.0. El menú de la cuenta también la muestra.

Desde la línea de comandos, la lleva el archivo de configuración de la consola:

curl -s https://emails.yourcompany.com/config.js | grep VERSION

Después comprueba que https://emails.yourcompany.com/healthz responde {"status":"ok"} y abre un espacio de trabajo para revisar tus datos.

Volver atrás

Notifuse solo registra la versión mayor en la base de datos, y no tiene migraciones de reversión.

Dentro de la misma versión mayor (de 44.1 a 44.0, por ejemplo), define la versión anterior en NOTIFUSE_VERSION y ejecuta docker compose up -d. Notifuse arranca sobre la misma base de datos.

Entre versiones mayores, la versión anterior se niega a arrancar sobre una base de datos que la más reciente ya migró. El log dice database is at version 44, this build is version 43 - refusing to start. Para volver atrás:

  1. Detén el stack con docker compose down.
  2. Define la versión anterior en NOTIFUSE_VERSION, o vuelve a poner su compose.yaml.
  3. Restaura en una base de datos vacía la copia que hiciste antes de actualizar, como explica Restaurar, con el SECRET_KEY con el que se hizo la copia.

Todo lo escrito desde la copia se pierde.

Si la actualización fue la de 44.0, que además lleva PostgreSQL a 18, usa en su lugar la copia que guarda compose.yaml: Volver atrás restituye los datos de PostgreSQL 17 tal como estaban antes de la actualización, con el compose.yaml de la versión anterior.

Actualizar PostgreSQL

La versión 44.0 pasa compose.yaml de PostgreSQL 17 a 18, y el primer docker compose up -d con ella actualiza también la base de datos. Actualizar PostgreSQL explica qué ocurre, cuánto espacio en disco necesita, cómo comprobarlo y cómo deshacerlo.