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

# Nâng cấp TeX Live

Để tiết kiệm băng thông, cả hai ảnh Overleaf Community Edition và Overleaf Pro chỉ đi kèm với một bản cài đặt tối thiểu của [TeX Live](https://www.tug.org/texlive/). Bạn có thể cài thêm các gói hoặc nâng cấp lên một bản cài đặt TeX Live đầy đủ bằng cách sử dụng [tlmgr](https://www.tug.org/texlive/tlmgr.html) lệnh trong `sharelatex` container.

{% hint style="warning" %}
Các hướng dẫn sau đây **chỉ** áp dụng cho các cài đặt Community Edition. Chúng tôi đặc biệt khuyến nghị người dùng Overleaf Pro bật [Biên dịch trong môi trường sandbox](broken://pages/3957e59109fbce4b81a0898f76608b14dc1642c2) vì điều này cung cấp cho người dùng quyền truy cập vào cùng các ảnh TeX Live được sử dụng trên [overleaf.com](/on-premises/vi/cau-hinh/overleaf-toolkit.md) đồng thời cung cấp sự cô lập giữa các lần biên dịch dự án để tăng cường bảo mật.
{% endhint %}

#### Truy cập vào bên trong container sharelatex

Để khởi động một shell bên trong `sharelatex` container, hãy chạy

```bash
bin/shell
```

Bạn sẽ nhận được một dấu nhắc trông như sau:

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

Trong các hướng dẫn sau, chúng tôi sẽ giả định rằng bạn đang ở trong container.

#### Xác định phiên bản TeX Live hiện tại của bạn

TeX Live được phát hành hằng năm vào khoảng tháng Tư. Các bước để sử dụng `tlmgr` khác nhau tùy thuộc vào việc bạn đang dùng bản phát hành hiện tại hay một bản cũ hơn. Bạn có thể kiểm tra phiên bản TeX Live bạn đang chạy bằng `tlmgr --version`. Ví dụ, bản cài đặt này đang chạy 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" %}
Bản phát hành hiện tại của TeX Live có thể được tìm thấy trên [trang chủ TeX Live](https://www.tug.org/texlive/).
{% endhint %}

Nếu bạn đang chạy một phiên bản TeX Live cũ hơn, bạn có hai lựa chọn. Một phiên bản mới của ảnh Docker Overleaf thường được phát hành ngay sau khi TeX Live phát hành, bạn có thể chờ nó và nâng cấp triển khai của mình bằng `bin/upgrade` script, hoặc, nếu bạn muốn giữ bản phát hành TeX Live cũ hơn, trước tiên bạn cần yêu cầu `tlmgr` sử dụng một kho lưu trữ lịch sử. Bạn sẽ tìm thấy hướng dẫn để làm điều đó [tại đây](https://www.tug.org/texlive/acquire.html#past).

#### Cài đặt các gói

Để cài đặt một bản TeX Live đầy đủ, hãy chạy lệnh này bên trong `sharelatex` container:

```
tlmgr install scheme-full
```

Bạn cũng có thể cài đặt từng gói riêng lẻ theo cách thủ công:

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

{% hint style="warning" %}
Từ `3.3.0` bản phát hành trở đi, việc chạy `tlmgr path add` là **là bắt buộc** lại sau mỗi lần sử dụng `tlmgr install`, để tạo liên kết tượng trưng đúng cách cho tất cả các tệp thực thi vào đường dẫn hệ thống.
{% endhint %}

Còn nhiều lệnh khác nữa. Tìm hiểu thêm bằng:

```
tlmgr help
```

Khi bạn xong, hãy gõ `exit` hoặc nhấn Control-D để thoát shell.

#### Lưu các thay đổi của bạn

Những thay đổi bạn vừa thực hiện đã thay đổi `sharelatex` container, nhưng chúng chỉ là tạm thời -- chúng sẽ bị mất nếu Docker Compose tạo lại container, ví dụ như trong quá trình cập nhật cấu hình.

Để làm cho chúng tồn tại lâu dài, hãy sử dụng `docker commit` để lưu các thay đổi vào một ảnh Docker mới:

```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
```

Sau khi commit các thay đổi, hãy cập nhật `config/version` cho phù hợp. Sau đó chạy `bin/up`, để tạo lại `sharelatex` container.

{% hint style="danger" %}
Bạn sẽ cần lặp lại các bước này mỗi khi bạn [nâng cấp](https://github.com/overleaf/toolkit/blob/master/doc/upgrading.md) lên một phiên bản Overleaf mới.
{% 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/vi/cai-dat/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.