Zum Hauptinhalt springen
Ayakaleaf Pro ist ein Drop-in-Ersatz für die offizielle Overleaf Community Edition und wird als Docker-Image ausgeliefert.

Wählen Sie Ihren Installationsweg

Unter Linux installieren

Docker Compose unter Linux verwenden (mit Docker)

Unter Windows installieren

Docker Compose unter Windows verwenden (mit WSL)

Auf dem Mac installieren

Docker Compose unter macOS verwenden (Docker Desktop)

Auf einem Kubernetes-Cluster ausführen

Kubernetes verwenden (experimentell)

Auf einem sehr kleinen Server ausführen

Nur für kleine Server (benötigt 2 GB Swap)

Die Installation von Claude oder Codex erledigen lassen

Claude oder Codex verwenden

Schnell im Browser ausprobieren

GitHub Codespace verwenden (minimales TeX Live)

Ein bestehendes Overleaf migrieren

Von einer bestehenden Overleaf-Instanz migrieren

Ohne Internetzugang installieren

Air-Gapped-/Offline-Bereitstellungen für die interne Nutzung
Sie kommen vom offiziellen Overleaf Server Pro? (Was ist der Unterschied?) Eröffnen Sie vor der Migration ein Issue: Vorlagen werden anders gespeichert, und wir helfen Ihnen kostenlos.
Sie möchten zur offiziellen Overleaf Community Edition zurückkehren? Setzen Sie SERVER_PRO=false (ayaka-notes Toolkit) oder entfernen Sie die Override-Datei (offizielles Toolkit). Es gehen keine Daten verloren.

Hardwareanforderungen

Wir haben entsprechende Tests durchgeführt und festgestellt, dass die Kernkomponenten von Overleaf – die hauptsächlich auf Node.js basieren – auf einem Server mit 2 Kernen und 2 GB RAM etwa 1 GB Arbeitsspeicher belegen. Redis und MongoDB benötigen möglicherweise weitere 0,5 GB, und das Starten eines Docker-Containers in einer Sandbox für die Kompilierung kann zusätzliche 0,3 GB beanspruchen. Ein Server mit 2 Kernen und 2 GB kann realistisch betrachtet also nur etwa eine Kompilierung gleichzeitig bewältigen.
  • Die minimalen Hardwareanforderungen für die Installation von Ayakaleaf Pro sind eine CPU mit 2 Kernen und 3 GB RAM.
  • Aufgrund der Größe unseres TeX Live-Images sind mindestens 40 GB Speicherplatz erforderlich, um die Sandbox-Kompilierung zu aktivieren.
  • Wenn Sie den vollständigen Satz an TeX Live-Images von 2020 bis 2026 installieren möchten, stellen Sie sicher, dass mindestens 150 GB freier Speicherplatz verfügbar sind.
Hier einige empfohlene Hardwarekonfigurationen für verschiedene Einsatzszenarien:

Softwareanforderungen

Für die Software empfehlen wir eine aktuelle und stabile Version von Ubuntu (z. B. Ubuntu 24.04 in 2025–2026, Ubuntu 22.04 in 2023–2024) zusammen mit der neuesten stabilen Docker-Version.
Ubuntu 26.04 wird mit dem Linux-Kernel 7.0 ausgeliefert, und MongoDB startet auf den Linux-Kernel-Versionen 6.19 bis 7.0.13 nicht (Details). Um auf diesen Kerneln zu laufen, fügen Sie dem Dienst mongo in overleaf-toolkit/config/docker-compose.override.yml (derselben Datei, in der das Ayakaleaf-Pro-Image festgelegt wird) Folgendes hinzu. Unsere CI läuft mit dieser Einstellung auf Ubuntu 26.04. Ab Kernel 7.0.14 ist sie nicht erforderlich.
docker-compose.override.yml
Für gemeinsam genutzte und produktive Server empfehlen wir Linux. Sie können Ayakaleaf Pro mit Docker Desktop auch unter macOS oder Windows mit WSL 2 ausführen. Folgen Sie der Anleitung für Ihre Plattform. Die Images unterstützen sowohl AMD64 als auch ARM64.

LaTeX-Performance

LaTeX ist ein Single-Thread-Programm, das heißt, es kann jeweils nur einen CPU-Kern nutzen. Beim Kompilieren eines einzelnen Dokuments wird die Leistung in erster Linie durch die Single-Core-Taktfrequenz der CPU begrenzt. Je höher also die Single-Core-Leistung Ihrer CPU, desto schneller können Sie ein Dokument kompilieren. Mehr CPU-Kerne bringen nur dann Vorteile, wenn mehrere Benutzer gleichzeitig Dokumente kompilieren. Am Beispiel der ThuThesis-Vorlage beträgt die Kompilierungszeit auf einem Intel Core i9-14900K (5,6 GHz) etwa 6 Sekunden, während sie auf einer Azure-Instanz vom Typ Standard D2as v5 (2 vCPUs, 8 GiB RAM) mit einem AMD EPYC 7763 (3,2 GHz) etwa 13 Sekunden dauert. Natürlich hängt die tatsächliche Kompilierungsleistung von Ihrer Hardwarekonfiguration ab. Die meisten Server-CPUs laufen nicht mit so hohen Taktfrequenzen wie der 14900K, daher müssen Sie einen Kompromiss zwischen Kosten und Kompilierungsgeschwindigkeit finden. Darüber hinaus haben wir eine ausführliche Analyse der LaTeX-Kompilierungsleistung durchgeführt. Bei Interesse lesen Sie bitte unseren Blogbeitrag Overleaf Benchmark: A Deep Research of Concurrent LaTeX Compilation in Overleaf (SaaS and Self-host).
Zuletzt geändert am 21. November 2026