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

# Fehlerbehebung

{% hint style="info" %}
Wenn Sie eine ältere Version verwenden, verwenden Sie bitte `sharelatex` anstatt von `Overleaf` in Pfadnamen.
{% endhint %}

<details>

<summary>Ausführen von Overleaf mit einem NFS-Dateisystem</summary>

Das Einhängen eines NFS-Dateisystems in einem Overleaf-Container ist technisch möglich, wird jedoch nicht empfohlen und kann zu verschiedenen Arten von Leistungsfehlern führen.

Ein häufiger Fehler, der bei Kompilierungen auftritt, ist:

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

Insbesondere raten wir davon ab, NFS-gestützte Dateisysteme für flüchtige Daten zu verwenden, wie z. B. die Verzeichnisse, die für Kompilierungsdaten verwendet werden. Wir empfehlen die Verwendung einer lokalen Scratch-Disk, vorzugsweise einer lokalen SSD, für die folgenden Verzeichnisse.

Für `docker-compose` basierte Setups empfehlen wir einfach, das Bind-Mount von NFS zu überschreiben, wodurch Pfade in der Anwendung nicht geändert werden müssen. Hier ist ein Beispiel für einen `docker-compose` Konfigurationsauszug mit der Verwendung einer Scratch-Disk, die unter `/scratch`:

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

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

Es ist nicht erforderlich, nach dem Update vorhandene Dateien vom NFS an ihren neuen Speicherort zu migrieren. Der LaTeX-Compiler kann alle Dateien bei einem vollständigen Kompilierungslauf erneut erzeugen.

Weitere Details finden Sie unter: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem>

</details>

<details>

<summary>Beim Ausführen von Overleaf unter Windows oder macOS wird der `mongo`-Dienst nicht gestartet</summary>

Wenn Sie Overleaf unter Windows oder macOS ausführen, kann der `mongo` Dienst mit einem Fehler möglicherweise nicht neu gestartet werden:

{% code title="Beispiel für einen Fehler" %}

```
WiredTiger konnte unter keiner Kompatibilitätsversion gestartet werden.
Grund: 1: Vorgang nicht erlaubt
```

{% endcode %}

Um diesen Fehler zu vermeiden, müssen die Daten in einem Volume und nicht in einem per Bind-Mount eingebundenen Verzeichnis gespeichert werden (siehe die `mongo` Image-Dokumentation für weitere Details: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Um Daten innerhalb von Docker-Volumes zu speichern, die in den MongoDB- und Redis-Containern eingehängt sind, fügen Sie Folgendes zu `config/docker-compose.override.yml` (erstellen Sie diese Datei, falls sie noch nicht existiert):

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

Weitere Informationen finden Sie unter: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting>

</details>

<details>

<summary>Das Upgrade auf Redis 6.2 führt zu einer Neustartschleife</summary>

Verwenden Sie den `docker logs redis` Befehl, um eine Kopie der Logs auszugeben.

Wenn Sie die Zeile `Fatal: Hintergrundjobs können nicht initialisiert werden`, sieht die vollständige Ausgabe etwa so aus:

{% code title="Beispiel für ein Redis-Log" %}

```
1:M 11 Feb 2024 15:19:22.609 # Server initialisiert
1:M 11 Feb 2024 15:19:22.609 # Fatal: Hintergrundjobs können nicht initialisiert werden.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis wird gestartet oO0OoO0OoO0Oo
```

{% endcode %}

Dies könnte mit der derzeit verwendeten Docker-Version zusammenhängen. Ein Update auf eine Version >= 20.10.10 sollte dieses Problem beheben.

Weitere Informationen finden Sie im Upstream-Issue von Redis: <https://github.com/redis/redis/issues/12362>

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

</details>

<details>

<summary>Falsche Ausrichtung der Vorschau-/Miniaturbild-Dateien der Vorlagengalerie</summary>

Gelegentlich können die von Server Pro generierten Vorschau-/Miniaturbilder in der falschen Ausrichtung erstellt werden und erfordern eine manuelle Korrektur. Diese Bilder werden gespeichert in `/var/lib/overleaf/data/template_files/` (>= 5.0.3) und `/var/lib/sharelatex/data/template_files/` (früher).

Wir empfehlen, diesen Ordner vor Änderungen zu sichern.

Sie müssen die folgenden Schritte für jede betroffene Vorlage ausführen:

Suchen Sie die Vorlagen-ID. Navigieren Sie zur Vorlagengalerie Ihrer Instanz (/templates/all), öffnen Sie eine betroffene Vorlage und kopieren Sie die ID aus der URL (zum Beispiel: <https://your-instance-url/templates/6645d346c224815e9460a695>). Führen Sie den Korrekturbefehl aus. Führen Sie den folgenden Befehl auf dem Docker-Host aus (ersetzen Sie die Vorlagen-ID durch die kopierte und aktualisieren Sie den Pfad, falls erforderlich):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*{thumbnail,preview}"

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

</details>

<details>

<summary>Bitte vergewissern Sie sich, dass Sie Systemaufrufe aktiviert haben. Für pdflatex lautet dies 'pdflatex -shell-escape'.</summary>

Das `\write18` Der \`\write18\`-Befehl ist in der Community Edition standardmäßig deaktiviert, da alle Kompilierungen innerhalb desselben `sharelatex` Containers stattfinden; dies ist die sicherere Standardeinstellung.

Wenn Sie ihn für pdflatex aktivieren möchten, erstellen Sie eine `latexmkrc` Datei im Stammverzeichnis Ihres Projekts mit dem folgenden Inhalt:

{% code title="latexmkrc" %}

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

{% endcode %}

Versuchen Sie dann, erneut zu kompilieren.

Referenz: <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/de/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.