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

Чтобы избежать этой ошибки, данные нужно хранить в томе, а не в bind-mounted каталоге (см. `mongo` документацию образа для получения дополнительных сведений: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Чтобы хранить данные внутри Docker volumes, подключённых в контейнерах 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 # Критическая ошибка: не удается инициализировать фоновые задания.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis запускается oO0OoO0OoO0Oo
```

{% endcode %}

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

Дополнительная информация: см. проблему в upstream 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://ayakaleaf-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.