> 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/texlive/de/texlive-in-docker.md).
# TeXLive in Docker
### Docker
Docker bietet eine leichtgewichtige und portable Möglichkeit, Anwendungen in isolierten Containern zu paketieren und auszuführen. Durch das Bündeln der Anwendung zusammen mit allen erforderlichen Abhängigkeiten sorgt ein Container für ein konsistentes Verhalten auf verschiedenen Maschinen, von Laptops bis zu Produktionsservern.
TeX Live ist leistungsstark, aber groß und empfindlich gegenüber Systemunterschieden. TeX Live in ein Docker-Image zu packen macht die LaTeX-Toolchain vorhersehbar, reproduzierbar und leicht verteilbar.
Allerdings verlassen sich einige TeX Live-Pakete auf Shell-Zugriff. Aus Sicherheitsgründen sollte der Container in einer eingeschränkten Umgebung laufen, die verhindert, dass Benutzer beliebige Shell-Befehle ausführen (zum Beispiel über `\write18` oder Shell-Escape). Diese Isolation schützt das Host-System und vermeidet unbeabsichtigten Zugriff auf das zugrunde liegende Dateisystem des Containers oder auf Werkzeuge wie `bash`.
### TeXLive Vollversion
[TeXLive-Full@ayaka-notes](https://github.com/ayaka-notes/texlive-full/) ist ein voll ausgestattetes **TeXLive-Docker-Image** speziell für Overleaf Server Pro, Overleaf Pro sowie eigenständige LaTeX-Kompilierungsumgebungen wie CI oder Pipelines entwickelt.
Dieses Image soll eine nahezu vollständige TeXLive-Distribution mit gängigen Schriften und vorinstallierten Werkzeugen bereitstellen, um Kompilierungsfehler durch fehlende Pakete oder Schriftarten zu minimieren.
Funktionen:
* 🚀 Unterstützt sowohl x86\_64- als auch arm64-Serverarchitekturen
* 📦 Vollständige und optimierte TeXLive-Installation
* 🧩 Vorinstallierte gängige Schriftarten und Dienstprogramme
* 🐳 Bereit zur Verwendung mit Docker und Docker Compose
* 🧪 Getestet mit Overleaf Server Pro / Overleaf Pro
* 🔄 Regelmäßig aktualisiert mit den neuesten TeXLive-Versionen
* 🏷 Mehrere TeXLive-Versions-Tags (2020 – aktuell)
* 🧑🔬 Knitr-Unterstützung für R-Code in LaTeX-Dokumenten
### Verwendung mit Overleaf Pro
[TeXLive-Full@ayaka-notes](https://github.com/ayaka-notes/texlive-full/) Unterstützung **Overleaf Pro**, können Sie die folgenden Umgebungsvariablen verwenden, um `config/variables.env` Datei, wenn Sie ein [Toolkit-Benutzer](https://github.com/overleaf/toolkit).
Zum Beispiel:
{% code title="config/variables.env" overflow="wrap" %}
```dotenv
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2025.1, ghcr.io/ayaka-notes/texlive-full:2024.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2025, Texlive 2024
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2025.1
```
{% endcode %}
### TeXLive-Version
Dank GitHub Actions können wir alle TeX-Images parallel bauen, was Folgendes umfasst:
* `ghcr.io/ayaka-notes/texlive-full:2026.1` (Auch `neuester` Tag)
* `ghcr.io/ayaka-notes/texlive-full:2025.1`
* `ghcr.io/ayaka-notes/texlive-full:2024.1`
* `ghcr.io/ayaka-notes/texlive-full:2023.1`
* `ghcr.io/ayaka-notes/texlive-full:2022.1`
* `ghcr.io/ayaka-notes/texlive-full:2021.1`
* `ghcr.io/ayaka-notes/texlive-full:2020.1`
* `ghcr.io/ayaka-notes/texlive-full:base`
Wir verwenden ein Spiegelarchiv von [texlive info](https://texlive.info/tlnet-archive/)das fast alle TeXLive-Images von 1996 bis 2026 enthält. Und dank Overleafs Dockerfile können wir dieses Projekt schneller bauen.
> Warum werden TeXLive 2019 und früher nicht unterstützt?
>
> Solche Images zu pflegen ist mehr als schwierig. Und wir glauben, dass Sie sie möglicherweise nicht mehr verwenden, da sie zu alt sind. Wenn Sie sie benötigen, öffnen Sie bitte ein Issue und lassen Sie es mich wissen.
### Enthaltene Komponenten
Die folgenden Pakete sind im Docker-Image enthalten.
* Alle TeXLive-Pakete (aus dem jeweiligen Jahr)
* R-Pakete (nur ausgewählte)
* fontconfig inkscape pandoc python3-pygments wget python3
* gnupg gnuplot perl-modules perl ca-certificates
* ghostscript qpdf r-base-core tar
Die folgenden Schriftarten sind im Docker-Image enthalten.
* [Google-Schriftarten](https://fonts.google.com/)
* [Microsoft msttcorefonts](https://packages.ubuntu.com/jammy/ttf-mscorefonts-installer)
* [Von Overleaf unterstützte Schriftarten](https://www.overleaf.com/learn/latex/Questions/Which_OTF_or_TTF_fonts_are_supported_via_fontspec%3F)
{% hint style="warning" %}
Bitte bestätigen Sie, ob die relevanten Schriftarten kommerziell verwendet werden dürfen. Wir sind **nicht verantwortlich** für rechtliche Probleme, die sich aus Ihrer fehlerhaften Verwendung von Schriftarten ergeben. Sobald Sie das Image herunterladen, stimmen Sie dem automatisch zu.
{% endhint %}
### Lizenz
MIT
### Probleme
Problem 01: Problem mit dem Schriftarten-Cache
Wenn Overleaf ein LaTeX-Projekt kompiliert und eine Schrift fehlt, **stellen Sie möglicherweise fest, dass der Kompilierungsfortschritt sehr lange dauert**, das liegt daran, dass TeXLive, wenn eine Schrift fehlt, versucht, **den gesamten Schriftarten-Cache neu aufzubauen**. Das ist ein zeitaufwändiger Prozess.
In unserem Image haben wir den Schriftarten-Cache vorab erstellt und dieses Problem durch [diesen Commit](https://github.com/ayaka-notes/texlive-full/commit/0cb66b0dc8b82be628cf6999cfd659d9784e132f)
Problem 02: SyncTeX extrem langsam
Wenn Sie dieses Image in ShareLaTeX verwenden, stellen Sie möglicherweise fest, dass SyncTeX extrem langsam ist.
Siehe: , deaktivieren Sie einfach HTTP/2.0.
Problem 03: Re-Kompilierfehler mit dem offiziellen TeXLive-Image
Wenn Sie das offizielle TeXLive-Image auf Docker Hub verwenden `texlive/texlive`, stellen Sie möglicherweise fest, dass beim erneuten Kompilieren eines Projekts ein Fehler gemeldet wird. In unserem Image ist dieses Problem jedoch behoben. Denn wir verwenden das neueste Ubuntu-Basisimage und installieren alle Abhängigkeiten aus dem offiziellen Ubuntu-Repository.
### Weitere technische Hinweise
Beim Erstellen des TeXLive-Images (vor 2019) müssen Sie möglicherweise auf die folgenden Probleme achten:
* Nur `http`/`ftp` wird vor TeXLive 2017 unterstützt, daher können Sie nicht `https` zum Herunterladen verwenden, es sei denn, Sie ändern das `peal` Skript.
* Vor 2015 wird nur die SHA256-Datei bereitgestellt. Daher können Sie SHA512 nicht zur Überprüfung verwenden.
---
# 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/texlive/de/texlive-in-docker.md?ask=&goal=
```
`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.