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

# Nâng cấp TeX Live

{% hint style="danger" %}
Các hướng dẫn sau **chỉ** áp dụng cho **Ấn bản Cộng đồng** các bản cài đặt. Chúng tôi đặc biệt khuyến nghị người dùng Ayakaleaf Pro của chúng tôi bật [Biên dịch trong môi trường cách ly](/on-premises/vi/cau-hinh/overleaf-toolkit/sandboxed-compiles.md) vì điều này cung cấp cho người dùng quyền truy cập vào các ảnh TeX Live gần như giống hệt được 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 của dự án để tăng cường bảo mật.
{% endhint %}

Để tiết kiệm băng thông, cả ảnh Overleaf Community Edition và Ayakaleaf 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 đặt 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 lệnh [tlmgr](https://www.tug.org/texlive/tlmgr.html) trong `sharelatex` container.

#### Truy cập vào container sharelatex

Để khởi động một shell bên trong `sharelatex` container, 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 theo 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 mình đang chạy bằng `tlmgr --version`. Ví dụ, bản cài đặt này chạy TeX Live 2021:

```bash
# tlmgr --version
tlmgr revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr đang sử dụng bản cài đặt: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) phiên bản 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ể hoặc 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 việc này [ở đâ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` phiên bản trở đi, việc chạy `tlmgr path add` 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 cho tất cả các tệp nhị phân vào đường dẫn hệ thống.
{% endhint %}

Còn rất nhiều lệnh khác nữa. Tìm hiểu thêm với:

```
tlmgr help
```

Khi bạn xong, 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ỉ tạm thời -- chúng sẽ bị mất nếu Docker Compose tạo lại container, ví dụ như khi cập nhật cấu hình.

Để chúng trở nên bền vững, 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` tương ứng. 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://ayakaleaf-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.