> ## 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.

# 5. Персонализация экземпляра

> Задайте порт, URL сайта и образ TeX Live для локального экземпляра на Mac, проверьте ядро виртуальной машины Docker и запустите Ayakaleaf Pro.

**1. Настройки контейнеров**

Измените следующие существующие записи в `config/overleaf.rc`:

```bash title="config/overleaf.rc" theme={null}
PROJECT_NAME=ayakaleaf-macos
SERVER_PRO=true
OVERLEAF_LISTEN_IP=127.0.0.1
OVERLEAF_PORT=8080
SIBLING_CONTAINERS_ENABLED=true
DOCKER_SOCKET_PATH=/var/run/docker.sock
```

Оставьте пути к данным по умолчанию и входящие в комплект сервисы MongoDB и Redis. При `OVERLEAF_LISTEN_IP=127.0.0.1` открыть экземпляр могут только браузеры на этом Mac.

**2. Настройки приложения**

В `config/variables.env` задайте следующие значения, заменив все активные записи с теми же именами:

```dotenv title="config/variables.env" theme={null}
OVERLEAF_SITE_URL=http://localhost:8080
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES="TeX Live 2026"
```

Сгенерируйте секрет сеанса:

```bash theme={null}
openssl rand -hex 32
```

Добавьте результат как `OVERLEAF_SESSION_SECRET` в `config/variables.env`. Без него каждый запуск `bin/up`, пересоздающий контейнер, будет выводить из системы всех пользователей, см. [Переменные окружения](https://ayakaleaf-pro.mintlify.site/ru/on-premises/configuration/overleaf-toolkit/environment-variables.md).

Для локального экземпляра без электронной почты не задавайте настройки SMTP и `OVERLEAF_EMAIL_FROM_ADDRESS`. Git Bridge, внешнюю аутентификацию и другие интеграции можно добавить позже, следуя их [страницам конфигурации](https://ayakaleaf-pro.mintlify.site/ru/on-premises/configuration/overleaf-toolkit).

**3. Проверьте ядро Linux виртуальной машины Docker**

MongoDB работает на ядре Linux виртуальной машины Docker Desktop, а не на macOS. Проверьте его версию перед первым запуском:

```bash theme={null}
docker info --format '{{.KernelVersion}}'
```

MongoDB документирует несовместимость с ядрами Linux **с 6.19 по 7.0.13**, которая затрагивает и MongoDB в Docker. Решение — ядро **7.0.14 или новее**, которое приходит с обновлением Docker Desktop, см. [production notes MongoDB](https://www.mongodb.com/docs/manual/administration/production-notes/).

Если ваша виртуальная машина Docker использует затронутое ядро, добавьте следующее в `config/docker-compose.override.yml`, объединив с уже имеющимися там `services`:

```yaml title="config/docker-compose.override.yml" theme={null}
services:
  mongo:
    environment:
      GLIBC_TUNABLES: glibc.pthread.rseq=1
```

> [!WARNING]
>
> Обновитесь до исправленного ядра, когда оно станет доступно. Если ваше ядро не входит в затронутый диапазон, этот обходной путь не нужен.

**4. Запустите экземпляр**

В каталоге Toolkit выполните:

```bash theme={null}
bin/up -d
```

Toolkit инициализирует набор реплик MongoDB, загружает образ TeX Live и запускает приложение. Первая загрузка занимает некоторое время. Чтобы следить за ходом процесса:

```bash theme={null}
bin/docker-compose ps
bin/docker-compose logs --tail=100 -f sharelatex
```

Нажмите `Ctrl+C`, чтобы прекратить просмотр журналов. Контейнеры продолжат работать.

Проверьте опубликованный порт и страницу первого запуска:

```bash theme={null}
bin/docker-compose port sharelatex 80
curl -I http://localhost:8080/launchpad
```

Порт должен быть `127.0.0.1:8080`.

> [!NOTE]
>
> Чтобы позже открыть экземпляр с других компьютеров, измените адрес прослушивания и URL сайта и настройте HTTPS, как описано в разделе [5. Персонализация экземпляра](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/linux/5.-personalizing-your-instance.md) руководства для Linux. Тогда Mac должен оставаться в активном режиме, см. [Обеспечение доступности экземпляра](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available).

### Следующий шаг

Переходите к разделу [6. Действия после установки](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md).


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