Vai al contenuto principale
Se usi una versione precedente, usa sharelatex al posto di overleaf nei nomi dei percorsi.
Montare un filesystem NFS in un container Overleaf è tecnicamente possibile, ma non è consigliato e può causare diversi tipi di errori di prestazioni.Un errore comune riscontrato durante le compilazioni è:
In particolare sconsigliamo di usare filesystem basati su NFS per i dati temporanei, come le directory usate per i dati di compilazione. Per le directory seguenti consigliamo di usare un disco scratch locale, preferibilmente un SSD locale.Per le configurazioni basate su docker-compose, suggeriamo semplicemente di sovrascrivere il bind mount da NFS, evitando così di modificare i percorsi nell’applicazione. Ecco un estratto di configurazione docker-compose che usa un disco scratch montato su /scratch:
docker-compose excerpt
Dopo l’aggiornamento non è necessario migrare i file esistenti da NFS alla nuova posizione. Il compilatore LaTeX può ricreare tutti i file eseguendo di nuovo una compilazione completa.Per maggiori dettagli vedi: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
Se esegui Overleaf su Windows o macOS, il servizio mongo potrebbe non riuscire a riavviarsi, restituendo l’errore:
Example error
Questo può accadere quando i dati di MongoDB sono montati con bind mount da un filesystem che non fornisce la semantica richiesta, come una directory montata da Windows. Per Windows con WSL 2, mantieni il Toolkit nella home directory Linux di Ubuntu e usa i bind mount predefiniti. Consulta i controlli di MongoDB nella guida della piattaforma.Per una nuova installazione che richiede uno storage gestito da Docker, il seguente override usa volumi con nome (consulta le indicazioni sullo storage dell’immagine MongoDB). Su un’installazione esistente, modificare i mount non migra i dati: esegui il backup e il ripristino del database/della cache prima di cambiare, altrimenti il servizio vedrà volumi vuoti. Aggiungi quanto segue a config/docker-compose.override.yml, unendolo a eventuali configurazioni esistenti:
config/docker-compose.override.yml
Per maggiori informazioni vedi: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
Usa il comando docker logs redis per ottenere una copia dei log.Se vedi la riga Fatal: Can't initialize Background Jobs, l’output completo sarà simile al seguente:
Redis log example
Questo problema può essere legato alla versione di Docker attualmente in uso. L’aggiornamento a una versione >= 20.10.10 dovrebbe risolverlo.Per maggiori informazioni, consulta la issue upstream di Redis: https://github.com/redis/redis/issues/12362Riferimento: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
Occasionalmente, le immagini di anteprima/miniatura generate da Ayakaleaf Pro possono essere create con un orientamento errato e richiedere un intervento manuale per correggerle. Queste immagini sono memorizzate in /var/lib/overleaf/data/template_files/.Consigliamo di eseguire un backup di questa cartella prima di apportare qualsiasi modifica.Dovrai seguire i passaggi seguenti per ciascun template interessato:Trova l’ID del template: vai alla galleria dei template della tua istanza (/templates/all), apri un template interessato e copia l’ID dall’URL (ad esempio: https://your-instance-url/templates/6645d346c224815e9460a695). Esegui il comando di correzione: esegui il comando seguente dall’host Docker (sostituisci l’ID del template con quello che hai copiato e aggiorna il percorso se necessario): docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”Riferimento: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images
Il comando \write18 è disabilitato per impostazione predefinita nella Community Edition, poiché tutte le compilazioni avvengono all’interno dello stesso container sharelatex; questa è l’impostazione predefinita più sicura.Se vuoi abilitarlo per pdflatex, crea un file latexmkrc nella radice del tuo progetto con il seguente contenuto:
latexmkrc
Quindi prova a ricompilare.Riferimento: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
Questi errori indicano che il container mongo continua ad arrestarsi in modo anomalo e a riavviarsi. bin/up avvia MongoDB e poi esegue un comando al suo interno, che non riesce mentre il container si riavvia. bin/docker-compose ps mostra il servizio mongo come Restarting.Per individuare la causa effettiva, leggi il log di MongoDB:
Le cause più comuni sono:
  • La CPU non supporta AVX. MongoDB 5.0 e successivi richiedono AVX su x86-64, e il log mostra MongoDB 5.0+ requires a CPU with AVX support. In una macchina virtuale, imposta il tipo di CPU su host in modo che AVX venga reso disponibile.
  • Kernel Linux da 6.19 a 7.0.13. MongoDB si rifiuta di avviarsi su questi kernel. Vedi Requisiti software per la soluzione alternativa.
  • I dati sono stati creati da una versione precedente di MongoDB. MongoDB 8.0 non può aprire direttamente i dati della 4.4 o della 5.0. Aggiorna una versione major alla volta, vedi Aggiornare MongoDB.
È il comportamento previsto con Ayakaleaf Pro e puoi ignorarlo. Il messaggio viene stampato quando OVERLEAF_IS_SERVER_PRO non è true, come avviene nell’immagine di Ayakaleaf Pro. Ayakaleaf Pro non ha bisogno di questa variabile, quindi lasciala non impostata.
Prima dell’avvio di Overleaf, il container esegue alcuni controlli di avvio e termina se uno di essi non riesce. Il Toolkit lo esegue con restart: always, quindi Docker lo riavvia e lo stesso controllo fallisce di nuovo. L’output di avvio indica il controllo non riuscito:
Le cause più comuni sono:
  • Missing required secrets: imposta OVERLEAF_INVITE_TOKEN_SECRET in config/variables.env, vedi Variabili d’ambiente.
  • ShareLaTeX to Overleaf rebranding: la configurazione usa ancora variabili o percorsi SHARELATEX_; rinominali come indicato dal messaggio.
  • Un errore dopo Checking can connect to mongo and redis: Overleaf non riesce a raggiungere MongoDB o Redis. Controlla bin/logs mongo e bin/logs redis.
Dopo aver risolto la causa, esegui bin/up -d.
A ogni avvio il container esegue i propri script di avvio uno dopo l’altro, e il log nomina ciascuno come *** Running /etc/my_init.d/<script>.... 910_initiate_doc_version_recovery ha qualcosa da fare solo sulle istanze che in passato hanno eseguito Overleaf 5.0.1. Su qualsiasi altra istanza stampa No recovery of doc versions needed. e l’avvio prosegue. Il suo output viene scritto anche in data/history/doc-version-recovery.log in OVERLEAF_DATA_PATH.Il codice di uscita e la parte finale di bin/docker-compose logs --tail=100 sharelatex indicano cosa è successo:
  • Codice di uscita 2, e il log termina con *** Init system aborted.: il container è stato arrestato, ad esempio da bin/stop, docker stop o Ctrl+C su bin/up. Lo script nell’ultima riga Running è solo quello in esecuzione in quel momento, non ha fallito. Avvia di nuovo il container con bin/up -d e lascia che l’avvio termini.
  • Codice di uscita 1, e il log mostra *** /etc/my_init.d/<script> failed with status <n>: quello script è fallito, e il suo errore si trova nelle righe immediatamente precedenti. Se 910_initiate_doc_version_recovery è fallito con Detected unflushed changes while recovering doc versions, l’istanza ha eseguito la 5.0.1 e ha ancora modifiche non scaricate; segui la guida ufficiale Doc version recovery.
Questa pagina viene mostrata quando il tuo account ha effettuato l’accesso ma non è autorizzato ad aprire la pagina, ad esempio una pagina di amministrazione aperta da un account che non è amministratore, oppure un progetto che non è condiviso con te.Per aprire le pagine di amministrazione, accedi con un account amministratore. Un amministratore esistente può rendere amministratore un altro account, oppure puoi crearne uno con il comando create-user --admin, vedi Gestione degli utenti. Nell’ambiente di sviluppo (develop/), le pagine di amministrazione richiedono anche ADMIN_PRIVILEGE_AVAILABLE=true in develop/dev.env; l’immagine di Ayakaleaf Pro lo imposta già.
Ultima modifica il 8 novembre 2026