> 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/environment-variables.md).
# 환경 변수
이 페이지는 다음에서 지원되는 환경 변수를 설명합니다 `config/variables.env` Toolkit 배포를 위한 파일입니다.
다음 `config/variables.env` 파일은 다음 형식의 변수 정의로 구성됩니다 `NAME=value`; 로 시작하는 줄은 `#` 주석으로 처리됩니다.
{% hint style="info" %}
다음 중 어떤 내용을 변경한 후에는 Docker 컨테이너를 다시 생성해야 합니다 `overleaf.rc` 또는 `variables.env` 다음 명령을 실행하여 `bin/up`.
{% endhint %}
### 모든 버전
이 환경 변수는 Server CE 및 Server Pro와 호환되며, 이 두 온프레미스 버전 간의 손쉬운 마이그레이션 경로를 제공합니다. 또한 Toolkit 및 Docker Compose 배포 모두에서 사용할 수 있습니다.
{% hint style="info" %}
이전에는 이 환경 변수들 앞에 다음 접두사가 붙었습니다 `SHARELATEX_` 대신 `OVERLEAF_`.
{% endhint %}
| 이름 | 설명 |
| -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `OVERLEAF_SITE_URL` | Overleaf 인스턴스가 공개적으로 이용 가능한 위치입니다. 공개 링크와 웹소켓 연결 시 사용되므로 올바르게 구성해야 합니다! |
| `OVERLEAF_ADMIN_EMAIL` | 사용자가 사이트 운영자에게 연락할 수 있는 이메일 주소입니다. |
| `OVERLEAF_APP_NAME` | 실행 중인 애플리케이션을 언급할 때 표시할 이름입니다. 기본값은 'Overleaf (Community Edition)'입니다. |
| `OVERLEAF_MONGO_URL` 및 `MONGO_URL` | 사용할 Mongo 데이터베이스의 URL입니다. |
| `OVERLEAF_REDIS_HOST` 및 `REDIS_HOST` | 사용할 Redis 인스턴스의 호스트 이름입니다. 둘 다 필요합니다(참조 [릴리스 노트](broken://pages/f2cfbd8bd38b8584e123c88189befe1a25836c40#changes-to-the-docker-compose-file-format)). |
| `OVERLEAF_REDIS_PORT` 및 `REDIS_PORT` | 사용할 Redis 인스턴스의 포트입니다. 둘 다 필요합니다(참조 [릴리스 노트](broken://pages/f2cfbd8bd38b8584e123c88189befe1a25836c40#changes-to-the-docker-compose-file-format)). |
| `OVERLEAF_REDIS_PASS` 및 `REDIS_PASSWORD` | Redis에 연결할 때 사용할 비밀번호입니다(해당되는 경우). **둘 다** 환경 변수를 설정해야 합니다. 참조 [비밀번호 인증 사용](broken://pages/1fdb016e1573efba99f9c3007bf0b9aa0077b4bc) 자세한 내용은 |
| `OVERLEAF_REDIS_TLS` | 다음으로 설정하면 trueTLS가 필요한 Redis 인스턴스에 연결할 수 있습니다.
참고: mTLS는 현재 지원되지 않습니다.
|
| `OVERLEAF_NAV_TITLE` | 애플리케이션의 탭 제목을 설정합니다. |
| `OVERLEAF_INVITE_TOKEN_SECRET` | 필수. 프로젝트 공유 토큰을 보호하는 데 사용되는 임의 문자열입니다(Server Pro 6.2.0에 추가됨).
최소 문자 수: 16
|
| `OVERLEAF_SESSION_SECRET` | 토큰을 보호하는 데 사용되는 임의 문자열입니다. 로드 밸런싱을 사용하는 경우 모든 박스에서 동일한 토큰으로 설정해야 합니다. 인스턴스가 1개만 실행 중인 경우 사용자가 설정할 필요가 없습니다. |
| `OVERLEAF_COOKIE_SESSION_LENGTH` | 기본 세션 쿠키 만료 시간인 5일을 재정의할 수 있습니다. 재정의 값은 밀리초 단위여야 합니다. 예: 세션을 1시간 지속되게 하려면 다음을 설정하세요 `COOKIE_SESSION_LENGTH=3600000`. (Server Pro 4.2에 추가됨) |
| `OVERLEAF_TRUSTED_PROXY_IPS` | 설정하지 않으면 기본값은 loopback. 수동으로 설정하는 경우, 신뢰할 IP 외에 다음 중 하나도 포함해야 합니다 loopback, localhost 또는 127.0.0.1, 이는 내부에서 실행 중인 nginx 인스턴스를 신뢰합니다 sharelatex 컨테이너.
다음의 서브넷을 사용하는 경우 172.16.0.0/12 (Docker 네트워크의 기본 서브넷)을 일반 네트워크로 사용하는 경우 다음을 설정하세요 OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,\ 에서 config/variables.env. 여기서 \ 은 IPAM -> Config -> Subnet 의 값입니다 docker inspect overleaf\_default, 예: OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,172.19.0.0/16. 이는 다음의 스푸핑을 방지하기 위한 것입니다 X-Forwarded 헤더.
외부 TLS 프록시를 사용하는 경우(즉, Overleaf Toolkit에서 관리하지 않는 경우) 다음을 확인하세요 OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,\, 예: OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,192.168.13.37.
|
| `OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS` | 다음으로 설정하면 `true`, 프로젝트 초대를 기존 사용자 계정에 해당하는 이메일 주소로 제한합니다. |
| `OVERLEAF_ALLOW_PUBLIC_ACCESS` | 다음으로 설정하면 `true`, 인증되지 않은 사용자가 사이트를 볼 수 있게 합니다. 기본값은 `false`, 이는 인증되지 않은 사용자가 사이트의 어떤 부분을 보려고 할 때 조건 없이 로그인 페이지로 리디렉션됨을 의미합니다. 참고로, 이 옵션을 설정한다고 해서 인증이나 보안이 어떤 방식으로든 비활성화되지는 않습니다. 사용자가 프로젝트를 공개하고 인증되지 않은 사용자가 해당 프로젝트를 보도록 하려는 경우 이 옵션이 필요합니다. |
| `OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING` | 다음으로 설정하면 `true`, 익명 사용자가 다음을 통해 공유된 프로젝트를 보고 편집할 수 있게 합니다 [링크 공유](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) 기능. |
| `OVERLEAF_DISABLE_LINK_SHARING` | 다음을 비활성화합니다 [링크 공유](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) 기능. |
| `EMAIL_CONFIRMATION_DISABLED` | 다음으로 설정하면 `true` 이메일 확인을 요청하는 배너가 표시되지 않습니다. |
| `ADDITIONAL_TEXT_EXTENSIONS` | 편집 가능한 파일에 대한 추가 확장자를 구성하는 문자열 배열입니다. |
| `DEFAULT_LATEX_COMPILER` | 다음에서 사용하는 기본 컴파일러를 설정하는 데 사용됩니다 새 프로젝트에 대해. (Server Pro 6.2.0에 추가됨).
옵션: pdflatex, latex, xelatex 또는 lualatex
|
| `OVERLEAF_STATUS_PAGE_URL` | 사용자 지정 상태 페이지 URL(Server Pro 3.4.0에 추가됨), 예: `status.example.com`. |
| `OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS` | 다음으로 설정 `'false'` 를 설정하면 새 프로젝트가 전체 프로젝트 기록으로 초기화되는 것을 방지합니다(Server Pro 3.5.0에 추가됨). |
| `OVERLEAF_FPH_DISPLAY_NEW_PROJECTS` | 다음으로 설정 `'false'` 새 프로젝트에 기존 기록 대신 전체 프로젝트 기록이 표시되는 것을 방지합니다(Server Pro 3.5.0에 추가됨). |
| `ENABLE_CRON_RESOURCE_DELETION` | 이 환경 변수를 다음으로 설정하세요 `true` 삭제된 프로젝트와 사용자를 90일 후 자동으로 정리하도록 활성화합니다. |
| `OVERLEAF_USER_HARD_DELETION_DELAY` | 삭제된 사용자 만료 지연을 수정하는 데 사용됩니다. 밀리초 단위로 구성됩니다.
기본값: 90일
|
| `OVERLEAF_PROJECT_HARD_DELETION_DELAY` | 삭제된 프로젝트 만료 지연을 수정하는 데 사용됩니다. 밀리초 단위로 구성됩니다.
기본값: 90일
|
| `MAX_UPLOAD_SIZE` | 개별 업로드의 최대 크기를 메가바이트 단위로 제어합니다. 기본값은 50.
주의: 이 변수는 단위(MB)나 래퍼 없이 단순한 숫자입니다.
|
| `COMPILE_SIZE_LIMIT` | 바이트 단위의 최대 요청 본문 크기를 제어합니다. 이는 프로젝트 내 모든 문서 파일 크기의 합입니다(`main.tex`, `references.bib` (연결되지 않은 경우) 등), 초기 컴파일 요청에 포함되어 CLSI 서비스로 보내야 합니다. |
| `COMPILE_TIMEOUT` | 컴파일이 완료될 수 있도록 허용되는 시간(초)입니다. 자세한 내용은 [프로젝트 컴파일 시간 초과 업데이트](broken://pages/7d148455d091e12e81b4952e6b00f11ab3d63399#updating-project-compile-timeout). |
| `MAX_RECONNECT_GRACEFULLY_INTERVAL_MS` | 데이터 손실 위험을 완화하기 위해 편집기 정상 재연결, 데이터 플러시, 컨테이너 종료 사이의 지연 시간을 구성할 수 있습니다. |
| `SECCOMP_PROFILE` | 이 환경 변수를 Docker의 경로로 설정하세요 호스트 머신에서 SECCOMP 프로필을 가리키는 경로로 설정합니다. 프로필 사본은 다운로드할 수 있습니다 여기.
현재 Sandboxed Compiles를 사용할 때 Podman 배포에 필요합니다.
|
| `OVERLEAF_DISABLE_CHAT` | 다음으로 설정하면 `true`, 프로젝트 내 채팅 기능을 비활성화합니다. |
| `OVERLEAF_LOGIN_SUPPORT_TEXT` | 설정하면 로그인 버튼 아래에 지원 정보를 표시하는 데 사용할 수 있습니다. 텍스트는 로그인 화면에 표시되며, 사용자를 내부 지원으로 안내하거나 로그인, 계정 생성 등에 관련된 안내를 제공하는 데 사용할 수 있습니다. |
| `ALLOW_MONGO_ADMIN_CHECK_FAILURES` | 다음으로 설정하면 true, MongoDB 시작 검사가 실패해도 배포 시작을 막지 않도록 허용합니다. 데이터베이스 사용자가 다음 권한을 가지고 있지 않은 MongoDB 데이터베이스를 사용하는 경우 필요할 수 있습니다 clusterParameterReader 역할.
사용자 지정 역할 생성에 대한 도움말은 다음을 참조하세요 여기.
|
| `V1_HISTORY_URL_FOR_GIT_BRIDGE` | 다음을 분리할 수 있게 합니다 **history-v1** 내부 트래픽용 엔드포인트(`web` 서비스 → `history-v1` 서비스, 둘 다 `sharelatex` 컨테이너)와 외부 트래픽(`git-bridge` → `history-v1`, 별도의 컨테이너에서 실행됨). |
| `OVERLEAF_MAINTENANCE_MESSAGE` 및 `OVERLEAF_MAINTENANCE_MESSAGE_HTML` | 유지 관리 페이지의 제목과 내용을 사용자 지정하는 데 사용됩니다. 다음과 함께 사용할 수 없습니다 `OVERLEAF_STATUS_PAGE_URL`. |
{% hint style="info" %}
Overleaf 로그인 시스템(로컬 계정)을 사용할 때는 LDAP와 같은 SSO 옵션이 아니라 사용자에게 비밀번호 제한을 적용할 수 있습니다. SSO 계정의 경우 비밀번호 정책은 ID 공급자 또는 디렉터리 서비스에 의해 적용되며, 추가로 다중 인증 지원도 가능합니다.
{% endhint %}
---
# 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/environment-variables.md?ask=&goal=
```
`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.