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

# Получение помощи

### Доктор

В Overleaf Toolkit есть удобный `доктор` скрипт для помощи в отладке. Запустите `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 Daemon
    - статус: запущен
====== Конфигурация ======
- 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. Если инструмент присутствует, он будет указан как `статус: присутствует` с информацией о версии. Если он отсутствует, он будет указан как `статус: ОТСУТСТВУЕТ!` и внизу `доктор` вывода будет добавлено предупреждение.

<details>

<summary>Пример вывода по зависимостям (присутствует)</summary>

```
- docker
    - статус: присутствует
    - сведения о версии: Docker version 28.0.4, build b8034c0
```

</details>

<details>

<summary>Пример вывода по зависимостям (отсутствует)</summary>

```
- docker
    - статус: ОТСУТСТВУЕТ!
```

</details>

Если каких-либо зависимостей не хватает, Toolkit почти наверняка не будет работать.

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

Поле `Конфигурация` раздел содержит информацию о файлах в `config/` каталоге. Для `config/overleaf.rc`, скрипт 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/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.
