설치 방법 선택
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으로 되돌아가고 싶으신가요?
공식 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

