> 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/ru/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/14e3a99831712fbed641777e9989c81f73f12a3c) разделе.

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

Поле `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/ru/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.