Giriş

Taşıma, gereksinimler ve LaTeX performansına ilişkin rehberlik eşliğinde Ayakaleaf Pro’yu dağıtın.

Overleaf Server Pro gibi Ayakaleaf Pro’muz da bir Docker konteyneri olarak gelir ve doğrudan yerine geçebilen (drop-in) bir alternatiftir; ek olarak LDAP ve SAML2 üzerinden sağlanan SSO, gelişmiş güvenlik, değişiklik takibi, yorumlar, optimize edilmiş TeX Live sürümümüz, şablonlar ve yönetim paneli gibi özellikler içerir.

• Yalnızca Ayakaleaf Pro’nun özelliklerini test etmek veya demoyu denemek istiyorsanız using-the-github-codespace.md eğitimimizi izleyebilirsiniz. Demo ortamı minimal bir TeX Live kurulumu kullanır; bu nedenle bazı projeleriniz başarıyla derlenmeyebilir.
• Daha önce Overleaf’in herhangi bir sürümünü hiç dağıtmadıysanız, önce Docker Engine’i kurmak için lütfen Docker Kurulumu sayfasına bakın, ardından Overleaf’i using-the-toolkit ile kurun.
• Overleaf’in Community Edition sürümünü zaten dağıttıysanız, Ayakaleaf Pro’ya geçiş için lütfen migrate-from-existing.md sayfasına bakın.
• Claude veya Codex gibi ajanları kullanmayı tercih ediyorsanız şu sayfaya başvurabilirsiniz: using-claude-or-codex.md.
• Çevrimdışı veya ağdan yalıtılmış (air-gapped) bir ortamda dağıtım yapmanız gerekiyorsa lütfen şu sayfaya bakın: air-gapped-offline-deployments.md.
• Mevcut bir Server Pro kullanıcısıysanız, şablon verileri biraz farklı bir biçimde depolandığından Ayakaleaf Pro’ya geçmeden önce lütfen bir issue açarak bize bildirin. Server Pro’dan Ayakaleaf Pro’ya ücretsiz olarak geçmenize yardımcı olmaktan memnuniyet duyarız.
• Bir gün Ayakaleaf Pro’dan sıkılır ve resmi Overleaf Community Edition’a geri dönmek isterseniz, bu tamamen desteklenir. Hiçbir veriniz kaybolmaz. Resmi Overleaf Toolkit kullanıcıları için override YAML dosyanızı kaldırmanız yeterlidir. ayaka-notes toolkit kullanıcıları için SERVER_PRO seçeneğini devre dışı bırakın. Ardından her şey standart Community Edition’a geri döner.

Lütfen ihtiyaçlarınıza göre bir kurulum yöntemi seçin:

GitHub Codespace Kullanarak

Toolkit Kullanarak

Claude veya Codex Kullanarak

Ağdan yalıtılmış/çevrimdışı dağıtımlar

Mevcut Kurulumdan Taşıma

​

Donanım gereksinimleri

İlgili testleri gerçekleştirdik ve Overleaf’i 2 çekirdekli, 2 GB RAM’li bir sunucuda çalıştırdığınızda, ağırlıklı olarak Node.js tabanlı olan temel bileşenlerinin yaklaşık 1 GB bellek tükettiğini gördük. Redis ve MongoDB ek olarak 0,5 GB gerektirebilirken, derleme için yalıtılmış bir Docker konteyneri başlatmak 0,3 GB daha tüketebilir. Bu, 2 çekirdekli, 2 GB’lık bir sunucunun gerçekçi olarak aynı anda yalnızca yaklaşık bir derlemeyi kaldırabileceği anlamına gelir.

• Ayakaleaf Pro kurulumu için minimum donanım gereksinimleri 2 çekirdekli bir CPU ve 3 GB RAM’dir.
• TeX Live imajımızın boyutu nedeniyle, yalıtılmış derlemeyi etkinleştirmek için en az 40 GB depolama alanı gerekir.
• 2020’den 2026’ya kadar TeX Live imajlarının tamamını kurmak istiyorsanız, lütfen en az 150 GB boş disk alanınız olduğundan emin olun.

Farklı kullanım senaryoları için önerilen bazı donanım yapılandırmaları şunlardır:

Kullanım Senaryosu	Önerilen Yapılandırma
Ara sıra işbirliği içeren kişisel kullanım	2 CPU çekirdeği, 4 GB RAM, 80 GB depolama
Hafif işbirliği yapan, en fazla 10 kullanıcılı küçük ekipler	2 CPU çekirdeği, 8 GB RAM, 256 GB depolama
En fazla 100 kullanıcılı orta ölçekli ekipler	4 CPU çekirdeği, 16 GB RAM, 1 TB depolama
Büyük ölçekli veya üniversite dağıtımları	S3 depolamalı dağıtık küme dağıtımı; dağıtım konusunda yardıma ihtiyacınız varsa lütfen bizimle iletişime geçin

​

Yazılım gereksinimleri

Yazılım gereksinimleri için, Docker’ın en son kararlı sürümüyle birlikte Ubuntu’nun yeni ve kararlı bir sürümünü (ör. 2025–2026’da Ubuntu 24.04, 2023–2024’te Ubuntu 22.04) kullanmanızı öneririz.

Önce kararlılık gelir: yeni çıkmış olanı değil, bir süredir piyasada olan en yeni Ubuntu LTS sürümünü seçin. Örneğin, Ekim 2026 itibarıyla Ubuntu 26.04 desteklenmemektedir: Linux çekirdeği 7.0 ile gelir ve MongoDB, Linux çekirdeği 6.19 ile 7.0.13 arasındaki sürümlerde başlamayı reddeder (ayrıntılar); bu nedenle lütfen Ubuntu 24.04 kullanın.

Kurulum ve çalışma sırasında uyumluluk sorunlarıyla veya beklenmedik problemlerle karşılaşabileceğiniz için Ayakaleaf Pro’yu Windows’ta veya CentOS gibi desteklenmeyen diğer işletim sistemlerinde dağıtmanızı önermiyoruz.

Ancak Ayakaleaf Pro’yu ARM tabanlı sistemlerde veya macOS’ta dağıtmayı denemek isterseniz, deneyimlerinizi ve geri bildirimlerinizi toplulukla paylaşmanızı memnuniyetle karşılarız.

​

LaTeX Performansı

LaTeX tek iş parçacıklı bir programdır; yani aynı anda yalnızca bir CPU çekirdeğini kullanabilir. Tek bir belge derlenirken performans öncelikle CPU’nun tek çekirdek saat hızıyla sınırlıdır. Bu nedenle CPU’nuzun tek çekirdek performansı ne kadar yüksekse, bir belgeyi o kadar hızlı derleyebilirsiniz. Daha fazla CPU çekirdeği yalnızca birden çok kullanıcı aynı anda belge derlerken fayda sağlar.

Örnek olarak ThuThesis şablonu kullanıldığında, derleme süresi Intel Core i9-14900K (5,6 GHz) üzerinde yaklaşık 6 saniye iken, AMD EPYC 7763 (3,2 GHz) ile çalışan bir Azure Standard D2as v5 örneğinde (2 vCPU, 8 GiB RAM) yaklaşık 13 saniye sürer.

Elbette gerçek derleme performansı donanım yapılandırmanıza bağlıdır. Çoğu sunucu CPU’su 14900K kadar yüksek saat hızlarında çalışmaz; bu nedenle maliyet ile derleme hızı arasında bir denge kurmanız gerekir.

Bu arada, LaTeX derleme performansının derinlemesine bir analizini de yaptık. İlgileniyorsanız lütfen blog yazımıza bakın: Overleaf Benchmark: A Deep Research of Concurrent LaTeX Compilation in Overleaf (SaaS and Self-host).