> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/nl/onderhoud/upgrading-your-deployment.md).
# Uw implementatie upgraden
{% hint style="danger" %}
Het is belangrijk om ervoor te zorgen dat je een [consistente back-up](/on-premises/nl/onderhoud/data-and-backups.md#performing-a-consistent-backup) **voordat** maakt bij elke upgrade naar een hoofdversie, zodat je kunt terugzetten als dat nodig is.
{% endhint %}
De [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) is een git-repository, dus het is eenvoudig om nieuwe Toolkit-functies te krijgen. Voer gewoon het `bin/upgrade` commando uit en volg de instructies op het scherm.
Het is vermeldenswaard dat de versie van de Docker-image (bij `config/version`) afzonderlijk wordt beheerd van de code-updates van de Toolkit. Het bijwerken van de Toolkit-code zal **niet** automatisch de versie van de Docker-image die u draait wijzigen. Dit betekent dat u in de meeste gevallen uw Toolkit-versie kunt upgraden zonder uw deployment te upgraden.
#### De `bin/upgrade` Script
Wanneer u het `bin/upgrade` commando uitvoert, controleert het script of er een beschikbare update voor de Toolkit-code is en biedt het aan om uw Toolkit bij te werken. U kunt deze upgrade altijd weigeren, en er zal niets veranderen.
Als u ervoor kiest om de Toolkit-code bij te werken, controleert het script vervolgens of de *standaard* Docker-imageversie is gewijzigd, en biedt aan om uw lokale versiebestand (in `config/version`) bij te werken zodat het overeenkomt met de nieuwe standaard.
Als u ervoor kiest van versie te wisselen, begeleidt het script u vervolgens door een proces van het stoppen van de Docker-services, het maken van een back-up en het herstarten van de Docker-services. Uw oude versiebestand wordt automatisch gekopieerd naar `config/__old-version`, voor het geval u moet terugrollen naar die versie van de Docker-images.
{% hint style="danger" %}
Wanneer je een upgrade van Server CE/Pro uitvoert, raden we aan eerst bij te werken naar de nieuwste release van de geïmplementeerde hoofdversie **voordat** je upgradet naar de nieuwste release van de **volgende** hoofdversie. Als je implementatie meer dan één hoofdversie achterloopt op de nieuwste, moet je een upgrade in meerdere stappen uitvoeren.
Als je bijvoorbeeld 3.5.10 gebruikt, moet je upgraden naar 3.5.13 -> voer de volledige projectgeschiedenismigratie uit -> 4.2.9 -> 5.5.4.
Je zou **nooit** hoofdversies overslaan (3.5.10 -> 5.5.4). Als je de Toolkit gebruikt en meer dan één hoofdversie achterloopt op de nieuwste, moet je **niet** het `bin/upgrade` script gebruiken, omdat je een handmatige upgrade in meerdere stappen moet uitvoeren.
{% endhint %}
{% hint style="info" %}
Voor air-gapped configuraties die Docker-images handmatig importeren, stelt u alstublieft `PULL_BEFORE_UPGRADE=false` in uw `config/overleaf.rc` bestand in.
Raadpleeg [hier](/on-premises/nl/installatie/air-gapped-offline-deployments.md) voor meer informatie over het uitrollen in air-gapped/offline-omgevingen.
{% endhint %}
### Upgradepad
De `bin/upgrade` commando kiest altijd de meest recente versie van Server Pro/CE die op dat moment beschikbaar is. Als uw upgradecyclus onregelmatig is, kan dit ertoe leiden dat grote versies worden overgeslagen en u mogelijk upgradet naar een versie die u niet had verwacht.
Bij het uitvoeren van een upgrade raden we aan eerst te upgraden naar de nieuwste release van de huidige hoofdversie voordat u upgradet naar de nieuwste release van de volgende hoofdversie. Als u bijvoorbeeld momenteel 3.3.2 gebruikt en de nieuwste beschikbare versie 5.3.1 is, zou het juiste upgradepad zijn:
* 3.3.2 -> 3.5.13
* 3.5.13 -> 4.2.9
* 4.2.9 -> 5.5.1
Om upgradeproblemen te voorkomen, raden we aan onze [release-opmerkingen](https://docs.overleaf.com/on-premises/release-notes) te raadplegen vóór het uitvoeren van upgrades, omdat bepaalde versies extra stappen kunnen vereisen, zoals handmatige wijzigingen aan de Toolkit aanbrengen, databases upgraden of migratiescripts uitvoeren.
Als u dat nog niet hebt gedaan, meldt u zich dan aan voor onze [mailinglijst](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) zodat u op de hoogte wordt gebracht wanneer nieuwe versies/updates worden uitgebracht. Hierdoor kunt u regelmatige onderhoudsvensters plannen die nauw aansluiten op onze releaseschema's.
---
# 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://ayakaleaf-pro.ayaka.space/on-premises/nl/onderhoud/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.