5. Personalizacja instancji

​

Personalizacja instancji

Przed pierwszym uruchomieniem instancji Overleaf zaktualizuj plik konfiguracyjny config/variables.env, wprowadzając własne dane.

1. Edytuj plik zmiennych

   Otwórz config/variables.env w ulubionym edytorze tekstu i zaktualizuj poniższe zmienne środowiskowe, podając wymagane wartości.

2. Wymagane zmienne środowiskowe

   Zaktualizuj następujące zmienne w config/variables.env:

   Nazwa	Opis	Przykład
   OVERLEAF_SITE_URL	Adres, pod którym Twoja instancja Overleaf jest publicznie dostępna. Jest używany w linkach publicznych oraz przy połączeniach przez websockety, więc musi być poprawnie skonfigurowany!	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	Ten adres e-mail będzie używany jako adres from (nadawca) we wszystkich wychodzących wiadomościach e-mail.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	Adres e-mail, pod którym użytkownicy mogą skontaktować się z osobą zarządzającą witryną.	[e-mail]

   Po zaktualizowaniu tych zmiennych środowiskowych zapisz plik i zamknij edytor.

3. Skonfiguruj Sandbox Compile

   Następnie skonfiguruj TeX Live Full dla sandboxed-compiles.md. Otwórz config/variables.env i zaktualizuj następujące zmienne środowiskowe:

   config/variables.env

   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   
4. Uruchom instancję

   Aby uruchomić instancję, wykonaj:

   Start the instance

   bin/up
   

   To polecenie pobierze wymagane obrazy, w tym texlive, utworzy kontenery (z uwzględnieniem Twoich ustawień) i uruchomi instancję. Powinieneś zobaczyć logi z poszczególnych kontenerów Dockera.

   Aby później ponownie uruchomić kontenery (bez podłączania się do logów), wykonaj:

   Start without attaching to logs

   bin/start
   

Toolkit używa docker compose do zarządzania kontenerami Dockera Overleaf. Toolkit udostępnia zestaw skryptów, które opakowują docker compose i zajmują się większością szczegółów za Ciebie.

Jeśli wszystko pójdzie dobrze, powinieneś zobaczyć stronę logowania nowej instancji Overleaf, przechodząc w przeglądarce pod adres http://127.0.0.1/ lub http://localhost/.

W zależności od konfiguracji sieci i miejsca hostowania instancji Overleaf może być konieczne wprowadzenie dodatkowych zmian w konfiguracji. Więcej informacji znajdziesz w ustawieniach Toolkit: toolkit-settings.md