> ## 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.

# Migreren vanaf een bestaande installatie

> Migreer een bestaande Overleaf Toolkit-deployment naar Ayakaleaf Pro.

<Danger>
  Het is belangrijk dat je **vóór** elke migratie naar een nieuwe hoofdversie een [consistente back-up](/nl/on-premises/maintenance/data-and-backups#performing-a-consistent-backup) maakt, zodat je zo nodig kunt terugdraaien.
</Danger>

### Migreren vanaf Overleaf Community

#### Geval 01: Vanaf de Overleaf Toolkit

Als je de officiële Overleaf Toolkit voor Overleaf Community gebruikt, voeg je simpelweg een bestand met de naam `docker-compose.override.yml` met de volgende of vergelijkbare inhoud toe aan de map `overleaf-toolkit/config`:

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

Start je instantie met:

```bash theme={null}
bin/up
```

Dat is alles! Je bent klaar. Vervolgens kun je controleren of je Ayakaleaf-instantie correct draait en of je de webinterface kunt openen. Zodra alles werkt, ga je verder met de [configuratiestappen](/nl/on-premises/configuration/overleaf-toolkit) hieronder om geavanceerde functies in te schakelen, zoals:

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

#### Geval 02: Vanaf een Docker Compose-bestand

Als je een losstaand `docker-compose.yml` gebruikt, migreer dit dan eerst naar de Overleaf Toolkit. De Toolkit vereenvoudigt de on-premises installatie, upgrades en het onderhoud.

Volg [docker-compose.yml-to-toolkit-migration.md](/nl/on-premises/maintenance/docker-compose.yml-to-toolkit-migration "mention") om je bestaande deployment om te zetten. Behoud tijdens deze migratie je huidige configuratie en de paden van je datavolumes.

Zodra de Toolkit-deployment draait, volg je [#from-overleaf-toolkit](/nl/on-premises/installation/migrate-from-existing#from-overleaf-toolkit "mention") om de image ervan om te zetten naar Ayakaleaf Pro. Start de instantie met `bin/up` en controleer vervolgens of je de webinterface kunt openen.

***

### Migreren vanaf Overleaf Server Pro

Als je momenteel een commercieel gelicentieerde instantie van [Overleaf Server Pro](https://www.overleaf.com/for/enterprises) draait en wilt migreren naar Ayakaleaf Pro, houd er dan rekening mee dat de migratie wat extra werk kan vereisen, omdat bepaalde gegevensformaten (`templates`) mogelijk niet volledig compatibel zijn. We helpen je echter graag. [Open een issue](https://github.com/ayaka-notes/ayakaleaf-pro/issues) of neem contact met ons op via [ayaka-notes@outlook.com](mailto:ayaka-notes@outlook.com), dan helpen we je kosteloos met de migratie naar Ayakaleaf Pro.

***

### Migreren vanaf Overleaf CEP

We krijgen regelmatig vragen van gebruikers of ze kunnen migreren van [Overleaf CEP](https://github.com/yu-i-i/overleaf-cep) naar Ayakaleaf Pro. In de meeste gevallen bieden Overleaf CEP en Ayakaleaf Pro grotendeels gelijkwaardige functionaliteit en zijn ze vanaf versie 6.2.0 datacompatibel. De twee projecten brengen functies mogelijk op verschillende momenten uit; zo kunnen wij bijvoorbeeld een functie uit Overleaf CEP cherry-picken, en omgekeerd. Hoewel onze implementaties van dezelfde functie licht kunnen verschillen, is er over het algemeen geen dwingende reden om te migreren.

Als je toch wilt migreren naar Ayakaleaf Pro of het wilt uitproberen, raadpleeg dan: [#case-01-from-overleaf-toolkit](/nl/on-premises/installation/migrate-from-existing#case-01-from-overleaf-toolkit "mention"). Het migratieproces is hetzelfde.

***

### Migreren vanaf Overleaf SaaS

Helaas kan migreren van het Overleaf SaaS-platform naar een zelfgehoste Ayakaleaf Pro-instantie aanzienlijk lastiger zijn. Op dit moment is de enige algemeen beschikbare methode om elk project als ZIP-archief te downloaden en het daarna te uploaden naar je zelfgehoste Ayakaleaf Pro-instantie. Hiermee worden alleen de huidige projectbestanden overgezet, wat betekent dat je het volgende ***kwijtraakt***:

* Alle projectgeschiedenis en eerdere revisies
* Alle opmerkingen en bijgehouden wijzigingen
* Alle Git-metadata en commitgeschiedenis
* Alle GitHub-synchronisatiekoppelingen en -instellingen
* Alle koppelingen tussen BibTeX-bestanden en referentiebeheerplatforms van derden

***

### Migreren vanaf een Overleaf-fork van derden

Ayakaleaf Pro ondersteunt mogelijk geen functies die specifiek zijn voor een bepaalde Overleaf-fork van derden. Zodra een fork aanzienlijk afwijkt van de upstream Overleaf-codebase, of wijzigingen doorvoert zonder upstream-compatibiliteit te behouden, kan het mergen van latere Overleaf-releases buitengewoon moeilijk worden. Je kunt de hierboven beschreven migratiemethode nog steeds proberen, maar compatibiliteit is niet gegarandeerd, en we kunnen mogelijk geen hulp of technische ondersteuning bieden bij migraties vanaf niet-ondersteunde forks.


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