메인 콘텐츠로 건너뛰기
이 페이지에서는 Toolkit이 Overleaf 온프레미스 배포를 구성하는 데 사용하는 구성 파일을 설명합니다.

영구 데이터

Overleaf Toolkit은 LaTeX 프로젝트 컴파일에 필요한 파일과 MongoDB 데이터베이스의 내용 같은 영구 데이터를 저장해야 합니다. 이를 위해 호스트 머신의 몇몇 디렉터리를 Docker 컨테이너에 마운트하고, 해당 디렉터리에 데이터를 기록합니다.

데이터 디렉터리

sharelatex 컨테이너에는 LaTeX 컴파일 관련 데이터를 저장할 디렉터리가 필요합니다. 이 디렉터리는 config/overleaf.rc의 OVERLEAF_DATA_PATH 변수로 설정합니다. mongo 컨테이너가 활성화된 경우 데이터베이스 파일을 저장할 디렉터리가 필요하며, redis 컨테이너도 마찬가지입니다. 이 디렉터리들도 config/overleaf.rc에서 구성할 수 있습니다.

파일 권한

Docker는 root로 실행되므로, Toolkit을 root가 아닌 사용자가 사용하더라도 데이터 디렉터리의 소유자는 root 사용자가 됩니다. 이는 문제가 되지 않지만, 컨테이너 외부에서 영구 데이터를 수정하려는 경우에는 알아 두는 것이 좋습니다.

구성 파일 위치

사용자가 소유하는 모든 구성 파일은 config/ 디렉터리에 있습니다. 이 디렉터리는 git 버전 관리 시스템에서 제외되어 있으므로 Toolkit 코드를 업데이트해도 변경되지 않습니다. Toolkit은 사용자의 허락 없이 config/ 디렉터리의 데이터를 변경하지 않습니다.
구성 파일의 변경 사항은 컨테이너를 중지했다가 다시 시작하더라도(bin/stop 및 bin/start 사용) 기존 컨테이너에 자동으로 적용되지 않습니다. 변경 사항을 적용하려면 bin/up을 실행하세요. 그러면 내부적으로 docker compose가 새 컨테이너에 구성 변경 사항을 자동으로 적용합니다. (Docker 로그에 연결하지 않으려면 bin/up -d를 실행하세요.)

config/overleaf.rc 파일

config/overleaf.rc 파일에는 Toolkit이 사용하는 가장 중요한 최상위 구성 설정이 들어 있습니다. 이 파일은 VARIABLE_NAME=value 형식으로 변수를 설정하는 구문으로 이루어져 있습니다. 사용 가능한 모든 구성 옵션의 자세한 내용은 설정 섹션을 참조하세요.

variables.env 파일

config/variables.env 파일에는 sharelatex 컨테이너에 로드되어 Overleaf 마이크로서비스를 구성하는 데 사용되는 환경 변수가 들어 있습니다. 여기에는 웹 인터페이스 헤더에 표시되는 애플리케이션 이름, 이메일 발송 설정, SSO 같은 기타 설정 등이 포함됩니다. 사용 가능한 모든 환경 변수의 자세한 내용은 환경 변수 섹션을 참조하세요.

config/version 파일

config/version 파일에는 Overleaf 서버의 실행 인스턴스를 생성하는 데 사용될 Docker 이미지의 버전 번호가 들어 있습니다.
이러한 구성 파일의 변경 사항은 컨테이너를 중지했다가 다시 시작하더라도(bin/stop 및 bin/start 사용) 기존 컨테이너에 자동으로 적용되지 않습니다. 변경 사항을 적용하려면 bin/up을 실행하세요. Toolkit이 구성 변경 사항이 적용된 새 컨테이너를 자동으로 생성합니다.

docker-compose.override.yml 파일

config/docker-compose.override.yml 파일이 있으면 docker compose 호출 시 함께 포함됩니다. Docker Compose 관련 구성을 재정의할 때 유용합니다. config/variables.env는 mongo 및 redis 컨테이너에는 로드되지 않습니다. 이 컨테이너에 환경 변수를 설정하려면 여기에 추가하고 bin/up -d를 실행하세요. 예시:
자세한 내용은 docker-compose 문서를 참조하세요.

Q&A

답변: Toolkit은 파일 시스템을 확인하지 않습니다. 요구 사항이 있는 것은 MongoDB이므로, 파일 시스템 선택은 data/mongo(MONGO_DATA_PATH)에 가장 중요합니다. MongoDB의 프로덕션 노트는 Linux에서 XFS 또는 ext4를 사용하라고 안내하며, MongoDB가 사용하는 스토리지 엔진인 WiredTiger에는 XFS를 강력히 권장합니다. btrfs나 기타 copy-on-write 파일 시스템은 다루지 않습니다. 루트 파일 시스템이 btrfs라면 XFS 볼륨을 마운트하고 MONGO_DATA_PATH가 이를 가리키도록 할 수 있습니다. 또한 파일 시스템은 디렉터리에 대한 fsync()를 지원해야 하며, HGFS와 VirtualBox 공유 폴더는 이를 지원하지 않습니다.파일 시스템 압축은 data/mongo에 대해 절약 효과가 거의 없습니다. WiredTiger는 이미 컬렉션을 snappy로, 인덱스를 접두사 압축으로 압축합니다. NFS에 대해서는 문제 해결을 참조하세요.
마지막 수정일 2026년 11월 2일