> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fehlerbehebung

<Info>
  Wenn Sie eine ältere Version verwenden, nutzen Sie in Pfadnamen bitte `sharelatex` statt `overleaf`.
</Info>

<Accordion title="Overleaf mit einem NFS-Dateisystem betreiben">
  Das Einbinden eines NFS-Dateisystems in einen Overleaf-Container ist technisch möglich, wird jedoch nicht empfohlen und kann zu verschiedenen Arten von Performance-Fehlern führen.

  Ein häufiger Fehler beim Kompilieren ist:

  ```text theme={null}
  EBUSY: resource busy or locked, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
  ```

  Insbesondere raten wir davon ab, NFS-basierte Dateisysteme für flüchtige Daten zu verwenden, etwa für die Verzeichnisse mit Kompilierungsdaten. Wir empfehlen für die folgenden Verzeichnisse eine lokale Scratch-Disk, vorzugsweise eine lokale SSD.

  Bei `docker-compose`-basierten Setups empfehlen wir, einfach den Bind-Mount vom NFS zu überschreiben, sodass Pfade in der Anwendung nicht geändert werden müssen. Hier ein Beispiel für einen Auszug aus einer `docker-compose`-Konfiguration mit einer unter `/scratch` eingebundenen Scratch-Disk:

  ```yaml title="docker-compose excerpt" theme={null}
  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
  ```

  Nach der Umstellung müssen keine vorhandenen Dateien vom NFS an ihren neuen Speicherort migriert werden. Der LaTeX-Compiler kann alle Dateien mit einem vollständigen Kompilierungsdurchlauf neu erzeugen.

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

<Accordion title="Unter Windows oder macOS startet der Dienst `mongo` nicht">
  Wenn Sie Overleaf unter Windows oder macOS betreiben, kann der Neustart des Dienstes `mongo` mit folgendem Fehler fehlschlagen:

  ```text title="Example error" theme={null}
  Failed to start up WiredTiger under any compatibility version.
  Reason: 1: Operation not permitted
  ```

  Um diesen Fehler zu vermeiden, müssen die Daten in einem Volume statt in einem per Bind-Mount eingebundenen Verzeichnis gespeichert werden (weitere Details in der Dokumentation des `mongo`-Images: [https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data](https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data)). Um Daten in Docker-Volumes zu speichern, die in die MongoDB- und Redis-Container eingebunden werden, fügen Sie Folgendes zu `config/docker-compose.override.yml` hinzu (legen Sie die Datei an, falls sie noch nicht existiert):

  ```yaml title="config/docker-compose.override.yml" theme={null}
  volumes:
    mongo-data:
    redis-data:

  services:
    mongo:
      volumes:
        - mongo-data:/data/db

    redis:
      volumes:
        - redis-data:/data
  ```

  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](https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting)
</Accordion>

<Accordion title="Upgrade auf Redis 6.2 führt zu einer Neustartschleife">
  Verwenden Sie den Befehl `docker logs redis`, um eine Kopie der Logs auszugeben.

  Wenn Sie die Zeile `Fatal: Can't initialize Background Jobs` sehen, sieht die vollständige Ausgabe etwa so aus:

  ```text title="Redis log example" theme={null}
  1:M 11 Feb 2024 15:19:22.609 # Server initialized
  1:M 11 Feb 2024 15:19:22.609 # Fatal: Can't initialize Background Jobs.
  1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo
  ```

  Dies kann mit der aktuell verwendeten Docker-Version zusammenhängen. Ein Update auf Version >= 20.10.10 sollte das Problem beheben.

  Weitere Informationen finden Sie im Upstream-Issue von Redis: [https://github.com/redis/redis/issues/12362](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](https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop)
</Accordion>

<Accordion title="Falsche Ausrichtung der Vorschau-/Miniaturbilder in der Vorlagengalerie">
  Gelegentlich werden die von Server Pro erzeugten Vorschau-/Miniaturbilder falsch ausgerichtet und müssen manuell korrigiert werden. Diese Bilder werden in `/var/lib/overleaf/data/template_files/` (>= 5.0.3) bzw. `/var/lib/sharelatex/data/template_files/` (ältere Versionen) gespeichert.

  Wir empfehlen, diesen Ordner zu sichern, bevor Sie Änderungen vornehmen.

  Führen Sie für jede betroffene Vorlage die folgenden Schritte aus:

  Vorlagen-ID ermitteln: 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](https://your-instance-url/templates/6645d346c224815e9460a695)). Korrekturbefehl ausführen: Führen Sie den folgenden Befehl auf dem Docker-Host aus (ersetzen Sie die Vorlagen-ID durch die kopierte ID und passen Sie den Pfad bei Bedarf 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](https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images)
</Accordion>

<Accordion title="Bitte prüfen Sie, ob Systemaufrufe aktiviert sind. Für pdflatex lautet dies 'pdflatex -shell-escape'.">
  Der Befehl `\write18` ist in der Community Edition standardmäßig deaktiviert, da alle Kompilierungen im selben Container `sharelatex` stattfinden; dies ist die sicherere Voreinstellung.

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

  ```perl title="latexmkrc" theme={null}
  $pdflatex = 'pdflatex --shell-escape';
  ```

  Kompilieren Sie anschließend erneut.

  Referenz: [https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape](https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape)
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.