> 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/ko/configuration/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>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 컨테이너에서 사용하는 Docker 이미지입니다(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>호스트 머신(즉, Toolkit을 실행 중인 머신)의 Docker 소켓 경로를 설정합니다. 이때 <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의 기본 디렉터리를 기준으로 한 상대 경로일 수 있습니다. 바인드 마운트를 비활성화하려면 config 항목을 제거하세요. 설정되지 않으면 컨테이너를 다시 생성할 때 로그는 삭제됩니다.<br><br>로깅에 대한 정보는 참조하세요.<br><br>- <strong>기본값:</strong> 설정되지 않음</p>                                                       |

***

### `mongo`

| 이름                | 설명                                                                                                                                                                                                                                                                                                                      |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MONGO_ENABLED`   | <p>다음으로 설정하면 <code>true</code>, Toolkit이 데이터베이스를 호스팅할 MongoDB 컨테이너를 생성하도록 합니다. 이 값이 <code>false</code>로 설정되면 이 컨테이너는 생성되지 않으며, 시스템은 대신 <code>MONGO\_URL</code> 로 지정된 MongoDB 데이터베이스를 사용합니다.<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>로 설정되면 이 컨테이너는 생성되지 않으며, 시스템은 대신 <code>REDIS\_HOST</code> 및 <code>REDIS\_PORT</code> 로 지정된 MongoDB 데이터베이스를 사용합니다.<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://ayakaleaf-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.