> 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/uk/vstanovlennya/introduction.md).

# Вступ

Як і Overleaf Server Pro, наш Ayakaleaf Pro постачається як Docker-контейнер і є прямою заміною, яка додатково включає такі функції, як SSO через LDAP і SAML2, покращену безпеку, відстеження змін, коментарі, нашу оптимізовану версію TeX Live, шаблони та панель адміністрування.

* Якщо ви ніколи раніше не розгортали жодну версію Overleaf, будь ласка, зверніться до [Налаштувати Docker](/on-premises/uk/vstanovlennya/setup-docker.md) щоб спочатку встановити Docker Engine, а потім встановити Overleaf [за допомогою Toolkit](/on-premises/uk/vstanovlennya/using-the-toolkit.md).
* Якщо ви вже розгортали Community Edition Overleaf, будь ласка, зверніться до [Міграція з наявної](/on-premises/uk/vstanovlennya/migraciya-z-nayavnoyi.md) щоб перейти на Ayakaleaf-Pro.
* Якщо ви вже є користувачем Server Pro, будь ласка, створіть issue, щоб повідомити нас перед переходом на AyakaLeaf Pro, оскільки дані шаблонів зберігаються у дещо іншому форматі.
* Іноді, якщо вам коли-небудь набридне наш AyakaLeaf Pro і ви захочете повернутися до офіційної Overleaf Community Edition, це повністю підтримується. Жодні ваші дані не буде втрачено. Для користувачів офіційного Overleaf Toolkit просто видаліть свій YAML-файл перевизначення. Для користувачів toolkit ayaka-notes вимкніть `SERVER_PRO` опцію. Після цього все повернеться до стандартної Community Edition.

### Апаратні вимоги

* Мінімальні апаратні вимоги для встановлення AyakaLeaf Pro — 2-ядерний CPU та 3 ГБ RAM.
* Через розмір нашого образу TeX Live для ввімкнення компіляції в ізольованому середовищі потрібно щонайменше 40 ГБ сховища.
* Якщо ви хочете встановити повний набір образів TeX Live з 2020 по 2026 рік, переконайтеся, що у вас є щонайменше 150 ГБ вільного місця на диску.

Ось кілька рекомендованих апаратних конфігурацій для різних сценаріїв використання:

| Сценарій використання                                     | Рекомендована конфігурація                                                                                   |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| Особисте використання, з епізодичною співпрацею           | 2 ядра CPU, 4 ГБ RAM                                                                                         |
| Невеликі команди, до 10 користувачів із легкою співпрацею | 2 ядра CPU, 8 ГБ RAM                                                                                         |
| Команди середнього розміру, до 100 користувачів           | 4 ядра CPU, 16 ГБ RAM                                                                                        |
| Великомасштабні або університетські розгортання           | Розгортання розподіленого кластера; будь ласка, зв’яжіться з нами, якщо вам потрібна допомога з розгортанням |

### Вимоги до програмного забезпечення

Щодо вимог до програмного забезпечення, ми рекомендуємо використовувати нещодавню версію Ubuntu разом із найновішою стабільною версією Docker.

Ми не рекомендуємо розгортати AyakaLeaf Pro на Windows або інших непідтримуваних операційних системах, оскільки під час встановлення та роботи можуть виникнути проблеми сумісності або несподівані помилки.

### Продуктивність LaTeX

LaTeX — це однопотокова програма, тобто вона може використовувати лише одне ядро CPU за раз. CPU також є головним обмеженням під час компіляції одного документа. Тому чим вища одноядерна продуктивність вашого CPU, тим швидше ви зможете компілювати документ. Більша кількість ядер допоможе лише тоді, коли ви намагаєтеся компілювати більше документів, ніж у вас є вільних ядер CPU.

Використовуючи [шаблон ThuThesis](https://www.overleaf.com/latex/templates/thuthesis-tsinghua-university-thesis-latex-template/cfwgcxtvkbsx) як приклад, час компіляції становить приблизно 6 секунд на Intel Core i9-14900K (5.6 ГГц), тоді як на екземплярі Azure Standard D2as v5 (2 vCPU, 8 GiB RAM) на базі AMD EPYC 7763 (3.2 ГГц) це займає приблизно 13 секунд.

Звісно, фактична продуктивність компіляції залежить від конфігурації вашого обладнання. Більшість серверних CPU не працюють на таких високих частотах, як 14900K, тому вам доведеться знайти компроміс між вартістю та швидкістю компіляції.


---

# 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/uk/vstanovlennya/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.