> 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/ru/ustanovka/upgrading-tex-live.md).

# Обновление TeX Live

{% hint style="danger" %}
Следующие инструкции **только** относятся к **Community Edition** установкам. Мы настоятельно рекомендуем пользователям Ayakaleaf Pro включить [Изолированные компиляции](/on-premises/ru/konfiguraciya/overleaf-toolkit/sandboxed-compiles.md) так как это дает пользователям доступ почти к тем же образам TeX Live, которые используются на [overleaf.com](/on-premises/ru/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 59291 (2021-05-21 05:14:40 +0200)
tlmgr использует установку: /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` или нажмите Ctrl-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/ru/ustanovka/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.