> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Файлы и расположение

На этой странице описаны конфигурационные файлы, которые 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/` без вашего разрешения.

<Info>
  Изменения в конфигурационных файлах не применяются автоматически к существующим контейнерам, даже если контейнер остановить и снова запустить (с помощью `bin/stop` и `bin/start`). Чтобы применить изменения, выполните `bin/up` — в фоновом режиме `docker compose` автоматически применит изменения конфигурации к новому контейнеру. (Или выполните `bin/up -d`, если не хотите подключаться к логам Docker.)
</Info>

### Файл `overleaf.rc`

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

Подробное описание всех доступных параметров конфигурации см. в нашем разделе о настройках.

### Файл `variables.env`

Файл `config/variables.env` содержит переменные окружения, которые загружаются в контейнер `sharelatex` и используются для настройки микросервисов Overleaf. Среди них — название приложения, отображаемое в заголовке веб-интерфейса, параметры отправки электронной почты и другие премиальные настройки, например SSO для Server Pro.

Подробное описание всех доступных переменных окружения см. в разделе [Переменные окружения](/ru/on-premises/configuration/overleaf-toolkit/environment-variables).

### Файл `version`

Файл `config/version` содержит номер версии Docker-образа, который будет использоваться для создания работающего экземпляра вашего сервера Overleaf.

<Info>
  Изменения в этих конфигурационных файлах не применяются автоматически к существующим контейнерам, даже если контейнер остановить и снова запустить (с помощью `bin/stop` и `bin/start`). Чтобы применить изменения, выполните `bin/up`, и Toolkit автоматически создаст для вас новый контейнер с применёнными изменениями конфигурации.
</Info>

### Файл `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).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.