> 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/pl/wsparcie/troubleshooting.md).

# Rozwiązywanie problemów

{% hint style="info" %}
Jeśli używasz wcześniejszej wersji, użyj `sharelatex` zamiast `Overleaf` w nazwach ścieżek.
{% endhint %}

<details>

<summary>Uruchamianie Overleaf z systemem plików NFS</summary>

Zamontowanie systemu plików NFS w kontenerze Overleaf jest technicznie możliwe, ale nie jest zalecane i może prowadzić do różnych problemów z wydajnością.

Jednym z częstych błędów widocznych podczas kompilacji jest:

```
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 do danych tymczasowych, takich jak katalogi używane do danych kompilacji. Zalecamy użycie lokalnego dysku scratch, najlepiej lokalnego dysku SSD, dla następujących katalogów.

Dla `docker-compose` opartych na, sugerujemy po prostu nadpisać montowanie bind z NFS, co pozwala uniknąć zmiany ścieżek w aplikacji. Oto przykład `docker-compose` fragmentu konfiguracji z użyciem dysku scratch zamontowanego w `/scratch`:

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

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

Nie ma potrzeby przenoszenia jakichkolwiek istniejących plików z NFS do ich nowej lokalizacji po aktualizacji. Kompilator LaTeX może ponownie utworzyć wszystkie pliki podczas pełnego uruchomienia kompilacji.

Więcej szczegółów: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem>

</details>

<details>

<summary>Uruchamianie Overleaf w systemie Windows lub macOS powoduje, że usługa `mongo` nie uruchamia się</summary>

Jeśli uruchamiasz Overleaf w systemie Windows lub macOS, to `mongo` usługa może nie uruchomić się ponownie, z błędem:

{% code title="Przykładowy błąd" %}

```
Nie udało się uruchomić WiredTiger w żadnej wersji zgodności.
Przyczyna: 1: Operacja niedozwolona
```

{% endcode %}

Aby uniknąć tego błędu, dane muszą być przechowywane w wolumenie, a nie w katalogu zamontowanym typu bind (zobacz `mongo` dokumentację obrazu, aby uzyskać więcej informacji: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Aby przechowywać dane wewnątrz wolumenów Dockera zamontowanych w kontenerach MongoDB i Redis, dodaj następujące do `config/docker-compose.override.yml` (utwórz ten plik, jeśli jeszcze nie istnieje):

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

Więcej informacji: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting>

</details>

<details>

<summary>Aktualizacja do Redis 6.2 powoduje pętlę ponownego uruchamiania</summary>

Użyj `docker logs redis` polecenia, aby wyświetlić kopię logów.

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

{% code title="Przykład logu Redis" %}

```
1:M 11 Feb 2024 15:19:22.609 # Serwer zainicjalizowany
1:M 11 Feb 2024 15:19:22.609 # Fatal: Nie można zainicjalizować zadań w tle.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis jest uruchamiany oO0OoO0OoO0Oo
```

{% endcode %}

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

Więcej informacji: zobacz zgłoszenie upstream Redis: <https://github.com/redis/redis/issues/12362>

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

</details>

<details>

<summary>Nieprawidłowa orientacja obrazów podglądu/miniatur galerii szablonów</summary>

Czasami obrazy podglądu/miniatur generowane przez Server Pro mogą zostać utworzone w niewłaściwej orientacji i wymagają ręcznej interwencji, aby je poprawić. Obrazy te są przechowywane w `/var/lib/overleaf/data/template_files/` (>= 5.0.3) oraz `/var/lib/sharelatex/data/template_files/` (wcześniej).

Zalecamy wykonanie kopii zapasowej tego folderu przed wprowadzeniem jakichkolwiek zmian.

Musisz wykonać poniższe kroki dla każdego dotkniętego szablonu:

Znajdź identyfikator szablonuPrzejdź do galerii szablonów swojej instancji (/templates/all), otwórz dotknięty szablon i skopiuj identyfikator z adresu URL (na przykład: <https://your-instance-url/templates/6645d346c224815e9460a695).Uruchom> polecenie naprawczeUruchom następujące polecenie z hosta Dockera (zastąp identyfikator szablonu tym, który skopiowałeś, 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}"

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

</details>

<details>

<summary>Proszę sprawdzić, czy włączyłeś wywołania systemowe. Dla pdflatex jest to 'pdflatex -shell-escape'.</summary>

Pole `\write18` polecenie jest domyślnie wyłączone w Community Edition, ponieważ wszystkie kompilacje odbywają się w tym samym `sharelatex` kontenerze; to bezpieczniejszy domyślny wybór.

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

{% code title="latexmkrc" %}

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

{% endcode %}

Następnie spróbuj ponownie skompilować.

Odwołanie: <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/pl/wsparcie/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.