5. Personalizzare la tua istanza

​

Personalizzare la tua istanza

Prima di avviare la tua istanza di Overleaf per la prima volta, aggiorna il file di configurazione config/variables.env con le tue informazioni personalizzate.

1. Modificare il file delle variabili

   Apri config/variables.env nel tuo editor di testo preferito e aggiorna le variabili d’ambiente seguenti con i valori richiesti.

2. Variabili d'ambiente obbligatorie

   Aggiorna le seguenti variabili in config/variables.env:

   Nome	Descrizione	Esempio
   OVERLEAF_SITE_URL	L’indirizzo a cui la tua istanza di Overleaf è accessibile pubblicamente. Viene usato nei link pubblici e nelle connessioni tramite websocket, quindi deve essere configurato correttamente!	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	Questo indirizzo email verrà usato come indirizzo from per tutte le email in uscita.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	L’indirizzo email a cui gli utenti possono contattare il responsabile del sito.	[e-mail]

   Dopo aver aggiornato queste variabili d’ambiente, salva ed esci.

3. Configurare le Sandbox Compiles

   Quindi configura TeX Live Full per le sandboxed-compiles.md. Apri config/variables.env e aggiorna le seguenti variabili d’ambiente:

   config/variables.env

   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   
4. Avviare la tua istanza

   Per avviare la tua istanza esegui:

   Start the instance

   bin/up
   

   Questo comando scaricherà le immagini necessarie, incluso TeX Live, creerà i container (usando le tue personalizzazioni) e avvierà l’istanza. Dovresti vedere l’output dei log dei vari container Docker.

   Per avviarli di nuovo in seguito (senza collegarti all’output dei log) esegui:

   Start without attaching to logs

   bin/start
   

Il Toolkit usa docker compose per gestire i container Docker di Overleaf. Il Toolkit fornisce una serie di script che incapsulano docker compose e si occupano per te della maggior parte dei dettagli.

Se tutto va bene, dovresti riuscire a visualizzare la pagina di accesso della tua nuova istanza di Overleaf visitando http://127.0.0.1/ o http://localhost/ nel browser.

A seconda della configurazione di rete e di dove è ospitata la tua istanza di Overleaf, potrebbero essere necessarie ulteriori modifiche alla configurazione. Per maggiori dettagli, consulta le impostazioni del Toolkit: toolkit-settings.md