> 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/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 для тимчасових даних, як-от каталоги, що використовуються для даних компіляції. Ми рекомендуємо використовувати локальний тимчасовий диск, бажано локальний SSD, для наведених нижче каталогів.

Для `docker-compose` налаштувань ми радимо просто перевизначити bind-монтування з NFS, що дозволяє не змінювати шляхи в застосунку. Ось приклад `docker-compose` фрагмента конфігурації з використанням тимчасового диска, змонтованого в `/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-томів, змонтованих у контейнерах 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 # 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://overleaf-pro.ayaka.space/on-premises/uk/pidtrimka/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.