> 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/getting-help.md).

# Uzyskiwanie pomocy

### Doktor

Overleaf Toolkit zawiera przydatny `doctor` skrypt ułatwiający debugowanie. Uruchom `bin/doctor` a skrypt wyświetli informacje o środowisku hosta, Twojej konfiguracji oraz zależnościach potrzebnych Toolkitowi. Ten wynik może też pomóc zespołowi wsparcia Overleaf diagnozować problemy w instalacjach Server Pro.

{% hint style="info" %}
Użytkownicy Overleaf Pro mogą [otworzyć zgłoszenie na GitHubie](https://github.com/ayaka-notes/overleaf/issues).

warto dołączyć wynik `bin/doctor` skryptu do swojej wiadomości.
{% endhint %}

### Konsultacja z Doktorem <a href="#consulting-with-the-doctor" id="consulting-with-the-doctor"></a>

Uruchom skrypt doctor:

{% code title="Uruchom doctor" %}

```bash
bin/doctor
```

{% endcode %}

Zobaczysz wynik podobny do poniższego przykładu.

<details>

<summary>Pełny przykładowy wynik</summary>

```
====== Overleaf Doctor ======
- Informacje o hoście
    - Linux
    - Wynik polecenia 'lsb_release -a':
            Nie są dostępne żadne moduły LSB.
            ID dystrybucji:	Ubuntu
            Opis:	Ubuntu 22.04.5 LTS
            Wydanie:	22.04
            Nazwa kodowa:	jammy
- Zależności
    - bash
        - status: obecny
        - informacje o wersji: 5.1.16(1)-release
    - docker
        - status: obecny
        - informacje o wersji: Docker w wersji 28.0.4, kompilacja b8034c0
    - docker compose
        - status: obecny
        - informacje o wersji: Docker Compose w wersji v2.34.0
    - realpath
        - status: obecny
        - informacje o wersji: realpath (GNU coreutils) 8.32
    - perl
        - status: obecny
        - informacje o wersji: 5.034000
    - awk
        - status: obecny
        - informacje o wersji: mawk 1.3.4 20200120
- Docker Daemon
    - status: uruchomiony
====== Konfiguracja ======
- config/version
    - status: obecny
    - wersja: 5.4.0
- config/overleaf.rc
    - status: obecny
    - wartości
        - OVERLEAF_DATA_PATH: data/overleaf
        - OVERLEAF_LOG_PATH: data/overleaf/logs
        - SERVER_PRO: true
        - SIBLING_CONTAINERS_ENABLED: true
            - zalogowano się do quay.io: true
        - MONGO_ENABLED: true
        - REDIS_ENABLED: true
- config/variables.env
    - status: obecny
    - wartości
        - OVERLEAF_FILESTORE_BACKEND: fs
        - OVERLEAF_HISTORY_BACKEND: fs

====== Ostrzeżenia ======
- Brak, wszystko w porządku
====== Koniec ======
```

</details>

### Informacje o hoście

Ustawienie `Informacje o hoście` zawiera informacje o maszynie uruchamiającej Toolkit (na przykład dystrybucję i wydanie Linuksa).

<details>

<summary>Przykładowy wynik informacji o hoście</summary>

```
- Informacje o hoście
    - Linux
    - Wynik polecenia 'lsb_release -a':
            Nie są dostępne żadne moduły LSB.
            ID dystrybucji:	Ubuntu
            Opis:	Ubuntu 22.04.5 LTS
            Wydanie:	22.04
            Nazwa kodowa:	jammy
```

</details>

### Zależności

Ustawienie `Zależności` zawiera listę narzędzi wymaganych do działania Toolkita. Jeśli narzędzie jest obecne, zostanie oznaczone jako `status: obecny` z informacją o wersji. Jeśli go brakuje, zostanie oznaczone jako `status: BRAK!` a na dole `doctor` wyniku zostanie dodane ostrzeżenie.

<details>

<summary>Przykładowy wynik zależności (obecne)</summary>

```
- docker
    - status: obecny
    - informacje o wersji: Docker w wersji 28.0.4, kompilacja b8034c0
```

</details>

<details>

<summary>Przykładowy wynik zależności (brak)</summary>

```
- docker
    - status: BRAK!
```

</details>

Jeśli brakuje jakichkolwiek zależności, Toolkit prawie na pewno nie będzie działać.

### Konfiguracja

Ustawienie `Konfiguracja` zawiera informacje o plikach w `config/` katalogu. Dla `config/overleaf.rc`, doctor wypisuje kilka kluczowych wartości. Brakujące pliki będą wyświetlane jako `status: BRAK!` a na dole `doctor` wyniku zostanie dodane ostrzeżenie.

<details>

<summary>Przykładowy wynik konfiguracji</summary>

```
====== Konfiguracja ======
- config/version
    - status: obecny
    - wersja: 5.4.0
- config/overleaf.rc
    - status: obecny
    - wartości
        - OVERLEAF_DATA_PATH: /tmp/overleaf
        - SERVER_PRO: false
        - MONGO_ENABLED: false
        - REDIS_ENABLED: true
- config/variables.env
    - status: BRAK!
```

</details>

Uwagi dotyczące powyższego przykładu:

* `OVERLEAF_DATA_PATH` ustawione na `/tmp/overleaf` może nie być bezpiecznym miejscem dla ważnych danych.
* `MONGO_ENABLED: false` oznacza, że Toolkit nie będzie tworzył własnej instancji MongoDB; upewnij się `MONGO_URL` że wskazuje na zewnętrznie zarządzaną instancję MongoDB, jeśli jest potrzebna.
* `config/variables.env` brakuje w przykładzie.

### Ostrzeżenia

Ustawienie `Ostrzeżenia` zawiera podsumowanie problemów wykrytych przez skrypt doctor. Jeśli nie ma żadnych problemów, ta sekcja to wskaże.

<details>

<summary>Przykładowy wynik ostrzeżeń</summary>

```
====== Ostrzeżenia ======
- nie znaleziono pliku konfiguracyjnego variables.env
- plik rc, OVERLEAF_DATA_PATH nie jest ustawiony
====== Koniec =======
```

</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/getting-help.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.
