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

# Rozwiązywanie problemów

{% hint style="info" %}
Jeśli korzystasz z 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 powodować różnego rodzaju błędy wydajności.

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

```
EBUSY: zasób zajęty lub zablokowany, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

W szczególności odradzamy używania systemów plików opartych na NFS do danych efemerycznych, takich jak katalogi używane do danych kompilacji. Zalecamy użycie lokalnego dysku scratch, najlepiej lokalnego SSD, dla następujących katalogów.

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

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

```yaml
usługi:
  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 żadnych istniejących plików z NFS do ich nowej lokalizacji po aktualizacji. Kompilator LaTeX może odtworzyć wszystkie pliki, uruchamiając ponownie pełną kompilację.

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, `mongo` usługa może nie uruchomić się ponownie, z błędem:

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

```
Nie udało się uruchomić WiredTiger przy żadnej wersji zgodności.
Powód: 1: Operacja niedozwolona
```

{% endcode %}

Aby uniknąć tego błędu, dane muszą być przechowywane w woluminie, a nie w katalogu zamontowanym metodą 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 w woluminach Docker zamontowanych wewnątrz kontenerów MongoDB i Redis, dodaj następujące elementy 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:

usługi:
  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 zapętlenie ponownych uruchomień</summary>

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

Jeśli zobaczysz 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 # 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
```

{% endcode %}

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

Więcej informacji na temat problemu w głównym repozytorium Redis: <https://github.com/redis/redis/issues/12362>

Odniesienie: <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>

Od czasu do czasu 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) i `/var/lib/sharelatex/data/template_files/` (wcześniej).

Zalecamy wykonanie kopii zapasowej tego folderu przed wprowadzeniem jakichkolwiek zmian.

Będziesz musiał 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 na hoście Dockera (zastąp identyfikator szablonu skopiowanym przez Ciebie i zaktualizuj ścieżkę, jeśli to właściwe):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*{thumbnail,preview}"

Odniesienie: <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. W przypadku pdflatex jest to 'pdflatex -shell-escape'.</summary>

Ustawienie `\write18` polecenie jest domyślnie wyłączone w Community Edition ze względu na to, że wszystkie kompilacje odbywają się wewnątrz tego samego `sharelatex` kontenera; to bezpieczniejsze ustawienie domyślne.

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

{% code title="latexmkrc" %}

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

{% endcode %}

Następnie spróbuj ponownie skompilować.

Odniesienie: <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/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.