> 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/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. Він містить інструкції, що задають змінні, у форматі: `ІМ’Я_ЗМІННОЇ=значення`

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

### Поле `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://overleaf-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.