> 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/maintenance/upgrading-your-deployment.md).
# 배포 업그레이드
{% hint style="danger" %}
반드시 [일관된 백업](/on-premises/ko/maintenance/data-and-backups.md#performing-a-consistent-backup) **이전** 을 각 주 버전 업그레이드마다 수행하여, 필요할 경우 되돌릴 수 있도록 해야 합니다.
{% endhint %}
다음 [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) git 저장소이므로 새로운 Toolkit 기능을 쉽게 가져올 수 있습니다. 다음을 실행하기만 하면 됩니다. `bin/upgrade` 명령을 실행하고 화면의 안내를 따르세요.
Docker 이미지 버전(에서 `config/version`)는 Toolkit 코드 업데이트와 별도로 관리됩니다. Toolkit 코드를 업데이트하면 **하지** 실행 중인 Docker 이미지의 버전이 자동으로 변경됩니다. 즉, 대부분의 경우 배포를 업그레이드하지 않고도 Toolkit 버전을 업그레이드할 수 있습니다.
#### 다음 `bin/upgrade` 스크립트
다음을 실행하면 `bin/upgrade` 명령, 스크립트가 Toolkit 코드에 사용 가능한 업데이트가 있는지 확인한 다음 Toolkit을 업데이트할지 제안합니다. 이 업그레이드는 언제든 거절할 수 있으며, 아무것도 변경되지 않습니다.
Toolkit 코드를 업데이트하기로 선택하면, 스크립트는 다음을 확인합니다. *기본* Docker 이미지 버전이 변경되었는지 확인한 다음, 로컬 버전 파일(에서)을 새 기본값에 맞게 업그레이드할지 제안합니다. `config/version`)
버전을 전환하기로 선택하면, 스크립트가 Docker 서비스를 종료하고, 백업을 생성한 뒤, Docker 서비스를 다시 시작하는 과정을 안내합니다. 이전 버전 파일은 자동으로 `config/__old-version`에 복사되므로, Docker 이미지의 해당 버전으로 되돌려야 할 경우를 대비할 수 있습니다.
{% hint style="danger" %}
Server CE/Pro를 업그레이드할 때는 배포된 주 버전의 최신 릴리스로 업그레이드한 다음 **이전** 최신 릴리스로 업그레이드하기 전에 **다음** 주 버전입니다. 배포가 최신보다 두 개 이상의 주 버전 뒤처져 있다면 단계별 다중 업그레이드를 수행해야 합니다.
예를 들어 3.5.10을 실행 중이라면 3.5.13으로 업그레이드 -> 전체 프로젝트 기록 마이그레이션 수행 -> 4.2.9 -> 5.5.4 순으로 진행해야 합니다.
업데이트해야 합니다 **절대** 주 버전(3.5.10 -> 5.5.4)을 건너뛰지 마세요. Toolkit을 사용 중이고 최신보다 두 개 이상의 주 버전 뒤처져 있다면 **하지** 마세요 `bin/upgrade` 스크립트를 사용하면 안 됩니다. 수동 다중 단계 업그레이드를 수행해야 하기 때문입니다.
{% endhint %}
{% hint style="info" %}
Docker 이미지를 수동으로 가져오는 에어갭 설정의 경우 `PULL_BEFORE_UPGRADE=false` 에서 `config/overleaf.rc` 파일로 설정해 주세요.
다음을 확인해 주세요. [여기](/on-premises/ko/installation/air-gapped-offline-deployments.md) 에어갭/오프라인 환경에서의 배포에 대한 자세한 내용은
{% endhint %}
### 업그레이드 경로
다음 `bin/upgrade` 명령은 항상 해당 시점에 사용 가능한 Server Pro/CE의 가장 최신 버전을 선택합니다. 업그레이드 주기가 드문 경우, 이로 인해 주요 버전을 건너뛰게 되어 예상하지 못한 버전으로 업그레이드될 수 있습니다.
업그레이드할 때는 다음 주요 버전의 최신 릴리스로 업그레이드하기 전에 현재 주요 버전의 최신 릴리스로 먼저 업그레이드하는 것을 권장합니다. 예를 들어 현재 3.3.2를 사용 중이고 사용 가능한 최신 버전이 5.3.1이라면, 올바른 업그레이드 경로는 다음과 같습니다:
* 3.3.2 -> 3.5.13
* 3.5.13 -> 4.2.9
* 4.2.9 -> 5.5.1
업그레이드 문제를 방지하기 위해 다음을 참고하실 것을 권장합니다. [릴리스 노트](https://docs.overleaf.com/on-premises/release-notes) 일부 버전은 추가 단계가 필요할 수 있으므로, 어떤 업그레이드를 수행하기 전에 미리 확인해 주세요. 예를 들어 Toolkit에 수동 변경을 적용하거나, 데이터베이스를 업그레이드하거나, 마이그레이션 스크립트를 실행하는 등의 작업이 필요할 수 있습니다.
아직 하지 않으셨다면, 새로운 버전/업데이트가 출시될 때 알림을 받을 수 있도록 다음에 가입해 주세요. [메일링 리스트](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) 이를 통해 릴리스 일정에 가깝게 정기적인 유지보수 창을 계획할 수 있습니다.
---
# 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/maintenance/upgrading-your-deployment.md?ask=&goal=
```
`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.