> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/ko/installation/upgrading-tex-live.md).

# TeX Live 업그레이드

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

{% hint style="warning" %}
다음 지침은 **오직** Community Edition 설치에 적용됩니다. Overleaf Pro 사용자는 [샌드박스화된 컴파일](broken://pages/c7999a2e39f906d951c2b5ec2f2c14ba192eea5c) 를 활성화할 것을 강력히 권장합니다. 이렇게 하면 사용자가 [overleaf.com](/on-premises/ko/configuration/overleaf-toolkit.md) 에서 사용되는 것과 동일한 TeX Live 이미지에 접근할 수 있으며, 프로젝트 컴파일 간 격리를 통해 보안도 향상됩니다.
{% endhint %}

#### 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 revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr using installation: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) version 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://overleaf-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.