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

# Auf ein neues Release aktualisieren

> Aktualisieren Sie ein selbst gehostetes Notifuse mit Docker Compose auf ein neues Release, prüfen Sie das Ergebnis und kehren Sie bei Bedarf zurück.

Ein Update ersetzt das Notifuse-Image und startet es neu. Beim Start auf dem neuen Release aktualisiert Notifuse seine Datenbanken selbst.

## Zuerst das Änderungsprotokoll lesen

Öffnen Sie das [Änderungsprotokoll](https://www.notifuse.com/de/docs/changelog.md) und lesen Sie jedes Release zwischen Ihrer Version und der neuen. Manche Releases haben einen Hinweis **Vor dem Update** mit einer Änderung, die Sie im selben Schritt wie das Update vornehmen, etwa einen neuen Wert für `SECRET_KEY` bei 42.0 oder `WEBHOOK_DELIVERY_ALLOW_PRIVATE_HOSTS` für Webhooks in Ihrem eigenen Netzwerk.

Ist **Nach Updates suchen** eingeschaltet, sehen der Root-Benutzer und die Inhaber von Arbeitsbereichen in der Liste der Arbeitsbereiche eine Karte, sobald ein neues Release erschienen ist. Ihre Schaltfläche **Neuerungen ansehen** zeigt jedes Release seit Ihrem, jeweils mit seinen Hinweisen **Vor dem Update:** und einem Link **Vollständiges Änderungsprotokoll**.

## Sicherung erstellen

Sichern Sie jede Datenbank und bewahren Sie `SECRET_KEY` zusammen mit den Dumps auf, wie unter [Sicherungen](https://www.notifuse.com/de/docs/self-hosting/backups.md) beschrieben. Eine Rückkehr zu einer früheren Hauptversion braucht diese Sicherung (siehe [Zurückkehren](#rolling-back)).

Setzen Sie `DB_EXPECT_EXISTING=true` in `.env`, falls es dort noch nicht steht. Sollte Notifuse nach dem Update je eine leere Datenbank vorfinden, hält es dann an, statt eine neue Installation zu beginnen.

## Mit Docker Compose aktualisieren

`compose.yaml` entnimmt das Release aus `NOTIFUSE_VERSION`:

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

Der Standardwert nach `:-` ist das Release, mit dem die Datei veröffentlicht wurde. Wählen Sie einen der beiden Wege, um ihn zu ändern, jeweils im Verzeichnis, das `compose.yaml` enthält.

**Version in .env festlegen**

Tragen Sie das neue Release in `.env` ein, laden Sie dann das Image und starten Sie neu:

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

**Neue compose.yaml herunterladen**

Ersetzen Sie Ihre `compose.yaml` durch die aktuelle, laden Sie dann das Image und starten Sie neu. Ihre `.env` bleibt, wie sie ist. Übertragen Sie eigene Änderungen an `compose.yaml` in die neue Datei.

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

Setzt `.env` die Variable `NOTIFUSE_VERSION`, hat dieser Wert Vorrang vor dem Standardwert in der Datei: Passen Sie ihn ebenfalls an.

`docker compose pull` lädt das neue Image herunter, während das alte weiterläuft. `docker compose up -d` ersetzt dann den Container. Notifuse hat bis zu 70 Sekunden Zeit zum Beenden: Der laufende Automatisierungsschritt und die gerade gesendeten E-Mails werden zuerst abgeschlossen.

Um vor dem Neustart zu prüfen, welches Release Compose ausführen wird, sehen Sie sich das aufgelöste Image an:

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

> [!NOTE]
>
> Bis 43.0 baut `compose.yaml` Notifuse aus dem Klon des Repositorys, in dem die Datei liegt. Checken Sie in einem solchen Klon das neue Release aus (`git fetch --tags && git checkout v44.0`) und führen Sie dann `docker compose up -d` aus. Ab 44.0 startet die Datei das veröffentlichte Image, außer Sie übergeben `--build`.

## Was beim Start passiert

Wenn das neue Release startet, führt Notifuse seine Datenbankmigrationen aus, bevor es eine Anfrage beantwortet:

1. Es prüft die PostgreSQL-Version. Seit 44.0 startet es nicht auf PostgreSQL älter als 17 und nennt die gefundene Version.
2. Es vergleicht die in der Systemdatenbank erfasste Hauptversion (`43` für 43.0) mit seiner eigenen.
3. Es wendet jede dazwischenliegende Migration auf die Systemdatenbank an, dann auf jede Datenbank eines Arbeitsbereichs.
4. Es erfasst die neue Version. Bei manchen Migrationen beendet sich Notifuse danach einmal, und Docker startet es wieder (`restart: unless-stopped`).

Laufen mehrere Instanzen auf derselben Datenbank, wendet eine die Migrationen an und die anderen warten auf sie (ab 42.2). Den Fortschritt verfolgen Sie im Log:

```bash
docker compose logs -f api
```

Das Log schließt diesen Schritt mit `Migration process completed successfully` ab, oder mit `Database is up to date, no migrations needed`, wenn sich die Hauptversion nicht geändert hat. Schlägt eine Migration fehl, startet Notifuse nicht, und das Log nennt sie: `migration failed for version …`.

## Version prüfen

Melden Sie sich an und öffnen Sie die Liste der Arbeitsbereiche. Ihre Fußzeile zeigt die laufende Version, etwa **Notifuse v44.0**. Auch das Kontomenü zeigt sie.

Auf der Kommandozeile finden Sie sie in der Konfigurationsdatei der Konsole:

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

Prüfen Sie dann, ob `https://emails.yourcompany.com/healthz` mit `{"status":"ok"}` antwortet, und öffnen Sie einen Arbeitsbereich, um Ihre Daten zu kontrollieren.

## Zurückkehren

Notifuse erfasst in der Datenbank nur die Hauptversion und hat keine Down-Migrationen.

Innerhalb derselben Hauptversion (zum Beispiel von 44.1 zurück auf 44.0) setzen Sie das vorherige Release in `NOTIFUSE_VERSION` und führen `docker compose up -d` aus. Notifuse startet auf derselben Datenbank.

Über Hauptversionen hinweg startet das ältere Release nicht auf einer Datenbank, die das neuere migriert hat. Das Log meldet `database is at version 44, this build is version 43 - refusing to start`. So kehren Sie zurück:

1. Halten Sie den Stack mit `docker compose down` an.
2. Setzen Sie das vorherige Release in `NOTIFUSE_VERSION` oder stellen Sie dessen `compose.yaml` wieder her.
3. Spielen Sie die vor dem Update erstellte Sicherung in eine leere Datenbank ein, wie unter [Wiederherstellen](https://www.notifuse.com/de/docs/self-hosting/backups.md#restoring) beschrieben, mit dem `SECRET_KEY`, mit dem die Sicherung erstellt wurde.

Alles, was seit der Sicherung geschrieben wurde, geht verloren.

War es das Update auf 44.0, das auch PostgreSQL auf 18 umstellt, verwenden Sie stattdessen die Kopie, die `compose.yaml` aufbewahrt: [Zurückkehren](https://www.notifuse.com/de/docs/self-hosting/upgrading-postgresql.md#rolling-back) stellt die PostgreSQL-17-Daten im Zustand vor dem Update wieder her, mit der `compose.yaml` des vorherigen Releases.

## PostgreSQL aktualisieren

Version 44.0 stellt `compose.yaml` von PostgreSQL 17 auf 18 um, und das erste `docker compose up -d` damit aktualisiert auch die Datenbank. [PostgreSQL aktualisieren](https://www.notifuse.com/de/docs/self-hosting/upgrading-postgresql.md) erklärt, was dabei passiert, wie viel Speicherplatz es braucht, wie Sie das Ergebnis prüfen und wie Sie zurückkehren.
