> 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/ru/ustanovka/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/87d3d92a07a8adf3e0e89789d3a72d83dff94452) поскольку это предоставляет пользователям доступ к тем же образам TeX Live, которые используются на [overleaf.com](/on-premises/ru/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) 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://overleaf-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.