Ana içeriğe atla
Ayakaleaf Pro, resmi Overleaf Community Edition’ın doğrudan yerine geçebilen (drop-in) bir alternatifidir ve bir Docker imajı olarak sunulur.

Kurulum yolunuzu seçin

Linux'a kurun

Linux’ta Docker Compose kullanma (Docker ile)

Windows'a kurun

Windows’ta Docker Compose kullanma (WSL ile)

Mac'e kurun

macOS’ta Docker Compose kullanma (Docker Desktop)

Bir Kubernetes kümesinde çalıştırın

Kubernetes kullanma (deneysel)

Çok küçük bir sunucuda çalıştırın

Yalnızca küçük sunucular için (2 GB swap gerekir)

Kurulumu Claude veya Codex'e bırakın

Claude veya Codex kullanma

Tarayıcıda hızlıca deneyin

GitHub Codespace kullanma (minimal TeX Live)

Mevcut bir Overleaf'i taşıyın

Mevcut bir Overleaf örneğinden geçiş

İnternet erişimi olmadan kurun

Dahili kullanım için yalıtılmış/çevrimdışı dağıtımlar
Resmi Overleaf Server Pro’dan mı geliyorsunuz? (Fark nedir?) Taşımadan önce bir issue açın: şablonlar farklı biçimde depolanır ve size ücretsiz yardımcı oluruz.
Resmi Overleaf Community Edition’a geri mi dönmek istiyorsunuz? SERVER_PRO=false ayarlayın (ayaka-notes Toolkit) veya override dosyasını kaldırın (resmi Toolkit). Hiçbir veri kaybolmaz.

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:

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.
Ubuntu 26.04, 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 çekirdeklerde çalıştırmak için overleaf-toolkit/config/docker-compose.override.yml dosyasındaki (Ayakaleaf Pro imajını ayarlayan dosyanın ta kendisi) mongo hizmetine aşağıdakileri ekleyin. CI’mız bu ayarla Ubuntu 26.04 üzerinde çalışır. Çekirdek 7.0.14 ve sonraki sürümler buna ihtiyaç duymaz.
docker-compose.override.yml
Paylaşılan sunucular ve üretim sunucuları için Linux öneririz. Ayakaleaf Pro’yu Docker Desktop kullanarak macOS veya WSL 2 ile Windows üzerinde de çalıştırabilirsiniz. Platformunuza uygun kılavuzu izleyin. İmajlar hem AMD64 hem de ARM64’ü destekler.

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).
Son değiştirilme tarihi 21 Kasım 2026