Migrare da un'installazione esistente

Migra una distribuzione esistente dell’Overleaf Toolkit ad Ayakaleaf Pro.

È importante eseguire un backup consistente prima di ogni migrazione a una versione principale, così da poter tornare indietro in caso di necessità.

​

Migrare da Overleaf Community

​

Caso 01: dall’Overleaf Toolkit

Se usi l’Overleaf Toolkit ufficiale per Overleaf Community, ti basta aggiungere nella directory overleaf-toolkit/config un file chiamato docker-compose.override.yml con il seguente contenuto (o simile):

docker-compose.override.yml

---
services:
    sharelatex:
        image: ghcr.io/ayaka-notes/overleaf-pro:X.x.x # change to specific version

Per avviare la tua istanza, esegui:

bin/up

Fatto! È tutto pronto. A questo punto puoi verificare che l’istanza di Ayakaleaf funzioni correttamente e che tu possa accedere all’interfaccia web. Quando tutto funziona, prosegui con i passaggi di configurazione per abilitare funzionalità avanzate come:

• sandboxed-compiles.md
• authentication
• github-synchronisation.md
• zotero-integration.md

​

Caso 02: da un file Docker Compose

Se usi un file docker-compose.yml autonomo, migralo prima all’Overleaf Toolkit. Il Toolkit semplifica l’installazione on-premises, gli aggiornamenti e la manutenzione.

Segui la guida docker-compose.yml-to-toolkit-migration.md per convertire la tua distribuzione esistente. Durante questa migrazione, mantieni la configurazione attuale e i percorsi dei volumi di dati.

Quando la distribuzione con il Toolkit è in esecuzione, segui #from-overleaf-toolkit per passare all’immagine di Ayakaleaf Pro. Avvia l’istanza con bin/up, quindi verifica di poter accedere all’interfaccia web.

---

​

Migrare da Overleaf Server Pro

Se attualmente utilizzi un’istanza con licenza commerciale di Overleaf Server Pro e desideri migrare ad Ayakaleaf Pro, tieni presente che la migrazione potrebbe richiedere un lavoro aggiuntivo, perché alcuni formati di dati (templates) potrebbero non essere pienamente compatibili. Saremo comunque felici di aiutarti. Apri una issue oppure contattaci all’indirizzo [e-mail] e ti aiuteremo gratuitamente a migrare ad Ayakaleaf Pro.

---

​

Migrare da Overleaf CEP

Riceviamo spesso domande da utenti che vogliono sapere se possono migrare da Overleaf CEP ad Ayakaleaf Pro. Nella maggior parte dei casi, Overleaf CEP e Ayakaleaf Pro offrono funzionalità sostanzialmente equivalenti e, alla versione 6.2.0, restano compatibili a livello di dati. I due progetti possono rilasciare funzionalità in momenti diversi; ad esempio, potremmo integrare con cherry-pick una funzionalità di Overleaf CEP, e viceversa. Sebbene le nostre implementazioni della stessa funzionalità possano differire leggermente, in genere non c’è un motivo valido per migrare.

Se desideri comunque migrare ad Ayakaleaf Pro o provarlo, consulta: #case-01-from-overleaf-toolkit. La procedura di migrazione è la stessa.

---

​

Migrare da Overleaf SaaS

Purtroppo, migrare dalla piattaforma SaaS di Overleaf a un’istanza self-hosted di Ayakaleaf Pro può essere notevolmente più difficile. Al momento, l’unico metodo generalmente disponibile consiste nello scaricare ogni progetto come archivio ZIP e caricarlo poi nella tua istanza self-hosted di Ayakaleaf Pro. In questo modo vengono trasferiti solo i file attuali del progetto, il che significa che perderai:

• Tutta la cronologia del progetto e le revisioni precedenti
• Tutti i commenti e le revisioni tracciate
• Tutti i metadati Git e la cronologia dei commit
• Tutti i collegamenti e le impostazioni di sincronizzazione con GitHub
• Tutti i collegamenti tra i file BibTeX e le piattaforme di gestione dei riferimenti bibliografici di terze parti

---

​

Migrare da un fork di Overleaf di terze parti

Ayakaleaf Pro potrebbe non supportare funzionalità specifiche di un particolare fork di Overleaf di terze parti. Quando un fork si discosta in modo significativo dal codice upstream di Overleaf, o introduce modifiche senza mantenere la compatibilità con l’upstream, l’integrazione dei rilasci successivi di Overleaf può diventare estremamente difficile. Puoi comunque provare il metodo di migrazione descritto sopra, ma la compatibilità non è garantita e potremmo non essere in grado di offrire assistenza o supporto tecnico per le migrazioni da fork non supportati.