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

# Усунення несправностей

{% hint style="info" %}
Якщо ви використовуєте більш ранню версію, будь ласка, використовуйте `контейнера sharelatex` замість `Overleaf` у назвах шляхів.
{% endhint %}

<details>

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

Підключення файлової системи NFS у контейнері Overleaf технічно можливе, але це не рекомендується і може призвести до різних типів помилок продуктивності.

Одна поширена помилка, яку бачать під час компіляції, така:

```
EBUSY: resource busy or locked, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

Зокрема, ми не рекомендуємо використовувати файлові системи на базі NFS для тимчасових даних, таких як каталоги, що використовуються для даних компіляції. Ми рекомендуємо використовувати локальний тимчасовий диск, бажано локальний SSD, для наведених нижче каталогів.

Для `docker-compose` на основі налаштувань ми пропонуємо просто перевизначити bind-mount із 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 mount (див. `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: Can't initialize Background Jobs`, повний вивід виглядатиме приблизно так:

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

```
1:M 11 Feb 2024 15:19:22.609 # Server initialized
1:M 11 Feb 2024 15:19:22.609 # Fatal: Can't initialize Background Jobs.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo
```

{% 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://ayakaleaf-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.