> ## 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.

# Rozwiązywanie problemów

<Info>
  Jeśli używasz wcześniejszej wersji, w nazwach ścieżek używaj `sharelatex` zamiast `overleaf`.
</Info>

<Accordion title="Uruchamianie Overleaf z systemem plików NFS">
  Zamontowanie systemu plików NFS w kontenerze Overleaf jest technicznie możliwe, ale nie jest zalecane i może prowadzić do różnego rodzaju problemów z wydajnością.

  Jednym z częstych błędów pojawiających się przy kompilacji jest:

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

  W szczególności odradzamy używanie systemów plików opartych na NFS dla danych tymczasowych, takich jak katalogi używane do przechowywania danych kompilacji. Dla poniższych katalogów zalecamy używanie lokalnego dysku roboczego (scratch), najlepiej lokalnego dysku SSD.

  W konfiguracjach opartych na `docker-compose` sugerujemy po prostu nadpisanie montowania (bind-mount) z NFS, co pozwala uniknąć zmiany ścieżek w aplikacji. Oto przykładowy fragment konfiguracji `docker-compose` z użyciem dysku roboczego zamontowanego w `/scratch`:

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

  Po aktualizacji nie ma potrzeby migrowania istniejących plików z NFS do nowej lokalizacji. Kompilator LaTeX może odtworzyć wszystkie pliki podczas ponownej pełnej kompilacji.

  Więcej szczegółów: [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="Uruchomienie Overleaf w systemie Windows lub macOS powoduje, że usługa `mongo` nie startuje">
  Jeśli uruchamiasz Overleaf w systemie Windows lub macOS, usługa `mongo` może nie zrestartować się, zgłaszając błąd:

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

  Aby uniknąć tego błędu, dane muszą być przechowywane w wolumenie, a nie w katalogu montowanym przez bind mount (więcej szczegółów w dokumentacji obrazu `mongo`: [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)). Aby przechowywać dane w wolumenach Docker montowanych w kontenerach MongoDB i Redis, dodaj poniższe wpisy do `config/docker-compose.override.yml` (utwórz ten plik, jeśli jeszcze nie istnieje):

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

  Więcej informacji: [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="Aktualizacja do Redis 6.2 powoduje pętlę restartów">
  Użyj polecenia `docker logs redis`, aby wyświetlić kopię logów.

  Jeśli widzisz wiersz `Fatal: Can't initialize Background Jobs`, pełne wyjście będzie wyglądać mniej więcej tak:

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

  Może to być związane z aktualnie używaną wersją Dockera. Aktualizacja do wersji >= 20.10.10 powinna rozwiązać ten problem.

  Więcej informacji znajdziesz w zgłoszeniu w projekcie Redis: [https://github.com/redis/redis/issues/12362](https://github.com/redis/redis/issues/12362)

  Źródło: [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="Nieprawidłowa orientacja obrazów podglądu/miniatur w galerii szablonów">
  Czasami obrazy podglądu/miniatur generowane przez Server Pro mogą zostać utworzone w złej orientacji i wymagać ręcznej korekty. Obrazy te są przechowywane w `/var/lib/overleaf/data/template_files/` (>= 5.0.3) oraz `/var/lib/sharelatex/data/template_files/` (wcześniejsze wersje).

  Przed wprowadzeniem jakichkolwiek zmian zalecamy wykonanie kopii zapasowej tego folderu.

  Dla każdego problematycznego szablonu wykonaj poniższe kroki:

  Znajdź identyfikator szablonuPrzejdź do galerii szablonów swojej instancji (/templates/all), otwórz problematyczny szablon i skopiuj identyfikator z adresu URL (na przykład: [https://your-instance-url/templates/6645d346c224815e9460a695).Uruchom](https://your-instance-url/templates/6645d346c224815e9460a695\).Uruchom) polecenie korygująceUruchom na hoście Docker poniższe polecenie (zastąp identyfikator szablonu skopiowanym i w razie potrzeby zaktualizuj ścieżkę):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*\{thumbnail,preview}"

  Źródło: [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="Sprawdź, czy wywołania systemowe są włączone. Dla pdflatex jest to 'pdflatex -shell-escape'.">
  Polecenie `\write18` jest domyślnie wyłączone w Community Edition, ponieważ wszystkie kompilacje odbywają się w tym samym kontenerze `sharelatex`; jest to bezpieczniejsze ustawienie domyślne.

  Jeśli chcesz włączyć je dla pdflatex, utwórz w katalogu głównym projektu plik `latexmkrc` o następującej zawartości:

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

  Następnie spróbuj ponownie skompilować projekt.

  Źródło: [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.