> ## 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/uk/on-premises/configuration/overleaf-toolkit/environment-variables.md).

Для локального екземпляра без електронної пошти не задавайте налаштування SMTP та `OVERLEAF_EMAIL_FROM_ADDRESS`. Git Bridge, зовнішню автентифікацію та інші інтеграції можна додати пізніше за допомогою відповідних [сторінок конфігурації](https://ayakaleaf-pro.mintlify.site/uk/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, див. [примітки 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/uk/on-premises/installation/using-docker-compose/linux/5.-personalizing-your-instance.md) посібника для Linux. Тоді Mac має залишатися активним, див. [Підтримання доступності екземпляра](https://ayakaleaf-pro.mintlify.site/uk/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available).

### Наступний крок

Переходьте до розділу [6. Завдання після встановлення](https://ayakaleaf-pro.mintlify.site/uk/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.