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

# Aggiornamento di TeX Live

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

{% hint style="warning" %}
Le istruzioni seguenti **solo** si applicano alle installazioni di Community Edition. Consigliamo vivamente agli utenti di Overleaf Pro di abilitare [Compilazioni in sandbox](broken://pages/fb8cf6f591d459be22557e87dd7d76658e53cc7e) poiché ciò offre agli utenti accesso alle stesse immagini TeX Live 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 %}

#### Accedere al container sharelatex

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

```bash
bin/shell
```

Riceverai un prompt simile a:

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

Nelle istruzioni seguenti, assumeremo che tu sia nel container.

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

TeX Live viene rilasciato ogni anno intorno al mese di aprile. I passaggi per usare `tlmgr` sono diversi a seconda che tu stia usando la release attuale o una precedente. 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) versione 2021
```

{% hint style="info" %}
La release attuale di TeX Live si trova su [la homepage 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 una release di TeX Live; puoi quindi aspettare e aggiornare il tuo deployment usando `bin/upgrade` lo script, oppure, se preferisci mantenere la versione più vecchia di TeX Live, dovrai prima indicare a `tlmgr` di usare un repository storico. Troverai le istruzioni per farlo [qui](https://www.tug.org/texlive/acquire.html#past).

#### Installare i pacchetti

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

```
tlmgr install scheme-full
```

Puoi anche installare manualmente singoli pacchetti:

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

{% hint style="warning" %}
Da `3.3.0` in poi, l'esecuzione di `tlmgr path add` sia **è necessario** di nuovo dopo ogni uso di `tlmgr install`, per creare correttamente i link 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 modifiche

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

Per renderle persistenti, 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. Quindi esegui `bin/up`, per ricreare il `sharelatex` contenitore.

{% hint style="danger" %}
Dovrai ripetere questi passaggi ogni volta che [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://overleaf-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.
