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

# TeX Live aktualisieren

{% hint style="danger" %}
Die folgenden Anweisungen **nur** gelten für **Community Edition** Installationen. Wir empfehlen unseren Ayakaleaf-Pro-Nutzern dringend, [Sandboxed Compiles](/on-premises/de/konfiguration/overleaf-toolkit/sandboxed-compiles.md) zu aktivieren, da dies den Nutzern Zugriff auf nahezu dieselben TeX-Live-Images bietet, die auf [overleaf.com](/on-premises/de/konfiguration/overleaf-toolkit.md) verwendet werden, und zudem eine Isolation zwischen Projektkompilierungen für erhöhte Sicherheit bietet.
{% endhint %}

Um Bandbreite zu sparen, werden sowohl die Overleaf Community Edition- als auch die Ayakaleaf-Pro-Images nur mit einer Minimalinstallation von [TeX Live](https://www.tug.org/texlive/). Sie können weitere Pakete installieren oder eine vollständige TeX-Live-Installation mit dem [tlmgr](https://www.tug.org/texlive/tlmgr.html) Befehl im `sharelatex` Container durchführen.

#### Im sharelatex-Container einsteigen

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

```bash
bin/shell
```

Sie erhalten eine Eingabeaufforderung, die so aussieht:

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

In den folgenden Anweisungen nehmen wir an, dass Sie sich im Container befinden.

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

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

```bash
# tlmgr --version
tlmgr Revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr verwendet 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 herausgegeben; 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` dieser Version an ist das Ausführen von `tlmgr path add` ist **erforderlich** erneut nach jeder Verwendung von `tlmgr install`, um alle Binärdateien korrekt im Systempfad zu verlinken.
{% endhint %}

Es sind viele weitere Befehle verfügbar. Mehr dazu mit:

```
tlmgr help
```

Wenn Sie fertig sind, tippen Sie `exit` 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 Konfigurationsaktualisierung.

Um sie dauerhaft zu machen, 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 übernommen haben, aktualisieren Sie die `config/version` entsprechend. Führen Sie dann `bin/up`aus, um den `sharelatex` Container durchführen.

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