5. Персоналізація вашого екземпляра

​

Персоналізація вашого екземпляра

Перш ніж уперше запустити свій екземпляр Overleaf, внесіть власні дані в конфігураційний файл config/variables.env.

1. Відредагуйте файл змінних

   Відкрийте config/variables.env у своєму улюбленому текстовому редакторі й укажіть потрібні значення для наведених нижче змінних середовища.

2. Обов'язкові змінні середовища

   Оновіть такі змінні в config/variables.env:

   Назва	Опис	Приклад
   OVERLEAF_SITE_URL	Адреса, за якою ваш екземпляр Overleaf публічно доступний. Вона використовується в публічних посиланнях і під час підключення через вебсокети, тому має бути налаштована правильно!	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	Ця адреса електронної пошти використовуватиметься як адреса from для всіх вихідних листів.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	Адреса електронної пошти, за якою користувачі можуть зв’язатися з людиною, що обслуговує сайт.	[e-mail]

   Оновивши ці змінні середовища, збережіть файл і закрийте редактор.

3. Налаштуйте ізольовану компіляцію

   Далі налаштуйте TeX Live Full для sandboxed-compiles.md. Відкрийте config/variables.env і оновіть такі змінні середовища:

   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. Запустіть свій екземпляр

   Щоб запустити екземпляр, виконайте:

   Start the instance

   bin/up
   

   Ця команда завантажить потрібні образи, зокрема texlive, створить контейнери (з урахуванням ваших налаштувань) і запустить екземпляр. Ви побачите журнали різних Docker-контейнерів.

   Щоб пізніше запустити їх знову (без під’єднання до виводу журналів), виконайте:

   Start without attaching to logs

   bin/start
   

Toolkit використовує docker compose для керування Docker-контейнерами Overleaf. Toolkit надає набір скриптів-обгорток над docker compose, які беруть на себе більшість деталей.

Якщо все пройшло успішно, ви зможете побачити сторінку входу свого нового екземпляра Overleaf, перейшовши в браузері за адресою http://127.0.0.1/ або http://localhost/.

Залежно від конфігурації вашої мережі та місця розміщення екземпляра Overleaf може знадобитися внести додаткові зміни в конфігурацію. Докладніше див. у налаштуваннях Toolkit: toolkit-settings.md