> 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/air-gapped-offline-deployments.md).

# 에어갭/오프라인 배포

일반적으로 AyakaLeaf Pro를 오프라인 환경에 배포하는 것은 권장하지 않습니다. GitHub Sync 및 Zotero 통합과 같은 많은 기능이 인터넷 연결을 필요로 하기 때문입니다.

하지만 오프라인에서 작업하고 싶다면, 필요한 이미지를 가져오기 위해 ghcr.io 레지스트리에 항상 접근할 수 없을 수 있다는 뜻입니다 `sharelatex` , `ayakaleaf-pro` 그리고 TeX Live 이미지들. Docker는 오프라인/에어갭 배포에 도움이 되는 이미지 내보내기 및 가져오기 도구를 제공하므로 이는 문제가 되지 않습니다.

큰 틀에서 보면, 인터넷 연결이 가능한 장치에서 필요한 이미지를 다운로드해 휴대용 장치로 내보내거나(SCP/Rsync를 사용해 전송할 수도 있음), 에어갭 서버로 가져오면 됩니다.

이를 위해 다음 단계를 완료해야 합니다:

* 필요한 모든 이미지를 가져오기( `overleaf-pro`, `git-bridge`, `mongo`, `redis` + 필요한 [TeX Live 이미지](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles#available-tex-live-images) 과 함께 사용하기 위한 [샌드박스화된 컴파일](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles)) 인터넷 연결이 가능한 머신에서
  * `docker pull ghcr.io/ayaka-notes/overleaf-pro:6.1.2`
  * `docker pull quay.io/sharelatex/git-bridge:6.1.2` (태그는 다음과 동일해야 합니다: `overleaf-pro`)
  * `docker pull mongo:6` (실제 버전으로 변경해 주세요)
  * `docker pull redis:6.2` (실제 버전으로 변경해 주세요)
  * `docker pull ghcr.io/ayaka-notes/texlive-full:2024.1` (실제 버전으로 변경해 주세요)
* 각 **각** 가져온 이미지들에 대해, 그런 다음 .tar 파일로 내보내야 합니다. 예를 들어, `docker save ghcr.io/ayaka-notes/overleaf-pro:6.1.2 > overleaf-pro:6.1.2.tar`
* 선호하는 방법을 사용하여 `.tar` 파일들을 인터넷에 연결된 머신에서 오프라인/에어갭 서버로 전송하세요
* 각 .tar 파일에 대해, `docker load` 명령을 사용하여 .tar 파일에서 이미지를 불러오세요. 예를 들어, `docker load < overleaf-pro:6.1.2.tar`
* 마지막으로, `docker images` 명령을 실행하여 이미지 로드가 성공했는지, 그리고 이미지가 사용 가능한지 확인합니다

{% hint style="danger" %}
기본적으로, `bin/up` 명령을 실행하면 Toolkit은 `ALL_TEX_LIVE_DOCKER_IMAGES` 의 `config/variables.env`. 에서 설정된 각 TeX Live 이미지를 자동으로 가져오려고 시도합니다. 배포 환경이 에어갭이므로 이는 실패할 것입니다. 이를 막으려면 `SIBLING_CONTAINERS_PULL=false` 의 `config/overleaf.rc`.
{% endhint %}


---

# 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/air-gapped-offline-deployments.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.