Impostazioni del Toolkit

Questa pagina descrive le variabili d’ambiente supportate nel file config/overleaf.rc per le installazioni basate sul Toolkit.

Il file config/overleaf.rc è composto da definizioni di variabili nella forma NAME=value. Le righe che iniziano con # vengono trattate come commenti.

Dopo aver modificato qualsiasi cosa in overleaf.rc o variables.env è necessario ricreare i container Docker eseguendo bin/up.

​

Container

​

sharelatex

Nome	Descrizione
PROJECT_NAME	Imposta il valore del flag --project-name passato a docker-compose. È utile quando si eseguono più istanze di Overleaf su un unico host, poiché ogni istanza può avere un nome di progetto diverso. - Predefinito: overleaf
OVERLEAF_IMAGE_NAME	Immagine Docker usata dal container dell’applicazione Server Pro/CE. Si tratta solo del nome dell’immagine Docker; il tag dell’immagine Docker viene letto da config/version. - Predefinito: - Server Pro: ghcr.io/ayaka-notes/overleaf-pro - Community Edition: sharelatex/sharelatex
SERVER_PRO	Se impostato su true, indica al Toolkit di usare l’immagine Server Pro (ghcr.io/ayaka-notes/overleaf-pro) invece dell’immagine predefinita Server CE (sharelatex/sharelatex). - Predefinito: false
GIT_BRIDGE_ENABLED	Imposta su true per abilitare la funzionalità git-bridge (solo Server Pro). Per maggiori informazioni consulta la documentazione utente https://www.overleaf.com/learn/how-to/Git_integration. - Predefinito: false
GIT_BRIDGE_IMAGE	Immagine Docker usata dal container git-bridge (solo Server Pro). Si tratta solo del nome dell’immagine Docker; il tag dell’immagine Docker viene letto da config/version. - Predefinito: ghcr.io/ayaka-notes/overleaf-pro/git-bridge
GIT_BRIDGE_DATA_PATH	Imposta il percorso della directory che verrà montata nel container git-bridge (solo Server Pro) e usata per memorizzare i repository git. Può essere un percorso completo (che inizia con /) oppure relativo alla directory di base del Toolkit.
GIT_BRIDGE_LOG_LEVEL	Configura il livello di log del container git-bridge. Livelli disponibili: TRACE, DEBUG, INFO, WARN, ERROR. - Predefinito: INFO
SIBLING_CONTAINERS_ENABLED	Se impostato su true, indica al Toolkit di usare la tecnica dei Sibling Containers per compilare i progetti in sandbox separate, usando un container Docker distinto per ogni progetto. Per maggiori informazioni consulta la documentazione <server-pro-only-configuration/sandboxed-compiles>. - Richiede: SERVER_PRO=true - Predefinito: true
SIBLING_CONTAINERS_PULL	Se impostato su true, indica al Toolkit di scaricare automaticamente, quando si usa il comando bin/up, tutte le immagini TeX Live impostate tramite ALL_TEX_LIVE_DOCKER_IMAGES nel file config/variables.env. - Predefinito: true
DOCKER_SOCKET_PATH	Imposta il percorso del socket Docker sulla macchina host (la macchina che esegue il Toolkit). Quando SIBLING_CONTAINERS_ENABLED è true, il socket viene montato nel container per consentire al servizio di compilazione di avviare nuovi container Docker sull’host. - Richiede: SIBLING_CONTAINERS_ENABLED=true - Predefinito: /var/run/docker.sock
OVERLEAF_DATA_PATH	Imposta il percorso della directory che verrà montata nel container principale sharelatex e usata per memorizzare i dati di compilazione. Può essere un percorso completo (che inizia con /) oppure relativo alla directory di base del Toolkit. - Predefinito: data/overleaf
OVERLEAF_LISTEN_IP	Imposta l’indirizzo o gli indirizzi IP dell’host a cui il container si collegherà. Ad esempio, se è impostato su 0.0.0.0, l’interfaccia web sarà disponibile su qualsiasi indirizzo IP dell’host. Per l’accesso diretto al container, il valore di OVERLEAF_LISTEN_IP deve essere impostato sul tuo indirizzo IP pubblico. Impostare OVERLEAF_LISTEN_IP su 0.0.0.0 o sull’IP esterno dell’host causa in genere errori se usato insieme al . - Predefinito: 127.0.0.1
OVERLEAF_PORT	Imposta la porta dell’host a cui il container si collegherà. Ad esempio, se è impostata su 8099 e OVERLEAF_LISTEN_IP è impostato su 127.0.0.1, l’interfaccia web sarà disponibile su http://localhost:8099. - Predefinito: 80
OVERLEAF_LOG_PATH	Imposta il percorso della directory che verrà montata nel container principale sharelatex e usata per rendere disponibili i log dell’applicazione sull’host Docker. Può essere un percorso completo (che inizia con /) oppure relativo alla directory di base del Toolkit. Rimuovi la voce di configurazione per disabilitare il bind mount. Se non è impostato, i log verranno eliminati quando il container viene ricreato. Vedi per informazioni sui log. - Predefinito: non impostato

---

​

mongo

Nome	Descrizione
MONGO_ENABLED	Se impostato su true, indica al Toolkit di creare un container MongoDB che ospiti il database. Se impostato su false, questo container non verrà creato e il sistema userà invece il database MongoDB specificato da MONGO_URL. - Predefinito: true
MONGO_URL	Specifica l’URL di connessione MongoDB da usare quando MONGO_ENABLED è false. - Predefinito: non impostato
MONGO_DATA_PATH	Imposta il percorso della directory che verrà montata nel container mongo e usata per memorizzare il database MongoDB. Può essere un percorso completo (che inizia con /) oppure relativo alla directory di base del Toolkit. Questa opzione riguarda solo il container mongo locale creato quando MONGO_ENABLED è true. - Predefinito: data/mongo
MONGO_IMAGE	Immagine Docker usata dal container MongoDB. Si tratta solo del nome dell’immagine Docker; il tag dell’immagine Docker va inserito in MONGO_VERSION (vedi sotto). - Predefinito: mongo
MONGO_VERSION	Versione di MongoDB usata dal container MongoDB. Il valore deve iniziare con la versione principale di MongoDB seguita da un punto, ad es. 6.0 o 6.0-with-suffix. - Predefinito: 6.0

---

​

redis

Nome	Descrizione
REDIS_ENABLED	Se impostato su true, indica al Toolkit di creare un container Redis che ospiti il database Redis. Se impostato su false, questo container non verrà creato e il sistema userà invece il database Redis specificato da REDIS_HOST e REDIS_PORT. - Predefinito: true
REDIS_HOST	Specifica l’host Redis da usare quando REDIS_ENABLED è false. - Predefinito: non impostato
REDIS_PORT	Specifica la porta Redis da usare quando REDIS_ENABLED è false. - Predefinito: non impostato
REDIS_DATA_PATH	Imposta il percorso della directory che verrà montata nel container redis e usata per memorizzare il database Redis. Può essere un percorso completo (che inizia con /) oppure relativo alla directory di base del Toolkit. Questa opzione riguarda solo il container redis locale creato quando REDIS_ENABLED è true. - Predefinito: data/redis
REDIS_AOF_PERSISTENCE	Attiva la persistenza AOF (Append Only File) per Redis. È la configurazione consigliata per la persistenza di Redis. Per ulteriori dettagli, consulta la sezione <../../../maintenance/data-and-backups#aof-append-only-file> in <../../maintenance/data-and-backups>. - Predefinito: true

---

​

nginx

Nome	Descrizione
NGINX_ENABLED	Se impostato su true, indica al Toolkit di creare un container NGINX che funga da proxy TLS. - Predefinito: false
NGINX_CONFIG_PATH	Percorso del file di configurazione NGINX da usare per il proxy TLS. - Predefinito: config/nginx/nginx.conf
NGINX_TLS_LISTEN_IP	Imposta l’indirizzo o gli indirizzi IP dell’host a cui il container del proxy TLS si collegherà per HTTPS. Ad esempio, se è impostato su 0.0.0.0, l’interfaccia web HTTPS sarà disponibile su qualsiasi indirizzo IP dell’host. In genere dovrebbe essere impostato sull’IP esterno del tuo host. - Predefinito: 127.0.1.1
NGINX_HTTP_LISTEN_IP	Imposta l’indirizzo o gli indirizzi IP dell’host a cui il container del proxy TLS si collegherà per il reindirizzamento HTTP. Ad esempio, se è impostato su 127.0.1.1, le connessioni HTTP a 127.0.1.1 verranno reindirizzate all’interfaccia web HTTPS. In genere dovrebbe essere impostato sull’IP esterno del tuo host. Non impostarlo su 0.0.0.0, perché in genere causa un conflitto con OVERLEAF_LISTEN_IP. - Predefinito: 127.0.1.1
NGINX_HTTP_PORT	Imposta la porta dell’host a cui il container del proxy TLS si collegherà per HTTP. - Predefinito: 80
TLS_PORT	Imposta la porta dell’host a cui il container del proxy TLS si collegherà per HTTPS. - Predefinito: 443
TLS_PRIVATE_KEY_PATH	Percorso della chiave privata da usare per il proxy TLS. - Predefinito: config/nginx/certs/overleaf_key.pem
TLS_CERTIFICATE_PATH	Percorso del certificato pubblico da usare per il proxy TLS. - Predefinito: config/nginx/certs/overleaf_certificate.pem