> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrare da un'installazione esistente

> Migra una distribuzione esistente dell'Overleaf Toolkit ad Ayakaleaf Pro.

<Danger>
  È importante eseguire un [backup consistente](/it/on-premises/maintenance/data-and-backups#performing-a-consistent-backup) **prima** di ogni migrazione a una versione principale, così da poter tornare indietro in caso di necessità.
</Danger>

### 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):

```yml title="docker-compose.override.yml" theme={null}
---
services:
    sharelatex:
        image: ghcr.io/ayaka-notes/overleaf-pro:X.x.x # change to specific version
```

Per avviare la tua istanza, esegui:

```bash theme={null}
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](/it/on-premises/configuration/overleaf-toolkit) per abilitare funzionalità avanzate come:

* [sandboxed-compiles.md](/it/on-premises/configuration/overleaf-toolkit/sandboxed-compiles "mention")
* [authentication](/it/on-premises/configuration/overleaf-toolkit/authentication "mention")
* [github-synchronisation.md](/it/on-premises/configuration/overleaf-toolkit/github-synchronisation "mention")
* [zotero-integration.md](/it/on-premises/configuration/overleaf-toolkit/zotero-integration "mention")

#### 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](/it/on-premises/maintenance/docker-compose.yml-to-toolkit-migration "mention") 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](/it/on-premises/installation/migrate-from-existing#from-overleaf-toolkit "mention") 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](https://www.overleaf.com/for/enterprises) 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](https://github.com/ayaka-notes/ayakaleaf-pro/issues) oppure contattaci all'indirizzo [ayaka-notes@outlook.com](mailto:ayaka-notes@outlook.com) 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](https://github.com/yu-i-i/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](/it/on-premises/installation/migrate-from-existing#case-01-from-overleaf-toolkit "mention"). 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.