> 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/nl/texlive-in-docker.md).
# TeXLive in Docker
### Docker
Docker biedt een lichtgewicht en draagbare manier om applicaties te verpakken en uit te voeren in geïsoleerde containers. Door de applicatie samen te bundelen met alle vereiste afhankelijkheden, zorgt een container voor consistent gedrag op verschillende machines, van laptops tot productieservers.
TeX Live is krachtig, maar groot en gevoelig voor systeemverschillen. Door TeX Live in een Docker-afbeelding te verpakken, wordt de LaTeX-toolchain voorspelbaar, reproduceerbaar en gemakkelijk te distribueren.
Sommige TeX Live-pakketten zijn echter afhankelijk van shell-toegang. Om veiligheidsredenen moet de container in een beperkte omgeving draaien die gebruikers verhindert willekeurige shell-opdrachten uit te voeren (bijvoorbeeld via `\write18` of shell escape). Deze isolatie beschermt het hostsysteem en voorkomt onbedoelde toegang tot het onderliggende bestandssysteem van de container of tools zoals `bash`.
### TeXLive Volledige editie
[TeXLive-Full@ayaka-notes](https://github.com/ayaka-notes/texlive-full/) is een volledig uitgeruste **TeXLive Docker-afbeelding** speciaal ontworpen voor Overleaf Server Pro, Overleaf Pro en ook zelfstandige LaTeX-compilatieomgevingen, zoals CI of pipelines.
Deze afbeelding is bedoeld om een bijna volledige TeXLive-distributie te bieden met gangbare lettertypen en tools vooraf geïnstalleerd, om compilatiefouten door ontbrekende pakketten of lettertypen te minimaliseren.
Kenmerken:
* 🚀 Ondersteuning voor zowel x86\_64- als arm64-serverarchitecturen
* 📦 Volledige en geoptimaliseerde TeXLive-installatie
* 🧩 Veelgebruikte lettertypen en hulpprogramma's vooraf geïnstalleerd
* 🐳 Klaar voor gebruik met Docker en Docker Compose
* 🧪 Getest met Overleaf Server Pro / Overleaf Pro
* 🔄 Regelmatig bijgewerkt met de nieuwste TeXLive-releases
* 🏷 Meerdere TeXLive-versietags (2020 – nieuwste)
* 🧑🔬 Knitr-ondersteuning voor R-code in LaTeX-documenten
### Gebruik van Overleaf Pro
[TeXLive-Full@ayaka-notes](https://github.com/ayaka-notes/texlive-full/) ondersteuning **overleaf pro**, kun je de volgende omgevingsvariabelen gebruiken om `config/variables.env` bestand als je een [toolkit-gebruiker bent](https://github.com/overleaf/toolkit).
Bijvoorbeeld:
{% 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-versie
Dankzij GitHub Actions kunnen we alle tex-afbeeldingen parallel bouwen, waaronder:
* `ghcr.io/ayaka-notes/texlive-full:2026.1` (Ook `nieuwste` 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`
We gebruiken een spiegelarchief van [texlive info](https://texlive.info/tlnet-archive/), dat bijna alle TeX Live-afbeeldingen bevat van 1996 tot 2026. En dankzij Overleafs Dockerfile kunnen we dit project sneller bouwen.
> Waarom worden texlive 2019 en eerder niet ondersteund?
>
> Het onderhouden van zulke afbeeldingen is meer dan moeilijk. En we denken dat je ze waarschijnlijk niet meer gebruikt, omdat ze te oud zijn. Als je ze nodig hebt, open dan een issue om het me te laten weten.
### Bevatte onderdelen
De volgende pakketten zijn opgenomen in de Docker-afbeelding.
* Alle TeXLive-pakketten (van dat jaar)
* R-pakketten (alleen geselecteerde)
* fontconfig inkscape pandoc python3-pygments wget python3
* gnupg gnuplot perl-modules perl ca-certificates
* ghostscript qpdf r-base-core tar
De volgende lettertypen zijn opgenomen in de Docker-afbeelding.
* [Google Fonts](https://fonts.google.com/)
* [Microsoft msttcorefonts](https://packages.ubuntu.com/jammy/ttf-mscorefonts-installer)
* [Door Overleaf ondersteunde lettertypen](https://www.overleaf.com/learn/latex/Questions/Which_OTF_or_TTF_fonts_are_supported_via_fontspec%3F)
{% hint style="warning" %}
Controleer alstublieft of de relevante lettertypen commercieel gebruikt mogen worden. Wij zijn **niet verantwoordelijk** voor eventuele juridische problemen die voortvloeien uit onjuist gebruik van lettertypen. Zodra je de afbeelding downloadt, ga je hier automatisch mee akkoord.
{% endhint %}
### Licentie
MIT
### Problemen
Probleem 01: Font-cache miss-probleem
Wanneer Overleaf een LaTeX-project compileert, en er een lettertype ontbreekt, **kan het zijn dat het compilatieproces lang duurt**, dat komt doordat wanneer een lettertype ontbreekt, TeX Live zal proberen om **de volledige fontcache opnieuw op te bouwen**. Dit is een tijdrovend proces.
In onze afbeelding hebben we de fontcache vooraf opgebouwd, en we lossen dit probleem op met [deze commit](https://github.com/ayaka-notes/texlive-full/commit/0cb66b0dc8b82be628cf6999cfd659d9784e132f)
Probleem 02: Sync TeX extreem langzaam
Wanneer je deze afbeelding in ShareLaTeX gebruikt, kun je merken dat SyncTeX extreem langzaam is.
Zie: , schakel gewoon HTTP/2.0 uit.
Probleem 03: Hercompilatiefout met officiële TeX Live-afbeelding
Als je de officiële TeX Live-afbeelding op Docker Hub gebruikt `texlive/texlive`, kun je merken dat wanneer je een project opnieuw compileert, er een fout wordt gerapporteerd. In onze afbeelding is dit probleem echter opgelost. Omdat we de nieuwste Ubuntu-basisafbeelding gebruiken en alle afhankelijkheden uit de officiële Ubuntu-repo installeren.
### Andere technische aandachtspunten
Bij het bouwen van de TeX Live-afbeelding (vóór 2019) moet je mogelijk letten op de volgende problemen:
* Alleen `http`/`ftp` worden ondersteund vóór TeX Live 2017, dus je kunt `https` niet gebruiken om te downloaden, tenzij je het `peal` script aanpast.
* Vóór 2015 wordt alleen een sha256-bestand geleverd. Dus je kunt sha512 niet gebruiken om te controleren.
---
# 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/nl/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.