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

# مقدمة

> انشر Ayakaleaf Pro مع إرشادات حول الترحيل والمتطلبات وأداء LaTeX.

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

* إذا كنت تريد فقط اختبار ميزات Ayakaleaf Pro أو تجربة العرض التوضيحي، فيمكنك اتباع دليل [using-the-github-codespace.md](/ar/on-premises/installation/using-the-github-codespace "mention"). تستخدم بيئة العرض التوضيحي تثبيتًا مصغّرًا من TeX Live، لذا قد لا تُترجم بعض مشاريعك بنجاح.
* إذا لم يسبق لك نشر أي إصدار من Overleaf، فيُرجى الرجوع إلى [إعداد Docker](/ar/on-premises/installation/setup-docker) لتثبيت Docker Engine أولًا، ثم تثبيت Overleaf [using-the-toolkit](/ar/on-premises/installation/using-the-toolkit "mention").
* إذا كنت قد نشرت بالفعل Community Edition من Overleaf، فيُرجى الرجوع إلى [migrate-from-existing.md](/ar/on-premises/installation/migrate-from-existing "mention") للترحيل إلى Ayakaleaf Pro.
* إذا كنت تفضّل استخدام وكلاء مثل Claude أو Codex، فيمكنك الرجوع إلى: [using-claude-or-codex.md](/ar/on-premises/installation/using-claude-or-codex "mention").
* إذا كنت بحاجة إلى النشر في بيئة غير متصلة بالإنترنت أو معزولة، فيُرجى الرجوع إلى: [air-gapped-offline-deployments.md](/ar/on-premises/installation/air-gapped-offline-deployments "mention").
* إذا كنت مستخدمًا حاليًا لـ Server Pro، فيُرجى فتح issue لإعلامنا قبل الترحيل إلى Ayakaleaf Pro، لأن بيانات القوالب مخزّنة بتنسيق مختلف قليلًا. ويسعدنا جدًا مساعدتك في الترحيل من Server Pro إلى Ayakaleaf Pro مجانًا.
* إذا سئمت يومًا من Ayakaleaf Pro وأردت العودة إلى Overleaf Community Edition الرسمي، فهذا مدعوم بالكامل، ولن تفقد أيًا من بياناتك. بالنسبة لمستخدمي Overleaf Toolkit الرسمي، ما عليك سوى إزالة ملف YAML الخاص بالتجاوز (override). أما مستخدمو ayaka-notes toolkit، فعليهم تعطيل الخيار `SERVER_PRO`. وسيعود كل شيء بعد ذلك إلى Community Edition القياسي.

يُرجى اختيار طريقة التثبيت وفقًا لاحتياجاتك:

<Card title="استخدام GitHub Codespace" icon="file-lines" href="/ar/on-premises/installation/using-the-github-codespace" horizontal />

<Card title="استخدام Toolkit" icon="file-lines" href="/ar/on-premises/installation/using-the-toolkit" horizontal />

<Card title="استخدام Claude أو Codex" icon="file-lines" href="/ar/on-premises/installation/using-claude-or-codex" horizontal />

<Card title="عمليات النشر المعزولة/دون اتصال" icon="file-lines" href="/ar/on-premises/installation/air-gapped-offline-deployments" horizontal />

<Card title="الترحيل من تثبيت قائم" icon="file-lines" href="/ar/on-premises/installation/migrate-from-existing" horizontal />

### متطلبات العتاد

أجرينا اختبارات ذات صلة ووجدنا أنه إذا شغّلت Overleaf على خادم بنواتين وذاكرة RAM بسعة 2 GB، فإن مكوناته الأساسية — المعتمدة أساسًا على Node.js — ستستهلك نحو 1 GB من الذاكرة. وقد يحتاج Redis و MongoDB إلى 0.5 GB إضافية، بينما قد يستهلك تشغيل حاوية Docker معزولة للترجمة 0.3 GB أخرى. وهذا يعني أن خادمًا بنواتين و 2 GB لا يمكنه عمليًا التعامل إلا مع عملية ترجمة متزامنة واحدة تقريبًا في كل مرة.

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

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

| حالة الاستخدام | الإعداد الموصى به |
| - | - |
| الاستخدام الشخصي، مع تعاون عرضي | نواتا CPU، و 4 GB RAM، و 80 GB تخزين |
| الفرق الصغيرة، حتى 10 مستخدمين مع تعاون خفيف | نواتا CPU، و 8 GB RAM، و 256 GB تخزين |
| الفرق متوسطة الحجم، حتى 100 مستخدم | 4 أنوية CPU، و 16 GB RAM، و 1 TB تخزين |
| عمليات النشر واسعة النطاق أو الجامعية | نشر على عنقود موزّع مع تخزين S3؛ يُرجى التواصل معنا إذا كنت بحاجة إلى مساعدة في النشر |

### متطلبات البرمجيات

بالنسبة لمتطلبات البرمجيات، نوصي باستخدام إصدار حديث ومستقر من Ubuntu (مثل Ubuntu 24.04 في 2025–2026، و Ubuntu 22.04 في 2023–2024) مع أحدث إصدار مستقر من Docker.

<Info>
  الاستقرار أولًا: اختر أحدث إصدار Ubuntu LTS مضى على صدوره بعض الوقت، وليس إصدارًا صدر للتو. على سبيل المثال، اعتبارًا من أكتوبر 2026، لا يُدعم Ubuntu 26.04: فهو يأتي مع نواة Linux 7.0، ويرفض MongoDB البدء على أنوية Linux من 6.19 حتى 7.0.13 ([التفاصيل](https://www.mongodb.com/docs/manual/administration/production-notes/))، لذا يُرجى استخدام Ubuntu 24.04.
</Info>

لا نوصي بنشر Ayakaleaf Pro على Windows أو على أنظمة تشغيل أخرى غير مدعومة مثل CentOS، إذ قد تواجه مشكلات توافق أو مشكلات غير متوقعة أثناء التثبيت والتشغيل.

لكن إذا رغبت في تجربة نشر Ayakaleaf Pro على أنظمة قائمة على ARM أو على macOS، فنرحب بمشاركتك تجربتك وملاحظاتك مع المجتمع.

### أداء LaTeX

LaTeX برنامج أحادي الخيط، أي أنه لا يستطيع استخدام أكثر من نواة معالج واحدة في كل مرة. وعند ترجمة مستند واحد، يكون الأداء محدودًا بشكل أساسي بسرعة تردد النواة الواحدة في المعالج. لذلك كلما كان أداء النواة الواحدة في معالجك أسرع، تمكنت من ترجمة المستند بشكل أسرع. ولا تكون أنوية المعالج الإضافية مفيدة إلا عندما يترجم عدة مستخدمين مستندات في الوقت نفسه.

باستخدام [قالب ThuThesis](https://www.overleaf.com/latex/templates/thuthesis-tsinghua-university-thesis-latex-template/cfwgcxtvkbsx) كمثال، يبلغ وقت الترجمة نحو 6 ثوانٍ على معالج Intel Core i9-14900K (5.6 GHz)، بينما يستغرق نحو 13 ثانية على نسخة Azure Standard D2as v5 (2 vCPUs، و 8 GiB RAM) العاملة بمعالج AMD EPYC 7763 (3.2 GHz).

بالطبع، يعتمد أداء الترجمة الفعلي على إعدادات العتاد لديك. فمعظم معالجات الخوادم لا تعمل بترددات عالية مثل 14900K، لذا ستحتاج إلى الموازنة بين التكلفة وسرعة الترجمة.

في الوقت نفسه، أجرينا أيضًا تحليلًا معمقًا لأداء ترجمة LaTeX. إذا كنت مهتمًا، فيُرجى الرجوع إلى مدونتنا [Overleaf Benchmark: A Deep Research of Concurrent LaTeX Compilation in Overleaf (SaaS and Self-host)](/ar/blog/2026/overleaf-benchmark "mention").


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