> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Проблемы, возникающие при запуске Ayakaleaf Pro с Docker Desktop в macOS, и способы их проверки.

### Инициализация завершается ошибкой invalid command code

`bin/init` сообщает `sed: ... invalid command code`, когда находит BSD sed из macOS. Добавьте GNU sed в `PATH`, как описано в разделе [1. Загрузка Toolkit](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/1.-download-the-toolkit.md), и проверьте `sed --version`.

После неудачной инициализации в `config/` могут остаться все три файла с пустым `OVERLEAF_INVITE_TOKEN_SECRET`. Повторный запуск `bin/init` тогда сообщает `Config files already exist`. Для новой установки, которая ещё ни разу не запускалась, переместите эти три файла в каталог резервных копий и снова выполните `bin/init`. Для существующего экземпляра сохраните его конфигурацию и секреты и не удаляйте его файлы ради повторного запуска `bin/init`.

### MongoDB постоянно перезапускается

Прочитайте журналы MongoDB и версию ядра виртуальной машины Docker:

```bash theme={null}
bin/docker-compose logs --tail=100 mongo
docker info --format '{{.KernelVersion}}'
```

Если в журнале упоминается несовместимость с ядром Linux, выполните шаг [Проверьте ядро Linux виртуальной машины Docker](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/5.-personalizing-your-instance.md#check-the-docker-vms-linux-kernel) и снова запустите `bin/up -d`. Один лишь код выхода `137` не доказывает, что MongoDB не хватило памяти: проверьте состояние контейнера и журналы. Об одной давней проблеме MongoDB в Docker Desktop см. также раздел [Устранение неполадок](https://ayakaleaf-pro.mintlify.site/ru/on-premises/support/troubleshooting.md).

### Не удаётся подключиться к демону Docker

Запустите Docker Desktop и проверьте выбранный контекст Docker, см. [0. Установка Docker Desktop](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/0.-setup-docker-desktop.md). Если `docker info` работает, но компиляции не могут обратиться к Docker, проверьте настройки сокета в `config/overleaf.rc` и прочитайте журналы `clsi`. Работающий Docker CLI на Mac не доказывает, что сокет в приложении смонтирован правильно.

### Страница открывается, но компиляция завершается ошибкой

Проверьте, что образ TeX Live есть локально и соответствует архитектуре движка Docker:

```bash theme={null}
docker image inspect ghcr.io/ayaka-notes/texlive-full:2026.1 \
  --format '{{.Os}}/{{.Architecture}}'
bin/logs -f clsi
```

На Apple silicon образ должен быть `linux/arm64`. Проверьте, что `SERVER_PRO` и `SIBLING_CONTAINERS_ENABLED` оба имеют значение `true`, затем примените изменения с помощью `bin/up -d`. Если журналы сообщают об отсутствующем каталоге компиляции, проверьте общий доступ к файлам в Docker Desktop и расположение `OVERLEAF_DATA_PATH`. Не отключайте изолированные компиляции, чтобы скрыть ошибку монтирования.

### Not a directory или отсутствует bind-монтирование

Файл на хосте, который монтируется через переопределение, мог быть удалён, или Docker мог создать каталог там, где должен быть файл. Проверьте исходный путь на хосте и то, ожидает ли монтирование файл или каталог. Восстановите конфигурационный файл, прежде чем пересоздавать контейнер. С этим может столкнуться установка в `/tmp` после того, как macOS удалит временные файлы.

### Конфликты портов или имён контейнеров

Если порт `8080` занят, выберите другой порт в `config/overleaf.rc`, задайте соответствующий `OVERLEAF_SITE_URL` и снова выполните `bin/up -d`.

Toolkit даёт своим контейнерам фиксированные имена, такие как `sharelatex`, `mongo` и `redis`. Одно лишь изменение `PROJECT_NAME` не делает две установки Toolkit независимыми. Прежде чем запускать второй экземпляр, проверьте `docker ps -a` и используйте другие имена контейнеров в переопределении Compose, другой порт и отдельные каталоги данных. Не удаляйте контейнеры или данные существующего развертывания, чтобы устранить конфликт имён.

### Через некоторое время экземпляр становится недоступен

Вероятно, Mac перешёл в спящий режим или работа Docker Desktop была завершена. См. раздел [Обеспечение доступности экземпляра](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available).

### `bin/doctor` сообщает, что это не Linux, или запрашивает вход в Quay

Оба предупреждения ожидаемы в macOS при использовании публичного образа, см. [2. Знакомство с Toolkit](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/2.-familiarize-yourself-with-the-toolkit.md). Вместо этого проверьте загрузку образов, состояние сервисов и результаты компиляции и не игнорируйте другие ошибки в отчёте.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.