> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/de/wartung/upgrading-your-deployment.md).
# Ihr Deployment aktualisieren
{% hint style="danger" %}
Es ist wichtig sicherzustellen, dass Sie ein [konsistentes Backup](/on-premises/de/wartung/data-and-backups.md#performing-a-consistent-backup) **vor** bei jedem Major-Version-Upgrade erstellen, damit Sie bei Bedarf zurückrollen können.
{% endhint %}
Die [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) ist ein Git-Repository, daher ist es einfach, neue Toolkit-Funktionen zu erhalten. Führen Sie einfach den `bin/upgrade` Befehl aus und folgen Sie den Anweisungen auf dem Bildschirm.
Es ist erwähnenswert, dass die Version des Docker-Images (bei `config/version`) separat von den Toolkit-Code-Updates verwaltet wird. Durch das Aktualisieren des Toolkit-Codes wird **nicht** die Version des Docker-Images, das Sie ausführen, automatisch geändert. Das bedeutet, dass Sie in den meisten Fällen Ihre Toolkit-Version aktualisieren können, ohne Ihr Deployment zu aktualisieren.
#### Die `bin/upgrade` Skript
Wenn Sie den `bin/upgrade` Befehl ausführen, prüft das Skript, ob ein verfügbares Update für den Toolkit-Code vorhanden ist, und bietet an, Ihr Toolkit zu aktualisieren. Sie können dieses Upgrade jederzeit ablehnen, und es wird sich nichts ändern.
Wenn Sie sich dafür entscheiden, den Toolkit-Code zu aktualisieren, prüft das Skript anschließend, ob sich die *Standard* Docker-Image-Version geändert hat, und bietet an, Ihre lokale Versionsdatei (bei `config/version`) zu aktualisieren, damit sie dem neuen Standard entspricht.
Wenn Sie sich dafür entscheiden, die Version zu wechseln, führt Sie das Skript dann durch einen Prozess des Herunterfahrens der Docker-Dienste, Erstellens eines Backups und Neustartens der Docker-Dienste. Ihre alte Versionsdatei wird automatisch nach `config/__old-version`kopiert, falls Sie auf diese Version der Docker-Images zurückrollen müssen.
{% hint style="danger" %}
Wenn Sie ein Upgrade von Server CE/Pro durchführen, empfehlen wir, zuerst auf die neueste Version der eingesetzten Major-Version **vor** dem Upgrade auf die neueste Version der **nächsten** Major-Version zu aktualisieren. Wenn Ihre Bereitstellung mehr als eine Major-Version hinter der neuesten zurückliegt, müssen Sie ein mehrstufiges Upgrade durchführen.
Wenn Sie beispielsweise 3.5.10 verwenden, müssen Sie auf 3.5.13 aktualisieren -> die Full-Project-History-Migration durchführen -> 4.2.9 -> 5.5.4.
Sie sollten **niemals** Major-Versionen überspringen (3.5.10 -> 5.5.4). Wenn Sie das Toolkit verwenden und mehr als eine Major-Version hinter der neuesten Version zurückliegen, dürfen Sie **nicht** das `bin/upgrade` Skript verwenden, da Sie ein manuelles mehrstufiges Upgrade durchführen müssen.
{% endhint %}
{% hint style="info" %}
Für air-gapped Setups, die Docker-Images manuell importieren, setzen Sie bitte `PULL_BEFORE_UPGRADE=false` in Ihrer `config/overleaf.rc` in der Datei.
Bitte prüfen Sie [hier](/on-premises/de/installation/air-gapped-offline-deployments.md) für weitere Informationen zum Deployment in air-gapped/offline-Umgebungen.
{% endhint %}
### Upgrade-Pfad
Die `bin/upgrade` Befehl wird immer die jeweils neueste verfügbare Version von Server Pro/CE auswählen. Wenn Ihr Upgrade-Zyklus selten ist, kann dies dazu führen, dass Hauptversionen übersprungen werden und Sie möglicherweise auf eine Version aktualisieren, die Sie nicht erwartet haben.
Bei einem Upgrade empfehlen wir, zunächst auf die neueste Version der aktuellen Hauptversion zu aktualisieren, bevor Sie auf die neueste Version der nächsten Hauptversion aktualisieren. Wenn Sie beispielsweise derzeit 3.3.2 verwenden und die neueste verfügbare Version 5.3.1 ist, wäre der richtige Upgrade-Pfad:
* 3.3.2 -> 3.5.13
* 3.5.13 -> 4.2.9
* 4.2.9 -> 5.5.1
Um Upgrade-Probleme zu vermeiden, empfehlen wir, unsere [Versionshinweise](https://docs.overleaf.com/on-premises/release-notes) vor der Durchführung von Upgrades zu konsultieren, da bestimmte Versionen zusätzliche Schritte erfordern können. Z. B. manuelle Änderungen am Toolkit, das Aktualisieren von Datenbanken oder das Ausführen von Migrationsskripten.
Falls Sie dies noch nicht getan haben, melden Sie sich für unsere [Mailingliste](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) an, damit Sie benachrichtigt werden können, wenn neue Versionen/Updates veröffentlicht werden. So können Sie regelmäßige Wartungsfenster planen, die unserem Veröffentlichungsplan eng folgen.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://overleaf-pro.ayaka.space/on-premises/de/wartung/upgrading-your-deployment.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.