> 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/upgrading-tex-live.md).

# TeX Live 업그레이드

{% hint style="danger" %}
다음 지침은 **만** 적용됩니다 **커뮤니티 에디션** 설치에 적용됩니다. Ayakaleaf Pro 사용자는 [샌드박스화된 컴파일](/on-premises/ko/configuration/overleaf-toolkit/sandboxed-compiles.md) 을 활성화할 것을 강력히 권장합니다. 이는 사용자에게 [overleaf.com](/on-premises/ko/configuration/overleaf-toolkit.md) 에서 사용되는 것과 거의 동일한 TeX Live 이미지에 대한 접근 권한을 제공하고, 프로젝트 컴파일 간 격리를 제공하여 보안을 향상시키기 때문입니다.
{% endhint %}

대역폭을 절약하기 위해 Overleaf 커뮤니티 에디션과 Ayakaleaf Pro 이미지에는 모두 [TeX Live](https://www.tug.org/texlive/)의 최소 설치만 포함되어 있습니다. 더 많은 패키지를 설치하거나 완전한 TeX Live 설치로 업그레이드하려면 [tlmgr](https://www.tug.org/texlive/tlmgr.html) 명령을 `sharelatex` 컨테이너에서 사용하면 됩니다.

#### sharelatex 컨테이너로 들어가기

안에서 셸을 시작하려면 `sharelatex` 컨테이너에서 실행하세요

```bash
bin/shell
```

다음과 같은 프롬프트가 표시됩니다:

```bash
root@309b192d4030:/#
```

다음 지침에서는 컨테이너 안에 있다고 가정하겠습니다.

#### 현재 TeX Live 버전 확인하기

TeX Live는 매년 4월경에 출시됩니다. 사용 `tlmgr` 방법은 현재 릴리스를 사용 중인지, 아니면 이전 버전을 사용 중인지에 따라 다릅니다. 현재 사용 중인 TeX Live 버전은 `tlmgr --version`으로 확인할 수 있습니다. 예를 들어, 이 설치는 TeX Live 2021을 실행합니다:

```bash
# tlmgr --version
tlmgr 개정판 59291 (2021-05-21 05:14:40 +0200)
tlmgr 설치 위치: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) 버전 2021
```

{% hint style="info" %}
현재 TeX Live 릴리스는 [TeX Live 홈페이지](https://www.tug.org/texlive/).
{% endhint %}

에서 찾을 수 있습니다. 더 오래된 TeX Live 버전을 사용 중이라면 두 가지 옵션이 있습니다. 새 버전의 Overleaf Docker 이미지는 일반적으로 TeX Live 릴리스 직후에 출시되므로, 그때까지 기다린 다음 `bin/upgrade` 스크립트를 사용해 배포를 업그레이드하거나, 이전 TeX Live 릴리스를 유지하려면 먼저 `tlmgr` 이 히스토릭 저장소를 사용하도록 알려야 합니다. 이를 수행하는 방법은 [여기](https://www.tug.org/texlive/acquire.html#past).

#### 패키지 설치하기

완전한 TeX Live 설치를 하려면, `sharelatex` 컨테이너 안에서 이 명령을 실행하세요:

```
tlmgr install scheme-full
```

개별 패키지를 수동으로 설치할 수도 있습니다:

```bash
tlmgr install tikzlings tikzmarmots tikzducks
```

{% hint style="warning" %}
부터 `3.3.0` 릴리스 이후에 실행하는 `tlmgr path add` 는 **필요합니다** 다음을 사용할 때마다 다시 `tlmgr install`를 실행해야 시스템 경로에 있는 모든 바이너리에 올바르게 심볼릭 링크가 생성됩니다.
{% endhint %}

사용할 수 있는 명령은 더 많습니다. 자세한 내용은 다음에서 확인하세요:

```
tlmgr help
```

끝나면 `exit` 를 입력하거나 Control-D를 눌러 셸을 종료하세요.

#### 변경 사항 저장하기

방금 적용한 변경 사항은 `sharelatex` 컨테이너를 변경했지만, 이는 일시적입니다 -- 예를 들어 구성을 업데이트하는 과정에서 Docker Compose가 컨테이너를 다시 생성하면 사라집니다.

이를 영구적으로 유지하려면 `docker commit` 을 사용하여 변경 사항을 새 docker 이미지에 저장하세요:

```bash
cat config/version #5.2.1
docker commit sharelatex sharelatex/sharelatex:5.2.1-with-texlive-full
echo 5.2.1-with-texlive-full > config/version
```

변경 사항을 커밋한 후 `config/version` 을 그에 맞게 업데이트하세요. 그런 다음 `bin/up`을 실행하여 `sharelatex` 컨테이너에서 사용하면 됩니다.

{% hint style="danger" %}
다음 경우마다 이 단계를 반복해야 합니다 [업그레이드할 때](https://github.com/overleaf/toolkit/blob/master/doc/upgrading.md) 새 Overleaf 버전으로.
{% 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/upgrading-tex-live.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.