> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/ko/installation/introduction.md).

# 소개

Overleaf Server Pro처럼, 우리의 Ayakaleaf Pro는 Docker 컨테이너 형태로 제공되며, LDAP 및 SAML2를 통해 제공되는 SSO, 향상된 보안, 변경 내용 추적, 주석, 최적화된 TeX Live 버전, 템플릿, 관리 패널 등의 기능을 추가로 포함하는 직접 대체 제품입니다.

* Overleaf를 한 번도 배포해 본 적이 없다면, 다음을 참조하세요. [Docker 설정](/on-premises/ko/installation/setup-docker.md) 먼저 Docker Engine을 설치한 다음 Overleaf를 설치합니다. [Toolkit을 사용하여](/on-premises/ko/installation/using-the-toolkit.md).
* 이미 Overleaf Community Edition을 배포한 적이 있다면, 다음을 참조하세요. [기존 환경에서 마이그레이션](/on-premises/ko/installation/migrate-from-existing.md) Ayakaleaf-Pro로 마이그레이션합니다.
* 기존 Server Pro 사용자라면, 템플릿 데이터가 약간 다른 형식으로 저장되므로 AyakaLeaf Pro로 마이그레이션하기 전에 문제를 열어 알려주시기 바랍니다.
* 가끔 AyakaLeaf Pro를 더 이상 사용하고 싶지 않고 공식 Overleaf Community Edition으로 다시 전환하고 싶다면, 완전히 지원됩니다. 데이터는 어떤 것도 손실되지 않습니다. 공식 Overleaf Toolkit 사용자는 override YAML 파일만 제거하면 됩니다. ayaka-notes toolkit 사용자는 다음을 비활성화하세요. `SERVER_PRO` 옵션. 그러면 모든 것이 표준 Community Edition으로 되돌아갑니다.

### 하드웨어 요구 사항

* AyakaLeaf Pro를 설치하기 위한 최소 하드웨어 요구 사항은 2코어 CPU와 3GB RAM입니다.
* TeX Live 이미지의 크기 때문에 샌드박스 컴파일을 활성화하려면 최소 40GB의 저장 공간이 필요합니다.
* 2020년부터 2026년까지의 전체 TeX Live 이미지 세트를 설치하려면 최소 150GB의 여유 디스크 공간이 있는지 확인해 주세요.

다음은 다양한 사용 시나리오에 대한 권장 하드웨어 구성입니다:

| 사용 사례                    | 권장 구성                            |
| ------------------------ | -------------------------------- |
| 개인 사용, 가끔 협업             | 2 CPU 코어, 4GB RAM                |
| 소규모 팀, 가벼운 협업을 하는 최대 10명 | 2 CPU 코어, 8GB RAM                |
| 중간 규모 팀, 최대 100명         | 4 CPU 코어, 16GB RAM               |
| 대규모 또는 대학 배포             | 분산 클러스터 배포; 배포 지원이 필요하시면 문의해 주세요 |

### 소프트웨어 요구 사항

소프트웨어 요구 사항으로는 최신 안정 버전의 Docker와 함께 최근 버전의 Ubuntu 사용을 권장합니다.

호환성 문제나 설치 및 운영 중 예기치 않은 문제가 발생할 수 있으므로 Windows나 기타 지원되지 않는 운영 체제에 AyakaLeaf Pro를 배포하는 것은 권장하지 않습니다.

### LaTeX 성능

LaTeX는 단일 스레드 프로그램으로, 한 번에 하나의 CPU 코어만 사용할 수 있습니다. 또한 단일 문서를 컴파일할 때 CPU가 주요 병목입니다. 따라서 CPU의 단일 코어 성능이 빠를수록 문서를 더 빠르게 컴파일할 수 있습니다. 코어 수가 더 많아지는 것은 사용 가능한 CPU 코어 수보다 더 많은 문서를 컴파일하려는 경우에만 도움이 됩니다.

다음을 사용하여 [ThuThesis 템플릿](https://www.overleaf.com/latex/templates/thuthesis-tsinghua-university-thesis-latex-template/cfwgcxtvkbsx) 을 예로 들면, 컴파일 시간은 Intel Core i9-14900K(5.6 Ghz)에서는 약 6초이며, AMD EPYC 7763(3.2Ghz) 기반의 Azure Standard D2as v5 인스턴스(2 vCPU, 8 GiB RAM)에서는 약 13초가 걸립니다.

물론 실제 컴파일 성능은 하드웨어 구성에 따라 달라집니다. 대부분의 서버 CPU는 14900K만큼 높은 클럭 속도로 동작하지 않으므로, 비용과 컴파일 속도 사이에서 절충해야 합니다.


---

# 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://ayakaleaf-pro.ayaka.space/on-premises/ko/installation/introduction.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.