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

# Problemen oplossen

{% hint style="info" %}
Als u een eerdere versie gebruikt, gebruik dan `sharelatex` in plaats van `overleaf` in padnamen.
{% endhint %}

<details>

<summary>Overleaf draaien met een NFS-bestandssysteem</summary>

Het koppelen van een NFS-bestandssysteem in een Overleaf-container is technisch mogelijk, maar wordt niet aanbevolen en kan leiden tot verschillende soorten prestatieproblemen.

Een veelvoorkomende fout die compilaties zien is:

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

In het bijzonder raden we af om NFS-ondersteunde bestandssystemen te gebruiken voor tijdelijke gegevens, zoals de mappen die worden gebruikt voor compilatiegegevens. We raden aan een lokale scratchschijf te gebruiken, bij voorkeur een lokale SSD, voor de volgende mappen.

Voor `docker-compose` gebaseerde configuraties stellen we voor om gewoon de bind-mount van NFS te overschrijven, zodat paden in de applicatie niet hoeven te worden gewijzigd. Hier is een voorbeeld van een `docker-compose` configuratiefragment met het gebruik van een scratchschijf die is aangekoppeld op `/scratch`:

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

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

Het is niet nodig om bestaande bestanden na de update van de NFS naar hun nieuwe locatie te migreren. De LaTeX-compiler kan alle bestanden opnieuw aanmaken met een volledige compilatie.

Voor meer details, zie: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem>

</details>

<details>

<summary>Overleaf draaien op Windows of macOS resulteert erin dat de `mongo`-service niet opstart</summary>

Als u Overleaf draait op Windows of macOS, kan de `mongo` service mogelijk niet opnieuw starten, met een fout:

{% code title="Voorbeeldfout" %}

```
WiredTiger kon onder geen enkele compatibiliteitsversie worden gestart.
Reden: 1: Operatie niet toegestaan
```

{% endcode %}

Om deze fout te voorkomen, moeten de gegevens worden opgeslagen in een volume in plaats van in een bind-gemounte map (zie de `mongo` imagedocumentatie voor meer details: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Om gegevens op te slaan in Docker-volumes die zijn aangekoppeld in de MongoDB- en Redis-containers, voeg het volgende toe aan `config/docker-compose.override.yml` (maak dit bestand aan als het nog niet bestaat):

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

Voor meer informatie, zie: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting>

</details>

<details>

<summary>Upgraden naar Redis 6.2 resulteert in een herstartlus</summary>

Gebruik het `docker logs redis` commando om een kopie van de logs uit te voeren.

Als u de regel ziet `Fatale fout: kan Background Jobs niet initialiseren`, dan ziet de volledige uitvoer er ongeveer zo uit:

{% code title="Redis-logvoorbeeld" %}

```
1:M 11 Feb 2024 15:19:22.609 # Server geïnitialiseerd
1:M 11 Feb 2024 15:19:22.609 # Fatale fout: kan Background Jobs niet initialiseren.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis wordt gestart oO0OoO0OoO0Oo
```

{% endcode %}

Dit kan verband houden met de versie van Docker die momenteel in gebruik is. Updaten naar een versie >= 20.10.10 zou dit probleem moeten oplossen.

Voor meer informatie, zie het upstream Redis-probleem: <https://github.com/redis/redis/issues/12362>

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

</details>

<details>

<summary>Onjuiste oriëntatie van voorbeeld-/miniatuurafbeeldingen in de sjabloongalerij</summary>

Soms kunnen de voorbeeld-/miniatuurafbeeldingen die door Server Pro worden gegenereerd in de verkeerde oriëntatie worden gemaakt en is handmatige tussenkomst nodig om dit te corrigeren. Deze afbeeldingen worden opgeslagen in `/var/lib/overleaf/data/template_files/` (>= 5.0.3) en `/var/lib/sharelatex/data/template_files/` (eerder).

We raden aan een back-up van deze map te maken voordat u wijzigingen aanbrengt.

U moet de onderstaande stappen voor elk getroffen sjabloon volgen:

Vind de sjabloon-IDNavigeer naar de sjabloongalerij van uw instantie (/templates/all), open een getroffen sjabloon en kopieer de ID uit de URL (bijvoorbeeld: <https://your-instance-url/templates/6645d346c224815e9460a695).Voer> het correctiecommando uitVoer het volgende commando uit vanaf de Docker-host (vervang de sjabloon-ID door de ID die u hebt gekopieerd en pas het pad indien nodig aan):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*{thumbnail,preview}"

Referentie: <https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images>

</details>

<details>

<summary>Controleer of u systeemaanroepen hebt ingeschakeld. Voor pdflatex is dit 'pdflatex -shell-escape'.</summary>

De `\write18` commando is standaard uitgeschakeld in de Community Edition omdat alle compilaties binnen dezelfde `sharelatex` container plaatsvinden; dit is de veiligere standaard.

Als u dit voor pdflatex wilt inschakelen, maak dan een `latexmkrc` bestand in de hoofdmap van uw project met de volgende inhoud:

{% code title="latexmkrc" %}

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

{% endcode %}

Probeer daarna opnieuw te compileren.

Referentie: <https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdftex-this-is-pdftex-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/nl/ondersteuning/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.