Přejít na hlavní obsah
Ayakaleaf Pro běží na serveru se 2 jádry CPU a 2 GB paměti, včetně integrace s Gitem, jakmile přidáte 2 GB swapu. Bez swapu mu během spouštění dojde paměť. Nastavení z kroku 2 pak sníží využití swapu téměř na polovinu.
Měřili jsme to na Ayakaleaf Pro 6.3.1 s Toolkitem ve virtuálním stroji QEMU/KVM se 2 vCPU / 2 GiB a systémem Ubuntu 24.04, se zapnutou kompilací v sandboxu (texlive-basic:2025.1) a integrací s Gitem.

Proč ve výchozím nastavení 2 GB nestačí

V nečinnosti a s výchozím nastavením potřebuje Ayakaleaf Pro asi 1,9 GiB. Ubuntu a Docker už na stroji se 2 GiB využívají 364 MiB, takže zbývá asi 1600 MiB.

  1. Přidejte 2 GB swapu

Toto je nejdůležitější krok.

  1. Snižte využití paměti

Přidejte tyto řádky do config/variables.env. Kontejner integrace s Gitem čte tento soubor také.
variables.env
Chcete-li omezit mezipaměť MongoDB, přidejte položku mongo do sekce services v souboru config/docker-compose.override.yml (ve stejném souboru, který nastavuje obraz Ayakaleaf Pro):
docker-compose.override.yml
Potom spusťte bin/up -d.
NODE_OPTIONS nahrazuje hodnotu nastavenou v obrazu, proto musí řádek zachovat --require /overleaf/.pnp.cjs --import /overleaf/.pnp.register.mjs. Bez nich služby Node.js nemohou načíst své balíčky a nespustí se. --optimize-for-size použít nelze: Node.js ho v NODE_OPTIONS odmítá.--replSet overleaf předává Toolkit MongoDB ve výchozím nastavení. Ponechte ho.
S haldou 160 MiB může klonování nebo push velkého projektu přes Git vyčerpat paměť a kontejner integrace s Gitem se restartuje. Netestovali jsme to. Pokud se to stane, zvyšte -Xmx.

Výsledky

Každý test kompiloval 33stránkový dokument LuaLaTeX s fontspec a 30 obrázky TikZ; souběžné kompilace se týkaly různých projektů. Bez swapu jedno ukončení kvůli nedostatku paměti vede k dalšímu: web se restartuje, jeho spuštění opět potřebuje paměť a server se zasekne až do tvrdého resetu. Se swapem trvají tři souběžné kompilace zhruba stejně dlouho jako jedna, protože do swapu odcházejí nečinné stránky Node.js. Netestováno: zátěž při klonování a push přes Git, mnoho uživatelů upravujících současně a swap na pomalých discích (náš hostitel používal SSD).

Kubernetes

Náš návod pro Kubernetes na uzlech vypíná swap (Příprava uzlů), takže tam platí jen krok 2. Vložte NODE_OPTIONS a MALLOC_ARENA_MAX do ConfigMap overleaf-env (Přizpůsobení instance). Mezipaměť MongoDB je již nastavena v části Nasazení MongoDB a Redisu.
Naposledy změněno 21. listopadu 2026