메인 콘텐츠로 건너뛰기
Ayakaleaf Pro는 공식 Overleaf Community Edition을 그대로 대체할 수 있는 제품으로, Docker 이미지로 제공됩니다.

설치 방법 선택

Linux에 설치

Linux에서 Docker Compose 사용(Docker 포함)

Windows에 설치

Windows에서 Docker Compose 사용(WSL 사용)

Mac에 설치

macOS에서 Docker Compose 사용(Docker Desktop)

Kubernetes 클러스터에서 실행

Kubernetes 사용(실험적)

작은 서버에서 실행

소규모 서버 전용(2 GB 스왑 필요)

Claude나 Codex에게 설치 맡기기

Claude 또는 Codex 사용

브라우저에서 빠르게 체험

GitHub Codespace 사용(최소 TeX Live)

기존 Overleaf 마이그레이션

기존 Overleaf 인스턴스에서 마이그레이션

인터넷 없이 설치

내부용 에어갭/오프라인 배포
공식 Overleaf Server Pro에서 오셨나요? (차이점은 무엇인가요?) 마이그레이션하기 전에 이슈를 열어 주세요. 템플릿이 다른 방식으로 저장되므로, 저희가 무료로 도와드리겠습니다.
공식 Overleaf Community Edition으로 되돌아가고 싶으신가요? SERVER_PRO=false로 설정하거나(ayaka-notes Toolkit) override 파일을 제거하세요(공식 Toolkit). 데이터는 손실되지 않습니다.

하드웨어 요구 사항

관련 테스트를 수행한 결과, 2코어, 2 GB RAM 서버에서 Overleaf를 실행하면 주로 Node.js 기반인 핵심 구성 요소가 약 1 GB의 메모리를 사용합니다. Redis와 MongoDB는 추가로 0.5 GB가 필요할 수 있으며, 컴파일을 위해 샌드박스 Docker 컨테이너를 시작하면 0.3 GB가 더 사용될 수 있습니다. 즉, 2코어, 2 GB 서버는 현실적으로 한 번에 약 하나의 동시 컴파일만 처리할 수 있습니다.
  • Ayakaleaf Pro 설치를 위한 최소 하드웨어 요구 사항은 2코어 CPU와 3 GB RAM입니다.
  • TeX Live 이미지의 크기 때문에 샌드박스 컴파일을 활성화하려면 최소 40 GB의 스토리지가 필요합니다.
  • 2020년부터 2026년까지의 TeX Live 이미지 전체를 설치하려면 최소 150 GB의 여유 디스크 공간이 있는지 확인하세요.
다음은 사용 시나리오별 권장 하드웨어 구성입니다.

소프트웨어 요구 사항

소프트웨어 요구 사항으로는 최근의 안정적인 Ubuntu 버전(예: 2025–2026년에는 Ubuntu 24.04, 2023–2024년에는 Ubuntu 22.04)과 최신 안정 버전의 Docker를 함께 사용할 것을 권장합니다.
Ubuntu 26.04는 Linux 커널 7.0을 탑재하고 있으며, MongoDB는 Linux 커널 6.19부터 7.0.13까지에서 시작을 거부합니다(자세히 보기). 이러한 커널에서 실행하려면 overleaf-toolkit/config/docker-compose.override.yml(Ayakaleaf Pro 이미지를 설정하는 것과 같은 파일)의 mongo 서비스에 다음 내용을 추가하세요. 저희 CI는 이 설정으로 Ubuntu 26.04에서 실행됩니다. 커널 7.0.14 이상에서는 필요하지 않습니다.
docker-compose.override.yml
공유 서버 및 프로덕션 서버에는 Linux를 권장합니다. Docker Desktop을 사용하여 macOS 또는 WSL 2를 사용하는 Windows에서도 Ayakaleaf Pro를 실행할 수 있습니다. 사용하는 플랫폼에 맞는 가이드를 따르세요. 이미지는 AMD64와 ARM64를 모두 지원합니다.

LaTeX 성능

LaTeX는 단일 스레드 프로그램이므로 한 번에 하나의 CPU 코어만 사용할 수 있습니다. 단일 문서를 컴파일할 때 성능은 주로 CPU의 단일 코어 클럭 속도에 의해 제한됩니다. 따라서 CPU의 단일 코어 성능이 빠를수록 문서를 더 빨리 컴파일할 수 있습니다. CPU 코어가 많으면 여러 사용자가 동시에 문서를 컴파일할 때에만 도움이 됩니다. ThuThesis 템플릿을 예로 들면, Intel Core i9-14900K(5.6 GHz)에서는 컴파일 시간이 약 6초인 반면, AMD EPYC 7763(3.2 GHz) 기반의 Azure Standard D2as v5 인스턴스(2 vCPU, 8 GiB RAM)에서는 약 13초가 걸립니다. 물론 실제 컴파일 성능은 하드웨어 구성에 따라 달라집니다. 대부분의 서버 CPU는 14900K만큼 높은 클럭 속도로 동작하지 않으므로 비용과 컴파일 속도 사이에서 절충해야 합니다. 한편 LaTeX 컴파일 성능에 대한 심층 분석도 진행했습니다. 관심이 있다면 블로그 글 Overleaf Benchmark: A Deep Research of Concurrent LaTeX Compilation in Overleaf (SaaS and Self-host)를 참고하세요.
마지막 수정일 2026년 11월 21일