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

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

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

Щоб заощадити трафік, образи як Overleaf Community Edition, так і 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 випускається щороку приблизно в квітні. Кроки для використання `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, у вас є два варіанти. Нова версія образу Docker Overleaf зазвичай випускається невдовзі після релізу 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/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.