> 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/ar/altthbyt/introduction.md).

# مقدمة

مثل Overleaf Server Pro، يأتي Ayakaleaf Pro الخاص بنا كحاوية Docker ويُعد بديلاً مباشرًا، كما يتضمن أيضًا ميزات مثل تسجيل الدخول الموحد (SSO) عبر LDAP وSAML2، وتحسينات أمنية، وتتبع التغييرات، والتعليقات، وإصدارنا المحسن من TeX Live، والقوالب، ولوحة الإدارة.

* إذا لم تقم من قبل بنشر أي إصدار من Overleaf، فيرجى الرجوع إلى [إعداد Docker](/on-premises/ar/altthbyt/setup-docker.md) لتثبيت Docker Engine أولًا، ثم تثبيت Overleaf [باستخدام Toolkit](/on-premises/ar/altthbyt/using-the-toolkit.md).
* إذا كنت قد نشرت بالفعل إصدار Community Edition من Overleaf، فيرجى الرجوع إلى [الترحيل من نظام قائم](/on-premises/ar/altthbyt/altrhyl-mn-nzam-qaem.md) لترحيل إلى Ayakaleaf-Pro.
* إذا كنت مستخدمًا حاليًا لـ Server Pro، فيرجى فتح تذكرة إعلامنا بذلك قبل الترقية إلى AyakaLeaf Pro، لأن بيانات القوالب تُخزَّن بتنسيق مختلف قليلًا.
* أحيانًا، إذا مللت من AyakaLeaf Pro وترغب في العودة إلى الإصدار الرسمي Overleaf Community Edition، فهذا مدعوم بالكامل. لن تُفقد أيٌّ من بياناتك. بالنسبة لمستخدمي Overleaf Toolkit الرسمي، ما عليك سوى إزالة ملف YAML الخاص بالتجاوز. أما مستخدمو أداة ayaka-notes toolkit، فقم بتعطيل `SERVER_PRO` الخيار. عندها سيعود كل شيء إلى Community Edition القياسي.

### متطلبات الأجهزة

* الحد الأدنى من متطلبات الأجهزة لتثبيت AyakaLeaf Pro هو معالج ثنائي النواة و3 جيجابايت من ذاكرة RAM.
* نظرًا لحجم صورة TeX Live الخاصة بنا، يلزم توفير مساحة تخزين لا تقل عن 40 جيجابايت لتمكين التحويل البرمجي داخل بيئة معزولة.
* إذا كنت ترغب في تثبيت المجموعة الكاملة من صور TeX Live من 2020 حتى 2026، فيرجى التأكد من توفر مساحة خالية على القرص لا تقل عن 150 جيجابايت.

فيما يلي بعض التكوينات الموصى بها للأجهزة لسيناريوهات الاستخدام المختلفة:

| حالة الاستخدام                                | التكوين الموصى به                                                  |
| --------------------------------------------- | ------------------------------------------------------------------ |
| الاستخدام الشخصي، مع تعاون عرضي               | نواتا CPU، 4 جيجابايت RAM                                          |
| فرق صغيرة، حتى 10 مستخدمين مع تعاون خفيف      | نواتا 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 جيجاهرتز)، بينما يستغرق حوالي 13 ثانية على مثيل Azure Standard D2as v5 ‏(2 vCPU، 8 GiB RAM) يعمل بمعالج AMD EPYC 7763 ‏(3.2 جيجاهرتز).

بالطبع، يعتمد أداء التجميع الفعلي على تكوين أجهزتك. لا تعمل معظم معالجات الخوادم بهذه السرعات العالية مثل 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/ar/altthbyt/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.