> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 파일 및 위치

이 페이지에서는 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/` 디렉터리의 데이터를 **변경하지 않습니다**.

<Info>
  구성 파일의 변경 사항은 컨테이너를 중지했다가 다시 시작하더라도(`bin/stop` 및 `bin/start` 사용) 기존 컨테이너에 자동으로 적용되지 않습니다. 변경 사항을 적용하려면 `bin/up`을 실행하세요. 그러면 내부적으로 `docker compose`가 새 컨테이너에 구성 변경 사항을 자동으로 적용합니다. (Docker 로그에 연결하지 않으려면 `bin/up -d`를 실행하세요.)
</Info>

### `overleaf.rc` 파일

`config/overleaf.rc` 파일에는 Toolkit이 사용하는 가장 중요한 최상위 구성 설정이 들어 있습니다. 이 파일은 `VARIABLE_NAME=value` 형식으로 변수를 설정하는 구문으로 이루어져 있습니다.

사용 가능한 모든 구성 옵션의 자세한 내용은 설정 섹션을 참조하세요.

### `variables.env` 파일

`config/variables.env` 파일에는 `sharelatex` 컨테이너에 로드되어 Overleaf 마이크로서비스를 구성하는 데 사용되는 환경 변수가 들어 있습니다. 여기에는 웹 인터페이스 헤더에 표시되는 애플리케이션 이름, 이메일 발송 설정, Server Pro에서 사용하는 SSO 같은 프리미엄 설정 등이 포함됩니다.

사용 가능한 모든 환경 변수의 자세한 내용은 [환경 변수](/ko/on-premises/configuration/overleaf-toolkit/environment-variables) 섹션을 참조하세요.

### `version` 파일

`config/version` 파일에는 Overleaf 서버의 실행 인스턴스를 생성하는 데 사용될 Docker 이미지의 버전 번호가 들어 있습니다.

<Info>
  이러한 구성 파일의 변경 사항은 컨테이너를 중지했다가 다시 시작하더라도(`bin/stop` 및 `bin/start` 사용) 기존 컨테이너에 자동으로 적용되지 않습니다. 변경 사항을 적용하려면 `bin/up`을 실행하세요. Toolkit이 구성 변경 사항이 적용된 새 컨테이너를 자동으로 생성합니다.
</Info>

### `docker-compose.override.yml` 파일

`config/docker-compose.override.yml` 파일이 있으면 `docker compose` 호출 시 함께 포함됩니다. Docker Compose 관련 구성을 재정의할 때 유용합니다.

자세한 내용은 [docker-compose 문서](https://docs.docker.com/compose/extends/#adding-and-overriding-configuration)를 참조하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.