> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Wprowadzenie

> Wdróż Ayakaleaf Pro, korzystając ze wskazówek dotyczących migracji, wymagań i wydajności LaTeX.

Podobnie jak Overleaf Server Pro, nasz Ayakaleaf Pro jest dostarczany jako kontener Dockera i stanowi bezpośredni zamiennik (drop-in replacement), który dodatkowo zawiera takie funkcje, jak SSO przez LDAP i SAML2, ulepszone zabezpieczenia, śledzenie zmian, komentarze, naszą zoptymalizowaną wersję TeX Live, szablony oraz panel administracyjny.

* Jeśli chcesz tylko przetestować funkcje Ayakaleaf Pro lub wypróbować wersję demonstracyjną, możesz skorzystać z naszego poradnika [using-the-github-codespace.md](/pl/on-premises/installation/using-the-github-codespace "mention"). Środowisko demonstracyjne korzysta z minimalnej instalacji TeX Live, więc niektóre Twoje projekty mogą się nie skompilować.
* Jeśli nigdy wcześniej nie wdrażałeś żadnej wersji Overleaf, najpierw zainstaluj Docker Engine zgodnie z [Konfiguracją Dockera](/pl/on-premises/installation/setup-docker), a następnie zainstaluj Overleaf [using-the-toolkit](/pl/on-premises/installation/using-the-toolkit "mention").
* Jeśli masz już wdrożoną wersję Community Edition Overleaf, zapoznaj się z [migrate-from-existing.md](/pl/on-premises/installation/migrate-from-existing "mention"), aby przeprowadzić migrację do Ayakaleaf Pro.
* Jeśli wolisz korzystać z agentów, takich jak Claude lub Codex, zapoznaj się z: [using-claude-or-codex.md](/pl/on-premises/installation/using-claude-or-codex "mention").
* Jeśli musisz przeprowadzić wdrożenie w środowisku offline lub odizolowanym (air-gapped), zapoznaj się z: [air-gapped-offline-deployments.md](/pl/on-premises/installation/air-gapped-offline-deployments "mention").
* Jeśli jesteś obecnym użytkownikiem Server Pro, przed migracją do Ayakaleaf Pro otwórz zgłoszenie (issue), aby nas o tym poinformować, ponieważ dane szablonów są przechowywane w nieco innym formacie. Chętnie bezpłatnie pomożemy Ci w migracji z Server Pro do Ayakaleaf Pro.
* Jeśli kiedyś zmęczy Cię nasz Ayakaleaf Pro i zechcesz wrócić do oficjalnej wersji Overleaf Community Edition, jest to w pełni obsługiwane. Żadne z Twoich danych nie zostaną utracone. Użytkownicy oficjalnego Overleaf Toolkit muszą po prostu usunąć swój plik YAML z nadpisaniami (override). Użytkownicy toolkitu ayaka-notes muszą wyłączyć opcję `SERVER_PRO`. Wszystko wróci wtedy do standardowej wersji Community Edition.

Wybierz metodę instalacji odpowiednią do swoich potrzeb:

<Card title="Korzystanie z GitHub Codespace" icon="file-lines" href="/pl/on-premises/installation/using-the-github-codespace" horizontal />

<Card title="Korzystanie z Toolkit" icon="file-lines" href="/pl/on-premises/installation/using-the-toolkit" horizontal />

<Card title="Korzystanie z Claude lub Codex" icon="file-lines" href="/pl/on-premises/installation/using-claude-or-codex" horizontal />

<Card title="Wdrożenia w środowiskach odizolowanych/offline" icon="file-lines" href="/pl/on-premises/installation/air-gapped-offline-deployments" horizontal />

<Card title="Migracja z istniejącej instalacji" icon="file-lines" href="/pl/on-premises/installation/migrate-from-existing" horizontal />

### 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:

| Scenariusz użycia | Zalecana konfiguracja |
| - | - |
| Użytek osobisty, z okazjonalną współpracą | 2 rdzenie CPU, 4 GB RAM, 80 GB przestrzeni dyskowej |
| Małe zespoły, do 10 użytkowników przy lekkiej współpracy | 2 rdzenie CPU, 8 GB RAM, 256 GB przestrzeni dyskowej |
| Średnie zespoły, do 100 użytkowników | 4 rdzenie CPU, 16 GB RAM, 1 TB przestrzeni dyskowej |
| Wdrożenia na dużą skalę lub uczelniane | Wdrożenie w rozproszonym klastrze z magazynem S3; skontaktuj się z nami, jeśli potrzebujesz pomocy we wdrożeniu |

### 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.

<Info>
  Stabilność przede wszystkim: wybierz najnowsze wydanie Ubuntu LTS, które jest dostępne już od jakiegoś czasu, a nie takie, które właśnie się ukazało. Na przykład według stanu na październik 2026 r. Ubuntu 26.04 nie jest obsługiwane: 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](https://www.mongodb.com/docs/manual/administration/production-notes/)), dlatego używaj Ubuntu 24.04.
</Info>

Nie zalecamy wdrażania Ayakaleaf Pro w systemie Windows ani w innych nieobsługiwanych systemach operacyjnych, takich jak CentOS, ponieważ podczas instalacji i działania mogą wystąpić problemy ze zgodnością lub nieoczekiwane błędy.

Jeśli jednak chcesz spróbować wdrożyć Ayakaleaf Pro w systemach opartych na architekturze ARM lub w macOS, zachęcamy do dzielenia się swoimi doświadczeniami i opiniami ze społecznością.

### 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](https://www.overleaf.com/latex/templates/thuthesis-tsinghua-university-thesis-latex-template/cfwgcxtvkbsx) 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)](/pl/blog/2026/overleaf-benchmark "mention").


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.