Ana içeriğe atla
2 GB swap eklediğinizde Ayakaleaf Pro, Git entegrasyonu dahil olmak üzere 2 CPU çekirdeği ve 2 GB belleğe sahip bir sunucuda çalışır. Swap olmadan başlatılırken belleği tükenir. 2. adımdaki ayarlar ise swap kullanımını neredeyse yarıya indirir.
Bunu Toolkit ile Ayakaleaf Pro 6.3.1 üzerinde, Ubuntu 24.04 çalıştıran 2 vCPU / 2 GiB QEMU/KVM sanal makinesinde, korumalı alan derlemeleri (texlive-basic:2025.1) ve Git entegrasyonu açıkken ölçtük.

Varsayılan olarak 2 GB neden yetmez

Varsayılan ayarlarla boşta çalışırken Ayakaleaf Pro yaklaşık 1,9 GiB’a ihtiyaç duyar. Ubuntu ve Docker, 2 GiB’lık bir makinenin 364 MiB’ını zaten kullanır ve geriye yaklaşık 1600 MiB kalır.

  1. 2 GB swap ekleyin

En önemli adım budur.

  1. Bellek kullanımını azaltın

Bu satırları config/variables.env dosyasına ekleyin. Git entegrasyonu konteyneri de bu dosyayı okur.
variables.env
MongoDB önbelleğini sınırlamak için config/docker-compose.override.yml dosyasında (Ayakaleaf Pro imajını ayarlayan dosya) services altına bir mongo girdisi ekleyin:
docker-compose.override.yml
Ardından bin/up -d komutunu çalıştırın.
NODE_OPTIONS, imajda ayarlanan değerin yerini alır; bu yüzden satırda --require /overleaf/.pnp.cjs --import /overleaf/.pnp.register.mjs korunmalıdır. Bunlar olmadan Node.js hizmetleri paketlerini yükleyemez ve başlamaz. --optimize-for-size kullanılamaz: Node.js bunu NODE_OPTIONS içinde reddeder.--replSet overleaf, Toolkit’in varsayılan olarak MongoDB’ye ilettiği değerdir. Bunu koruyun.
160 MiB’lık bir heap ile büyük bir projeyi Git üzerinden klonlamak veya push etmek belleği tüketebilir ve Git entegrasyonu konteyneri yeniden başlar. Bunu test etmedik. Böyle bir durumda -Xmx değerini artırın.

Sonuçlar

Her test, fontspec ve 30 TikZ şekli içeren 33 sayfalık bir LuaLaTeX belgesini derledi; eşzamanlı derlemeler farklı projelerdi. Swap olmadan bellek yetersizliğinden kaynaklanan bir sonlandırma bir sonrakine yol açar: web yeniden başlar, başlaması yine bellek gerektirir ve sunucu donanımsal bir sıfırlamaya kadar takılı kalır. Swap ile aynı anda üç derleme yaklaşık bir derleme kadar sürer, çünkü swap’e giden şey boştaki Node.js sayfalarıdır. Test edilmeyenler: Git klonlama ve push yükü, aynı anda düzenleme yapan çok sayıda kullanıcı ve yavaş disklerde swap (ana makinemiz SSD kullanıyordu).

Kubernetes

Kubernetes kılavuzumuz düğümlerde swap’i kapatır (Düğümleri hazırlayın), bu nedenle orada yalnızca 2. adım geçerlidir. NODE_OPTIONS ve MALLOC_ARENA_MAX değerlerini overleaf-env ConfigMap’ine koyun (Örneğinizi kişiselleştirme). MongoDB önbelleği MongoDB ve Redis’i dağıtın sayfasında zaten ayarlanmıştır.
Son değiştirilme tarihi 21 Kasım 2026