Ayakaleaf Pro 라이선스는 어떠한 제한도 없이 모든 환경에서 애플리케이션을 실행할 수 있도록 허용합니다. 테스트용 비프로덕션 환경을 마련할 것을 강력히 권장합니다.
Ayakaleaf Pro 6.3.0
릴리스 날짜: 2026.10.03 (재릴리스, 최초 릴리스는 2026.09.24) 참고: https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.3.0기존 설치를 위한 Zotero / Mendeley 마이그레이션
기존 설치를 위한 Zotero / Mendeley 마이그레이션
재릴리스된 6.3.0 이미지로 업그레이드할 때는 아래 스크립트를 사용하여 기존 Zotero/Mendeley 연결 참고문헌 메타데이터를 마이그레이션하세요. 이 마이그레이션은 수정 사항 이 스크립트는 중첩된 폴더도 처리하며 Zotero/Mendeley 메타데이터만 변경합니다. 다시 실행해도 안전합니다. 마이그레이션이 완료된 경우 다음 실행 시
12031b8dfd와 함께 제공됩니다.이 마이그레이션은 zoteroGroupId / mendeleyGroupId를 group_id로, importedByUserId를 importer_id로 이름을 바꾸고 importedByName을 제거합니다.마이그레이션을 실행하기 전에 MongoDB를 백업하고 애플리케이션을 중지하세요. MongoDB는 계속 실행 상태로 둡니다. MongoDB 셸을 엽니다(mongo를 컨테이너 이름으로 바꾸세요).mongosh에서 다음을 실행합니다(sharelatex를 데이터베이스 이름으로 바꾸세요).Updated 0 project(s).를 출력합니다. 충돌로 인해 중단되면 보고된 프로젝트/파일을 확인하세요. 그 이전의 프로젝트는 이미 마이그레이션되었을 수 있습니다.업데이트된 애플리케이션을 시작하고 편집기를 새로 고친 다음, 원래 가져온 사용자로 기존 참고문헌 파일을 새로 고칩니다. 과거 스냅샷은 다시 작성되지 않습니다. 이전 애플리케이션으로 다운그레이드하려면 MongoDB 백업을 복원하세요.변경 사항
- AI 채팅 어시스턴트: 자체 공급자를 통해 편집기 안에서 바로 AI 모델과 대화할 수 있습니다.
- LaTeX 오류 어시스턴트: LaTeX 컴파일 오류에 대해 AI가 제안하는 수정 사항을 받을 수 있습니다.
- Mendeley 연동: Zotero와 마찬가지로 Mendeley에서 참고문헌을 가져올 수 있습니다.
- Open in Overleaf API: Overleaf에서 콘텐츠를 여는 API를 추가했습니다.
- 템플릿 갤러리: 서버 측 페이지네이션, 검색, 정렬을 추가하여 대규모 갤러리에서도 더 이상 브라우저에서 모든 템플릿을 불러올 필요가 없습니다.
- 번역: 지원되는 언어 전반의 새 인터페이스 텍스트를 포함하여 6.3.0용 번역 패치를 업데이트했습니다.
- 업스트림 Overleaf 6.3.0: 탭 방식의 파일 편집, 라이트 및 다크 테마별 헤더 로고, 종속성 및 기본 이미지 업데이트가 포함되어 있습니다.
- 라이트 및 다크 테마에 서로 다른 헤더 로고 이미지를 지원하기 위해
OVERLEAF_HEADER_IMAGE_URL_LIGHT및OVERLEAF_HEADER_IMAGE_URL_DARK를 추가했습니다. - 이제 편집기에서 파일을 서로 다른 탭으로 열 수 있습니다.
OVERLEAF_LINKED_URL_OUTBOUND_PROXY를 통해 로컬 호스팅 프록시를 포함한 구성 가능한 HTTP(S) 프록시를 지원합니다. 이 설정은 Open in Overleaf API에서도 사용됩니다.
기능 01: AI 어시스턴트 출시
AI만 있으면 됩니다. 설정 튜토리얼을 참고하세요: AI 연동기능 02: Open in Overleaf API
이 기능은 기본적으로 활성화되어 있으며, 자체 Overleaf 인스턴스에서 LaTeX 프로젝트를 여는 링크를 직접 생성할 수 있습니다. 자세한 내용은your.overleaf.com/devs를 방문하세요. 참고: Overleaf Import API
기능 03: Mendeley 연동
Zotero 연동과 유사합니다. 참고: Mendeley 연동기능 04: 템플릿 페이지네이션
이제 갤러리는 MongoDB에서 페이지 나누기, 정렬, 검색을 수행합니다. 별도의 준비 없이 동작하지만, 템플릿이 수천 개라면 빠른 속도를 유지하기 위해 다음 인덱스를 추가할 수 있습니다(다시 실행해도 안전하며,mongo/sharelatex는 컨테이너 및 데이터베이스 이름입니다).
*_ci 인덱스의 collation은 작성된 그대로 유지하세요. 갤러리는 동일한 collation으로 쿼리하며, MongoDB는 일치하는 인덱스만 사용합니다.
Docker 이미지
Docker 이미지는 여기에서 확인할 수 있습니다: https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-pro공식 릴리스 노트
공식 릴리스 노트
릴리스 날짜: 2026-08-28샌드박스 컴파일을 실행하는 Server Pro 인스턴스에서 TexLive 2026을 사용할 수 있습니다. 업그레이드 방법은 문서를, 이 버전의 주요 변경 사항은 릴리스 노트를 확인하세요.새 기능
- 라이트 및 다크 테마에 서로 다른 헤더 로고 이미지를 지원하기 위해
OVERLEAF_HEADER_IMAGE_URL_LIGHT및OVERLEAF_HEADER_IMAGE_URL_DARK를 추가했습니다. - 이제 편집기에서 파일을 서로 다른 탭으로 열 수 있습니다.
- 기본 이미지 및 설치된 패키지의 보안 업데이트.
Ayakaleaf Pro 6.2.2
릴리스 날짜: 2026.07.23 참고: https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.2.2변경 사항
업스트림 Overleaf6.2.2에 포함된 공식 핫픽스 패치를 (6.2.1 위에) 백포트했습니다.
- 프로젝트 초대 토큰 비밀 값이 로그에 유출되지 않도록 했습니다. 초대 토큰 암호화기는 암호화/복호화할 때마다 자체 구성을 로그에 기록했는데, 여기에는
OVERLEAF_INVITE_TOKEN_SECRET에서 파생된 암호 비밀번호가 포함되어 있었습니다. - 발신 이메일을 지원이 종료된 AWS SES v1 클라이언트에서 SESv2로 마이그레이션했습니다.
ses이메일 드라이버로 구성된 인스턴스에서는 이메일 전송이 아예 실패할 수 있었으며, 이제SESv2Client를 통해 전송합니다. - 프로젝트 공유 드롭다운의 그룹 항목을 새
group-link-sharing기능 플래그로 제어하여, 해당되지 않는 인스턴스에서는 더 이상 그룹 링크 공유가 제공되지 않습니다. - 공동 작업자를 위한 프로젝트 공유 모달을 수정했습니다. 소유자가 아닌 사용자로 열거나
sharing-updates흐름이 비활성화된 상태에서 열면 항상 실패하는 요청이 전송되어 “문제가 발생했습니다” 오류가 표시되었습니다. - document-updater에
scripts/flush_docs_with_pending_updates.js를 추가했습니다. 이 유지 관리 스크립트는 프로젝트가 플러시되거나 영구 삭제된 후 Redis에PendingUpdates대기열이 멈춘 채 남아 있는 문서를 복구합니다.--dry-run및--estimated-docs안전 검사를 지원합니다. - 종속성 업데이트:
multer2.2.0,form-data2.5.6,protobufjs7.6.3,@grpc/grpc-js1.14.4.
- 16개 언어(cs, da, de, es, fi, fr, it, ja, ko, nl, no, pl, pt, ru, sv, tr)에 대한 전체 번역을 추가하여 비밀번호 재설정 페이지 등 번역되지 않은 문자열을 수정했습니다. #38을 수정합니다.
- 복수형 자리 표시자가 올바르게 전달되지 않아 관리자 패널의 “프로젝트 N개 더 보기” 버튼에 잘못된 숫자가 표시되던 문제를 수정했습니다.
- GitHub 내보내기 유효성 검사 오류가 원시 메시지 대신 정적 i18n 키로 렌더링되도록 수정하고, GitHub 동기화 모달에서 더 이상 사용되지 않는 오류 키를 제거했습니다.
Docker 이미지
Docker 이미지는 여기에서 확인할 수 있습니다: https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-pro공식 릴리스 노트
공식 릴리스 노트
릴리스 날짜: 2026-07-20버그 수정
- #1499: 설정에서
OVERLEAF_INVITE_TOKEN_SECRET이 무시되던 문제 수정 - 손상된 SES API 이메일 전송 문제 해결
- LDAP: 이메일 주소를 사용자 이름으로 사용할 때 발생하는 “유효하지 않은 이메일 주소” 오류 해결
- Git: 외부 URL에서 로그 레벨을 폴링할 때 발생하는 “fetch” 오류 해결
- 프로젝트 공유 모달에 표시되던 오류 알림 해결
- 멈춘 문서를 관리하기 위한
flush_docs_with_pending_updates스크립트 도입 - 내부 종속성 갱신
Ayakaleaf Pro 6.2.1
릴리스 날짜: 2026.07.18 참고: https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.2.1변경 사항
업스트림 Overleaf6.2.1에 포함된 공식 핫픽스 패치를 (6.2.0 위에) 백포트했습니다.
- 실시간
applyOtUpdate메시지가 아무 객체나 받아들이는 대신 엄격한 유효성 검사 스키마를 사용하도록 강화하여, 잘못된 형식의 편집 작업을 거부합니다. - 해당 스키마를 완화하여
meta.tc를 선택 사항으로 만들었으므로, 유효한 업데이트가 더 엄격한 유효성 검사로 인해 거부되지 않습니다. - 원격/동시 작업으로 상쇄되었거나 실행 취소로 완전히 되돌려져 빈 작업이 된 경우, 편집기(ShareJS 클라이언트)가 이를 서버로 보내지 않고 버리며 문서가 올바르게 저장된 것으로 표시되도록 수정했습니다. 실행 취소 및 동시 편집과 관련된 잘못된 동기화 / “저장되지 않은 변경 사항” 문제를 방지합니다.
Docker 이미지
Docker 이미지는 여기에서 확인할 수 있습니다: https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-proAyakaleaf Pro 6.2.0
릴리스 날짜: 2026.07.10 참고: https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.2.0 커뮤니티에서 가장 강력하고 기능이 풍부한 온라인 LaTeX 편집기인 Overleaf Pro 6.2.0의 릴리스를 발표하게 되어 자랑스럽습니다. 소중한 기여를 해 주신 yu-i-i와 davrot에게 특별히 감사드립니다. 이들은 GitHub 동기화를 개선하고 고급 인용 검색과 Zotero 연동을 도입했습니다.참고 사항
- 새 프로젝트에서 사용하는 기본 컴파일러(
pdflatex,latex,xelatex,lualatex중 하나)를 설정하는 새 환경 변수DEFAULT_LATEX_COMPILER를 추가했습니다. - 이제 새롭게 디자인된 편집기만 사용할 수 있습니다.
변경 사항
이 릴리스에는 다음과 같은 개선 사항과 새 기능이 포함되어 있습니다.- 이제
MAX_UPLOAD_SIZE를 50 MB로 제한하지 않고 구성할 수 있습니다. - 샌드박스 컴파일이 비활성화되었을 때 컨테이너가 재시작을 반복하던 문제를 수정했습니다.
- OAuth2에서 소유자 범위의 PAT 삭제를 적용했습니다.
- LDAP 가져오기 문제를 수정했습니다.
- 브라우저 기반 Python 실행기를 추가했습니다.
- Markdown, DOCX 및 기타 형식의 가져오기와 내보내기를 위한 Pandoc 지원을 추가했습니다.
- GitHub 동기화를 추가했습니다.
- 완전한 중국어 번역을 추가했습니다.
- Zotero 연동을 추가했습니다.
DEFAULT_LATEX_COMPILER를 추가했습니다.
기능 01: GitHub 동기화
LaTeX 프로젝트를 GitHub 저장소와 동기화하여 매끄러운 개발 워크플로를 유지하세요. 편집기에서 직접 변경 사항을 푸시하고 풀하며, 풀 리퀘스트로 협업하고, 기존 CI/CD 파이프라인과 통합할 수 있습니다. 버전 관리를 통해 수정 내역을 추적하고, 변경 사항을 검토하고, 재현 가능한 학술 또는 기술 문서를 손쉽게 관리할 수 있습니다. 참고: GitHub 동기화기능 02: Pandoc 가져오기/내보내기
Microsoft Word 및 Markdown 문서를 완전히 편집 가능한 LaTeX 프로젝트로 가져오거나, 클릭 한 번으로 LaTeX 프로젝트를 Markdown 및 DOCX로 다시 내보낼 수 있습니다. Pandoc 기반의 이 기능은 문서 구조를 최대한 보존하면서 학술 작성, 공동 편집, 출판 워크플로 간의 매끄러운 상호 운용성을 제공합니다. 참고: Pandoc 가져오기 및 내보내기기능 03: 고급 참고문헌 검색
지능형 필터링과 즉각적인 인용 지원으로 여러 학술 데이터베이스에서 참고문헌을 검색하고 삽입할 수 있습니다. 여러 연구 웹사이트를 오가지 않고도 논문을 빠르게 찾고, 메타데이터를 미리 보고, 정확한 BibTeX 항목을 만들 수 있어 문헌 검토 효율이 크게 향상됩니다.기능 04: Python 실행기
편집기를 떠나지 않고 프로젝트 안에서 직접 Python 코드를 실행할 수 있습니다. 그림 생성, 데이터셋 처리, 문서 워크플로 자동화, 재현 가능한 연구 스크립트 실행에 적합합니다. 결과를 LaTeX 문서에 통합할 수 있어 과학 계산과 글쓰기를 하나의 워크플로로 통합할 수 있습니다.기능 05: Zotero
Zotero 라이브러리를 작성 워크플로에 직접 연결하고 편집기를 떠나지 않고 참고문헌을 관리하세요. 개인 Zotero 컬렉션을 검색하고, 클릭 한 번으로 인용을 삽입하고, BibTeX 항목을 자동으로 생성 및 동기화할 수 있습니다. 이 연동은 참고문헌 목록을 최신 상태로 유지하여 학술 논문, 학위 논문, 기술 문서의 문헌 관리를 간소화합니다. 참고: Zotero 연동Docker 이미지
Docker 이미지는 여기에서 확인할 수 있습니다: https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-pro공식 릴리스 노트
공식 릴리스 노트
호환성이 깨지는 변경 사항
-
새로운 필수 환경 변수
OVERLEAF_INVITE_TOKEN_SECRET이 도입되었습니다. 다음 명령으로 생성하세요.최소 길이: 16자.
- 이제 새롭게 디자인된 편집기만 사용할 수 있습니다.
DEFAULT_LATEX_COMPILER를 추가했습니다.
- 비활성화된 경우 다른 프로젝트나 외부 URL에서 이미지를 삽입하는 옵션을 제거했습니다.
- 이메일 스타일을 업데이트했습니다.
- 기본 이미지, 패키지, 내부 종속성을 업데이트했습니다.
Ayakaleaf Pro 6.1.2
릴리스 날짜: 2026.02.21 참고: https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.1.2변경 사항
- ayaka-notes filestore 패치를 되돌림(PDF 표지 회전 문제는 업스트림에서 이미 수정됨)
- filestore에
poppler-utils설치(Overleaf 공식) - PDF 표지를 PNG로 변환할 때
convert대신pdftocairo사용(Overleaf 공식) - 미리보기(1000) 및 썸네일(700) 이미지의 너비 조정(Overleaf 공식)
Docker 이미지
Docker 이미지는 여기에서 확인할 수 있습니다: https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-pro알려진 문제
이 버전에서는 LDAP가 동작하지 않습니다. LDAP를 활성화하지 않는 한 다른 기능에는 영향이 없습니다. 관련 버그를 업스트림에 보고했으며, 다음 버전에서 LDAP 종속성을 업데이트할 예정입니다.Ayakaleaf Pro 6.1.1
릴리스 날짜: 2026.02.20 참고: https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.1.1변경 사항
Overleaf에서 전체 테마를 활성화했습니다.Docker 이미지
Docker 이미지는 여기에서 확인할 수 있습니다: https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-pro참고 사항
마이그레이션: 기존 CE/Overleaf 사용자라면 6.1.0에서 기록 되돌리기 기능을 활성화했으므로, 이 기능을 사용하려면 기존 프로젝트를 업데이트해야 합니다. 자세한 내용은 Overleaf Pro v6.1.0 릴리스를 참고하세요.공식 릴리스 노트
공식 릴리스 노트
버그 수정
OVERLEAF_PROXY_LEARN이true로 설정되지 않았을 때 잘못된 문서 링크가 표시되던 문제를 수정했습니다.- 새롭게 디자인된 편집기 설정 모달에서 잘못된 구독 링크를 제거했습니다.
- 메뉴에서 잘못된 문의하기 링크를 제거했습니다.
- 내부 종속성을 업데이트했습니다.
Ayakaleaf Pro 6.0.1
릴리스 날짜: 2026.02.20 테스트 패치 릴리스입니다. 참고: https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.0.1 마이너 버전 릴리스를 위한 테스트 릴리스이며, 추가 기능은 없습니다. 이 릴리스는 최신 runc 업데이트 이후 발생한 여러 컴파일 문제를 수정합니다.이제 Server CE/Pro 6.0.1의 최소 MongoDB 버전은 MongoDB 8.0입니다. MongoDB 업그레이드에 관한 문서는 여기에서 확인할 수 있습니다.
Docker 이미지
Docker 이미지는 여기에서 확인할 수 있습니다: https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-proAyakaleaf Pro 6.0.0
릴리스 날짜: 2026.02.17 테스트 릴리스입니다. 참고: https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.0.0 이 릴리스는 테스트 릴리스이자 Overleaf Pro의 첫 번째 버전입니다. 이 버전에는 Server Pro의 기능이 포함되어 있지 않으므로 출발점으로만 표시됩니다. 관리자 패널, git-bridge 등 새 기능은 나중에 추가할 예정입니다. 이번 릴리스에서는 ARM용 Overleaf Docker 이미지를 도입했습니다. Mac이나 ARM 기반 서버가 있다면 사용해 볼 수 있지만, 일부 기능은 제대로 동작하지 않을 수 있습니다(아직 테스트되지 않음).Docker 이미지
Docker 이미지는 여기에서 확인할 수 있습니다: https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-pro 멀티 아키텍처 이미지는 여기를 참고하세요.바이너리 파일 마이그레이션
이번 새 릴리스는 바이너리 파일의 스토리지 사용량을 절반으로 줄입니다. 버전5.5에는 온라인 마이그레이션이 포함되어 있어 업그레이드 과정에서 다운타임을 최소화할 수 있습니다. Server Pro v6로 업그레이드하기 전에 이미 Server Pro v5.5의 최신 버전(릴리스 노트 5.x.x)을 실행 중이며 마이그레이션을 실행했는지 확인하세요.
전체 마이그레이션 지침 보기.
MongoDB v8로 업그레이드
이 릴리스는 최소 MongoDB 버전을8.0으로 올립니다.
현재 MongoDB v6 이하를 사용 중이라면 한 번에 하나의 메이저 버전씩 업데이트해야 합니다(v6 → v7 → v8).
MongoDB v6 → v7 → v8 업그레이드 방법은 여기의 단계별 가이드를 참고하세요.
Redis v7.4로 업그레이드
이 릴리스는 최소 Redis 버전도7.4로 올립니다.
config/overleaf.rc의 REDIS_IMAGE를 REDIS_IMAGE=7.4로 업데이트하세요.
새 기능
- 이제
OVERLEAF_DISABLE_LINK_SHARING=true로 링크 공유를 비활성화할 수 있습니다. - 이제
OVERLEAF_MAINTENANCE_MESSAGE및OVERLEAF_MAINTENANCE_MESSAGE_HTML로 유지 관리 페이지의 제목과 내용을 사용자 지정할 수 있습니다. OVERLEAF_USER_HARD_DELETION_DELAY및OVERLEAF_PROJECT_HARD_DELETION_DELAY를 (밀리초 단위로) 구성하여 삭제된 사용자/프로젝트의 만료 지연 시간(기본값 90일)을 변경할 수 있습니다.
버그 수정
- 링크가 포함된 푸터 렌더링을 수정했습니다.
- SAML 로그인 오류 시의 오류 메시지를 개선했습니다.
- SSO 로그인 시 사용자의 관리자 상태가 업데이트될 때 감사 로그 항목이 추가되지 않던 문제를 수정했습니다.
- Redis에서 TLS가 활성화되었을 때 발생하던 기록 패널 오류를 수정했습니다.
- 이제 샌드박스가 아닌 컴파일을 사용할 때도 컴파일을 중지할 수 있습니다.
기타 변경 사항
- 상태 페이지(
OVERLEAF_STATUS_PAGE_URL로 설정)로 연결되는 모든 링크가 이제HTTPS를 사용하며 새 브라우저 탭에서 열립니다.

