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