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

# Uzyskiwanie pomocy

### Doktor

Overleaf Toolkit zawiera przydatny `doctor` skrypt do pomocy przy debugowaniu. Uruchom `bin/doctor` a skrypt wypisze informacje o środowisku hosta, konfiguracji oraz zależnościach potrzebnych Toolkitowi. Ten wynik może także pomóc zespołowi wsparcia Overleaf diagnozować problemy w instalacjach Server Pro.

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

dobrym pomysłem jest dołączenie wyniku `bin/doctor` skryptu w 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>Przykładowy pełny 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
- Demon Dockera
    - 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 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

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

<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

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

<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

Pole `Konfiguracja` sekcja zawiera informacje o plikach w `katalogu config/` katalogu. Dla `config/overleaf.rc`, doctor wypisuje kilka kluczowych wartości. Brakujące pliki zostaną wymienione jako `status: BRAK!` a na dole zostanie dodane ostrzeżenie do `doctor` wyniku.

<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 do powyższego przykładu:

* `OVERLEAF_DATA_PATH` na `/tmp/overleaf` może nie być bezpiecznym miejscem dla ważnych danych.
* `MONGO_ENABLED: false` oznacza, że Toolkit nie będzie udostępniać własnej bazy MongoDB; upewnij się, `MONGO_URL` w razie potrzeby wskazuje na zewnętrznie zarządzaną MongoDB.
* `config/variables.env` brakuje w przykładzie.

### Ostrzeżenia

Pole `Ostrzeżenia` Sekcja podsumowuje problemy wykryte przez skrypt doctor. Jeśli nie ma 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 został 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://ayakaleaf-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.
