Migration von bestehenden Installationen

Migrieren Sie eine bestehende Overleaf Toolkit-Bereitstellung zu Ayakaleaf Pro.

Es ist wichtig, vor jeder Migration auf eine neue Hauptversion eine konsistente Sicherung zu erstellen, damit Sie bei Bedarf zurückkehren können.

​

Migration von Overleaf Community

​

Fall 01: Vom Overleaf Toolkit

Wenn Sie das offizielle Overleaf Toolkit für Overleaf Community verwenden, fügen Sie einfach eine Datei namens docker-compose.override.yml mit folgendem oder ähnlichem Inhalt in das Verzeichnis overleaf-toolkit/config ein:

docker-compose.override.yml

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

Um Ihre Instanz zu starten, führen Sie Folgendes aus:

bin/up

Das war’s! Sie sind startklar. Als Nächstes können Sie überprüfen, ob Ihre Ayakaleaf-Instanz korrekt läuft und Sie auf die Weboberfläche zugreifen können. Sobald alles funktioniert, fahren Sie mit den unten stehenden Konfigurationsschritten fort, um erweiterte Funktionen zu aktivieren, wie zum Beispiel:

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

​

Fall 02: Von einer Docker Compose-Datei

Wenn Sie eine eigenständige docker-compose.yml verwenden, migrieren Sie diese zunächst zum Overleaf Toolkit. Das Toolkit vereinfacht Installation, Upgrades und Wartung vor Ort.

Folgen Sie der Anleitung docker-compose.yml-to-toolkit-migration.md, um Ihre bestehende Bereitstellung umzustellen. Behalten Sie bei dieser Migration Ihre aktuelle Konfiguration und die Pfade Ihrer Daten-Volumes bei.

Sobald die Toolkit-Bereitstellung läuft, folgen Sie #from-overleaf-toolkit, um das Image auf Ayakaleaf Pro umzustellen. Starten Sie die Instanz mit bin/up und überprüfen Sie anschließend, ob Sie auf die Weboberfläche zugreifen können.

---

​

Migration von Overleaf Server Pro

Wenn Sie derzeit eine kommerziell lizenzierte Instanz von Overleaf Server Pro betreiben und zu Ayakaleaf Pro migrieren möchten, beachten Sie bitte, dass die Migration zusätzlichen Aufwand erfordern kann, da bestimmte Datenformate (templates) möglicherweise nicht vollständig kompatibel sind. Wir unterstützen Sie jedoch gerne. Bitte eröffnen Sie ein Issue oder kontaktieren Sie uns unter [e-mail], und wir helfen Ihnen kostenlos bei der Migration zu Ayakaleaf Pro.

---

​

Migration von Overleaf CEP

Wir erhalten häufig Fragen von Benutzern, ob sie von Overleaf CEP zu Ayakaleaf Pro migrieren können. In den meisten Fällen bieten Overleaf CEP und Ayakaleaf Pro weitgehend gleichwertige Funktionen und sind ab Version 6.2.0 datenkompatibel. Die beiden Projekte können Funktionen zu unterschiedlichen Zeitpunkten veröffentlichen; beispielsweise übernehmen wir per Cherry-Pick eine Funktion aus Overleaf CEP und umgekehrt. Auch wenn sich unsere Implementierungen derselben Funktion leicht unterscheiden können, gibt es in der Regel keinen zwingenden Grund für eine Migration.

Wenn Sie dennoch zu Ayakaleaf Pro migrieren oder es ausprobieren möchten, lesen Sie bitte: #case-01-from-overleaf-toolkit. Der Migrationsprozess ist derselbe.

---

​

Migration von Overleaf SaaS

Leider kann die Migration von der Overleaf-SaaS-Plattform zu einer selbst gehosteten Ayakaleaf Pro-Instanz deutlich schwieriger sein. Derzeit besteht die einzige allgemein verfügbare Methode darin, jedes Projekt als ZIP-Archiv herunterzuladen und anschließend in Ihre selbst gehostete Ayakaleaf Pro-Instanz hochzuladen. Dabei werden nur die aktuellen Projektdateien übertragen, das heißt, Sie verlieren:

• Den gesamten Projektverlauf und alle früheren Revisionen
• Alle Kommentare und nachverfolgten Änderungen
• Alle Git-Metadaten und den Commit-Verlauf
• Alle GitHub-Synchronisierungsverknüpfungen und -einstellungen
• Alle Verknüpfungen zwischen BibTeX-Dateien und Literaturverwaltungsplattformen von Drittanbietern

---

​

Migration von einem Overleaf-Fork eines Drittanbieters

Ayakaleaf Pro unterstützt möglicherweise keine Funktionen, die spezifisch für einen bestimmten Overleaf-Fork eines Drittanbieters sind. Sobald ein Fork erheblich von der Upstream-Codebasis von Overleaf abweicht – oder Änderungen ohne Wahrung der Upstream-Kompatibilität einführt –, kann das Zusammenführen späterer Overleaf-Releases äußerst schwierig werden. Sie können die oben beschriebene Migrationsmethode dennoch ausprobieren, die Kompatibilität ist jedoch nicht garantiert, und wir können bei Migrationen von nicht unterstützten Forks möglicherweise keine Hilfe oder technische Unterstützung leisten.