> 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/ru/podderzhka/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 %}

### Работа с Doctor <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/ru/podderzhka/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.
