> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/uk/konfiguraciya/overleaf-toolkit/files-and-locations.md).

# Файли та розташування

Ця сторінка описує файли конфігурації, які використовує Toolkit для налаштування вашого локального розгортання Overleaf.

### Постійні дані

Overleaf Toolkit потрібно зберігати постійні дані, такі як файли, необхідні для компіляції проєктів LaTeX, і вміст бази даних MongoDB. Це досягається шляхом монтування кількох каталогів із хост-машини в контейнери Docker і запису даних у ці каталоги.

#### Каталоги даних

Поле `контейнера sharelatex` контейнеру потрібен каталог, у якому зберігати дані, пов’язані зі збиранням LaTeX. Цей каталог задається за допомогою `OVERLEAF_DATA_PATH` змінної в `config/overleaf.rc`.

Поле `mongo` контейнер, якщо його ввімкнено, потребує каталогу для зберігання файлів своєї бази даних, і те саме стосується `redis` контейнера. Ці каталоги також можна налаштувати у `config/overleaf.rc`.

#### Права доступу до файлів

Оскільки Docker запускається як `root`, каталоги даних будуть у власності `root` користувача, навіть якщо Toolkit використовується користувачем без прав root. Це не є проблемою, але про це варто знати, якщо ви маєте намір змінювати постійні дані з-поза меж контейнерів.

### Розташування файлів конфігурації

Усі файли конфігурації, що належать користувачу, знаходяться в `config/` каталозі.

Цей каталог **виключено** із системи керування версіями git, тож він не буде змінюватися під час оновлення коду Toolkit. Toolkit не буде **не** змінювати будь-які дані в `config/` каталозі без вашого дозволу.

{% hint style="info" %}
Зміни до файлів конфігурації не будуть автоматично застосовані до наявних контейнерів, навіть якщо контейнер зупинити й перезапустити (за допомогою `bin/stop` та `bin/start`). Щоб застосувати зміни, запустіть `bin/up`, а у фоновому режимі `docker compose` автоматично застосує зміни конфігурації до нового контейнера. (Або запустіть `bin/up -d`, якщо ви не хочете підключатися до журналів Docker.)
{% endhint %}

### Поле `overleaf.rc` файл

Поле `config/overleaf.rc` файл містить найважливіші верхньорівневі параметри конфігурації, які використовує Toolkit. Він містить інструкції, що задають змінні, у форматі: `VARIABLE_NAME=value`

Щоб переглянути розбір усіх доступних параметрів конфігурації, див. розділ налаштувань.

### Поле `variables.env` файл

Поле `config/variables.env` файл містить змінні середовища, які завантажуються в `контейнера sharelatex` контейнер і використовуються для налаштування мікросервісів Overleaf. До них належать назва застосунку, що відображається в заголовку вебінтерфейсу, параметри надсилання електронних листів та інші преміумналаштування, такі як SSO для використання з Server Pro.

Щоб переглянути розбір усіх доступних змінних середовища, див.  [Змінні середовища](broken://pages/2db6c85df4994d46e27a99e0d121414d97e0f879) розділі.

### Поле `версія` файл

Поле `config/version` файл містить номер версії образу Docker, який буде використано для створення запущеного екземпляра вашого сервера Overleaf.

{% hint style="info" %}
Зміни до цих файлів конфігурації не будуть автоматично застосовані до наявних контейнерів, навіть якщо контейнер зупинити й перезапустити (за допомогою `bin/stop` та `bin/start`). Щоб застосувати ваші зміни, запустіть `bin/up`, і Toolkit автоматично створить для вас новий контейнер із застосованими змінами конфігурації.
{% endhint %}

### Поле `docker-compose.override.yml` файл

Якщо наявний, `config/docker-compose.override.yml` файл буде включено до виклику `docker compose`. Це корисно для перевизначення конфігурації, специфічної для Docker Compose.

Див.  [документацію docker-compose](https://docs.docker.com/compose/extends/#adding-and-overriding-configuration) для отримання додаткових відомостей.


---

# 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://ayakaleaf-pro.ayaka.space/on-premises/uk/konfiguraciya/overleaf-toolkit/files-and-locations.md?ask=<question>&goal=<endgoal>
```

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