> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Estendere TeX Live

> Estendi le immagini Docker di TeX Live con pacchetti e font per gli ambienti di compilazione supportati.

È possibile estendere un'immagine TeX Live esistente usando un nuovo Dockerfile e configurare l'applicazione per usare la nuova immagine.

Qui offriamo alcune linee guida per installare nuovi pacchetti o font, ma la configurazione di un'immagine personalizzata non è coperta dai nostri termini di supporto.

Le immagini TeX Live ricevono aggiornamenti poco frequenti. Consigliamo di ricompilare le immagini personalizzate quando aggiorni Server Pro.

<Danger>
  Le sezioni seguenti si applicano solo a Server Pro e alle [Sandboxed Compiles](/it/on-premises/configuration/overleaf-toolkit/sandboxed-compiles).
</Danger>

### Installare e aggiornare nuovi pacchetti

Puoi usare comandi `tlmgr` come `tlmgr install` e `tlmgr update` per gestire i pacchetti TeX Live, come nell'esempio seguente:

```dockerfile theme={null}
FROM ghcr.io/ayaka-notes/texlive-full:2023.1

RUN tlmgr update --force ebproof
```

### Usare `tlmgr` in un'immagine TeX Live precedente

Per impostazione predefinita `tlmgr` scarica le risorse dall'ultima release di TeX Live. Quando si applicano patch a un'immagine TeX Live precedente, i download devono essere indirizzati all'archivio corrispondente. Consulta l'elenco in [https://www.tug.org/historic/](https://www.tug.org/historic/) per i mirror degli archivi.

```dockerfile theme={null}
FROM ghcr.io/ayaka-notes/texlive-full:2022.1

RUN tlmgr option repository <MIRROR>/systems/texlive/<YEAR>/tlnet-final
# e.g. RUN tlmgr option repository ftp://tug.org/historic/systems/texlive/2022/tlnet-final

RUN tlmgr update --force ebproof
```

### Installare nuovi font

Esistono diverse procedure per installare nuovi font in una distribuzione TeX Live, e l'installazione di un font personalizzato può richiedere diversi passaggi. Consultare le [istruzioni per installare i font TeX](https://tug.org/fonts/fontinstall.html) nella documentazione ufficiale di TeX Live è probabilmente un buon punto di partenza.

Il seguente `Dockerfile` mostra un esempio di installazione di un font TrueType su un'immagine TeX Live 2022 esistente:

```dockerfile theme={null}
FROM ghcr.io/ayaka-notes/texlive-full:2022.1

COPY ./myfonts/*.ttf /usr/share/fonts/truetype/myfont/

# rebuild font information cache
RUN fc-cache
```

### Configurare Server Pro per usare le nuove immagini

Usa il nome `ghcr.io/ayaka-notes/texlive-full` e un tag personalizzato per compilare la nuova immagine, come in:

```bash theme={null}
docker build -t ghcr.io/ayaka-notes/texlive-full:2023.1-custom
```

Ora possiamo configurare Server Pro per usare la nuova immagine `2023.1-custom` aggiornando le variabili d'ambiente `TEX_LIVE_DOCKER_IMAGE` e `ALL_TEX_LIVE_DOCKER_IMAGES`:

```text wrap theme={null}
TEX_LIVE_DOCKER_IMAGE: "ghcr.io/ayaka-notes/texlive-full:2023.1-custom"
ALL_TEX_LIVE_DOCKER_IMAGES: "ghcr.io/ayaka-notes/texlive-full:2023.1,ghcr.io/ayaka-notes/texlive-full:2023.1-custom"
```

Nell'esempio sopra, i nuovi progetti sono impostati per usare per impostazione predefinita la nuova immagine `2023.1-custom`, mentre `2023.1` resta disponibile quando serve.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.