> 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/it/installazione/upgrading-tex-live.md).

# Aggiornamento di TeX Live

{% hint style="danger" %}
Le seguenti istruzioni **solo** si applicano a **Community Edition** installazioni. Consigliamo vivamente ai nostri utenti di Ayakaleaf Pro di abilitare [Compilazioni in sandbox](/on-premises/it/configurazione/overleaf-toolkit/sandboxed-compiles.md) poiché ciò offre agli utenti accesso alle immagini TeX Live quasi identiche utilizzate su [overleaf.com](/on-premises/it/configurazione/overleaf-toolkit.md) oltre a fornire isolamento tra le compilazioni dei progetti per una maggiore sicurezza.
{% endhint %}

Per risparmiare larghezza di banda, sia le immagini di Overleaf Community Edition sia quelle di Ayakaleaf Pro includono solo un'installazione minima di [TeX Live](https://www.tug.org/texlive/). Puoi installare altri pacchetti o aggiornare a un'installazione completa di TeX Live usando il [tlmgr](https://www.tug.org/texlive/tlmgr.html) comando nel `sharelatex` contenitore.

#### Accedere al contenitore sharelatex

Per avviare una shell all'interno del `sharelatex` contenitore, esegui

```bash
bin/shell
```

Riceverai un prompt simile a:

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

Nelle istruzioni seguenti, daremo per scontato che tu sia nel contenitore.

#### Determinare la tua versione attuale di TeX Live

TeX Live viene rilasciato ogni anno intorno al mese di aprile. Le istruzioni per usare `tlmgr` sono diverse a seconda che tu stia usando la versione corrente o una più vecchia. Puoi verificare quale versione di TeX Live stai usando con `tlmgr --version`. Ad esempio, questa installazione esegue 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 versione attuale di TeX Live si trova su [la pagina principale di TeX Live](https://www.tug.org/texlive/).
{% endhint %}

Se stai usando una versione più vecchia di TeX Live, hai due opzioni. Una nuova versione dell'immagine Docker di Overleaf viene di solito rilasciata poco dopo il rilascio di TeX Live; puoi quindi aspettarla e aggiornare la tua installazione usando `bin/upgrade` script, oppure, se preferisci mantenere la vecchia versione di TeX Live, dovrai prima indicare `tlmgr` di usare un repository storico. Troverai le istruzioni per farlo [qui](https://www.tug.org/texlive/acquire.html#past).

#### Installazione dei pacchetti

Per installare un'installazione completa di TeX Live, esegui questo comando all'interno del `sharelatex` contenitore:

```
tlmgr install scheme-full
```

Puoi anche installare singoli pacchetti manualmente:

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

{% hint style="warning" %}
Da `3.3.0` a partire dalla versione, eseguire `tlmgr path add` è **richiesto** di nuovo dopo ogni utilizzo di `tlmgr install`, per creare correttamente i collegamenti simbolici di tutti i binari nel percorso di sistema.
{% endhint %}

Sono disponibili molti altri comandi. Scopri di più con:

```
tlmgr help
```

Quando hai finito, digita `exit` oppure premi Control-D per uscire dalla shell.

#### Salvare le tue modifiche

Le modifiche che hai appena apportato hanno modificato il `sharelatex` contenitore, ma sono effimere -- andranno perse se Docker Compose ricrea il contenitore, ad esempio durante l'aggiornamento della configurazione.

Per renderle permanenti, usa `docker commit` per salvare le modifiche in una nuova immagine 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
```

Dopo aver eseguito il commit delle modifiche, aggiorna il `config/version` di conseguenza. Poi esegui `bin/up`, per ricreare il `sharelatex` contenitore.

{% hint style="danger" %}
Dovrai ripetere questi passaggi ogni volta che tu [aggiorni](https://github.com/overleaf/toolkit/blob/master/doc/upgrading.md) a una nuova versione di 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/it/installazione/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.