> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/pl/instalacja/introduction.md).

# Wprowadzenie

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

* Jeśli nigdy wcześniej nie wdrażałeś żadnej wersji Overleaf, zapoznaj się z [Konfiguracja Dockera](/on-premises/pl/instalacja/setup-docker.md) aby najpierw zainstalować Docker Engine, a następnie zainstalować Overleaf [za pomocą Toolkit](/on-premises/pl/instalacja/using-the-toolkit.md).
* Jeśli masz już wdrożoną wersję Community Edition Overleaf, zapoznaj się z [Migracja z istniejącej instalacji](/on-premises/pl/instalacja/migracja-z-istniejacej-instalacji.md) aby przejść na Ayakaleaf-Pro.
* Jeśli jesteś obecnym użytkownikiem Server Pro, prosimy o zgłoszenie problemu i poinformowanie nas przed migracją do AyakaLeaf Pro, ponieważ dane szablonów są przechowywane w nieco innym formacie.
* Czasami, jeśli kiedykolwiek znudzi Ci się 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 zostanie utracone. Użytkownicy oficjalnego Overleaf Toolkit powinni po prostu usunąć swój plik YAML override. Użytkownicy narzędzia ayaka-notes powinni wyłączyć `SERVER_PRO` opcji. Wszystko zostanie wtedy przywrócone do standardowej wersji Community Edition.

### Wymagania sprzętowe

* Minimalne wymagania sprzętowe do zainstalowania AyakaLeaf Pro to 2-rdzeniowy procesor CPU i 3 GB pamięci RAM.
* Ze względu na rozmiar naszego obrazu TeX Live wymagane jest co najmniej 40 GB przestrzeni dyskowej, aby umożliwić kompilację w piaskownicy.
* Jeśli chcesz zainstalować pełny zestaw obrazów TeX Live z lat 2020–2026, upewnij się, że masz co najmniej 150 GB dostępnego wolnego miejsca na dysku.

Oto kilka zalecanych konfiguracji sprzętowych dla różnych scenariuszy użycia:

| Przypadek użycia                                    | Zalecana konfiguracja                                                                              |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| Użytek osobisty, z okazjonalną współpracą           | 2 rdzenie CPU, 4 GB RAM                                                                            |
| Małe zespoły, do 10 użytkowników z lekką współpracą | 2 rdzenie CPU, 8 GB RAM                                                                            |
| Średniej wielkości zespoły, do 100 użytkowników     | 4 rdzenie CPU, 16 GB RAM                                                                           |
| Duże wdrożenia lub wdrożenia uniwersyteckie         | Wdrożenie w rozproszonym klastrze; skontaktuj się z nami, jeśli potrzebujesz pomocy przy wdrożeniu |

### Wymagania programowe

Jeśli chodzi o wymagania programowe, zalecamy użycie nowszej wersji Ubuntu wraz z najnowszą stabilną wersją Dockera.

Nie zalecamy wdrażania AyakaLeaf Pro w systemie Windows ani w innych nieobsługiwanych systemach operacyjnych, ponieważ mogą wystąpić problemy z kompatybilnością lub nieoczekiwane trudności podczas instalacji i działania.

### Wydajność LaTeX

LaTeX jest programem jednowątkowym, co oznacza, że może korzystać tylko z jednego rdzenia CPU naraz. CPU jest również głównym ograniczeniem podczas kompilowania pojedynczego dokumentu. Dlatego im wyższa wydajność jednego rdzenia Twojego CPU, tym szybciej będziesz mógł skompilować dokument. Większa liczba rdzeni pomoże tylko wtedy, gdy próbujesz kompilować więcej dokumentów, niż masz wolnych rdzeni CPU.

Korzystając z [szablonu ThuThesis](https://www.overleaf.com/latex/templates/thuthesis-tsinghua-university-thesis-latex-template/cfwgcxtvkbsx) jako przykładu, czas kompilacji wynosi około 6 sekund na 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) zajmuje około 13 sekund.

Oczywiście rzeczywista wydajność kompilacji zależy od Twojej konfiguracji sprzętowej. Większość serwerowych procesorów CPU nie pracuje z tak wysokim taktowaniem jak 14900K, więc będziesz musiał znaleźć kompromis między kosztem a szybkością kompilacji.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/pl/instalacja/introduction.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
