> 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/fr/texlive-dans-docker.md).

# TeXLive dans Docker

### Docker

Docker offre une manière légère et portable de empaqueter et d’exécuter des applications dans des conteneurs isolés. En regroupant l’application avec toutes les dépendances requises, un conteneur garantit un comportement cohérent sur différentes machines, des ordinateurs portables aux serveurs de production.

TeX Live est puissant, mais volumineux et sensible aux différences au niveau du système. Empaqueter TeX Live dans une image Docker rend la chaîne d’outils LaTeX prévisible, reproductible et facile à distribuer.

Cependant, certains paquets TeX Live reposent sur l’accès au shell. Pour des raisons de sécurité, le conteneur doit s’exécuter dans un environnement restreint qui empêche les utilisateurs d’exécuter des commandes shell arbitraires (par exemple via `\write18` ou shell escape). Cet isolement protège le système hôte et évite l’accès non intentionnel au système de fichiers sous-jacent du conteneur ou à des outils tels que `bash`.

### TeXLive Full Edition

[TeXLive-Full@ayaka-notes](https://github.com/ayaka-notes/texlive-full/) est une **image Docker TeXLive** conçue spécialement pour Overleaf Server Pro, Overleaf Pro, ainsi que pour les environnements autonomes de compilation LaTeX, comme CI ou les pipelines.

Cette image vise à fournir une distribution TeXLive presque complète avec des polices et des outils courants préinstallés, afin de minimiser les échecs de compilation causés par des paquets ou des polices manquants.

Fonctionnalités :

* 🚀 Prise en charge des architectures de serveur x86\_64 et arm64
* 📦 Installation TeXLive complète et optimisée
* 🧩 Polices et utilitaires courants préinstallés
* 🐳 Prête à être utilisée avec Docker et Docker Compose
* 🧪 Testée avec Overleaf Server Pro / Overleaf Pro
* 🔄 Mise à jour régulière avec les dernières versions de TeXLive
* 🏷 Plusieurs tags de versions TeXLive (2020 – Dernière)
* 🧑‍🔬 Prise en charge de Knitr pour le code R dans les documents LaTeX

### Utilisation avec Overleaf Pro

[TeXLive-Full@ayaka-notes](https://github.com/ayaka-notes/texlive-full/) support **overleaf pro**vous pouvez utiliser les variables d’environnement suivantes pour `config/variables.env` fichier si vous êtes [utilisateur toolkit](https://github.com/overleaf/toolkit).

Par exemple :

{% 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 %}

### Version de TeXLive

Grâce à Github Action, nous pouvons construire toutes les images tex en parallèle, ce qui inclut :

* `ghcr.io/ayaka-notes/texlive-full:2026.1` (Aussi `dernier` 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`

Nous utilisons une archive miroir de [infos texlive](https://texlive.info/tlnet-archive/)qui comprend presque toutes les images texlive allant de 1996 à 2026. Et grâce au Dockerfile d’Overleaf, nous pouvons construire ce projet plus rapidement.

> Pourquoi texlive 2019 et les versions antérieures ne sont-elles pas prises en charge ?
>
> Maintenir de telles images est plus que difficile. Et nous pensons que vous ne les utilisez probablement plus, car elles sont trop anciennes. Si vous en avez besoin, ouvrez un ticket pour me le faire savoir.

### Composants inclus

Les paquets suivants sont inclus dans l’image docker.

* Tous les paquets TeXLive (de cette année)
* Paquets R (sélectionnés uniquement)
* fontconfig inkscape pandoc python3-pygments wget python3
* gnupg gnuplot perl-modules perl ca-certificates
* ghostscript qpdf r-base-core tar

Les polices suivantes sont incluses dans l’image docker.

* [Google Fonts](https://fonts.google.com/)
* [Microsoft msttcorefonts](https://packages.ubuntu.com/jammy/ttf-mscorefonts-installer)
* [Polices prises en charge par Overleaf](https://www.overleaf.com/learn/latex/Questions/Which_OTF_or_TTF_fonts_are_supported_via_fontspec%3F)

{% hint style="warning" %}
Veuillez confirmer si les polices concernées peuvent être utilisées à des fins commerciales. Nous ne sommes **pas responsables** de tout problème juridique découlant d’une utilisation incorrecte des polices. Une fois l’image téléchargée, vous acceptez cela automatiquement.
{% endhint %}

### Licence

MIT

### Problèmes

<details>

<summary>Problème 01 : problème de cache de polices manquant</summary>

Lorsque Overleaf compile un projet LaTeX, si une police manque, **vous pouvez constater que le processus de compilation prend beaucoup de temps**; cela est dû au fait que lorsqu’une police manque, TeXLive essaiera de **reconstruire tout le cache de polices**. C’est un processus chronophage.

Dans notre image, nous avons préconstruit le cache de polices, et nous corrigeons ce problème par [ce commit](https://github.com/ayaka-notes/texlive-full/commit/0cb66b0dc8b82be628cf6999cfd659d9784e132f)

</details>

<details>

<summary>Problème 02 : synchronisation TeX extrêmement lente</summary>

Lorsque vous utilisez cette image dans ShareLaTeX, vous pouvez constater que la synchronisation TeX est extrêmement lente.

Voir : <https://github.com/overleaf/overleaf/issues/1150>désactivez simplement HTTP 2.0.

</details>

<details>

<summary>Problème 03 : erreur de recompilation avec l’image officielle Texlive</summary>

Si vous utilisez l’image officielle texlive sur Docker Hub `texlive/texlive`vous pouvez constater que lorsque vous recompilerez un projet, une erreur sera signalée. Cependant, dans notre image, ce problème est corrigé. Parce que nous utilisons la dernière image de base Ubuntu et installons toutes les dépendances depuis le dépôt officiel Ubuntu.

</details>

### Autre rappel technique

Lors de la construction d’une image TeXLive (avant 2019), vous devrez peut-être prêter attention aux problèmes suivants :

* Seul `http`/`ftp` est pris en charge avant TeXLive 2017, donc vous ne pouvez pas utiliser `https` pour télécharger, sauf si vous modifiez le `peal` script.
* Avant 2015, seul le fichier sha256 est fourni. Vous ne pouvez donc pas utiliser sha512 pour vérifier.


---

# 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/fr/texlive-dans-docker.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.
