Passer au contenu principal
Il est important d’effectuer une sauvegarde cohérente avant chaque mise à niveau de version majeure, afin de pouvoir revenir en arrière si nécessaire.
Le toolkit ayakaleaf↗ est un dépôt git : il est donc facile d’obtenir les nouvelles fonctionnalités du Toolkit. Exécutez simplement la commande bin/upgrade et suivez les instructions à l’écran. Notez que la version de l’image Docker (dans config/version) est gérée indépendamment des mises à jour du code du Toolkit. Mettre à jour le code du Toolkit ne modifie pas automatiquement la version de l’image Docker que vous exécutez. Dans la plupart des cas, vous pouvez donc mettre à jour votre Toolkit sans mettre à niveau votre déploiement.

Le script bin/upgrade

Lorsque vous exécutez la commande bin/upgrade, le script vérifie si une mise à jour du code du Toolkit est disponible et vous propose de mettre à jour votre Toolkit. Vous pouvez toujours refuser cette mise à jour : rien ne sera alors modifié. Si vous choisissez de mettre à jour le code du Toolkit, le script vérifie ensuite si la version par défaut de l’image Docker a changé et vous propose de mettre à jour votre fichier de version local (dans config/version) pour qu’il corresponde à la nouvelle valeur par défaut. Si vous choisissez de changer de version, le script vous guide ensuite à travers l’arrêt des services Docker, la réalisation d’une sauvegarde et le redémarrage des services Docker. Votre ancien fichier de version est automatiquement copié dans config/__old-version, au cas où vous auriez besoin de revenir à cette version des images Docker.
Pour les installations isolées (air-gapped) qui importent manuellement les images Docker, définissez PULL_BEFORE_UPGRADE=false dans votre fichier config/overleaf.rc.Consultez cette page pour plus d’informations sur le déploiement dans des environnements isolés ou hors ligne.

Chemin de mise à niveau

Si vous exécutez une version d’Overleaf Community antérieure à la v6.0.0, consultez la documentation officielle d’Overleaf pour effectuer la mise à niveau. Au sein d’Ayakaleaf Pro, effectuez d’abord la mise à niveau vers la dernière version corrective de votre ligne de versions actuelle, puis vers la suivante, par exemple 6.2.0 → 6.2.2 → 6.3.2. Lisez les notes de version de chaque version traversée : certaines nécessitent des étapes supplémentaires. Seule la dernière version est prise en charge. Pour vérifier quelle image vous exécutez, utilisez docker inspect --format '{{.Config.Image}}' sharelatex.

Questions/réponses

Réponse : Il attribue aux utilisateurs existants les fonctionnalités par défaut de votre instance, comme le délai de compilation défini par COMPILE_TIMEOUT. Il ne fait qu’augmenter les valeurs, sans jamais les réduire : un utilisateur disposant d’un délai de compilation plus long le conserve. Il ne fait pas partie d’une mise à niveau et ne s’exécute jamais de lui-même ; vous n’en avez besoin qu’après avoir augmenté une valeur par défaut telle que COMPILE_TIMEOUT. Par défaut, il s’exécute à blanc et liste les utilisateurs qu’il modifierait ; ajoutez --dry-run=false pour enregistrer les modifications :
Dernière modification le 2 novembre 2026