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

# Mise à niveau de TeX Live

Pour économiser de la bande passante, les images Overleaf Community Edition et Overleaf Pro sont toutes deux fournies uniquement avec une installation minimale de [TeX Live](https://www.tug.org/texlive/). Vous pouvez installer davantage de paquets ou passer à une installation complète de TeX Live à l'aide de la [tlmgr](https://www.tug.org/texlive/tlmgr.html) commande dans le `conteneur sharelatex.` conteneur.

{% hint style="warning" %}
Les instructions suivantes **uniquement** s'appliquent aux installations de la Community Edition. Nous recommandons fortement aux utilisateurs d'Overleaf Pro d'activer [Compilations en bac à sable](broken://pages/c7d2888b20152958775a4e287244d6e0cef6c81a) car cela permet aux utilisateurs d'accéder aux mêmes images TeX Live utilisées sur [overleaf.com](/on-premises/fr/configuration/overleaf-toolkit.md) tout en offrant également une isolation entre les compilations de projets pour une sécurité renforcée.
{% endhint %}

#### Accéder au conteneur sharelatex

Pour ouvrir un shell à l'intérieur du `conteneur sharelatex.` conteneur, exécutez

```bash
bin/shell
```

Vous obtiendrez une invite qui ressemble à :

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

Dans les instructions suivantes, nous supposerons que vous êtes dans le conteneur.

#### Déterminer votre version actuelle de TeX Live

TeX Live est publié chaque année autour du mois d'avril. Les étapes pour utiliser `tlmgr` diffèrent selon que vous utilisez la version actuelle ou une version plus ancienne. Vous pouvez vérifier quelle version de TeX Live vous utilisez avec `tlmgr --version`. Par exemple, cette installation exécute TeX Live 2021 :

```bash
# tlmgr --version
tlmgr revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr using installation: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) version 2021
```

{% hint style="info" %}
La version actuelle de TeX Live peut être trouvée sur [la page d'accueil de TeX Live](https://www.tug.org/texlive/).
{% endhint %}

Si vous utilisez une version plus ancienne de TeX Live, vous avez deux options. Une nouvelle version de l'image Docker Overleaf est généralement publiée peu de temps après une version de TeX Live ; vous pouvez soit l'attendre et mettre à niveau votre déploiement à l'aide de `bin/upgrade` script, ou, si vous préférez conserver l'ancienne version de TeX Live, vous devrez d'abord indiquer à `tlmgr` d'utiliser un dépôt historique. Vous trouverez des instructions pour le faire [ici](https://www.tug.org/texlive/acquire.html#past).

#### Installation de paquets

Pour installer une installation complète de TeX Live, exécutez cette commande à l'intérieur du `conteneur sharelatex.` conteneur :

```
tlmgr install scheme-full
```

Vous pouvez également installer des paquets individuels manuellement :

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

{% hint style="warning" %}
À partir de `3.3.0` la version, l'exécution de `tlmgr path add` est **est nécessaire** à nouveau après chaque utilisation de `tlmgr install`, afin de créer correctement des liens symboliques pour tous les binaires dans le chemin système.
{% endhint %}

De nombreuses autres commandes sont disponibles. Pour en savoir plus, consultez :

```
tlmgr help
```

Une fois terminé, tapez `exit` ou appuyez sur Ctrl-D pour quitter le shell.

#### Enregistrer vos modifications

Les modifications que vous venez d'apporter ont modifié le `conteneur sharelatex.` conteneur, mais elles sont éphémères — elles seront perdues si Docker Compose recrée le conteneur, par exemple lors de la mise à jour de la configuration.

Pour les rendre persistantes, utilisez `docker commit` pour enregistrer les modifications dans une nouvelle image Docker :

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

Après avoir validé les modifications, mettez à jour le `config/version` en conséquence. Puis exécutez `bin/up`, pour recréer le `conteneur sharelatex.` conteneur.

{% hint style="danger" %}
Vous devrez répéter ces étapes chaque fois que vous [mettez à niveau](https://github.com/overleaf/toolkit/blob/master/doc/upgrading.md) vers une nouvelle version d'Overleaf.
{% 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/fr/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.
