> 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/environment-variables.md). # 환경 변수 이 페이지에서는 Toolkit 배포에서 지원되는 환경 변수를 설명합니다 `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_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 헤더입니다.

Overleaf Toolkit에서 관리되지 않는 외부 TLS 프록시를 사용하는 경우, 다음이 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` | 편집 가능한 파일에 대한 추가 확장자를 구성하기 위한 문자열 배열입니다. | | `OVERLEAF_STATUS_PAGE_URL` | 사용자 지정 상태 페이지 URL (Server Pro 3.4.0에 추가됨), 예: `status.example.com`. | | `OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS` | 다음으로 설정 `'false'` Full Project History로 새 프로젝트를 초기화하지 않도록 합니다(Server Pro 3.5.0에 추가됨). | | `OVERLEAF_FPH_DISPLAY_NEW_PROJECTS` | 다음으로 설정 `'false'` 레거시 기록 대신 새 프로젝트에 Full Project History가 표시되지 않도록 합니다(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` |

다음으로 설정하면 trueMongoDB 시작 검사에서 실패해도 배포 시작을 막지 않도록 허용합니다. 이는 데이터베이스 사용자가 다음 clusterParameterReader 역할을 갖고 있지 않은 MongoDB 데이터베이스를 사용하는 경우 필요할 수 있습니다.

사용자 지정 역할 생성에 대한 도움말은 다음을 참조하세요 여기.

| | `V1_HISTORY_URL_FOR_GIT_BRIDGE` | 다음을 분리할 수 있습니다 **history-v1** 내부 트래픽용 엔드포인트(`web` service → `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://overleaf-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.