> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/uk/konfiguraciya/overleaf-toolkit/environment-variables.md). # Змінні середовища Ця сторінка описує змінні середовища, які підтримуються у `config/variables.env` файлі для розгортань Toolkit. Поле `config/variables.env` файл складається з визначень змінних у формі `NAME=value`; рядки, що починаються з `#` розглядаються як коментарі. {% hint style="info" %} Потрібно повторно створити Docker-контейнери після зміни будь-чого у `overleaf.rc` або `variables.env` виконавши `bin/up`. {% endhint %} ### Усі версії Ці змінні середовища сумісні з Server CE і Server Pro та забезпечують простий шлях міграції між цими двома локальними версіями. Їх також можна використовувати як у розгортаннях Toolkit, так і Docker Compose. {% hint style="info" %} Раніше ці змінні середовища мали префікс `SHARELATEX_` замість `OVERLEAF_`. {% endhint %} | Назва | Опис | | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OVERLEAF_SITE_URL` | Де ваш екземпляр Overleaf доступний публічно. Це використовується в публічних посиланнях і під час підключення через WebSocket, тож має бути налаштовано правильно! | | `OVERLEAF_ADMIN_EMAIL` | Адреса електронної пошти, за якою користувачі можуть зв’язатися з людиною, що керує сайтом. | | `OVERLEAF_APP_NAME` | Назва, яка відображатиметься під час згадування запущеного застосунку. За замовчуванням — 'Overleaf (Community Edition)'. | | `OVERLEAF_MONGO_URL` та `MONGO_URL` | URL-адреса бази даних Mongo, яку слід використовувати. | | `OVERLEAF_REDIS_HOST` та `REDIS_HOST` | Ім’я хоста екземпляра Redis, який слід використовувати. Обидва потрібні (див. [примітки до випуску](broken://pages/58b95b8202378ee02ec6887a399ee99a646b98f2#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PORT` та `REDIS_PORT` | Порт екземпляра Redis, який слід використовувати. Обидва потрібні (див. [примітки до випуску](broken://pages/58b95b8202378ee02ec6887a399ee99a646b98f2#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PASS` та `REDIS_PASSWORD` | Пароль, який слід використовувати під час підключення до Redis (за наявності). **Обидва** змінні середовища потрібно встановити. Див. [увімкнення автентифікації за паролем](broken://pages/d0f1ab33cf61f8781bd5de57106b3307bc4a57d6) для отримання додаткової інформації. | | `OVERLEAF_REDIS_TLS` |

Якщо встановлено значення true, це дозволяє підключення до екземпляра Redis, що вимагає TLS.

Примітка: mTLS наразі не підтримується.

| | `OVERLEAF_NAV_TITLE` | Встановлює заголовок вкладки застосунку. | | `OVERLEAF_SESSION_SECRET` | Випадковий рядок, який використовується для захисту токенів; якщо використовується балансування навантаження, його потрібно встановити однаковим на всіх вузлах. Якщо запущено лише 1 екземпляр, користувачеві не потрібно його задавати. | | `OVERLEAF_COOKIE_SESSION_LENGTH` | Дозволяє перевизначити стандартний час дії сесійного cookie — 5 днів. Значення перевизначення має бути в мілісекундах. Приклад: щоб сесія тривала 1 годину, встановіть `COOKIE_SESSION_LENGTH=3600000`. (Додано в Server Pro 4.2) | | `OVERLEAF_TRUSTED_PROXY_IPS` | Якщо не встановлено, за замовчуванням `loopback`. Якщо встановлюєте вручну, окрім довірених IP-адрес, ви також маєте включити один із `loopback`, `localhost` або `127.0.0.1`, який довіряє екземпляру nginx, що працює всередині **sharelatex** контейнера.\n\nЯкщо ви використовуєте підмережу з `172.16.0.0/12` (стандартна підмережа для мереж Docker) для вашої звичайної мережі, будь ласка, встановіть `OVERLEAF_TRUSTED_PROXY_IPS=loopback,` у вашому `config/variables.env`. Де `` — це `IPAM -> Config -> Subnet` значення у `docker inspect overleaf_default`, напр. `OVERLEAF_TRUSTED_PROXY_IPS=loopback,172.19.0.0/16`. Це потрібно, щоб запобігти підробці `X-Forwarded` заголовків.\n\nЯкщо ви використовуєте зовнішній TLS-проксі (тобто не керований Overleaf Toolkit), переконайтеся, що `OVERLEAF_TRUSTED_PROXY_IPS=loopback,`, напр. `OVERLEAF_TRUSTED_PROXY_IPS=loopback,192.168.13.37`. | | `OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS` | Якщо встановлено значення `true`, обмежить запрошення до проєктів адресами електронної пошти, що відповідають наявним обліковим записам користувачів. | | `OVERLEAF_ALLOW_PUBLIC_ACCESS` | Якщо встановлено значення `true`, дозволить неавтентифікованим користувачам переглядати сайт. За замовчуванням — `false`, що означає, що неавтентифіковані користувачі безумовно перенаправлятимуться на сторінку входу, коли спробують переглянути будь-яку частину сайту. Зверніть увагу: встановлення цього параметра жодним чином не вимикає автентифікацію чи безпеку. Цей параметр необхідний, якщо ваші користувачі планують зробити свої проєкти загальнодоступними й дозволити неавтентифікованим користувачам переглядати ці проєкти. | | `OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING` | Якщо встановлено значення `true`, дозволить анонімним користувачам переглядати та редагувати проєкти, якими поділилися через [обмін посиланнями](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) функцію. | | `OVERLEAF_DISABLE_LINK_SHARING` | Вимикає [обмін посиланнями](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) функцію. | | `EMAIL_CONFIRMATION_DISABLED` | Коли встановлено `true` банер із запитом підтвердження електронної пошти не відображатиметься. | | `ADDITIONAL_TEXT_EXTENSIONS` | Масив рядків для налаштування додаткових розширень для редагованих файлів. | | `OVERLEAF_STATUS_PAGE_URL` | Користувацька URL-адреса сторінки статусу (додано в Server Pro 3.4.0), напр. `status.example.com`. | | `OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS` | Встановіть значення `'false'` щоб запобігти ініціалізації нових проєктів із Full Project History (додано в Server Pro 3.5.0). | | `OVERLEAF_FPH_DISPLAY_NEW_PROJECTS` | Встановіть значення `'false'` щоб запобігти відображенню для нових проєктів Full Project History замість застарілої історії (додано в Server Pro 3.5.0). | | `ENABLE_CRON_RESOURCE_DELETION` | Установіть цю змінну середовища значенням `true` щоб увімкнути автоматичне очищення видалених проєктів і користувачів через 90 днів. | | `OVERLEAF_USER_HARD_DELETION_DELAY` |

Використовується для зміни затримки до завершення терміну зберігання видалених користувачів. Налаштовується в мілісекундах.

За замовчуванням: 90 днів

| | `OVERLEAF_PROJECT_HARD_DELETION_DELAY` |

Використовується для зміни затримки до завершення терміну зберігання видалених проєктів. Налаштовується в мілісекундах.

За замовчуванням: 90 днів

| | `MAX_UPLOAD_SIZE` |

Керує максимальною розміром окремого завантаження в мегабайтах. За замовчуванням — 50.

Увага: Ця змінна — це лише необроблене число, без одиниці (MB) або обгортки.

| | `COMPILE_SIZE_LIMIT` | Керує максимальною розміром тіла запиту в байтах. Це сума всіх розмірів файлів документів у межах проєкту (`main.tex`, `references.bib` (якщо не пов’язано) тощо), яку потрібно надіслати в початковому запиті на компіляцію до служби CLSI. | | `COMPILE_TIMEOUT` | Час у секундах, відведений на завершення компіляції. Докладніше див. [Оновлення тайм-ауту компіляції проєкту](broken://pages/e2e9e61c756c0e103aab002a8ff9e029bc755fc4#updating-project-compile-timeout). | | `MAX_RECONNECT_GRACEFULLY_INTERVAL_MS` | Налаштовувана затримка між коректним повторним підключенням редактора, скиданням даних і завершенням роботи контейнера, щоб зменшити ризик втрати даних. | | `SECCOMP_PROFILE` | Установіть цю змінну середовища на шлях на Docker **хост-машині** машині, що вказує на профіль SECCOMP. Ви можете завантажити копію профілю [тут](https://raw.githubusercontent.com/overleaf/overleaf/365af778b68a7940e08282119dc4ef473e2f0044/services/clsi/seccomp/clsi-profile.json).\n\nНаразі потрібно для розгортань Podman під час використання Sandboxed Compiles. | | `OVERLEAF_DISABLE_CHAT` | Якщо встановлено значення `true`, вимикає функцію чату в межах проєкту. | | `OVERLEAF_LOGIN_SUPPORT_TEXT` | Коли встановлено, може використовуватися для відображення інформації про підтримку під кнопкою входу. Текст відображатиметься на екрані входу і може використовуватися, щоб спрямувати користувачів до внутрішньої підтримки або надати вказівки щодо входу, створення облікових записів тощо. | | `ALLOW_MONGO_ADMIN_CHECK_FAILURES` | Якщо встановлено значення `true`, дозволяє перевіркам запуску MongoDB завершуватися з помилкою і не перешкоджати запуску розгортання. Це може знадобитися, якщо ви використовуєте базу даних MongoDB, у якій ваш користувач бази даних не має `clusterParameterReader` ролі.\n\nЩоб отримати допомогу зі створенням користувацької ролі, див. [тут](broken://pages/5302ced6aa02411bcff70583365421f47db11948#creating-a-custom-role). | | `V1_HISTORY_URL_FOR_GIT_BRIDGE` | Дозволяє розділити **history-v1** кінцеву точку для внутрішнього трафіку (`web` сервіс → `history-v1` сервіс, обидва у `sharelatex` контейнері) та зовнішнього трафіку (`git-bridge` → `history-v1`, що працюють у окремих контейнерах). | | `OVERLEAF_MAINTENANCE_MESSAGE` та `OVERLEAF_MAINTENANCE_MESSAGE_HTML` | Використовується для налаштування заголовка та вмісту сторінки обслуговування. Не може використовуватися разом із `OVERLEAF_STATUS_PAGE_URL`. | {% hint style="info" %} Можна примусово застосовувати обмеження паролів для користувачів під час використання системи входу Overleaf (локальні облікові записи), але не для варіанту SSO, такого як LDAP. Для облікових записів SSO політики паролів застосовуватиме ваш постачальник ідентифікації або служба каталогів, що додатково забезпечує підтримку багатофакторної автентифікації. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/on-premises/uk/konfiguraciya/overleaf-toolkit/environment-variables.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.