> 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/configurazione/overleaf-toolkit/environment-variables.md). # Variabili d'ambiente Questa pagina descrive le variabili d'ambiente supportate nel `config/variables.env` file per le distribuzioni Toolkit. Il `config/variables.env` Il file consiste in definizioni di variabili nella forma `NAME=value`; le righe che iniziano con `#` sono trattate come commenti. {% hint style="info" %} È necessario ricreare i contenitori Docker dopo aver modificato qualsiasi cosa in `overleaf.rc` o `variables.env` eseguendo `bin/up`. {% endhint %} ### Tutte le versioni Queste variabili d'ambiente sono compatibili con Server CE e Server Pro e forniscono un percorso di migrazione semplice tra queste due versioni on-premise. Possono anche essere utilizzate sia con distribuzioni Toolkit che Docker Compose. {% hint style="info" %} In precedenza, queste variabili d'ambiente avevano il prefisso `SHARELATEX_` invece di `OVERLEAF_`. {% endhint %} | Nome | Descrizione | | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OVERLEAF_SITE_URL` | Dove la tua istanza di Overleaf è disponibile pubblicamente. Questo viene usato nei link pubblici e quando ci si connette tramite websocket, quindi deve essere configurato correttamente! | | `OVERLEAF_ADMIN_EMAIL` | L'indirizzo email a cui gli utenti possono contattare la persona che gestisce il sito. | | `OVERLEAF_APP_NAME` | Il nome da visualizzare quando si parla dell'applicazione in esecuzione. Il valore predefinito è 'Overleaf (Community Edition)'. | | `OVERLEAF_MONGO_URL` e `MONGO_URL` | L'URL del database Mongo da utilizzare. | | `OVERLEAF_REDIS_HOST` e `REDIS_HOST` | Il nome host dell'istanza Redis da utilizzare. Entrambi sono richiesti (vedi [note di rilascio](broken://pages/bbc6c2ff5f08ddc7e724f247b288db581a204be3#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PORT` e `REDIS_PORT` | La porta dell'istanza Redis da utilizzare. Entrambi sono richiesti (vedi [note di rilascio](broken://pages/bbc6c2ff5f08ddc7e724f247b288db581a204be3#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PASS` e `REDIS_PASSWORD` | La password da usare quando ci si connette a Redis (se applicabile). **Entrambe** le variabili d'ambiente devono essere impostate. Vedi [abilitazione dell'autenticazione tramite password](broken://pages/63dc82a073369fc8067c8654543d9649ccb7d7ef) per maggiori informazioni. | | `OVERLEAF_REDIS_TLS` |

Se impostato su true, consente la connessione a un'istanza Redis che richiede TLS.

Nota: mTLS al momento non è supportato.

| | `OVERLEAF_NAV_TITLE` | Imposta il titolo della scheda dell'applicazione. | | `OVERLEAF_INVITE_TOKEN_SECRET` |

Obbligatorio. Stringa casuale usata per proteggere i token di condivisione dei progetti (aggiunto in Server Pro 6.2.0).

Caratteri minimi: 16

| | `OVERLEAF_SESSION_SECRET` | Una stringa casuale usata per proteggere i token; se si usa il bilanciamento del carico, deve essere impostata sullo stesso token su tutte le macchine. Se è in esecuzione una sola istanza, non deve essere impostata dall'utente. | | `OVERLEAF_COOKIE_SESSION_LENGTH` | Consente di sovrascrivere il tempo di scadenza predefinito del cookie di sessione di 5 giorni. Il valore di sovrascrittura deve essere in millisecondi. Esempio: per fare in modo che la sessione duri 1 ora, imposta `COOKIE_SESSION_LENGTH=3600000`. (aggiunto in Server Pro 4.2) | | `OVERLEAF_TRUSTED_PROXY_IPS` |

Se non impostato, il valore predefinito è loopback. Se impostato manualmente, oltre ai tuoi IP attendibili, devi includere anche uno di loopback, localhost o 127.0.0.1, che si fida dell'istanza nginx in esecuzione all'interno del sharelatex contenitore.

Se si usa una subnet da 172.16.0.0/12 (subnet predefinita per le reti Docker) per la tua rete normale, imposta OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,\ nel tuo config/variables.env. Dove \ è il valore IPAM -> Config -> Subnet in docker inspect overleaf\_default, ad es. OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,172.19.0.0/16. Questo serve a prevenire lo spoofing delle intestazioni X-Forwarded .

Se stai usando un proxy TLS esterno (cioè non gestito dall'Overleaf Toolkit), assicurati che OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,\, ad es. OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,192.168.13.37.

| | `OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS` | Se impostato su `true`, limiterà gli inviti ai progetti agli indirizzi email che corrispondono a account utente esistenti. | | `OVERLEAF_ALLOW_PUBLIC_ACCESS` | Se impostato su `true`, consentirà agli utenti non autenticati di visualizzare il sito. Il valore predefinito è `false`, il che significa che gli utenti non autenticati verranno reindirizzati in modo incondizionato alla pagina di accesso quando provano a visualizzare qualsiasi parte del sito. Nota: impostare questa opzione non disabilita in alcun modo l'autenticazione o la sicurezza. Questa opzione è necessaria se i tuoi utenti intendono rendere pubblici i propri progetti e far sì che utenti non autenticati li visualizzino. | | `OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING` | Se impostato su `true`, consentirà agli utenti anonimi di visualizzare e modificare i progetti condivisi tramite la funzionalità di [condivisione tramite link](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) . | | `OVERLEAF_DISABLE_LINK_SHARING` | Disabilita la [condivisione tramite link](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) . | | `EMAIL_CONFIRMATION_DISABLED` | Quando impostato su `true` il banner che richiede la conferma dell'email non verrà mostrato. | | `ADDITIONAL_TEXT_EXTENSIONS` | Un array di stringhe per configurare estensioni aggiuntive per i file modificabili. | | `DEFAULT_LATEX_COMPILER` |

Usato per impostare il compilatore predefinito utilizzato da nuovi progetti. (aggiunto in Server Pro 6.2.0).

Opzioni: pdflatex, latex, xelatex o lualatex

| | `OVERLEAF_STATUS_PAGE_URL` | URL personalizzato della pagina di stato (aggiunto in Server Pro 3.4.0), ad es. `status.example.com`. | | `OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS` | Imposta su `'false'` per impedire che i nuovi progetti vengano inizializzati con la Cronologia completa del progetto (aggiunto in Server Pro 3.5.0). | | `OVERLEAF_FPH_DISPLAY_NEW_PROJECTS` | Imposta su `'false'` per impedire che i nuovi progetti mostrino la Cronologia completa del progetto invece della cronologia legacy (aggiunto in Server Pro 3.5.0). | | `ENABLE_CRON_RESOURCE_DELETION` | Imposta questa variabile d'ambiente su `true` per abilitare la pulizia automatica dei progetti e degli utenti eliminati dopo 90 giorni. | | `OVERLEAF_USER_HARD_DELETION_DELAY` |

Usato per modificare il ritardo di scadenza degli utenti eliminati. Configurato in millisecondi.

Predefiniti: 90 giorni

| | `OVERLEAF_PROJECT_HARD_DELETION_DELAY` |

Usato per modificare il ritardo di scadenza dei progetti eliminati. Configurato in millisecondi.

Predefiniti: 90 giorni

| | `MAX_UPLOAD_SIZE` |

Controlla la dimensione massima di un singolo caricamento, in megabyte. Il valore predefinito è 50.

Attenzione: Questa variabile è solo un numero grezzo, senza unità (MB) o wrapper.

| | `COMPILE_SIZE_LIMIT` | Controlla la dimensione massima del corpo della richiesta in byte. È la somma di tutte le dimensioni dei file del documento all'interno del progetto (`main.tex`, `references.bib` (se non collegato) ecc.), che deve essere inviata nella richiesta di compilazione iniziale al servizio CLSI. | | `COMPILE_TIMEOUT` | La quantità di tempo, in secondi, consentita per il completamento di una compilazione. Per maggiori informazioni vedi [Aggiornamento del timeout di compilazione del progetto](broken://pages/98570477cca3c990354e617a98f6a9f3e0ec6df2#updating-project-compile-timeout). | | `MAX_RECONNECT_GRACEFULLY_INTERVAL_MS` | Un ritardo configurabile tra la riconnessione graduale dell'editor, lo svuotamento dei dati e l'arresto del contenitore per mitigare il rischio di perdita di dati. | | `SECCOMP_PROFILE` |

Imposta questa variabile d'ambiente su un percorso sulla host macchina Docker che punta al profilo SECCOMP. Puoi scaricare una copia del profilo qui.

Attualmente necessario per le distribuzioni Podman quando si usano compilazioni in sandbox.

| | `OVERLEAF_DISABLE_CHAT` | Se impostato su `true`, disabilita la funzionalità di chat all'interno del progetto. | | `OVERLEAF_LOGIN_SUPPORT_TEXT` | Quando impostato, può essere usato per mostrare informazioni di supporto sotto il pulsante di accesso. Il testo verrà mostrato nella schermata di login e può essere usato per indirizzare gli utenti al supporto interno o fornire indicazioni relative all'accesso, alla creazione di account, ecc. | | `ALLOW_MONGO_ADMIN_CHECK_FAILURES` |

Se impostato su true, consente ai controlli di avvio di MongoDB di fallire e di non impedire l'avvio della distribuzione. Questo può essere necessario se usi un database MongoDB in cui l'utente del database non dispone del clusterParameterReader ruolo.

Per assistenza sulla creazione di un ruolo personalizzato vedi qui.

| | `V1_HISTORY_URL_FOR_GIT_BRIDGE` | Consente di separare l' **history-v1** endpoint per il traffico interno (`web` service → `history-v1` service, entrambi nel `sharelatex` contenitore) e il traffico esterno (`git-bridge` → `history-v1`, in esecuzione in contenitori separati). | | `OVERLEAF_MAINTENANCE_MESSAGE` e `OVERLEAF_MAINTENANCE_MESSAGE_HTML` | Usato per personalizzare il titolo e il contenuto della pagina di manutenzione. Non può essere usato con `OVERLEAF_STATUS_PAGE_URL`. | {% hint style="info" %} È possibile imporre restrizioni sulle password agli utenti quando si usa il sistema di accesso Overleaf (account locali), non un'opzione SSO come LDAP. Per gli account SSO, i criteri di password saranno applicati dal provider di identità o dal servizio di directory, consentendo inoltre il supporto per l'autenticazione a più fattori. {% 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/configurazione/overleaf-toolkit/environment-variables.md?ask=&goal= ``` `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.