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

# Отримання допомоги

### Лікар

У Overleaf Toolkit є зручний `doctor` скрипт для допомоги з налагодженням. Запустіть `bin/doctor` і скрипт виведе інформацію про ваше середовище хоста, вашу конфігурацію та залежності, які потрібні Toolkit. Цей вивід також може допомогти команді підтримки Overleaf діагностувати проблеми для встановлень Server Pro.

{% hint style="info" %}
Користувачі Overleaf Pro можуть [відкрити issue на GitHub](https://github.com/ayaka-notes/overleaf/issues).

варто додати вивід `bin/doctor` скрипта у своє повідомлення.
{% endhint %}

### Консультація з Лікарем <a href="#consulting-with-the-doctor" id="consulting-with-the-doctor"></a>

Запустіть скрипт doctor:

{% code title="Запустити doctor" %}

```bash
bin/doctor
```

{% endcode %}

Ви побачите вивід, подібний до наведеного нижче прикладу.

<details>

<summary>Повний приклад виводу</summary>

```
====== Overleaf Doctor ======
- Інформація про хост
    - Linux
    - Вивід 'lsb_release -a':
            Модулі LSB недоступні.
            Ідентифікатор дистрибутива:	Ubuntu
            Опис:	Ubuntu 22.04.5 LTS
            Версія:	22.04
            Кодова назва:	jammy
- Залежності
    - bash
        - стан: наявний
        - інформація про версію: 5.1.16(1)-release
    - docker
        - стан: наявний
        - інформація про версію: Docker version 28.0.4, build b8034c0
    - docker compose
        - стан: наявний
        - інформація про версію: Docker Compose version v2.34.0
    - realpath
        - стан: наявний
        - інформація про версію: realpath (GNU coreutils) 8.32
    - perl
        - стан: наявний
        - інформація про версію: 5.034000
    - awk
        - стан: наявний
        - інформація про версію: mawk 1.3.4 20200120
- Демон Docker
    - стан: запущено
====== Конфігурація ======
- config/version
    - стан: наявний
    - версія: 5.4.0
- config/overleaf.rc
    - стан: наявний
    - значення
        - OVERLEAF_DATA_PATH: data/overleaf
        - OVERLEAF_LOG_PATH: data/overleaf/logs
        - SERVER_PRO: true
        - SIBLING_CONTAINERS_ENABLED: true
            - виконано вхід до quay.io: true
        - MONGO_ENABLED: true
        - REDIS_ENABLED: true
- config/variables.env
    - стан: наявний
    - значення
        - OVERLEAF_FILESTORE_BACKEND: fs
        - OVERLEAF_HISTORY_BACKEND: fs

====== Попередження ======
- Немає, усе добре
====== Кінець ======
```

</details>

### Інформація про хост

Поле `Інформація про хост` цей розділ містить інформацію про машину, на якій запущено Toolkit (наприклад, дистрибутив і версію Linux).

<details>

<summary>Приклад виводу інформації про хост</summary>

```
- Інформація про хост
    - Linux
    - Вивід 'lsb_release -a':
            Модулі LSB недоступні.
            Ідентифікатор дистрибутива:	Ubuntu
            Опис:	Ubuntu 22.04.5 LTS
            Версія:	22.04
            Кодова назва:	jammy
```

</details>

### Залежності

Поле `Залежності` цей розділ перелічує інструменти, потрібні для роботи Toolkit. Якщо інструмент присутній, він буде вказаний як `статус: наявний` з інформацією про версію. Якщо його немає, він буде вказаний як `статус: ВІДСУТНІЙ!` і попередження буде додано внизу `doctor` виводу.

<details>

<summary>Приклад виводу залежностей (наявні)</summary>

```
- docker
    - стан: наявний
    - інформація про версію: Docker version 28.0.4, build b8034c0
```

</details>

<details>

<summary>Приклад виводу залежностей (відсутні)</summary>

```
- docker
    - статус: ВІДСУТНІЙ!
```

</details>

Якщо будь-які залежності відсутні, Toolkit майже напевно не працюватиме.

### Конфігурація

Поле `Конфігурація` цей розділ містить інформацію про файли в `config/` каталозі. Для `config/overleaf.rc`, doctor виводить деякі ключові значення. Відсутні файли буде вказано як `статус: ВІДСУТНІЙ!` і попередження буде додано внизу `doctor` виводу.

<details>

<summary>Приклад виводу конфігурації</summary>

```
====== Конфігурація ======
- config/version
    - стан: наявний
    - версія: 5.4.0
- config/overleaf.rc
    - стан: наявний
    - значення
        - OVERLEAF_DATA_PATH: /tmp/overleaf
        - SERVER_PRO: false
        - MONGO_ENABLED: false
        - REDIS_ENABLED: true
- config/variables.env
    - статус: ВІДСУТНІЙ!
```

</details>

Примітки до наведеного вище прикладу:

* `OVERLEAF_DATA_PATH` на `/tmp/overleaf` може бути небезпечним місцем для важливих даних.
* `MONGO_ENABLED: false` означає, що Toolkit не розгорне власну MongoDB; переконайтеся `MONGO_URL` що вказує на зовнішньо керовану MongoDB, якщо потрібно.
* `config/variables.env` відсутнє в прикладі.

### Попередження

Поле `Попередження` цей розділ підсумовує проблеми, виявлені скриптом doctor. Якщо проблем немає, цей розділ це покаже.

<details>

<summary>Приклад виводу попереджень</summary>

```
====== Попередження ======
- файл конфігурації variables.env не знайдено
- у файлі rc, OVERLEAF_DATA_PATH не задано
====== Кінець =======
```

</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/uk/pidtrimka/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.
