> 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/nl/onderhoud/upgrading-your-deployment.md).
# Uw implementatie upgraden
{% hint style="danger" %}
Het is belangrijk 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 major-versie-upgrade, zodat je kunt terugrollen 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 aanwijzingen op het scherm.
Het is de moeite waard op te merken dat de versie van de Docker-image (bij `config/version`) apart 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 je gebruikt wijzigen. Dit betekent dat je in de meeste gevallen je Toolkit-versie kunt upgraden zonder je implementatie te upgraden.
#### De `bin/upgrade` Script
Wanneer je het `bin/upgrade` commando uitvoert, controleert het script of er een beschikbare update is voor de Toolkit-code, en biedt het aan om je Toolkit bij te werken. Je kunt deze upgrade altijd weigeren, en er verandert niets.
Als je ervoor kiest de Toolkit-code bij te werken, controleert het script vervolgens of de *standaard* versie van de Docker-image is gewijzigd, en biedt het aan om je lokale versiebestand (bij `config/version`) bij te werken zodat het overeenkomt met de nieuwe standaard.
Als je ervoor kiest van versie te wisselen, leidt het script je vervolgens door het proces van het afsluiten van de Docker-services, het maken van een back-up en het opnieuw starten van de Docker-services. Je oude versiebestand wordt automatisch gekopieerd naar `config/__old-version`, voor het geval je moet terugkeren naar die versie van de Docker-images.
{% hint style="danger" %}
Wanneer je een upgrade van Server CE/Pro uitvoert, raden we aan om te upgraden naar de nieuwste release van de geïmplementeerde major-versie **voordat** je bijwerkt naar de nieuwste release van de **volgende** major-versie. Als je implementatie meer dan één major-versie 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 Full Project History-migratie uit -> 4.2.9 -> 5.5.4.
Je moet **nooit** major-versies overslaan (3.5.10 -> 5.5.4). Als je Toolkit gebruikt en meer dan één major-versie 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 opstellingen die Docker-images handmatig importeren, stel 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 implementeren in air-gapped/offline omgevingen.
{% endhint %}
### Upgradepad
De `bin/upgrade` commando zal altijd de meest recente versie van Server Pro/CE kiezen die op dat moment beschikbaar is. Als je upgradecyclus onregelmatig is, kan dit ertoe leiden dat grote versies worden overgeslagen en je mogelijk upgradet naar een versie die je niet had verwacht.
Bij het uitvoeren van een upgrade raden we aan eerst te upgraden naar de laatste release van de huidige hoofdversie voordat je upgradet naar de laatste release van de volgende hoofdversie. Als je bijvoorbeeld momenteel 3.3.2 gebruikt en de laatst beschikbare versie 5.3.1 is, dan 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 voordat je upgrades uitvoert, omdat bepaalde versies extra stappen kunnen vereisen, zoals handmatige wijzigingen aan de Toolkit, het upgraden van databases of het uitvoeren van migratiescripts.
Als je dat nog niet hebt gedaan, schrijf je dan in voor onze [mailinglijst](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) zodat je op de hoogte kunt worden gebracht wanneer nieuwe versies/updates worden uitgebracht. Zo kun je regelmatige onderhoudsvensters plannen die nauw aansluiten op ons releaseschema.
---
# 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/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.