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

# Toolkit 설정

이 페이지에서는 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>Server Pro/CE 애플리케이션 컨테이너에서 사용하는 Docker 이미지입니다. 이는 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>git-bridge 컨테이너(Server Pro 전용)에서 사용하는 Docker 이미지입니다. 이는 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>호스트 머신( Toolkit를 실행 중인 머신)의 Docker 소켓 경로를 설정합니다. When <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의 기준 디렉터리에 대한 상대 경로일 수도 있습니다. 바인드 마운트를 비활성화하려면 설정 항목을 제거하세요. 설정되지 않으면 컨테이너를 다시 만들 때 로그가 폐기됩니다.<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>다음일 때 사용할 MongoDB 연결 URL을 지정합니다 <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>MongoDB 컨테이너에서 사용하는 Docker 이미지입니다. 이는 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>Redis에 대해 AOF (Append Only File) 지속성을 켭니다. 이는 <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가 TLS 프록시 역할을 하는 NGINX 컨테이너를 생성하도록 지시합니다.<br><br>- <strong>기본값</strong>: <code>false</code></p>                                                                                                                                                                                                                              |
| `NGINX_CONFIG_PATH`    | <p>TLS 프록시에 사용할 NGINX 설정 파일의 경로.<br><br>- <strong>기본값</strong>: <code>config/nginx/nginx.conf</code></p>                                                                                                                                                                                                                                                            |
| `NGINX_TLS_LISTEN_IP`  | <p>TLS 프록시 컨테이너가 HTTPS를 위해 바인딩할 호스트 IP 주소(들)를 설정합니다. 예를 들어, 이 값이 다음으로 설정되면 <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>TLS 프록시 컨테이너가 HTTP 리디렉션을 위해 바인딩할 호스트 IP 주소(들)를 설정합니다. 예를 들어, 이 값이 다음으로 설정되면 <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/ko/configuration/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.