> 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/de/installation/upgrading-tex-live.md).

# TeX Live aktualisieren

Um Bandbreite zu sparen, werden sowohl die Bilder der Overleaf Community Edition als auch der Overleaf Pro nur mit einer Minimalinstallation von [TeX Live](https://www.tug.org/texlive/). Sie können weitere Pakete installieren oder auf eine vollständige TeX-Live-Installation upgraden, indem Sie den [tlmgr](https://www.tug.org/texlive/tlmgr.html) -Befehl in der `sharelatex` -Container.

{% hint style="warning" %}
Die folgenden Anweisungen **nur** gelten für Installationen der Community Edition. Wir empfehlen Overleaf-Pro-Nutzern dringend, [Sandboxed Compiles](broken://pages/51ec3aa029adb0a5f1a165663b1222784c92f886) zu aktivieren, da dies den Nutzern Zugriff auf dieselben TeX-Live-Images bietet, die auf [overleaf.com](/on-premises/de/konfiguration/overleaf-toolkit.md) verwendet werden, und außerdem eine Isolierung zwischen Projektkompilierungen für erhöhte Sicherheit bietet.
{% endhint %}

#### In den sharelatex-Container gelangen

Um eine Shell innerhalb des `sharelatex` Containers zu starten, führen Sie

```bash
bin/shell
```

Sie erhalten eine Eingabeaufforderung, die etwa so aussieht:

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

In den folgenden Anweisungen gehen wir davon aus, dass Sie sich im Container befinden.

#### Ihre aktuelle TeX-Live-Version ermitteln

TeX Live wird jedes Jahr etwa im Monat April veröffentlicht. Schritte zur Verwendung von `tlmgr` sind je nachdem unterschiedlich, ob Sie die aktuelle Version oder eine ältere verwenden. Sie können mit `tlmgr --version`prüfen, welche Version von TeX Live Sie verwenden. Zum Beispiel verwendet diese Installation TeX Live 2021:

```bash
# tlmgr --version
tlmgr-Revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr mit Installation: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) Version 2021
```

{% hint style="info" %}
Die aktuelle Version von TeX Live finden Sie auf [der TeX-Live-Homepage](https://www.tug.org/texlive/).
{% endhint %}

Wenn Sie eine ältere TeX-Live-Version verwenden, haben Sie zwei Optionen. Eine neue Version des Overleaf-Docker-Images wird normalerweise kurz nach einer TeX-Live-Veröffentlichung freigegeben; Sie können entweder darauf warten und Ihre Bereitstellung mit dem `bin/upgrade` Skript aktualisieren oder, wenn Sie die ältere TeX-Live-Version beibehalten möchten, müssen Sie zunächst `tlmgr` anweisen, ein historisches Repository zu verwenden. Anweisungen dazu finden Sie [hier](https://www.tug.org/texlive/acquire.html#past).

#### Pakete installieren

Um eine vollständige TeX-Live-Installation zu installieren, führen Sie diesen Befehl innerhalb des `sharelatex` Containers aus:

```
tlmgr install scheme-full
```

Sie können auch einzelne Pakete manuell installieren:

```bash
tlmgr install tikzlings tikzmarmots tikzducks
```

{% hint style="warning" %}
Ab `3.3.0` der Version `tlmgr path add` ist **erforderlich** erneut nach jeder Verwendung von `tlmgr install`, um alle Binärdateien korrekt in den Systempfad zu verlinken.
{% endhint %}

Es stehen viele weitere Befehle zur Verfügung. Mehr erfahren Sie mit:

```
tlmgr help
```

Wenn Sie fertig sind, geben Sie `exit` ein oder drücken Sie Strg-D, um die Shell zu beenden.

#### Ihre Änderungen speichern

Die Änderungen, die Sie gerade vorgenommen haben, haben den `sharelatex` Container verändert, aber sie sind flüchtig -- sie gehen verloren, wenn Docker Compose den Container neu erstellt, z. B. im Rahmen einer Aktualisierung der Konfiguration.

Verwenden Sie `docker commit` um die Änderungen in einem neuen Docker-Image zu speichern:

```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
```

Nachdem Sie die Änderungen übertragen haben, aktualisieren Sie die `config/version` entsprechend. Führen Sie dann `bin/up`, um den `sharelatex` -Container.

{% hint style="danger" %}
Sie müssen diese Schritte jedes Mal wiederholen, wenn Sie [ein Upgrade](https://github.com/overleaf/toolkit/blob/master/doc/upgrading.md) auf eine neue Overleaf-Version durchführen.
{% 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/de/installation/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.
