> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://www.notifuse.com/es/docs/changelog.md) 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](https://www.notifuse.com/es/docs/self-hosting/backups.md). Volver a una versión mayor anterior requiere esta copia (consulta [Volver atrás](#rolling-back)).

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`:

```yaml compose.yaml
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:

```bash
# 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`.

```bash
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:

```bash
docker compose config | grep 'image: notifuse'
```

> [!NOTE]
>
> 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:

```bash
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:

```bash
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](https://www.notifuse.com/es/docs/self-hosting/backups.md#restoring), 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](https://www.notifuse.com/es/docs/self-hosting/upgrading-postgresql.md#rolling-back) 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](https://www.notifuse.com/es/docs/self-hosting/upgrading-postgresql.md) explica qué ocurre, cuánto espacio en disco necesita, cómo comprobarlo y cómo deshacerlo.
