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 인스턴스의 호스트 이름입니다. 둘 다 필요합니다(릴리스 노트 참조). |
OVERLEAF_REDIS_PORT 및 REDIS_PORT | 사용할 Redis 인스턴스의 포트입니다. 둘 다 필요합니다(릴리스 노트 참조). |
OVERLEAF_REDIS_PASS 및 REDIS_PASSWORD | Redis에 연결할 때 사용할 비밀번호입니다(해당하는 경우). 두 환경 변수를 모두 설정해야 합니다. 자세한 내용은 비밀번호 인증 활성화하기를 참조하세요. |
OVERLEAF_REDIS_TLS | true로 설정하면 TLS가 필요한 Redis 인스턴스에 연결할 수 있습니다.
참고: mTLS는 현재 지원되지 않습니다.
|
OVERLEAF_NAV_TITLE | 애플리케이션의 탭 제목을 설정합니다. |
OVERLEAF_HEADER_IMAGE_URL_LIGHT 및 OVERLEAF_HEADER_IMAGE_URL_DARK | 라이트 테마와 다크 테마용 사용자 지정 헤더 로고의 URL입니다(6.3.0에서 추가됨). 각 테마별 변수가 설정되지 않은 경우 OVERLEAF_HEADER_IMAGE_URL로 대체됩니다. Branding을 참조하세요. |
OVERLEAF_LINKED_URL_OUTBOUND_PROXY | 외부 연결 파일과 Open in Overleaf API를 통한 외부 ZIP 또는 TeX 리소스를 가져올 때 사용할 HTTP(S) 프록시의 URL입니다. 재릴리스된 Ayakaleaf Pro 6.3.0(2026년 10월 3일)부터 사용할 수 있습니다. 직접 연결하려면 설정하지 마세요. 예: OVERLEAF_LINKED_URL_OUTBOUND_PROXY=http://proxy.internal:3128. 구성 및 네트워크 접근 제한에 대해서는 Outbound Proxy를 참조하세요. |
OVERLEAF_INVITE_TOKEN_SECRET | 필수. 프로젝트 공유 토큰을 보호하는 데 사용되는 임의의 문자열입니다(6.2.0에서 추가됨). 최소 문자 수: 16 |
OVERLEAF_SESSION_SECRET | 권장. 세션 쿠키에 서명하는 데 사용되는 임의의 문자열입니다. 로드 밸런싱을 사용하는 경우 모든 서버에서 동일한 토큰으로 설정해야 합니다. 설정하지 않으면 컨테이너가 생성될 때마다 새로운 임의의 값이 생성되므로, 컨테이너를 다시 생성하는 모든 bin/up(예: config/variables.env 변경 후)이나 업그레이드 시 모든 사용자가 로그아웃됩니다. openssl rand -hex 32로 한 번 생성하여 계속 유지하세요. |
OVERLEAF_COOKIE_SESSION_LENGTH | 기본 세션 쿠키 만료 시간인 5일을 재정의할 수 있습니다. 재정의 값은 밀리초 단위여야 합니다. 예: 세션을 1시간 동안 유지하려면 COOKIE_SESSION_LENGTH=3600000으로 설정합니다. |
OVERLEAF_TRUSTED_PROXY_IPS | 설정하지 않으면 기본값은 loopback입니다. 수동으로 설정하는 경우 신뢰할 수 있는 IP 외에도 sharelatex 컨테이너 내부에서 실행되는 nginx 인스턴스를 신뢰하도록 loopback(또는 127.0.0.1)을 반드시 포함해야 합니다. IP 주소와 CIDR 범위만 허용됩니다. localhost와 같은 호스트 이름을 추가하지 마세요. 그렇지 않으면 Overleaf가 시작되지 않고 502 Bad Gateway를 반환합니다.
일반 네트워크에 172.16.0.0/12(Docker 네트워크의 기본 서브넷)의 서브넷을 사용하는 경우 config/variables.env에 OVERLEAF_TRUSTED_PROXY_IPS=loopback,<network>를 설정하세요. 여기서 <network>는 docker inspect overleaf_default의 IPAM -> Config -> Subnet 값입니다(예: OVERLEAF_TRUSTED_PROXY_IPS=loopback,172.19.0.0/16). 이는 X-Forwarded 헤더 스푸핑을 방지하기 위한 것입니다.
외부 TLS 프록시(즉, Overleaf Toolkit에서 관리하지 않는 프록시)를 사용하는 경우 OVERLEAF_TRUSTED_PROXY_IPS=loopback,<ip-of-your-tls-proxy>로 설정되어 있는지 확인하세요(예: 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로 설정하면 익명 사용자가 링크 공유 기능을 통해 공유된 프로젝트를 보고 편집할 수 있습니다. |
OVERLEAF_DISABLE_LINK_SHARING | 링크 공유 기능을 비활성화합니다. |
EMAIL_CONFIRMATION_DISABLED | true로 설정하면 이메일 확인을 요청하는 배너가 표시되지 않습니다. |
ADDITIONAL_TEXT_EXTENSIONS | 편집 가능한 파일의 추가 확장자를 구성하는 문자열 배열입니다. |
DEFAULT_LATEX_COMPILER | 새 프로젝트에서 사용할 기본 컴파일러를 설정합니다. (6.2.0에서 추가됨). 옵션: pdflatex, latex, xelatex 또는 lualatex |
OVERLEAF_STATUS_PAGE_URL | 사용자 지정 상태 페이지 URL입니다. 예: status.example.com. |
OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS | 'false'로 설정하면 새 프로젝트가 Full Project History로 초기화되지 않습니다. |
OVERLEAF_FPH_DISPLAY_NEW_PROJECTS | 'false'로 설정하면 새 프로젝트에서 레거시 기록 대신 Full Project History가 표시되지 않습니다. |
ENABLE_CRON_RESOURCE_DELETION | 이 환경 변수를 true로 설정하면 삭제된 프로젝트와 사용자를 90일 후 자동으로 정리합니다. |
OVERLEAF_USER_HARD_DELETION_DELAY | 삭제된 사용자의 만료 지연 시간을 변경하는 데 사용됩니다. 밀리초 단위로 구성합니다.
기본값: 90일 |
OVERLEAF_PROJECT_HARD_DELETION_DELAY | 삭제된 프로젝트의 만료 지연 시간을 변경하는 데 사용됩니다. 밀리초 단위로 구성합니다.
기본값: 90일 |
MAX_UPLOAD_SIZE | 개별 업로드의 최대 크기를 메가바이트 단위로 제어합니다. 기본값은 50입니다.
주의: 이 변수는 단위(MB)나 래퍼 없이 숫자만 입력합니다.
업로드된 .zip 파일의 압축 해제 후 총크기는 이 값의 6배(기본값 300 MB)로 제한됩니다. |
COMPILE_SIZE_LIMIT | 최대 요청 본문 크기를 바이트 단위로 제어합니다. 이는 CLSI 서비스에 대한 초기 컴파일 요청에서 전송해야 하는 프로젝트 내 모든 문서 파일(main.tex, references.bib(연결되지 않은 경우) 등)의 크기를 합한 값입니다. |
COMPILE_TIMEOUT | 컴파일 완료에 허용되는 시간(초)입니다. 자세한 내용은 프로젝트 컴파일 시간 제한 업데이트를 참조하세요. |
MAX_RECONNECT_GRACEFULLY_INTERVAL_MS | 데이터 손실 위험을 줄이기 위해 편집기의 정상 재연결, 데이터 플러시 및 컨테이너 종료 사이에 두는 구성 가능한 지연 시간입니다. |
SECCOMP_PROFILE | 이 환경 변수를 SECCOMP 프로필을 가리키는 Docker 호스트 머신의 경로로 설정합니다. 프로필 사본은 여기에서 다운로드할 수 있습니다.
현재 샌드박스 컴파일을 사용하는 Podman 배포에 필요합니다. |
OVERLEAF_DISABLE_CHAT | true로 설정하면 프로젝트 내 채팅 기능을 비활성화합니다. |
OVERLEAF_DISABLE_LOCAL_LOGIN | true로 설정하면 이메일 및 비밀번호 로그인을 숨겨 사용자가 LDAP, SAML 또는 OIDC로만 로그인할 수 있습니다. EXTERNAL_AUTH에서 이 중 하나 이상이 활성화된 경우에만 적용됩니다(Ayakaleaf Pro 6.3.1에서 추가됨). |
OVERLEAF_LOGIN_SUPPORT_TEXT | 설정하면 로그인 버튼 아래에 지원 정보를 표시할 수 있습니다. 텍스트는 로그인 화면에 표시되며, 사용자를 내부 지원 창구로 안내하거나 로그인, 계정 생성 등과 관련된 안내를 제공하는 데 사용할 수 있습니다. |
ALLOW_MONGO_ADMIN_CHECK_FAILURES | true로 설정하면 MongoDB 시작 검사가 실패해도 배포 시작을 막지 않습니다. 데이터베이스 사용자에게 clusterParameterReader 역할이 없는 MongoDB 데이터베이스를 사용하는 경우 필요할 수 있습니다.
사용자 지정 역할 생성에 대한 도움말은 여기를 참조하세요.
|
V1_HISTORY_URL_FOR_GIT_BRIDGE | 내부 트래픽(web 서비스 → history-v1 서비스, 둘 다 sharelatex 컨테이너 내부)과 외부 트래픽(git-bridge → history-v1, 별도 컨테이너에서 실행)에 대한 history-v1 엔드포인트를 분리할 수 있습니다. |
OVERLEAF_MAINTENANCE_MESSAGE 및 OVERLEAF_MAINTENANCE_MESSAGE_HTML | 유지보수 페이지의 제목과 내용을 사용자 지정하는 데 사용됩니다. OVERLEAF_STATUS_PAGE_URL과 함께 사용할 수 없습니다. |