> 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/toolkit-settings.md).

# Настройки Toolkit

На этой странице описаны переменные среды, поддерживаемые в `config/overleaf.rc` файле для развёртываний Toolkit.

Поле `config/overleaf.rc` файл состоит из определений переменных в формате `NAME=value`. Строки, начинающиеся с `#` считаются комментариями.

{% hint style="info" %}
Необходимо пересоздать контейнеры Docker после изменения чего-либо в `overleaf.rc` или `variables.env` с помощью `bin/up`.
{% endhint %}

## Контейнер

### `sharelatex`

| Имя                          | Описание                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PROJECT_NAME`               | <p>Устанавливает значение <code>--project-name</code> флага, передаваемого в <code>docker-compose</code>. Это полезно при запуске нескольких экземпляров Overleaf на одном хосте, так как у каждого экземпляра может быть разное имя проекта.<br><br>- <strong>По умолчанию</strong>: <code>overleaf</code></p>                                                                                                                                                                                                                              |
| `OVERLEAF_IMAGE_NAME`        | <p>Docker-образ, используемый контейнером приложения Server Pro/CE. Здесь указано только имя Docker-образа; тег Docker-образа берётся из <code>config/version</code>.<br><br>- <strong>По умолчанию:</strong><br>- Server Pro: <code>quay.io/sharelatex/sharelatex-pro</code><br>- Community Edition: <code>sharelatex/sharelatex</code></p>                                                                                                                                                                                                 |
| `SERVER_PRO`                 | <p>Если установлено в <code>true</code>, указывает Toolkit использовать образ Server Pro (<code>quay.io/sharelatex/sharelatex-pro</code>), а не образ Server CE по умолчанию (<code>sharelatex/sharelatex</code>).<br><br>- <strong>По умолчанию</strong>: <code>false</code></p>                                                                                                                                                                                                                                                            |
| `GIT_BRIDGE_ENABLED`         | <p>Установите в <code>true</code> для включения функции git-bridge (только Server Pro). Подробнее см. в <a href="https://www.overleaf.com/learn/how-to/Git_integration"><https://www.overleaf.com/learn/how-to/Git_integration></a> документации для пользователей.<br><br>- <strong>По умолчанию:</strong> <code>false</code></p>                                                                                                                                                                                                           |
| `GIT_BRIDGE_IMAGE`           | <p>Docker-образ, используемый контейнером git-bridge (только Server Pro). Здесь указано только имя Docker-образа; тег Docker-образа берётся из <code>config/version</code>.<br><br>- <strong>По умолчанию:</strong> <code>quay.io/sharelatex/git-bridge</code></p>                                                                                                                                                                                                                                                                           |
| `GIT_BRIDGE_DATA_PATH`       | Задаёт путь к каталогу, который будет смонтирован в `git-bridge` контейнер (только Server Pro) и использован для хранения git-репозиториев. Это может быть либо полный путь (начинающийся с `/`), либо относительный путь к базовому каталогу Toolkit.                                                                                                                                                                                                                                                                                       |
| `GIT_BRIDGE_LOG_LEVEL`       | <p>Настраивает уровень логирования <code>git-bridge</code> контейнера. Доступные уровни: <code>TRACE</code>, <code>DEBUG</code>, <code>INFO</code>, <code>WARN</code>, <code>ERROR</code>.<br><br>- <strong>По умолчанию:</strong> <code>INFO</code></p>                                                                                                                                                                                                                                                                                     |
| `SIBLING_CONTAINERS_ENABLED` | <p>Если установлено в <code>true</code>, указывает Toolkit использовать <strong>Sibling Containers</strong> технику для компиляции проектов в отдельных песочницах, используя отдельный Docker-контейнер для каждого проекта. Подробнее см. документацию \<server-pro-only-configuration/sandboxed-compiles>.<br><br>- <strong>Требуется:</strong> <code>SERVER\_PRO=true</code><br>- <strong>По умолчанию:</strong> <code>true</code></p>                                                                                                   |
| `SIBLING_CONTAINERS_PULL`    | <p>Если установлено в <code>true</code>, указывает Toolkit автоматически загружать все образы TeX Live, заданные с помощью <code>ALL\_TEX\_LIVE\_DOCKER\_IMAGES</code> в <strong>config/variables.env</strong> файл при использовании <code>bin/up</code> команды.<br><br>- <strong>По умолчанию:</strong> <code>true</code></p>                                                                                                                                                                                                             |
| `DOCKER_SOCKET_PATH`         | <p>Задаёт путь к сокету Docker на хост-машине (машине, на которой запущен Toolkit). Когда <code>SIBLING\_CONTAINERS\_ENABLED</code> равно <code>true</code>, сокет будет смонтирован в контейнер, чтобы позволить сервису компилятора создавать новые Docker-контейнеры на хосте.<br><br>- <strong>Требуется:</strong> <code>SIBLING\_CONTAINERS\_ENABLED=true</code><br>- <strong>По умолчанию:</strong> <code>/var/run/docker.sock</code></p>                                                                                              |
| `OVERLEAF_DATA_PATH`         | <p>Задаёт путь к каталогу, который будет смонтирован в основной <code>sharelatex</code> контейнер и использован для хранения данных сборки. Это может быть либо полный путь (начинающийся с <code>/</code>), либо относительный путь к базовому каталогу Toolkit.<br><br>- <strong>По умолчанию:</strong> <code>data/overleaf</code></p>                                                                                                                                                                                                     |
| `OVERLEAF_LISTEN_IP`         | <p>Задаёт IP-адрес(а) хоста, к которым будет привязан контейнер. Например, если это установлено в <code>0.0.0.0</code>, тогда веб-интерфейс будет доступен по любому IP-адресу хоста. Для прямого доступа к контейнеру значение <code>OVERLEAF\_LISTEN\_IP</code> должно быть установлено в ваш публичный IP-адрес. Установка <code>OVERLEAF\_LISTEN\_IP</code> в <code>0.0.0.0</code> или внешний IP вашего хоста обычно приводит к ошибкам при использовании вместе с .<br><br>- <strong>По умолчанию:</strong> <code>127.0.0.1</code></p> |
| `OVERLEAF_PORT`              | <p>Задаёт порт хоста, к которому будет привязан контейнер. Например, если это установлено в <code>8099</code> и <code>OVERLEAF\_LISTEN\_IP</code> установлено в <code>127.0.0.1</code>, тогда веб-интерфейс будет доступен по адресу <code><http://localhost:8099></code>.<br><br>- <strong>По умолчанию:</strong> <code>80</code></p>                                                                                                                                                                                                       |
| `OVERLEAF_LOG_PATH`          | <p>Задаёт путь к каталогу, который будет смонтирован в основной <code>sharelatex</code> контейнер и используется для предоставления журналов приложения на хосте Docker. Это может быть либо полный путь (начинающийся с <code>/</code>), либо относительный путь к базовому каталогу Toolkit. Удалите запись конфигурации, чтобы отключить bind-mount. Если не задано, журналы будут удаляться при повторном создании контейнера.<br><br>См. информацию о ведении журналов в .<br><br>- <strong>По умолчанию:</strong> не задано</p>        |

***

### `mongo`

| Имя               | Описание                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `MONGO_ENABLED`   | <p>Если установлено в <code>true</code>, указывает Toolkit создать контейнер MongoDB для размещения базы данных. Когда установлено в <code>false</code>, этот контейнер не будет создан, и система будет использовать базу данных MongoDB, указанную <code>MONGO\_URL</code> вместо этого.<br><br>- <strong>По умолчанию</strong>: <code>true</code></p>                                                                                                                       |
| `MONGO_URL`       | <p>Указывает URL подключения MongoDB, который следует использовать, когда <code>MONGO\_ENABLED</code> равно <code>false</code>.<br><br>- <strong>По умолчанию</strong>: не задано</p>                                                                                                                                                                                                                                                                                          |
| `MONGO_DATA_PATH` | <p>Задаёт путь к каталогу, который будет смонтирован в <code>mongo</code> контейнер и использован для хранения базы данных MongoDB. Это может быть либо полный путь (начинающийся с <code>/</code>), либо относительный путь к базовому каталогу toolkit. Эта опция влияет только на локальный <code>mongo</code> контейнер, который создаётся, когда <code>MONGO\_ENABLED</code> равно <code>true</code>.<br><br>- <strong>По умолчанию</strong>: <code>data/mongo</code></p> |
| `MONGO_IMAGE`     | <p>Docker-образ, используемый контейнером MongoDB. Здесь указано только имя Docker-образа; тег Docker-образа следует поместить в <code>MONGO\_VERSION</code> (см. ниже).<br><br>- <strong>По умолчанию:</strong> <code>mongo</code></p>                                                                                                                                                                                                                                        |
| `MONGO_VERSION`   | <p>Версия MongoDB, используемая контейнером MongoDB. Значение должно начинаться с основной версии MongoDB и точки, например <code>6.0</code> или <code>6.0-with-suffix</code>.<br><br>- <strong>По умолчанию:</strong> <code>6.0</code></p>                                                                                                                                                                                                                                    |

***

### `redis`

| Имя                     | Описание                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `REDIS_ENABLED`         | <p>Если установлено в <code>true</code>, указывает Toolkit создать контейнер Redis для размещения базы данных Redis. Когда установлено в <code>false</code>, этот контейнер не будет создан, и система будет использовать базу данных Redis, указанную <code>REDIS\_HOST</code> и <code>REDIS\_PORT</code> вместо этого.<br><br>- <strong>По умолчанию</strong>: <code>true</code></p>                                                                                       |
| `REDIS_HOST`            | <p>Указывает хост Redis, который следует использовать, когда <code>REDIS\_ENABLED</code> равно <code>false</code>.<br><br>- <strong>По умолчанию</strong>: не задано</p>                                                                                                                                                                                                                                                                                                     |
| `REDIS_PORT`            | <p>Указывает порт Redis, который следует использовать, когда <code>REDIS\_ENABLED</code> равно <code>false</code>.<br><br>- <strong>По умолчанию</strong>: не задано</p>                                                                                                                                                                                                                                                                                                     |
| `REDIS_DATA_PATH`       | <p>Задаёт путь к каталогу, который будет смонтирован в <code>redis</code> контейнер и использован для хранения базы данных Redis. Это может быть либо полный путь (начинающийся с <code>/</code>), либо относительный путь к базовому каталогу Toolkit. Эта опция влияет только на локальный <code>redis</code> контейнер, который создаётся, когда <code>REDIS\_ENABLED</code> равно <code>true</code>.<br><br>- <strong>По умолчанию</strong>: <code>data/redis</code></p> |
| `REDIS_AOF_PERSISTENCE` | <p>Включает постоянство AOF (Append Only File) для Redis. Это <strong>рекомендуемая</strong> конфигурация для постоянства Redis.<br><br>Дополнительные сведения см. в разделе <../../../maintenance/data-and-backups#aof-append-only-file> в <../../maintenance/data-and-backups>.<br><br>- <strong>По умолчанию:</strong> <code>true</code></p>                                                                                                                             |

***

### `nginx`

| Имя                    | Описание                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `NGINX_ENABLED`        | <p>Если установлено в <code>true</code>, указывает Toolkit создать контейнер NGINX, который будет выступать в качестве TLS-прокси.<br><br>- <strong>По умолчанию</strong>: <code>false</code></p>                                                                                                                                                                                                                                                                                                               |
| `NGINX_CONFIG_PATH`    | <p>Путь к файлу конфигурации NGINX, используемому для TLS-прокси.<br><br>- <strong>По умолчанию</strong>: <code>config/nginx/nginx.conf</code></p>                                                                                                                                                                                                                                                                                                                                                              |
| `NGINX_TLS_LISTEN_IP`  | <p>Задаёт IP-адрес(а) хоста, к которым контейнер TLS-прокси будет привязан для HTTPS. Например, если это установлено в <code>0.0.0.0</code> тогда HTTPS-веб-интерфейс будет доступен по любому IP-адресу хоста. Обычно это следует установить на внешний IP вашего хоста.<br><br>- <strong>По умолчанию</strong>: <code>127.0.1.1</code></p>                                                                                                                                                                    |
| `NGINX_HTTP_LISTEN_IP` | <p>Задаёт IP-адрес(а) хоста, к которым контейнер TLS-прокси будет привязан для перенаправления HTTP. Например, если это установлено в <code>127.0.1.1</code> тогда HTTP-соединения с <code>127.0.1.1</code> будут перенаправляться на HTTPS-веб-интерфейс. Обычно это следует установить на внешний IP вашего хоста. Не устанавливайте его в <code>0.0.0.0</code> , так как это обычно вызовет конфликт с <code>OVERLEAF\_LISTEN\_IP</code>.<br><br>- <strong>По умолчанию</strong>: <code>127.0.1.1</code></p> |
| `NGINX_HTTP_PORT`      | <p>Задаёт порт хоста, к которому контейнер TLS-прокси будет привязан для HTTP.<br><br>- <strong>По умолчанию</strong>: <code>80</code></p>                                                                                                                                                                                                                                                                                                                                                                      |
| `TLS_PORT`             | <p>Задаёт порт хоста, к которому контейнер TLS-прокси будет привязан для HTTPS.<br><br>- <strong>По умолчанию</strong>: <code>443</code></p>                                                                                                                                                                                                                                                                                                                                                                    |
| `TLS_PRIVATE_KEY_PATH` | <p>Путь к закрытому ключу, используемому для TLS-прокси.<br><br>- <strong>По умолчанию</strong>: <code>config/nginx/certs/overleaf\_key.pem</code></p>                                                                                                                                                                                                                                                                                                                                                          |
| `TLS_CERTIFICATE_PATH` | <p>Путь к публичному сертификату, используемому для TLS-прокси.<br><br>- <strong>По умолчанию</strong>: <code>config/nginx/certs/overleaf\_certificate.pem</code></p>                                                                                                                                                                                                                                                                                                                                           |


---

# 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/toolkit-settings.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.
