Przejdź do głównej treści
Ayakaleaf Pro to bezpośredni zamiennik (drop-in replacement) oficjalnej wersji Overleaf Community Edition, dostarczany jako obraz Dockera.

Wybierz ścieżkę instalacji

Instalacja w systemie Linux

Docker Compose w systemie Linux (z Dockerem)

Instalacja w systemie Windows

Docker Compose w systemie Windows (z WSL)

Instalacja na Macu

Docker Compose w systemie macOS (Docker Desktop)

Uruchomienie w klastrze Kubernetes

Kubernetes (eksperymentalnie)

Uruchomienie na bardzo małym serwerze

Tylko dla małych serwerów (wymaga 2 GB swapu)

Instalacja przez Claude lub Codex

Z użyciem Claude lub Codex

Szybki test w przeglądarce

GitHub Codespace (minimalny TeX Live)

Migracja istniejącego Overleaf

Migracja z istniejącej instancji Overleaf

Instalacja bez dostępu do internetu

Wdrożenia odizolowane/offline do użytku wewnętrznego
Przechodzisz z oficjalnego Overleaf Server Pro? (Jaka jest różnica?) Przed migracją otwórz zgłoszenie (issue): szablony są przechowywane w inny sposób, a my bezpłatnie Ci pomożemy.
Chcesz wrócić do oficjalnej wersji Overleaf Community Edition? Ustaw SERVER_PRO=false (toolkit ayaka-notes) lub usuń plik z nadpisaniami (override) (oficjalny Toolkit). Żadne dane nie zostaną utracone.

Wymagania sprzętowe

Przeprowadziliśmy odpowiednie testy i stwierdziliśmy, że przy uruchomieniu Overleaf na serwerze z 2 rdzeniami i 2 GB RAM jego główne komponenty — oparte przede wszystkim na Node.js — zużywają około 1 GB pamięci. Redis i MongoDB mogą wymagać dodatkowych 0,5 GB, a uruchomienie izolowanego kontenera Dockera do kompilacji może zużyć kolejne 0,3 GB. Oznacza to, że serwer z 2 rdzeniami i 2 GB RAM jest w stanie realnie obsłużyć tylko około jednej kompilacji jednocześnie.
  • Minimalne wymagania sprzętowe do instalacji Ayakaleaf Pro to 2-rdzeniowy procesor i 3 GB RAM.
  • Ze względu na rozmiar naszego obrazu TeX Live do włączenia izolowanej kompilacji (sandboxed compilation) wymagane jest co najmniej 40 GB przestrzeni dyskowej.
  • Jeśli chcesz zainstalować pełny zestaw obrazów TeX Live z lat 2020–2026, upewnij się, że masz co najmniej 150 GB wolnego miejsca na dysku.
Oto kilka zalecanych konfiguracji sprzętowych dla różnych scenariuszy użycia:

Wymagania programowe

Jeśli chodzi o wymagania programowe, zalecamy korzystanie z aktualnej i stabilnej wersji Ubuntu (np. Ubuntu 24.04 w latach 2025–2026, Ubuntu 22.04 w latach 2023–2024) wraz z najnowszą stabilną wersją Dockera.
Ubuntu 26.04 jest dostarczane z jądrem Linux 7.0, a MongoDB nie uruchamia się na jądrach Linux od 6.19 do 7.0.13 (szczegóły). Aby uruchomić je na tych jądrach, dodaj poniższe ustawienie do usługi mongo w pliku overleaf-toolkit/config/docker-compose.override.yml (tym samym, w którym ustawiany jest obraz Ayakaleaf Pro). Nasze CI działa na Ubuntu 26.04 z tym ustawieniem. Jądra 7.0.14 i nowsze go nie wymagają.
docker-compose.override.yml
Dla serwerów współdzielonych i produkcyjnych zalecamy system Linux. Ayakaleaf Pro możesz też uruchomić w macOS lub w Windows z WSL 2 za pomocą Docker Desktop. Postępuj zgodnie z przewodnikiem dla swojej platformy. Obrazy obsługują zarówno AMD64, jak i ARM64.

Wydajność LaTeX

LaTeX jest programem jednowątkowym, co oznacza, że w danym momencie może wykorzystywać tylko jeden rdzeń procesora. Podczas kompilacji pojedynczego dokumentu wydajność jest ograniczona głównie przez taktowanie pojedynczego rdzenia procesora. Zatem im wyższa wydajność jednordzeniowa procesora, tym szybciej skompilujesz dokument. Większa liczba rdzeni przynosi korzyści tylko wtedy, gdy wielu użytkowników kompiluje dokumenty jednocześnie. Na przykładzie szablonu ThuThesis czas kompilacji wynosi około 6 sekund na procesorze Intel Core i9-14900K (5,6 GHz), podczas gdy na instancji Azure Standard D2as v5 (2 vCPU, 8 GiB RAM) z procesorem AMD EPYC 7763 (3,2 GHz) trwa około 13 sekund. Oczywiście rzeczywista wydajność kompilacji zależy od konfiguracji sprzętowej. Większość procesorów serwerowych nie pracuje z tak wysokim taktowaniem jak 14900K, więc konieczne będzie znalezienie kompromisu między kosztem a szybkością kompilacji. Przeprowadziliśmy również szczegółową analizę wydajności kompilacji LaTeX. Jeśli jesteś zainteresowany, zapoznaj się z naszym wpisem na blogu Overleaf Benchmark: A Deep Research of Concurrent LaTeX Compilation in Overleaf (SaaS and Self-host).
Ostatnia modyfikacja 21 listopada 2026