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

# Mise à niveau de TeX Live

{% hint style="danger" %}
Les instructions suivantes **s’appliquent uniquement** aux **installations de Community Edition** . Nous recommandons vivement à nos utilisateurs d’Ayakaleaf Pro d’activer [les compilations en bac à sable](/on-premises/fr/configuration/overleaf-toolkit/sandboxed-compiles.md) car cela donne aux utilisateurs accès aux images TeX Live presque identiques 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 %}

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

#### Accéder au conteneur sharelatex

Pour démarrer un shell à l’intérieur du `sharelatex` conteneur, exécutez

```bash
bin/shell
```

Vous obtiendrez une invite qui ressemble à ceci :

```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 vers le mois d’avril. Les étapes pour utiliser `tlmgr` sont différentes 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 révision 59291 (2021-05-21 05:14:40 +0200)
tlmgr utilisant l’installation : /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) version 2021
```

{% hint style="info" %}
La version actuelle de TeX Live se trouve 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 après une version de TeX Live ; vous pouvez soit attendre sa publication et mettre à niveau votre déploiement à l’aide de `bin/upgrade` script, soit, 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 dans le `sharelatex` conteneur :

```
tlmgr install scheme-full
```

Vous pouvez également installer manuellement des paquets individuels :

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

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

De nombreuses autres commandes sont disponibles. En savoir plus avec :

```
tlmgr help
```

Quand vous avez 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 `sharelatex` conteneur, mais elles sont éphémères — elles seront perdues si Docker Compose recrée le conteneur, par exemple dans le cadre d’une 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 `config/version` en conséquence. Puis exécutez `bin/up`, pour recréer le `sharelatex` .

{% hint style="danger" %}
Vous devrez répéter ces étapes à chaque fois que vous [mettre à 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://ayakaleaf-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.