> 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/files-and-locations.md).

# 파일 및 위치

이 페이지에서는 Toolkit이 온프레미스 Overleaf 배포를 구성하는 데 사용하는 설정 파일을 설명합니다.

### 영구 데이터

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

#### 데이터 디렉터리

해당 `sharelatex` 컨테이너는 LaTeX 컴파일과 관련된 데이터를 저장할 디렉터리가 필요합니다. 이 디렉터리는 `OVERLEAF_DATA_PATH` 변수로 설정되며, `config/overleaf.rc`.

해당 `mongo` 컨테이너는(활성화되어 있는 경우) 데이터베이스 파일을 저장할 디렉터리가 필요하며, `redis` 컨테이너도 마찬가지입니다. 이러한 디렉터리는 `config/overleaf.rc`.

#### 파일 권한

Docker가 `root`로 실행되기 때문에, 데이터 디렉터리의 소유자는 `root` 사용자가 되며, Toolkit을 root가 아닌 사용자로 사용하더라도 마찬가지입니다. 이것은 문제는 아니지만, 컨테이너 외부에서 영구 데이터를 변경하려는 경우 알아두는 것이 좋습니다.

### 설정 파일 위치

사용자가 소유한 모든 설정 파일은 `config/` 디렉터리에 있습니다.

이 디렉터리는 **제외되며** git 버전 관리 시스템에서 제외되므로 Toolkit 코드를 업데이트해도 변경되지 않습니다. Toolkit은 **아니** 디렉터리의 어떤 데이터도 `config/` 사용자 허가 없이 변경하지 않습니다.

{% hint style="info" %}
설정 파일의 변경 사항은 컨테이너가 중지되었다가 다시 시작되더라도(와 함께 `bin/stop` 그리고 `bin/start`) 기존 컨테이너에 자동으로 적용되지 않습니다. 변경 사항을 적용하려면 `bin/up`을 실행하세요. 그러면 내부적으로 `docker compose` 가 새 컨테이너에 설정 변경 사항을 자동으로 적용합니다. (또는 Docker 로그에 연결하지 않으려면 `bin/up -d`을 실행하세요.)
{% endhint %}

### 해당 `overleaf.rc` 파일

해당 `config/overleaf.rc` 파일에는 Toolkit에서 사용하는 가장 중요한 최상위 설정이 들어 있습니다. 여기에는 다음 형식으로 변수를 설정하는 문이 포함되어 있습니다: `VARIABLE_NAME=value`

사용 가능한 모든 설정 옵션의 세부 내용을 보려면 설정 섹션을 참조하세요.

### 해당 `variables.env` 파일

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

사용 가능한 모든 환경 변수의 세부 내용을 보려면 [환경 변수](broken://pages/906d29a7f121d3d121ddd462343b3b44ff90041a) 섹션을 살펴보세요.

### 해당 `버전` 파일

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

{% hint style="info" %}
이 설정 파일의 변경 사항은 컨테이너가 중지되었다가 다시 시작되더라도(와 함께 `bin/stop` 그리고 `bin/start`) 기존 컨테이너에 자동으로 적용되지 않습니다. 변경 사항을 적용하려면 `bin/up`을 실행하면 Toolkit이 설정 변경 사항이 적용된 새 컨테이너를 자동으로 생성합니다.
{% endhint %}

### 해당 `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) 를 참조하세요.


---

# 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/files-and-locations.md?ask=<question>&goal=<endgoal>
```

`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.