Passer au contenu principal
Si vous utilisez une version antérieure, utilisez sharelatex au lieu de overleaf dans les noms de chemins.
Monter un système de fichiers NFS dans un conteneur Overleaf est techniquement possible, mais ce n’est pas recommandé et cela peut entraîner différents types d’erreurs de performance.Une erreur fréquente lors des compilations est la suivante :
Nous déconseillons en particulier l’utilisation de systèmes de fichiers reposant sur NFS pour les données éphémères, comme les répertoires utilisés pour les données de compilation. Nous recommandons d’utiliser un disque de travail local, de préférence un SSD local, pour les répertoires suivants.Pour les installations basées sur docker-compose, nous suggérons simplement de remplacer le montage depuis NFS, ce qui évite de modifier les chemins dans l’application. Voici un extrait de configuration docker-compose utilisant un disque de travail monté sur /scratch :
docker-compose excerpt
Il n’est pas nécessaire de migrer les fichiers existants depuis le NFS vers leur nouvel emplacement après la mise à jour. Le compilateur LaTeX peut recréer tous les fichiers lors d’une nouvelle compilation complète.Pour plus de détails, consultez : https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
Si vous exécutez Overleaf sous Windows ou macOS, le service mongo peut ne pas redémarrer, avec l’erreur suivante :
Example error
Cela peut se produire lorsque les données MongoDB sont montées par bind mount depuis un système de fichiers qui n’offre pas la sémantique requise, comme un répertoire monté depuis Windows. Pour Windows avec WSL 2, conservez le Toolkit dans le répertoire personnel Linux d’Ubuntu et utilisez les bind mounts par défaut. Consultez les vérifications MongoDB du guide de la plateforme.Pour une nouvelle installation qui nécessite un stockage géré par Docker, la surcharge suivante utilise des volumes nommés (voir les recommandations de stockage de l’image MongoDB). Sur une installation existante, modifier les montages ne migre pas les données : sauvegardez et restaurez la base de données et le cache avant de basculer, sinon le service verra des volumes vides. Ajoutez ceci à config/docker-compose.override.yml, en le fusionnant avec toute configuration existante :
config/docker-compose.override.yml
Pour plus d’informations, consultez : https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
Utilisez la commande docker logs redis pour afficher une copie des journaux.Si vous voyez la ligne Fatal: Can't initialize Background Jobs, la sortie complète ressemblera à ceci :
Redis log example
Cela peut être lié à la version de Docker actuellement utilisée. Une mise à jour vers une version >= 20.10.10 devrait résoudre ce problème.Pour plus d’informations, consultez le ticket correspondant dans le projet Redis : https://github.com/redis/redis/issues/12362Référence : https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
Il arrive que les images d’aperçu/miniatures générées par Ayakaleaf Pro soient créées avec une mauvaise orientation et nécessitent une intervention manuelle pour être corrigées. Ces images sont stockées dans /var/lib/overleaf/data/template_files/.Nous vous recommandons de sauvegarder ce dossier avant toute modification.Vous devrez suivre les étapes ci-dessous pour chaque modèle concerné :Trouver l’ID du modèleAccédez à la galerie de modèles de votre instance (/templates/all), ouvrez un modèle concerné et copiez l’ID depuis l’URL (par exemple : https://your-instance-url/templates/6645d346c224815e9460a695).Exécuter la commande de correctionExécutez la commande suivante depuis l’hôte Docker (remplacez l’ID du modèle par celui que vous avez copié et adaptez le chemin si nécessaire) :docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”Référence : https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images
La commande \write18 est désactivée par défaut dans la Community Edition, car toutes les compilations s’effectuent dans le même conteneur sharelatex ; c’est le réglage par défaut le plus sûr.Si vous souhaitez l’activer pour pdflatex, créez un fichier latexmkrc à la racine de votre projet avec le contenu suivant :
latexmkrc
Relancez ensuite la compilation.Référence : https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
Ces erreurs signifient que le conteneur mongo plante et redémarre en boucle. bin/up démarre MongoDB puis exécute une commande à l’intérieur, qui échoue pendant que le conteneur redémarre. bin/docker-compose ps affiche le service mongo avec l’état Restarting.Pour trouver la cause réelle, consultez le journal de MongoDB :
Causes fréquentes :
  • Le processeur ne prend pas en charge AVX. MongoDB 5.0 et versions ultérieures nécessitent AVX sur x86-64, et le journal affiche MongoDB 5.0+ requires a CPU with AVX support. Dans une machine virtuelle, définissez le type de processeur sur host afin qu’AVX soit transmis.
  • Noyau Linux 6.19 à 7.0.13. MongoDB refuse de démarrer sur ces noyaux. Voir Prérequis logiciels pour la solution de contournement.
  • Les données ont été créées par une ancienne version de MongoDB. MongoDB 8.0 ne peut pas ouvrir directement des données de la 4.4 ou de la 5.0. Effectuez la mise à niveau une version majeure à la fois, voir Mettre à jour MongoDB.
C’est le comportement attendu avec Ayakaleaf Pro, et vous pouvez l’ignorer. Ce message s’affiche lorsque OVERLEAF_IS_SERVER_PRO ne vaut pas true, ce qui est le cas dans l’image Ayakaleaf Pro. Ayakaleaf Pro n’a pas besoin de cette variable ; laissez-la donc non définie.
Avant le démarrage d’Overleaf, le conteneur exécute des vérifications de démarrage et s’arrête lorsque l’une d’elles échoue. Le Toolkit l’exécute avec restart: always ; Docker le relance donc et la même vérification échoue à nouveau. La sortie de démarrage indique la vérification qui a échoué :
Les causes courantes sont :
  • Missing required secrets : définissez OVERLEAF_INVITE_TOKEN_SECRET dans config/variables.env, voir Variables d’environnement.
  • ShareLaTeX to Overleaf rebranding : la configuration utilise encore des variables ou des chemins SHARELATEX_ ; renommez-les comme l’indique le message.
  • Une erreur après Checking can connect to mongo and redis : Overleaf ne parvient pas à joindre MongoDB ou Redis. Consultez bin/logs mongo et bin/logs redis.
Après avoir corrigé la cause, exécutez bin/up -d.
À chaque démarrage, le conteneur exécute ses scripts de démarrage l’un après l’autre, et le journal nomme chacun d’eux sous la forme *** Running /etc/my_init.d/<script>.... 910_initiate_doc_version_recovery n’a de travail à effectuer que sur les instances qui ont un jour exécuté Overleaf 5.0.1. Sur toute autre instance, il affiche No recovery of doc versions needed. et le démarrage se poursuit. Sa sortie est également écrite dans data/history/doc-version-recovery.log dans OVERLEAF_DATA_PATH.Le code de sortie et la fin de bin/docker-compose logs --tail=100 sharelatex indiquent ce qui s’est passé :
  • Code de sortie 2, et le journal se termine par *** Init system aborted. : le conteneur a été arrêté, par exemple par bin/stop, docker stop ou Ctrl+C sur bin/up. Le script de la dernière ligne Running est simplement celui qui était en cours d’exécution à ce moment-là, il n’a pas échoué. Redémarrez le conteneur avec bin/up -d et laissez le démarrage se terminer.
  • Code de sortie 1, et le journal affiche *** /etc/my_init.d/<script> failed with status <n> : ce script a échoué, et son erreur figure dans les lignes juste au-dessus. Si 910_initiate_doc_version_recovery a échoué avec Detected unflushed changes while recovering doc versions, l’instance a exécuté la 5.0.1 et contient encore des modifications non vidées ; suivez le guide officiel Doc version recovery.
Cette page s’affiche lorsque votre compte est connecté mais n’est pas autorisé à ouvrir la page, par exemple une page d’administration ouverte par un compte qui n’est pas administrateur, ou un projet qui n’est pas partagé avec vous.Pour ouvrir les pages d’administration, connectez-vous avec un compte administrateur. Un administrateur existant peut faire d’un autre compte un administrateur, ou vous pouvez en créer un avec la commande create-user --admin, voir Gestion des utilisateurs. Dans l’environnement de développement (develop/), les pages d’administration nécessitent également ADMIN_PRIVILEGE_AVAILABLE=true dans develop/dev.env ; l’image Ayakaleaf Pro le définit déjà.
Dernière modification le 8 novembre 2026