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

# Probleemoplossing

{% 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 optreedt tijdens compilaties is:

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

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

Voor `docker-compose` gebaseerde opstellingen raden we aan 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 scratch-schijf 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 NFS naar hun nieuwe locatie te verplaatsen. De LaTeX-compiler kan alle bestanden opnieuw aanmaken met een volledige compilatieronde.

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

</details>

<details>

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

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

{% code title="Voorbeeldfout" %}

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

{% endcode %}

Om deze fout te voorkomen, moeten de gegevens worden opgeslagen in een volume in plaats van in een bind-gemonteerde map (zie de `mongo` image-documentatie 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, voegt u 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 %}

Zie voor meer informatie: <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 `Fataal: kan achtergrondtaken niet initialiseren`, dan ziet de volledige uitvoer er ongeveer als volgt uit:

{% code title="Voorbeeld van Redis-log" %}

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

{% endcode %}

Dit kan verband houden met de momenteel gebruikte versie van Docker. Bijwerken naar een versie >= 20.10.10 zou dit probleem moeten oplossen.

Zie voor meer informatie het upstream-probleem van Redis: <https://github.com/redis/redis/issues/12362>

Verwijzing: <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 interventie 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 deze map te back-uppen voordat u wijzigingen aanbrengt.

U moet de onderstaande stappen voor elk getroffen sjabloon volgen:

Zoek 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 aan indien nodig):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*{thumbnail,preview}"

Verwijzing: <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 standaardinstelling.

Als u het 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.

Verwijzing: <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/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.