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

> Ustaw port, adres URL witryny i obraz TeX Live dla lokalnej instancji na Macu, sprawdź jądro maszyny wirtualnej Dockera i uruchom Ayakaleaf Pro.

**1. Ustawienia kontenerów**

Zmień te istniejące wpisy w `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
```

Zachowaj domyślne ścieżki danych oraz dołączone usługi MongoDB i Redis. Przy `OVERLEAF_LISTEN_IP=127.0.0.1` instancję mogą otworzyć tylko przeglądarki na tym Macu.

**2. Ustawienia aplikacji**

W `config/variables.env` ustaw te wartości, zastępując wszystkie aktywne wpisy o tych samych nazwach:

```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"
```

Wygeneruj sekret sesji:

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

Dodaj wynik jako `OVERLEAF_SESSION_SECRET` w `config/variables.env`. Bez niego każde `bin/up`, które odtwarza kontener, wylogowuje wszystkich użytkowników, zobacz [Zmienne środowiskowe](https://ayakaleaf-pro.mintlify.site/pl/on-premises/configuration/overleaf-toolkit/environment-variables.md).

Dla lokalnej instancji bez poczty e-mail pozostaw nieustawione ustawienia SMTP oraz `OVERLEAF_EMAIL_FROM_ADDRESS`. Git Bridge, uwierzytelnianie zewnętrzne i inne integracje możesz dodać później, korzystając z ich [stron konfiguracji](https://ayakaleaf-pro.mintlify.site/pl/on-premises/configuration/overleaf-toolkit).

**3. Sprawdź jądro Linux maszyny wirtualnej Dockera**

MongoDB działa na jądrze Linux maszyny wirtualnej Docker Desktop, a nie na macOS. Sprawdź jego wersję przed pierwszym uruchomieniem:

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

MongoDB dokumentuje niezgodność z jądrami Linux od **6.19 do 7.0.13**, która dotyczy również MongoDB w Dockerze. Rozwiązaniem jest jądro **7.0.14 lub nowsze**, dostarczane wraz z aktualizacją Docker Desktop, zobacz [uwagi produkcyjne MongoDB](https://www.mongodb.com/docs/manual/administration/production-notes/).

Jeśli maszyna wirtualna Dockera używa jądra z tego zakresu, dodaj poniższy fragment do `config/docker-compose.override.yml`, scalając go z sekcją `services`, którą już tam masz:

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

> [!WARNING]
>
> Zaktualizuj do poprawionego jądra, gdy będzie dostępne. Jeśli Twoje jądro jest spoza tego zakresu, to obejście jest niepotrzebne.

**4. Uruchom instancję**

W katalogu Toolkit uruchom:

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

Toolkit inicjalizuje zestaw replik MongoDB, pobiera obraz TeX Live i uruchamia aplikację. Pierwsze pobieranie trwa chwilę. Aby śledzić postęp:

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

Naciśnij `Ctrl+C`, aby przestać śledzić logi. Kontenery nadal działają.

Sprawdź opublikowany port i stronę pierwszego uruchomienia:

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

Port powinien mieć postać `127.0.0.1:8080`.

> [!NOTE]
>
> Aby później otworzyć instancję z innych komputerów, zmień adres nasłuchiwania i adres URL witryny oraz skonfiguruj HTTPS, zgodnie z opisem w kroku [5. Personalizacja instancji](https://ayakaleaf-pro.mintlify.site/pl/on-premises/installation/using-docker-compose/linux/5.-personalizing-your-instance.md) przewodnika dla systemu Linux. Mac musi wtedy pozostawać wybudzony, zobacz [Utrzymywanie dostępności instancji](https://ayakaleaf-pro.mintlify.site/pl/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available).

### Następny krok

Przejdź do kroku [6. Zadania poinstalacyjne](https://ayakaleaf-pro.mintlify.site/pl/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.