Naar hoofdinhoud gaan
Ayakaleaf Pro draait op een server met 2 CPU-cores en 2 GB geheugen, inclusief Git-integratie, zodra je 2 GB swap toevoegt. Zonder swap raakt het geheugen op tijdens het opstarten. De instellingen in stap 2 halveren daarna bijna het swapgebruik.
We hebben dit gemeten met Ayakaleaf Pro 6.3.1 en de Toolkit, in een QEMU/KVM-VM met 2 vCPU / 2 GiB onder Ubuntu 24.04, met sandboxed compiles (texlive-basic:2025.1) en Git-integratie ingeschakeld.

Waarom 2 GB standaard niet genoeg is

In rust heeft Ayakaleaf Pro met de standaardinstellingen ongeveer 1,9 GiB nodig. Ubuntu en Docker gebruiken al 364 MiB van een machine met 2 GiB, waardoor er ongeveer 1600 MiB overblijft.

  1. Voeg 2 GB swap toe

Dit is de belangrijkste stap.

  1. Verlaag het geheugengebruik

Voeg deze regels toe aan config/variables.env. De container van de Git-integratie leest dit bestand ook.
variables.env
Om de MongoDB-cache te begrenzen, voeg je een mongo-item toe onder services in config/docker-compose.override.yml (hetzelfde bestand dat de Ayakaleaf Pro-image instelt):
docker-compose.override.yml
Voer daarna bin/up -d uit.
NODE_OPTIONS vervangt de waarde die in de image is ingesteld, dus de regel moet --require /overleaf/.pnp.cjs --import /overleaf/.pnp.register.mjs behouden. Zonder deze opties kunnen de Node.js-services hun pakketten niet laden en starten ze niet. --optimize-for-size kan niet worden gebruikt: Node.js weigert het in NODE_OPTIONS.--replSet overleaf is wat de Toolkit standaard aan MongoDB doorgeeft. Laat het staan.
Met een heap van 160 MiB kan het klonen of pushen van een groot project via Git het geheugen uitputten, waarna de container van de Git-integratie herstart. We hebben dit niet getest. Als het gebeurt, verhoog dan -Xmx.

Resultaten

Elke test compileerde een LuaLaTeX-document van 33 pagina’s met fontspec en 30 TikZ-figuren; gelijktijdige compiles waren verschillende projecten. Zonder swap leidt de ene beëindiging wegens geheugentekort tot de volgende: web herstart, het opstarten heeft opnieuw geheugen nodig en de server blijft hangen tot een harde reset. Met swap duren drie gelijktijdige compiles ongeveer even lang als één, omdat wat naar swap gaat inactieve Node.js-pagina’s zijn. Niet getest: belasting door Git-clone en -push, veel gebruikers die tegelijk bewerken en swap op trage schijven (onze host gebruikte een SSD).

Kubernetes

Onze Kubernetes-handleiding schakelt swap op de nodes uit (De nodes voorbereiden), dus daar geldt alleen stap 2. Zet NODE_OPTIONS en MALLOC_ARENA_MAX in de ConfigMap overleaf-env (Je instantie personaliseren). De MongoDB-cache is al ingesteld in MongoDB en Redis deployen.
Laatst gewijzigd op 21 november 2026