Toolkit 설정 - Ayakaleaf Pro

이 페이지에서는 Toolkit 배포의 config/overleaf.rc 파일에서 지원되는 환경 변수를 설명합니다. config/overleaf.rc 파일은 NAME=value 형식의 변수 정의로 구성됩니다. #으로 시작하는 줄은 주석으로 처리됩니다.

overleaf.rc 또는 variables.env에서 무엇이든 변경한 후에는 bin/up을 실행하여 Docker 컨테이너를 다시 생성해야 합니다.

컨테이너

`sharelatex`

이름	설명
`PROJECT_NAME`	`docker-compose`에 전달되는 `--project-name` 플래그의 값을 설정합니다. 한 호스트에서 여러 Overleaf 인스턴스를 실행할 때 각 인스턴스에 다른 프로젝트 이름을 지정할 수 있어 유용합니다. - 기본값: `overleaf`
`OVERLEAF_IMAGE_NAME`	Server Pro/CE 애플리케이션 컨테이너에서 사용하는 Docker 이미지입니다. Docker 이미지 이름만 지정하며, Docker 이미지 태그는 `config/version`에서 가져옵니다. - 기본값: - Server Pro: `ghcr.io/ayaka-notes/overleaf-pro` - Community Edition: `sharelatex/sharelatex`
`SERVER_PRO`	`true`로 설정하면 Toolkit이 기본 Server CE 이미지(`sharelatex/sharelatex`) 대신 Server Pro 이미지(`ghcr.io/ayaka-notes/overleaf-pro`)를 사용합니다. - 기본값: `false`
`GIT_BRIDGE_ENABLED`	git-bridge 기능을 활성화하려면 `true`로 설정합니다(Server Pro 전용). 자세한 내용은 https://www.overleaf.com/learn/how-to/Git_integration 사용자 문서를 참고하세요. - 기본값: `false`
`GIT_BRIDGE_IMAGE`	git-bridge 컨테이너에서 사용하는 Docker 이미지입니다(Server Pro 전용). Docker 이미지 이름만 지정하며, Docker 이미지 태그는 `config/version`에서 가져옵니다. - 기본값: `ghcr.io/ayaka-notes/overleaf-pro/git-bridge`
`GIT_BRIDGE_DATA_PATH`	`git-bridge` 컨테이너(Server Pro 전용)에 마운트되어 git 저장소를 저장하는 데 사용되는 디렉터리 경로를 설정합니다. 전체 경로(`/`로 시작) 또는 Toolkit 기본 디렉터리에 대한 상대 경로를 사용할 수 있습니다.
`GIT_BRIDGE_LOG_LEVEL`	`git-bridge` 컨테이너의 로깅 수준을 구성합니다. 사용 가능한 수준: `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`. - 기본값: `INFO`
`SIBLING_CONTAINERS_ENABLED`	`true`로 설정하면 Toolkit이 Sibling Containers 기법을 사용하여 각 프로젝트마다 별도의 Docker 컨테이너를 사용하는 개별 샌드박스에서 프로젝트를 컴파일합니다. 자세한 내용은 <server-pro-only-configuration/sandboxed-compiles> 문서를 참고하세요. - 필요 조건: `SERVER_PRO=true` - 기본값: `true`
`SIBLING_CONTAINERS_PULL`	`true`로 설정하면 `bin/up` 명령을 사용할 때 Toolkit이 config/variables.env 파일의 `ALL_TEX_LIVE_DOCKER_IMAGES`로 설정된 모든 TeX Live 이미지를 자동으로 가져옵니다. - 기본값: `true`
`DOCKER_SOCKET_PATH`	호스트 머신(Toolkit을 실행하는 머신)의 Docker 소켓 경로를 설정합니다. `SIBLING_CONTAINERS_ENABLED`가 `true`이면 컴파일러 서비스가 호스트에서 새 Docker 컨테이너를 생성할 수 있도록 소켓이 컨테이너에 마운트됩니다. - 필요 조건: `SIBLING_CONTAINERS_ENABLED=true` - 기본값: `/var/run/docker.sock`
`OVERLEAF_DATA_PATH`	메인 `sharelatex` 컨테이너에 마운트되어 컴파일 데이터를 저장하는 데 사용되는 디렉터리 경로를 설정합니다. 전체 경로(`/`로 시작) 또는 Toolkit 기본 디렉터리에 대한 상대 경로를 사용할 수 있습니다. - 기본값: `data/overleaf`
`OVERLEAF_LISTEN_IP`	컨테이너가 바인딩할 호스트 IP 주소를 설정합니다. 예를 들어 `0.0.0.0`으로 설정하면 모든 호스트 IP 주소에서 웹 인터페이스를 사용할 수 있습니다. 컨테이너에 직접 접근하려면 `OVERLEAF_LISTEN_IP` 값을 공인 IP 주소로 설정해야 합니다. `OVERLEAF_LISTEN_IP`를 `0.0.0.0` 또는 호스트의 외부 IP로 설정하면 와 함께 사용할 때 일반적으로 오류가 발생합니다. - 기본값: `127.0.0.1`
`OVERLEAF_PORT`	컨테이너가 바인딩할 호스트 포트를 설정합니다. 예를 들어 이 값을 `8099`로, `OVERLEAF_LISTEN_IP`를 `127.0.0.1`로 설정하면 `http://localhost:8099`에서 웹 인터페이스를 사용할 수 있습니다. - 기본값: `80`
`OVERLEAF_LOG_PATH`	메인 `sharelatex` 컨테이너에 마운트되어 Docker 호스트에서 애플리케이션 로그를 사용할 수 있도록 하는 디렉터리 경로를 설정합니다. 전체 경로(`/`로 시작) 또는 Toolkit 기본 디렉터리에 대한 상대 경로를 사용할 수 있습니다. 바인드 마운트를 비활성화하려면 이 구성 항목을 제거하세요. 설정하지 않으면 컨테이너를 다시 생성할 때 로그가 삭제됩니다. 로깅에 대한 정보는 를 참고하세요. - 기본값: 설정 안 됨

`mongo`

이름	설명
`MONGO_ENABLED`	`true`로 설정하면 Toolkit이 데이터베이스를 호스팅할 MongoDB 컨테이너를 생성합니다. `false`로 설정하면 이 컨테이너가 생성되지 않으며, 대신 `MONGO_URL`로 지정된 MongoDB 데이터베이스를 사용합니다. - 기본값: `true`
`MONGO_URL`	`MONGO_ENABLED`가 `false`일 때 사용할 MongoDB 연결 URL을 지정합니다. - 기본값: 설정 안 됨
`MONGO_DATA_PATH`	`mongo` 컨테이너에 마운트되어 MongoDB 데이터베이스를 저장하는 데 사용되는 디렉터리 경로를 설정합니다. 전체 경로(`/`로 시작) 또는 toolkit 기본 디렉터리에 대한 상대 경로를 사용할 수 있습니다. 이 옵션은 `MONGO_ENABLED`가 `true`일 때 생성되는 로컬 `mongo` 컨테이너에만 영향을 줍니다. - 기본값: `data/mongo`
`MONGO_IMAGE`	MongoDB 컨테이너에서 사용하는 Docker 이미지입니다. Docker 이미지 이름만 지정하며, Docker 이미지 태그는 `MONGO_VERSION`(아래 참고)에 지정해야 합니다. - 기본값: `mongo`
`MONGO_VERSION`	MongoDB 컨테이너에서 사용하는 MongoDB 버전입니다. 값은 MongoDB 메이저 버전과 점으로 시작해야 합니다. 예: `6.0` 또는 `6.0-with-suffix`. - 기본값: `6.0`

`redis`

이름	설명
`REDIS_ENABLED`	`true`로 설정하면 Toolkit이 redis 데이터베이스를 호스팅할 Redis 컨테이너를 생성합니다. `false`로 설정하면 이 컨테이너가 생성되지 않으며, 대신 `REDIS_HOST`와 `REDIS_PORT`로 지정된 Redis 데이터베이스를 사용합니다. - 기본값: `true`
`REDIS_HOST`	`REDIS_ENABLED`가 `false`일 때 사용할 Redis 호스트를 지정합니다. - 기본값: 설정 안 됨
`REDIS_PORT`	`REDIS_ENABLED`가 `false`일 때 사용할 Redis 포트를 지정합니다. - 기본값: 설정 안 됨
`REDIS_DATA_PATH`	`redis` 컨테이너에 마운트되어 Redis 데이터베이스를 저장하는 데 사용되는 디렉터리 경로를 설정합니다. 전체 경로(`/`로 시작) 또는 Toolkit 기본 디렉터리에 대한 상대 경로를 사용할 수 있습니다. 이 옵션은 `REDIS_ENABLED`가 `true`일 때 생성되는 로컬 `redis` 컨테이너에만 영향을 줍니다. - 기본값: `data/redis`
`REDIS_AOF_PERSISTENCE`	Redis의 AOF(Append Only File) 영속성을 켭니다. Redis 영속성에 권장되는 구성입니다. 자세한 내용은 <../../maintenance/data-and-backups>의 <../../../maintenance/data-and-backups#aof-append-only-file> 섹션을 참고하세요. - 기본값: `true`

`nginx`

이름	설명
`NGINX_ENABLED`	`true`로 설정하면 Toolkit이 TLS 프록시 역할을 할 NGINX 컨테이너를 생성합니다. - 기본값: `false`
`NGINX_CONFIG_PATH`	TLS 프록시에 사용할 NGINX 구성 파일의 경로입니다. - 기본값: `config/nginx/nginx.conf`
`NGINX_TLS_LISTEN_IP`	TLS 프록시 컨테이너가 HTTPS용으로 바인딩할 호스트 IP 주소를 설정합니다. 예를 들어 `0.0.0.0`으로 설정하면 모든 호스트 IP 주소에서 HTTPS 웹 인터페이스를 사용할 수 있습니다. 일반적으로 호스트의 외부 IP로 설정해야 합니다. - 기본값: `127.0.1.1`
`NGINX_HTTP_LISTEN_IP`	TLS 프록시 컨테이너가 HTTP 리디렉션용으로 바인딩할 호스트 IP 주소를 설정합니다. 예를 들어 `127.0.1.1`로 설정하면 `127.0.1.1`로의 HTTP 연결이 HTTPS 웹 인터페이스로 리디렉션됩니다. 일반적으로 호스트의 외부 IP로 설정해야 합니다. `0.0.0.0`으로 설정하면 일반적으로 `OVERLEAF_LISTEN_IP`와 충돌이 발생하므로 그렇게 설정하지 마세요. - 기본값: `127.0.1.1`
`NGINX_HTTP_PORT`	TLS 프록시 컨테이너가 HTTP용으로 바인딩할 호스트 포트를 설정합니다. - 기본값: `80`
`TLS_PORT`	TLS 프록시 컨테이너가 HTTPS용으로 바인딩할 호스트 포트를 설정합니다. - 기본값: `443`
`TLS_PRIVATE_KEY_PATH`	TLS 프록시에 사용할 개인 키의 경로입니다. - 기본값: `config/nginx/certs/overleaf_key.pem`
`TLS_CERTIFICATE_PATH`	TLS 프록시에 사용할 공개 인증서의 경로입니다. - 기본값: `config/nginx/certs/overleaf_certificate.pem`

마지막 수정일 2026년 10월 5일