> 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/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://ayakaleaf-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.