> 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/assistance/troubleshooting.md).

# Dépannage

{% hint style="info" %}
Si vous utilisez une version antérieure, veuillez utiliser `sharelatex` au lieu de `Overleaf` dans les noms de chemin.
{% endhint %}

<details>

<summary>Exécution d'Overleaf avec un système de fichiers NFS</summary>

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 courante que l'on voit lors des compilations est :

```
EBUSY: resource busy or locked, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

En particulier, nous déconseillons d'utiliser des systèmes de fichiers adossés à 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 local temporaire, de préférence un SSD local, pour les répertoires suivants.

Pour `docker-compose` basées sur, nous suggérons simplement de remplacer le montage lié depuis NFS, ce qui évite de modifier les chemins dans l'application. Voici un exemple de `docker-compose` extrait de configuration utilisant un disque temporaire monté à `/scratch`:

{% code title="extrait docker-compose" %}

```yaml
services :
  sharelatex :
    environment:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    volumes:
      - nfs:/var/lib/overleaf/data
      - /scratch/cache/:/var/lib/overleaf/data/cache
      - /scratch/compiles/:/var/lib/overleaf/data/compiles
      - /scratch/output/:/var/lib/overleaf/data/output
      - /scratch/tmp/:/var/lib/overleaf/tmp
```

{% endcode %}

Il n'est pas nécessaire de migrer les fichiers existants de 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, voir : <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem>

</details>

<details>

<summary>L'exécution d'Overleaf sous Windows ou macOS entraîne le non-démarrage du service `mongo`</summary>

Si vous exécutez Overleaf sous Windows ou macOS, le `mongo` service peut ne pas redémarrer, avec une erreur :

{% code title="Exemple d'erreur" %}

```
Échec du démarrage de WiredTiger sous n'importe quelle version de compatibilité.
Raison : 1 : Opération non autorisée
```

{% endcode %}

Pour éviter cette erreur, les données doivent être stockées dans un volume plutôt que dans un répertoire monté en bind (voir la `mongo` documentation de l'image pour plus de détails : <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Pour stocker les données dans des volumes Docker montés dans les conteneurs MongoDB et Redis, ajoutez ce qui suit à `config/docker-compose.override.yml` (créez ce fichier s'il n'existe pas encore) :

{% code title="config/docker-compose.override.yml" %}

```yaml
volumes:
  mongo-data:
  redis-data:

services :
  mongo:
    volumes:
      - mongo-data:/data/db

  redis:
    volumes:
      - redis-data:/data
```

{% endcode %}

Pour plus d'informations, voir : <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting>

</details>

<details>

<summary>La mise à niveau vers Redis 6.2 entraîne une boucle de redémarrage</summary>

Utilisez la `docker logs redis` commande pour afficher une copie des journaux.

Si vous voyez la ligne `Fatal : impossible d'initialiser les tâches en arrière-plan`, la sortie complète ressemblera à ceci :

{% code title="Exemple de journal Redis" %}

```
1:M 11 Feb 2024 15:19:22.609 # Serveur initialisé
1:M 11 Feb 2024 15:19:22.609 # Fatal : impossible d'initialiser les tâches en arrière-plan.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis démarre oO0OoO0OoO0OoO
```

{% endcode %}

Cela peut être lié à la version de Docker actuellement utilisée. La mise à jour vers une version >= 20.10.10 devrait résoudre ce problème.

Pour plus d'informations, voir le problème amont de Redis : <https://github.com/redis/redis/issues/12362>

Référence : <https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop>

</details>

<details>

<summary>Orientation incorrecte des images d'aperçu/vignette de la galerie de modèles</summary>

À l'occasion, les images d'aperçu/vignette générées par Server Pro peuvent être créées dans la mauvaise orientation et nécessiter une intervention manuelle pour être corrigées. Ces images sont stockées dans `/var/lib/overleaf/data/template_files/` (>= 5.0.3) et `/var/lib/sharelatex/data/template_files/` (version antérieure).

Nous recommandons de sauvegarder ce dossier avant d'effectuer 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écutez> 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 mettez à jour 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>

</details>

<details>

<summary>Veuillez vérifier que vous avez activé les appels système. Pour pdflatex, il s'agit de `pdflatex -shell-escape`.</summary>

Le `\write18` commande est désactivée par défaut dans l'Édition Community, car toutes les compilations ont lieu dans le même `sharelatex` conteneur ; c'est la valeur par défaut la plus sûre.

Si vous souhaitez l'activer pour pdflatex, créez un `latexmkrc` fichier à la racine de votre projet avec le contenu suivant :

{% code title="latexmkrc" %}

```perl
$pdflatex = 'pdflatex --shell-escape';
```

{% endcode %}

Essayez ensuite de recompiler.

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>

</details>


---

# 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/assistance/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`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.