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

# Оновлення TeX Live

Щоб заощадити пропускну здатність, образи Overleaf Community Edition і Overleaf Pro постачаються лише з мінімальною інсталяцією [TeX Live](https://www.tug.org/texlive/). Ви можете встановити більше пакетів або оновити інсталяцію до повної інсталяції TeX Live за допомогою [tlmgr](https://www.tug.org/texlive/tlmgr.html) команди в `sharelatex` контейнера.

{% hint style="warning" %}
Наступні інструкції **лише** стосуються інсталяцій Community Edition. Ми наполегливо рекомендуємо користувачам Overleaf Pro увімкнути [Ізольованих компіляцій](broken://pages/b9ca3bcc97e34b56334d9d294bf1334d5794a4bd) оскільки це надає користувачам доступ до тих самих образів TeX Live, що використовуються на [overleaf.com](/on-premises/uk/konfiguraciya/overleaf-toolkit.md) а також забезпечує ізоляцію між компіляціями проєктів для підвищення безпеки.
{% endhint %}

#### Вхід до контейнера sharelatex

Щоб запустити оболонку всередині `sharelatex` контейнера, виконайте

```bash
bin/shell
```

Ви отримаєте запит, що виглядає так:

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

У наведених далі інструкціях ми припускатимемо, що ви перебуваєте в контейнері.

#### Визначення вашої поточної версії TeX Live

TeX Live випускається щороку приблизно в квітні. Кроки для використання `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) версія 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/uk/vstanovlennya/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.