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

# Устранение неполадок

{% hint style="info" %}
Если вы используете более раннюю версию, пожалуйста, используйте `sharelatex` вместо `overleaf` в именах путей.
{% endhint %}

<details>

<summary>Запуск Overleaf с файловой системой NFS</summary>

Монтирование файловой системы NFS в контейнере Overleaf технически возможно, но не рекомендуется и может приводить к различным проблемам с производительностью.

Одна распространённая ошибка, которую можно увидеть при компиляции:

```
EBUSY: ресурс занят или заблокирован, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

В частности, мы не рекомендуем использовать файловые системы на базе NFS для временных данных, таких как каталоги, используемые для данных компиляции. Мы рекомендуем использовать локальный scratch-диск, предпочтительно локальный SSD, для следующих каталогов.

Для `docker-compose` основанных на них конфигураций, мы предлагаем просто переопределить bind-mount от NFS, что позволит избежать изменения путей в приложении. Вот пример `docker-compose` фрагмента конфигурации с использованием scratch-диска, смонтированного в `/scratch`:

{% code title="фрагмент docker-compose" %}

```yaml
services:
  sharelatex:
    environment:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    volumes:
      - nfs:/var/lib/overleaf/data
      - /scratch/cache/:/var/lib/overleaf/data/cache
      - /scratch/compiles/:/var/lib/overleaf/data/compiles
      - /scratch/output/:/var/lib/overleaf/data/output
      - /scratch/tmp/:/var/lib/overleaf/tmp
```

{% endcode %}

Нет необходимости переносить какие-либо существующие файлы из NFS в новое место после обновления. Компилятор LaTeX может заново создать все файлы при полном повторном запуске компиляции.

Подробнее см.: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem>

</details>

<details>

<summary>Запуск Overleaf на Windows или macOS приводит к тому, что служба `mongo` не запускается</summary>

Если вы запускаете Overleaf на Windows или macOS, служба `mongo` может не перезапуститься с ошибкой:

{% code title="Пример ошибки" %}

```
Не удалось запустить WiredTiger ни в одной версии совместимости.
Причина: 1: Операция не разрешена
```

{% endcode %}

Чтобы избежать этой ошибки, данные нужно хранить в томе, а не в привязанном каталоге (см. `mongo` документацию образа для получения дополнительных сведений: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Чтобы хранить данные внутри томов Docker, смонтированных в контейнерах MongoDB и Redis, добавьте следующее в `config/docker-compose.override.yml` (создайте этот файл, если он ещё не существует):

{% code title="config/docker-compose.override.yml" %}

```yaml
volumes:
  mongo-data:
  redis-data:

services:
  mongo:
    volumes:
      - mongo-data:/data/db

  redis:
    volumes:
      - redis-data:/data
```

{% endcode %}

Подробнее см.: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting>

</details>

<details>

<summary>Обновление до Redis 6.2 приводит к циклу перезапуска</summary>

Используйте `docker logs redis` команду, чтобы вывести копию журналов.

Если вы видите строку `Fatal: Не удалось инициализировать фоновые задания`, полный вывод будет выглядеть примерно так:

{% code title="Пример журнала Redis" %}

```
1:M 11 Feb 2024 15:19:22.609 # Сервер инициализирован
1:M 11 Feb 2024 15:19:22.609 # Fatal: Не удалось инициализировать фоновые задания.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0OoO Redis запускается oO0OoO0OoO0OoO
```

{% endcode %}

Это может быть связано с используемой в настоящее время версией Docker. Обновление до версии >= 20.10.10 должно решить эту проблему.

Подробнее об исходной проблеме Redis см.: <https://github.com/redis/redis/issues/12362>

Ссылка: <https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop>

</details>

<details>

<summary>Неправильная ориентация изображений предварительного просмотра/миниатюр галереи шаблонов</summary>

Иногда изображения предварительного просмотра/миниатюр, создаваемые Server Pro, могут быть созданы в неправильной ориентации и для исправления требуют ручного вмешательства. Эти изображения хранятся в `/var/lib/overleaf/data/template_files/` (>= 5.0.3) и `/var/lib/sharelatex/data/template_files/` (ранее).

Мы рекомендуем сделать резервную копию этой папки, прежде чем вносить какие-либо изменения.

Вам нужно будет выполнить следующие шаги для каждого затронутого шаблона:

Найдите ID шаблонаПерейдите в галерею шаблонов вашего экземпляра (/templates/all), откройте затронутый шаблон и скопируйте ID из URL (например: <https://your-instance-url/templates/6645d346c224815e9460a695).Запустите> команду исправленияВыполните следующую команду на Docker-хосте (замените ID шаблона на тот, который вы скопировали, и при необходимости обновите путь):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*{thumbnail,preview}"

Ссылка: <https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images>

</details>

<details>

<summary>Пожалуйста, убедитесь, что вы включили системные вызовы. Для pdflatex это 'pdflatex -shell-escape'.</summary>

Поле `\write18` команда по умолчанию отключена в Community Edition, поскольку все компиляции происходят внутри одного и того же `sharelatex` контейнера; это более безопасное значение по умолчанию.

Если вы хотите включить её для pdflatex, создайте `latexmkrc` файл в корне вашего проекта со следующим содержимым:

{% code title="latexmkrc" %}

```perl
$pdflatex = 'pdflatex --shell-escape';
```

{% endcode %}

Затем попробуйте перекомпилировать.

Ссылка: <https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape>

</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/troubleshooting.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.