> 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/fr/maintenance/upgrading-your-deployment.md).
# Mise à niveau de votre déploiement
{% hint style="danger" %}
Il est important de s'assurer que vous effectuez une [sauvegarde cohérente](/on-premises/fr/maintenance/data-and-backups.md#performing-a-consistent-backup) **avant** à chaque mise à niveau 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 de nouvelles fonctionnalités du Toolkit. Il suffit d’exécuter la `bin/upgrade` commande et de suivre les instructions à l’écran.
Il convient de noter que la version de l’image Docker (à `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 utilisez. 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 (à `config/version`) pour correspondre au nouveau réglage 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 passer à la dernière version de la version majeure déployée **avant** de passer à la dernière version de la **prochaine** version majeure. Si votre déploiement a plus d'une version majeure de retard sur la dernière version, vous devrez effectuer une mise à niveau en plusieurs étapes.
Par exemple, si vous utilisez 3.5.10, vous devrez mettre à niveau vers 3.5.13 -> effectuer la migration Full Project History -> 4.2.9 -> 5.5.4.
Vous devriez **ne jamais** sauter les versions majeures (3.5.10 -> 5.5.4). Si vous utilisez le Toolkit et avez plus d'une version majeure de retard sur la dernière, 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 configurations isolées du réseau qui importent manuellement des images Docker, veuillez définir `PULL_BEFORE_UPGRADE=false` dans votre `config/overleaf.rc` dans le 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 du réseau/hors ligne.
{% endhint %}
### Parcours 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 peut conduire à sauter des versions majeures et potentiellement à passer à 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 la 5.3.1, le parcours 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. Par exemple, apporter des modifications manuelles au Toolkit, mettre à niveau des bases de données ou exécuter des 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 que vous puissiez ê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 publication.
---
# 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/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.