> 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/fr/maintenance/upgrading-your-deployment.md).
# Mise à niveau de votre déploiement
{% hint style="danger" %}
Il est important de vous assurer de prendre une [sauvegarde cohérente](/on-premises/fr/maintenance/data-and-backups.md#performing-a-consistent-backup) **avant** à chaque mise à niveau d'une version majeure afin de pouvoir revenir en arrière si nécessaire.
{% endhint %}
Le [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) est un dépôt git, donc il est facile d’obtenir les nouvelles fonctionnalités du Toolkit. Il suffit d’exécuter la `bin/upgrade` commande et de suivre les instructions affichées à l’écran.
Il convient de noter que la version de l’image Docker (dans `config/version`) est gérée séparément des mises à jour du code du Toolkit. La mise à jour du code du Toolkit **ne pas** modifiera automatiquement la version de l’image Docker que vous exécutez. Cela signifie que, dans la plupart des cas, vous pouvez mettre à niveau votre version du Toolkit sans mettre à niveau votre déploiement.
#### Le `bin/upgrade` Script
Lorsque vous exécutez la `bin/upgrade` commande, le script vérifiera s’il existe une mise à jour disponible du code du Toolkit et proposera de mettre à jour votre Toolkit. Vous pouvez toujours refuser cette mise à niveau, et rien ne changera.
Si vous choisissez de mettre à jour le code du Toolkit, le script vérifiera ensuite si la *par défaut* version de l’image Docker a changé, et proposera de mettre à niveau votre fichier de version local (dans `config/version`) afin de correspondre au nouveau paramètre par défaut.
Si vous choisissez de changer de version, le script vous guidera ensuite à travers un processus d’arrêt des services Docker, de création d’une sauvegarde et de redémarrage des services Docker. Votre ancien fichier de version sera automatiquement copié vers `config/__old-version`, au cas où vous auriez besoin de revenir à cette version des images Docker.
{% hint style="danger" %}
Lors d'une mise à niveau de Server CE/Pro, nous recommandons de mettre à niveau vers la dernière version publiée de la version majeure déployée **avant** de mettre à niveau vers la dernière version de la **prochaine** version majeure. Si votre déploiement a plus d'une version majeure de retard par rapport à la dernière version, vous devrez effectuer une mise à niveau en plusieurs étapes.
Par exemple, si vous utilisez la version 3.5.10, vous devrez mettre à niveau vers 3.5.13 -> effectuer la migration complète de l'historique du projet -> 4.2.9 -> 5.5.4.
Vous devriez **jamais** sauter des versions majeures (3.5.10 -> 5.5.4). Si vous utilisez Toolkit et que vous avez plus d'une version majeure de retard par rapport à la dernière version, vous devez **ne pas** utiliser le `bin/upgrade` script, car vous devrez effectuer une mise à niveau manuelle en plusieurs étapes.
{% endhint %}
{% hint style="info" %}
Pour les environnements isolés qui importent manuellement des images Docker, veuillez définir `PULL_BEFORE_UPGRADE=false` dans votre `config/overleaf.rc` fichier.
Veuillez consulter [ici](/on-premises/fr/installation/air-gapped-offline-deployments.md) pour plus d’informations sur le déploiement dans des environnements isolés/hors ligne.
{% endhint %}
### Chemin de mise à niveau
Le `bin/upgrade` la commande choisira toujours la version la plus récente de Server Pro/CE disponible à ce moment-là. Si votre cycle de mise à niveau est peu fréquent, cela pourrait entraîner le saut de versions majeures et potentiellement la mise à niveau vers une version à laquelle vous ne vous attendiez pas.
Lors d’une mise à niveau, nous recommandons de passer d’abord à la dernière version de la version majeure actuelle avant de passer à la dernière version de la prochaine version majeure. Par exemple, si vous utilisez actuellement la version 3.3.2 et que la dernière version disponible est 5.3.1, le chemin de mise à niveau correct serait :
* 3.3.2 -> 3.5.13
* 3.5.13 -> 4.2.9
* 4.2.9 -> 5.5.1
Pour éviter tout problème de mise à niveau, nous vous recommandons de consulter nos [Notes de version](https://docs.overleaf.com/on-premises/release-notes) avant d’effectuer toute mise à niveau, car certaines versions peuvent nécessiter des étapes supplémentaires, comme des modifications manuelles du Toolkit, la mise à niveau des bases de données ou l’exécution de scripts de migration.
Si ce n’est pas déjà fait, inscrivez-vous à notre [liste de diffusion](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) afin d’être informé lorsque de nouvelles versions/mises à jour sont publiées. Cela vous permettrait de planifier des fenêtres de maintenance régulières qui suivent de près notre calendrier de publications.
---
# 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/fr/maintenance/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.