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

# Dépannage

{% hint style="info" %}
Si vous utilisez une version antérieure, veuillez utiliser `conteneur sharelatex.` au lieu de `overleaf` dans les noms de chemins.
{% 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 performances.

Une erreur courante que l’on voit lors de la compilation est :

```
EBUSY: ressource occupée ou verrouillée, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

En particulier, nous déconseillons d’utiliser des systèmes de fichiers reposant sur NFS pour des 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 bind-mount depuis NFS, ce qui évite de modifier les chemins dans l’application. Voici un exemple de `docker-compose` extrait de configuration avec l’utilisation d’un disque temporaire monté sur `/scratch`:

{% code title="extrait de 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 du 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="Erreur d’exemple" %}

```
É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 à l’intérieur de 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 d’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 d’arrière-plan.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis démarre oO0OoO0OoO0Oo
```

{% 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>

Il arrive parfois que les images d’aperçu/de vignette générées par Server Pro soient créées dans la mauvaise orientation et nécessitent 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/` (versions antérieures).

Nous vous recommandons de sauvegarder ce dossier avant d’apporter des modifications.

Vous devrez suivre les étapes ci-dessous pour chaque modèle concerné :

Trouvez 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 communautaire, car toutes les compilations ont lieu dans le même `conteneur sharelatex.` conteneur ; c’est le réglage par défaut le plus sûr.

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 %}

Puis essayez 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://overleaf-pro.ayaka.space/on-premises/fr/support/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.