> 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/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 di definizioni di variabili nel formato `NAME=value`; le righe che iniziano con `#` sono trattate come commenti. {% hint style="info" %} È necessario ricreare i container 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 facile percorso di migrazione tra queste due versioni on-premise. Possono anche essere usate con le distribuzioni sia Toolkit sia Docker Compose. {% hint style="info" %} In precedenza, queste variabili d'ambiente avevano come 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 con 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 usare. | | `OVERLEAF_REDIS_HOST` e `REDIS_HOST` | Il nome host dell'istanza Redis da usare. Entrambe sono richieste (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 usare. Entrambe sono richieste (vedi [note di rilascio](broken://pages/bbc6c2ff5f08ddc7e724f247b288db581a204be3#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PASS` e `REDIS_PASSWORD` | La password da usare durante la connessione a Redis (se applicabile). **Entrambe** le variabili d'ambiente devono essere impostate. Vedi [abilitazione dell'autenticazione con password](broken://pages/63dc82a073369fc8067c8654543d9649ccb7d7ef) per ulteriori informazioni. | | `OVERLEAF_REDIS_TLS` |

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

Nota: mTLS attualmente non è supportato.

| | `OVERLEAF_NAV_TITLE` | Imposta il titolo della scheda dell'applicazione. | | `OVERLEAF_SESSION_SECRET` | Una stringa casuale usata per proteggere i token; se si usa il bilanciamento del carico, deve essere impostata con lo stesso token su tutte le macchine. Se viene eseguita una sola istanza, l'utente non deve impostarla. | | `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 lo imposti manualmente, oltre ai tuoi IP affidabili, devi includere anche uno di loopback, localhost o 127.0.0.1, che si fida dell'istanza nginx in esecuzione all'interno del sharelatex container.

Se utilizzi 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 IPAM -> Config -> Subnet valore in docker inspect overleaf\_default, ad es. OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,172.19.0.0/16. Questo serve a impedire la falsificazione degli X-Forwarded intestazioni.

Se stai usando un proxy TLS esterno (cioè non gestito da 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 ad 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 loro progetti e consentire agli utenti non autenticati di visualizzarli. | | `OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING` | Se impostato su `true`, consentirà agli utenti anonimi di visualizzare e modificare i progetti condivisi tramite la [condivisione tramite link](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) funzione. | | `OVERLEAF_DISABLE_LINK_SHARING` | Disabilita la [condivisione tramite link](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) funzione. | | `EMAIL_CONFIRMATION_DISABLED` | Se impostato su `true` il banner che richiede la conferma dell'email non verrà visualizzato. | | `ADDITIONAL_TEXT_EXTENSIONS` | Un array di stringhe per configurare estensioni aggiuntive per i file modificabili. | | `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 precedente (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.

Valori predefiniti: 90 giorni

| | `OVERLEAF_PROJECT_HARD_DELETION_DELAY` |

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

Valori 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 un'unità (MB) o wrapper.

| | `COMPILE_SIZE_LIMIT` | Controlla la dimensione massima del corpo della richiesta in byte. È la somma delle dimensioni di tutti i file doc all'interno del progetto (`main.tex`, `references.bib` (se non collegati) ecc.), che deve essere inviata nella richiesta di compilazione iniziale al servizio CLSI. | | `COMPILE_TIMEOUT` | Il tempo consentito, in secondi, affinché una compilazione venga completata. Per ulteriori 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 container per mitigare il rischio di perdita di dati. | | `SECCOMP_PROFILE` |

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

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

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

| | `OVERLEAF_DISABLE_CHAT` | Se impostato su `true`, disabilita la funzione di chat nel progetto. | | `OVERLEAF_LOGIN_SUPPORT_TEXT` | Se impostato, può essere usato per visualizzare informazioni di supporto sotto il pulsante di accesso. Il testo verrà mostrato nella schermata di accesso 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. Potrebbe essere necessario se usi un database MongoDB in cui l'utente del database non ha il ruolo clusterParameterReader .

Per assistenza sulla creazione di un ruolo personalizzato vedi

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

| | `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` container) e il traffico esterno (`git-bridge` → `history-v1`, in esecuzione in container 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 di Overleaf (account locali), non un'opzione SSO come LDAP. Per gli account SSO, le policy sulle password saranno applicate dal tuo identity provider o 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://overleaf-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.