Zum Hauptinhalt springen
Ayakaleaf Pro läuft einschließlich Git-Integration auf einem Server mit 2 CPU-Kernen und 2 GB Arbeitsspeicher, sobald Sie 2 GB Swap hinzufügen. Ohne Swap geht ihm beim Start der Speicher aus. Die Einstellungen in Schritt 2 halbieren dann fast die Swap-Nutzung.
Wir haben dies mit Ayakaleaf Pro 6.3.1 und dem Toolkit gemessen, in einer QEMU/KVM-VM mit 2 vCPU / 2 GiB unter Ubuntu 24.04, mit Sandbox-Kompilierung (texlive-basic:2025.1) und aktivierter Git-Integration.

Warum 2 GB standardmäßig nicht ausreichen

Im Leerlauf benötigt Ayakaleaf Pro mit den Standardeinstellungen etwa 1,9 GiB. Ubuntu und Docker belegen auf einer Maschine mit 2 GiB bereits 364 MiB, sodass etwa 1600 MiB übrig bleiben.

  1. 2 GB Swap hinzufügen

Dies ist der wichtigste Schritt.

  1. Speichernutzung senken

Fügen Sie diese Zeilen zu config/variables.env hinzu. Der Container der Git-Integration liest diese Datei ebenfalls.
variables.env
Um den MongoDB-Cache zu begrenzen, fügen Sie in config/docker-compose.override.yml (derselben Datei, in der das Ayakaleaf-Pro-Image festgelegt wird) unter services einen Eintrag mongo hinzu:
docker-compose.override.yml
Führen Sie anschließend bin/up -d aus.
NODE_OPTIONS ersetzt den im Image gesetzten Wert, daher muss die Zeile --require /overleaf/.pnp.cjs --import /overleaf/.pnp.register.mjs beibehalten. Ohne diese Optionen können die Node.js-Dienste ihre Pakete nicht laden und starten nicht. --optimize-for-size kann nicht verwendet werden: Node.js lehnt diese Option in NODE_OPTIONS ab.--replSet overleaf übergibt das Toolkit standardmäßig an MongoDB. Behalten Sie es bei.
Mit einem Heap von 160 MiB kann beim Klonen oder Pushen eines großen Projekts über Git der Speicher ausgehen, und der Container der Git-Integration startet neu. Das haben wir nicht getestet. Falls es passiert, erhöhen Sie -Xmx.

Ergebnisse

Jeder Test kompilierte ein 33-seitiges LuaLaTeX-Dokument mit fontspec und 30 TikZ-Abbildungen; gleichzeitige Kompilierungen betrafen unterschiedliche Projekte. Ohne Swap zieht ein Abbruch wegen Speichermangels den nächsten nach sich: web startet neu, sein Start braucht wieder Speicher, und der Server hängt bis zu einem harten Reset. Mit Swap dauern drei gleichzeitige Kompilierungen etwa so lange wie eine, denn ausgelagert werden ungenutzte Node.js-Speicherseiten. Nicht getestet: Last durch Git-Clone und -Push, viele gleichzeitig bearbeitende Benutzer und Swap auf langsamen Datenträgern (unser Host verwendete eine SSD).

Kubernetes

Unsere Kubernetes-Anleitung deaktiviert Swap auf den Knoten (Knoten vorbereiten), daher gilt dort nur Schritt 2. Legen Sie NODE_OPTIONS und MALLOC_ARENA_MAX in der ConfigMap overleaf-env ab (Ihre Instanz personalisieren). Der MongoDB-Cache ist bereits in MongoDB und Redis bereitstellen festgelegt.
Zuletzt geändert am 21. November 2026