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

# Fehlerbehebung

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

<details>

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

Das Einbinden eines NFS-Dateisystems in einen 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: Ressource belegt oder gesperrt, 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 etwa die Verzeichnisse für Kompilierungsdaten. Wir empfehlen, für die folgenden Verzeichnisse eine lokale Scratch-Disk, vorzugsweise eine lokale SSD, zu verwenden.

Für `docker-compose` basierte Setups schlagen wir vor, 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 ein `docker-compose` Konfigurationsausschnitt mit der Verwendung einer Scratch-Disk, die unter `/scratch`:

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

```yaml
services:
  sharelatex:
    Umgebung:
      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 notwendig, vorhandene Dateien nach dem Update vom NFS an ihren neuen Speicherort zu migrieren. Der LaTeX-Compiler kann alle Dateien bei einem vollständigen erneuten Kompilierungslauf neu erstellen.

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

</details>

<details>

<summary>Das Ausführen von Overleaf unter Windows oder macOS führt dazu, dass der `mongo`-Dienst nicht startet</summary>

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

{% code title="Beispielfehler" %}

```
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 statt in einem per Bind-Mount eingebundenen Verzeichnis gespeichert werden (siehe die `mongo` Dokumentation des Images für weitere Details: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Um Daten in Docker-Volumes zu speichern, die in den MongoDB- und Redis-Containern eingebunden 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>Ein Upgrade auf Redis 6.2 führt zu einer Neustartschleife</summary>

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

Wenn Sie die Zeile sehen `Fatal: Background Jobs können nicht initialisiert werden`, sieht die vollständige Ausgabe ungefähr so aus:

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

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

{% endcode %}

Dies kann 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-/Miniaturbilder in der Vorlagengalerie</summary>

Gelegentlich können die von Server Pro erzeugten Vorschau-/Miniaturbilder in der falschen Ausrichtung erstellt werden und erfordern manuelles Eingreifen zur 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:

Vorlagen-ID findenNavigieren 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 ausFühren Sie den folgenden Befehl auf dem Docker-Host aus (ersetzen Sie die Vorlagen-ID durch die von Ihnen kopierte und passen Sie den Pfad gegebenenfalls an):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>

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

Wenn Sie ihn für pdflatex aktivieren möchten, erstellen Sie eine `latexmkrc` Datei im Stammverzeichnis Ihres Projekts mit folgendem 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://overleaf-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.