Vai al contenuto principale
Qui abbiamo raccolto le risposte ad alcune domande frequenti su Ayakaleaf Pro.

Domande di base

No. Ayakaleaf Pro è completamente gratuito. Non è una versione di prova e non richiede alcuna licenza.
Sì. Ayakaleaf Pro include tutte le funzionalità di Overleaf Server Pro, compresa l’integrazione Git-Bridge. Include anche alcune funzionalità selezionate della piattaforma SaaS di Overleaf. Continuiamo a sviluppare e migliorare Ayakaleaf Pro.
Overleaf Server Pro costa circa $300 per utente all’anno. Richiede almeno 10 licenze, quindi le installazioni partono da circa $3.000 all’anno. Contratti pubblici statunitensi di dimensioni minori mostrano costi annuali di circa $320–$370 per utente. Questo rende Server Pro costoso, soprattutto per i team più piccoli. Consulta #information-and-price-about-overleaf-server-pro per acquisti e prezzi documentati.
Overleaf Server Pro è comunemente utilizzato da organizzazioni governative, che lo installano su reti private e ne controllano rigorosamente l’accesso. Per proteggere i dati sensibili, le funzionalità incluse evitano di scambiare dati con servizi di terze parti. Se hai bisogno di GitHub Sync, dell’IA o di funzionalità connesse simili, Overleaf consiglia un abbonamento alla sua piattaforma SaaS.
Ayakaleaf Pro è open source. Esaminiamo il codice con strumenti come Codex Security per rafforzarne la sicurezza e l’affidabilità. Se non abiliti la sincronizzazione dei dati con terze parti, i tuoi dati restano sul tuo server. Ayakaleaf Pro non contiene alcuna telemetria che invii i tuoi dati altrove.
Faremo tutto il possibile per mantenere questo progetto a lungo termine.
Ayakaleaf Pro è un fork della community. Il suo codice e le funzionalità integrate provengono da contributi della community. È distribuito con licenza AGPL v3. Le installazioni possono essere conformi a questa licenza quando ne soddisfano i requisiti.
Il progetto si chiamava originariamente Overleaf Pro nel 2024. Lo sviluppo si è interrotto per un periodo, per poi riprendere alla fine del 2025. Nel primo trimestre del 2026, Overleaf ha rinominato Pro il proprio piano di abbonamento con IA. Inoltre, il feedback della community ha evidenziato che il nome Overleaf Pro poteva creare rischi legati ai marchi e alla sostituzione d’identità, inducendo gli utenti a pensare che il progetto fosse ufficiale.Abbiamo rinominato il progetto Ayakaleaf Pro per evitare questa confusione. Il nome può essere letto come “Ayaka-notes Overleaf Pro”. Il maintainer (puoi chiamarmi ayaka!) contribuisce allo sviluppo della community di Overleaf fin dagli anni da studente, da oltre cinque anni. Questa esperienza sostiene il nostro impegno di manutenzione a lungo termine.
Dal 2026, la community open source ha rilasciato molti editor LaTeX realizzati con l’IA, tra cui OpenAI Prism. Ayakaleaf Pro mantiene i tuoi dati e servizi sul tuo server, offrendoti il controllo diretto sulla tua installazione e sui tuoi dati.Molti editor sperimentali della community non hanno un piano consolidato di manutenzione a lungo termine. Anche le piattaforme di compilazione LaTeX di terze parti possono cessare l’attività quando la base di utenti o i ricavi sono insufficienti. Ayakaleaf Pro fornisce tutto il codice sorgente e ti consente di ospitare autonomamente ogni servizio. Anche se la manutenzione si interrompesse, il tuo servizio self-hosted esistente potrebbe continuare a funzionare.
È stato rinominato in ayaka-notes/ayakaleaf-pro con il cambio di nome del progetto (vedi Q08). Non è stato archiviato né sostituito: è lo stesso repository e GitHub reindirizza i vecchi link e i remote Git ayaka-notes/overleaf-pro al nuovo nome. L’immagine Docker mantiene il suo nome, ghcr.io/ayaka-notes/overleaf-pro, quindi non devi modificare config/overleaf.rc o config/version.

Funzionalità

Consulta la nostra documentazione per l’elenco aggiornato delle funzionalità. Se c’è una funzionalità che vorresti aggiungessimo, apri pure una issue (di tipo feature request) su GitHub. Faremo del nostro meglio per implementare le funzionalità richieste, ma lo sviluppo richiede tempo e non possiamo garantire che ogni funzionalità venga rilasciata subito.
I contributi sono benvenuti, ma l’accettazione non è garantita. Valutiamo ogni PR in base al suo impatto sul codice di base di Overleaf, all’onere di manutenzione e al valore che offre agli utenti. Faremo del nostro meglio per integrare e mantenere i contributi di valore.Tuttavia, potremmo rifiutare PR che introducono modifiche eccessive, che consistono in codice generato dall’IA non revisionato o poco compreso (“vibe coding”) o che aggiungono funzionalità difficili da mantenere nel tempo.
In genere aggiorniamo la documentazione ogni volta che rilasciamo una nuova funzionalità. Consulta la documentazione pertinente per istruzioni di configurazione dettagliate e per la spiegazione delle variabili d’ambiente disponibili.
Il Python Runner esegue Python nel browser dell’utente con Pyodide 0.29.3, non sul server. Carica i pacchetti importati dal tuo codice tra i pacchetti integrati in Pyodide, come NumPy, pandas e Matplotlib. I pacchetti installati con pip e altri pacchetti non sono disponibili. Non c’è nulla da configurare sul server.
No. Il correttore ortografico non dispone di un dizionario per il giapponese o il cinese, quindi queste lingue non compaiono nell’elenco delle lingue del controllo ortografico. Gli utenti possono disattivare il controllo ortografico per un progetto nelle impostazioni dell’editor.Per evitare che una parola venga segnalata come errata, fai clic destro su di essa e scegli Add to dictionary. Le parole aggiunte vengono salvate nel tuo account e valgono per tutti i tuoi progetti. Per rivederle o rimuoverle, apri le impostazioni dell’editor, quindi Spelling and language → Dictionary → Edit. L’aggiunta di parole non aggiunge una nuova lingua al controllo ortografico.
Non esiste un programma di installazione dei plugin. Le funzionalità sono moduli in services/web/modules del codice sorgente, inclusi nell’immagine Docker e attivati con le impostazioni descritte in questa documentazione. Per aggiungerne di tuoi, aggiungi un modulo al codice sorgente e crea la tua immagine.

Installazione

Per la maggior parte degli utenti consigliamo di installare con il Toolkit. Il supporto per Kubernetes è sperimentale: Usare Kubernetes mostra i manifest che abbiamo testato con una o più repliche, ma un cluster aumenta la complessità operativa e l’impegno di manutenzione. Le Sandboxed Compiles creano i propri container di compilazione tramite il socket Docker, quindi ogni nodo che esegue Ayakaleaf Pro necessita di Docker Engine. Non forniamo configurazioni per CRI-O, Podman o Quadlet.
Consulta la nostra guida sulla scalabilità orizzontale. Puoi installare più istanze di Overleaf e configurare un load balancer per distribuire il traffico tra di esse.
Se hai un’istanza esistente di Overleaf Server Pro, saremo felici di aiutarti a migrare ad Ayakaleaf Pro. Contattaci via email o tramite issue.
No. Ayakaleaf Pro deve essere servito dalla radice di un dominio. Usa un dominio o un sottodominio dedicato, come https://overleaf.example.com.
Sì. Il Toolkit funziona su Linux, su macOS con Docker Desktop e su Windows con WSL 2 e Docker Desktop. Consigliamo Linux per i server condivisi e di produzione. Le guide per macOS e Windows includono la configurazione delle sandboxed compiles.Non forniamo un docker-compose.yml autonomo. Per vedere la configurazione Compose usata dal Toolkit, esegui bin/docker-compose config nella directory del Toolkit.
Non esiste uno script di disinstallazione. Nella directory del Toolkit:
  1. Arresta e rimuovi i container con bin/docker-compose down.
  2. Elimina i dati. Per impostazione predefinita si trovano nella directory data/ del Toolkit. Se hai modificato OVERLEAF_DATA_PATH, MONGO_DATA_PATH, REDIS_DATA_PATH o GIT_BRIDGE_DATA_PATH in config/overleaf.rc, elimina anche quelle directory. L’operazione è irreversibile, quindi esegui prima un backup se potresti aver bisogno dei dati.
  3. Elimina la directory del Toolkit.
  4. Rimuovi le immagini Docker, che puoi elencare con docker images: ghcr.io/ayaka-notes/overleaf-pro, l’immagine git-bridge, mongo, redis e le immagini TeX Live.
Esegui questi comandi nella directory del Toolkit:
  • bin/stop arresta tutti i container, bin/start li riavvia. I container vengono conservati, quindi gli utenti restano connessi.
  • bin/up -d crea i container e li avvia in background. Eseguilo dopo aver modificato config/variables.env, config/overleaf.rc o config/version: ricrea i container la cui configurazione è cambiata, e solo allora le modifiche hanno effetto. bin/stop e bin/start non le applicano.
  • bin/docker-compose restart sharelatex riavvia solo il container di Overleaf, senza applicare le modifiche alla configurazione.
Se gli utenti vengono disconnessi ogni volta che bin/up ricrea il container, imposta OVERLEAF_SESSION_SECRET; vedi le Q&A in Variabili d’ambiente.
Nell’applicazione che crei presso il provider, non in Ayakaleaf Pro. In config/variables.env non esiste un’impostazione di callback per nessuna di queste integrazioni: Ayakaleaf Pro costruisce ogni URL di callback a partire da OVERLEAF_SITE_URL e lo invia al provider, che lo rifiuta se non corrisponde a quello registrato per l’applicazione. Devi quindi solo registrarlo presso il provider e impostare OVERLEAF_SITE_URL sull’indirizzo che gli utenti aprono.Se modifichi OVERLEAF_SITE_URL, ad esempio passando a un nuovo dominio, aggiorna l’URL anche presso ogni provider, altrimenti il collegamento non riesce.
Per impostazione predefinita, tutto resta sul disco locale del server, nella directory data/ del Toolkit: data/overleaf (file dei progetti, cronologia e output di compilazione), data/mongo e data/redis. Per le istanze con meno di 1000 utenti, consigliamo il disco locale con backup regolari.L’immagine di Ayakaleaf Pro occupa circa 5 GB. Il minimo di 40 GB indicato nell’Introduzione è per le Sandboxed Compiles, le cui immagini texlive-full occupano circa 28 GB ciascuna. Senza le Sandboxed Compiles, le compilazioni vengono eseguite all’interno del container sharelatex con lo schema basic di TeX Live più latexmk, texcount, synctex, etoolbox e xetex, quindi molti progetti non riescono a compilare per via di pacchetti mancanti. La directory data/ cresce poi con i tuoi progetti e la loro cronologia; controllala con du -sh data/*.
Sì, a condizione che Windows resti attivo e Docker Desktop resti in esecuzione. Attiva Start Docker Desktop when you sign in to your computer, mantieni i criteri restart: always del Toolkit e disattiva la sospensione e l’ibernazione automatiche quando il computer è collegato alla corrente. Lo schermo può spegnersi; il comportamento alla chiusura del coperchio del portatile è un’impostazione separata. Chiudere il terminale Ubuntu dopo bin/up -d non arresta i container in modalità detached. Uscire da Docker Desktop, mettere in pausa il suo motore o eseguire wsl --shutdown interrompe il servizio.Il Resource Saver di Docker Desktop è diverso dalla sospensione di Windows: si applica quando non ci sono container in esecuzione, quindi uno stack Ayakaleaf in esecuzione non è inattivo solo perché nessuno sta modificando. Dopo un riavvio di Windows, l’impostazione di avvio all’accesso richiede comunque che qualcuno effettui l’accesso. Segui Mantenere l’istanza disponibile per i controlli e i passaggi di ripristino. Linux resta la nostra raccomandazione quando la disponibilità non deve dipendere da un accesso interattivo al desktop.
Questa guida usa il backend WSL 2. Richiede la virtualizzazione della CPU abilitata nel BIOS/UEFI, la funzionalità Virtual Machine Platform di Windows e un’installazione di WSL 2 funzionante. La funzionalità completa Hyper-V è un backend separato di Docker Desktop e non è un prerequisito per questa configurazione WSL.Controlla Task Manager → Performance → CPU → Virtualization ed esegui wsl --list --verbose in PowerShell. Errori come 0x80370102 possono indicare che la virtualizzazione, la funzionalità di Windows o l’hypervisor di avvio sono disabilitati. Consulta i passaggi di risoluzione dei problemi dell’installazione su Windows, con i link di riparazione di Microsoft e Docker. Riavvia Windows dopo aver abilitato le funzionalità richieste; reinstallare Ayakaleaf non può risolvere un motore Docker che non si avvia.

LaTeX

Quando abiliti le Sandbox Compiles, la compilazione di ogni utente viene eseguita in un container Docker separato ed è isolata dalle compilazioni degli altri utenti. Shell Escape è abilitato per impostazione predefinita per le Sandbox Compiles.
Negli ultimi tre anni abbiamo migliorato la nostra immagine TeX Live Full per le Sandbox Compiles. Nella maggior parte dei casi, i progetti che compilano su overleaf.com compilano correttamente anche con Ayakaleaf Pro. Se un font necessario non è disponibile, caricalo manualmente nel tuo progetto.
Carica il tuo progetto sul sito ufficiale di Overleaf, abilita la condivisione tramite link in sola lettura e includi il link in una issue su GitHub.Analizzeremo e correggeremo qualsiasi bug che impedisca la compilazione di un progetto in Ayakaleaf Pro quando questo compila correttamente sul sito ufficiale di Overleaf. I problemi di compilazione al di fuori di questo ambito non rientrano nel nostro supporto.
Ultima modifica il 8 novembre 2026