> For the complete documentation index, see [llms.txt](https://docs.chamilo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chamilo.org/2.x/ar/dlyl-alidarh/admin-guide/installation/installation-wizard.md).

# معالج التثبيت

يحتوي Chamilo 2.0 على معالج تثبيت قائم على الويب يرشدك خلال الإعداد الأولي. يعمل المعالج تلقائيًا عند الوصول إلى المنصة للمرة الأولى.

## قبل البدء

تأكد من تحقق المتطلبات التمهيدية التالية:

1. يلبي خادمك جميع [متطلبات الخادم](/2.x/ar/dlyl-alidarh/admin-guide/installation/server-requirements.md).
2. قمت بتحميل نسخة معبأة (zip أو tar.gz) من Chamilo.
3. تم تهيئة خادم الويب الخاص بك لخدمة دليل `public/` كجذر المستندات.
4. يوجد ملف `.env` الخاص بك وهو فارغ (سيرشد المعالج إعداد قاعدة البيانات).

## الخطوة 1: لغة التثبيت

![Installation wizard Step 1 — language selection](https://3326931924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUmEugCMXVYymTgsFt5qa%2Fuploads%2Fgit-blob-3bb63d9477d7c1c7f6f53c60b1e4a05f9f7ff4b3%2Finstall-step1-language.png?alt=media)

تتيح الخطوة الأولى اختيار اللغة لعملية التثبيت. اختر اللغة المفضلة لديك من القائمة المنسدلة.

إذا اكتشف Chamilo تثبيتًا موجودًا (للترقية)، فسيعرض حالة الترحيل ويقدم مسار ترقية بدلاً من تثبيت جديد.

## الخطوة 2: فحص المتطلبات

![Installation wizard Step 2 — requirements check showing PHP version, extensions, and directory permissions](https://3326931924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUmEugCMXVYymTgsFt5qa%2Fuploads%2Fgit-blob-2538f869c74fe5bde35450d30ea2b1482ba8e59e%2Finstall-step2-requirements.png?alt=media)

يفحص المعالج بيئة خادمك:

* **إصدار PHP** هو 8.2 أو أعلى
* **الامتدادات المطلوبة لـ PHP** مثبتة (intl، gd، curl، zip، mbstring، xml، إلخ)
* **إعدادات PHP الموصى بها** — `date.timezone` مُهيأ، حدود تحميل/ذاكرة كافية
* **أذونات الدليل والملف** — `var/`، `config/`، و `public/upload/` قابلة للكتابة بواسطة خادم الويب

إذا لم تتحقق أي من المتطلبات، يعرض المعالج تحذيرات أو أخطاء. قم بحلها قبل المتابعة.

## الخطوة 3: الترخيص

![Installation wizard Step 3 — license acceptance](https://3326931924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUmEugCMXVYymTgsFt5qa%2Fuploads%2Fgit-blob-f094fb2fe7a74f43c4e25f4efb0c63049641b5ff%2Finstall-step3-license.png?alt=media)

تعرض هذه الخطوة رخصة GNU/GPLv3. يجب عليك تحديد خانة الاختيار **"أقبل"** للمتابعة.

اختياريًا، يمكنك توسيع قسم **معلومات الاتصال** لتقديم تفاصيل عن منظمتك (الاسم، البريد الإلكتروني، الشركة، البلد). هذا طوعي ويساعد مجتمع Chamilo على فهم من يستخدم المنصة، لكنه سيسمح لنا أيضًا بالاتصال بك *نادرًا جدًا* بشأن الفعاليات التي تحدث بالقرب منك.

## الخطوة 4: إعدادات قاعدة البيانات

![Installation wizard Step 4 — database connection configuration](https://3326931924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUmEugCMXVYymTgsFt5qa%2Fuploads%2Fgit-blob-2137cbc14608b72e73c11e47e3da98c8129193e9%2Finstall-step4-database.png?alt=media)

أدخل تفاصيل اتصال قاعدة البيانات الخاصة بك:

| الحقل                        | الوصف                                                                        |
| ---------------------------- | ---------------------------------------------------------------------------- |
| **مضيف قاعدة البيانات**      | اسم المضيف أو عنوان IP لخادم قاعدة البيانات (مثل `localhost` أو `127.0.0.1`) |
| **منفذ قاعدة البيانات**      | الافتراضي: 3306 لـ MySQL/MariaDB                                             |
| **اسم قاعدة البيانات**       | اسم قاعدة البيانات المستخدمة (حروف وأرقام ورموز سفلية فقط)                   |
| **مستخدم قاعدة البيانات**    | مستخدم قاعدة بيانات لديه صلاحيات كاملة على قاعدة البيانات المحددة            |
| **كلمة مرور قاعدة البيانات** | كلمة المرور لمستخدم قاعدة البيانات                                           |

انقر على **فحص اتصال قاعدة البيانات** للاختبار. لن يسمح المعالج بالمتابعة حتى ينجح الاتصال. إذا كانت قاعدة البيانات موجودة بالفعل، يُعرض تحذير.

## الخطوة 5: إعدادات التكوين

![Installation wizard Step 5 — administrator account, portal settings, and email configuration](https://3326931924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUmEugCMXVYymTgsFt5qa%2Fuploads%2Fgit-blob-fb38c8506af225df9cd3154cc64d2c3c823c8bc0%2Finstall-step5-config.png?alt=media)

تجمع هذه الخطوة بين إنشاء حساب المسؤول، إعدادات البوابة، وتكوين البريد الإلكتروني.

### حساب المسؤول

| الحقل                 | الوصف                                                      |
| --------------------- | ---------------------------------------------------------- |
| **تسجيل الدخول**      | اسم مستخدم المسؤول                                         |
| **كلمة المرور**       | اختر كلمة مرور قوية — هذا الحساب لديه وصول كامل إلى المنصة |
| **الاسم الأول**       | الاسم الأول للمسؤول                                        |
| **الاسم الأخير**      | الاسم الأخير للمسؤول                                       |
| **البريد الإلكتروني** | يُستخدم لإشعارات النظام وإعادة تعيين كلمة المرور           |
| **الهاتف**            | رقم الاتصال الاختياري                                      |

سيتم استخدام هذه التفاصيل الخاصة بالمسؤول أيضًا من قبل Chamilo لملء تفاصيل الاتصال بالدعم، لذا تأكد من إعادة تهيئتها في الإعدادات بعد انتهاء التثبيت.

### إعدادات البوابة

| الحقل                            | الوصف                                                  |
| -------------------------------- | ------------------------------------------------------ |
| **اللغة**                        | اللغة الافتراضية لواجهة المستخدم                       |
| **اسم البوابة**                  | اسم المنصة الخاصة بك (مثل "نظام إدارة التعلم لمنظمتي") |
| **الاسم المختصر للشركة**         | الاسم المختصر لمنظمتك                                  |
| **رابط الشركة**                  | موقع منظمتك على الويب                                  |
| **طريقة التشفير**                | خوارزمية تشفير كلمات المرور — **bcrypt** موصى به       |
| **السماح بالتسجيل الذاتي**       | نعم / لا / بعد الموافقة                                |
| **السماح بالتسجيل الذاتي كمدرب** | نعم / لا                                               |

### تكوين البريد الإلكتروني

يسمح قسم إعدادات البريد الإلكتروني بتكوين وسيلة نقل البريد (SMTP، Amazon SES، Mailjet، إلخ) واختبار إرسال البريد الإلكتروني. انظر [تكوين البريد الإلكتروني](/2.x/ar/dlyl-alidarh/admin-guide/installation/email-configuration.md) للتفاصيل.

يمكن تغيير جميع هذه الإعدادات لاحقًا من لوحة الإدارة.

***

***

## الخطوة 6: التحقق النهائي قبل التثبيت

![Installation wizard Step 6 — review of all settings before installation](https://3326931924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUmEugCMXVYymTgsFt5qa%2Fuploads%2Fgit-blob-53ef3d6ea7c9ab712af17be93542eeb95fab548a%2Finstall-step6-review.png?alt=media)

تعرض هذه الخطوة ملخصًا لكل ما أدخلته للمراجعة:

* بيانات مصادقة المسؤول (يتم إخفاء كلمة المرور افتراضيًا — انقر على أيقونة العين للكشف عنها)
* إعدادات البوابة
* تفاصيل اتصال قاعدة البيانات

راجع بعناية، ثم انقر على **تثبيت Chamilo** لتنفيذ التثبيت. يقوم المعالج بإنشاء جميع جداول قاعدة البيانات، وملء البيانات الأولية، وتكوين المنصة.

## الخطوة 7: اكتمل التثبيت

![Installation wizard Step 7 — completion with security advice and portal link](https://3326931924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUmEugCMXVYymTgsFt5qa%2Fuploads%2Fgit-blob-6905f8077e5f60547b2147a6a44de47122a8350a%2Finstall-step7-complete.png?alt=media)

بعد اكتمال التثبيت بنجاح، يعرض المعالج:

* **نصائح البدء** — يقترح إنشاء مساقك الأول لاستكشاف المنصة (كمسؤول، يجب عليك القيام بذلك من لوحة الإدارة)
* **توصيات الأمان**:
  * اجعل دليل `config/` للقراءة فقط (`chmod 0555`)
  * احذف دليل `public/main/install/`
* **رابط إلى بوابتك** لتسجيل الدخول ببيانات مصادقة المسؤول التي أنشأتها للتو

## ما بعد التثبيت

بعد إكمال المعالج:

* **إزالة أو تقييد الوصول إلى برنامج التثبيت** -- يجب ألا يكون المعالج متاحًا بعد التثبيت. يقوم Chamilo عادةً بقفله تلقائيًا، لكن تحقق من أن إعادة زيارة عنوان URL للتثبيت يعيد التوجيه إلى صفحة تسجيل الدخول.
* **تكوين إرسال البريد الإلكتروني** -- انظر [تكوين البريد الإلكتروني](/2.x/ar/dlyl-alidarh/admin-guide/installation/email-configuration.md).
* **إعداد النسخ الاحتياطي** -- قبل إضافة المحتوى، قم بتكوين نسخ احتياطي تلقائي لقاعدة البيانات والملفات (لا يوفر Chamilo حلاً لهذا، لكن نسخ مجلد var/ وقاعدة البيانات هما العنصران الأهم).
* **مراجعة إعدادات الأمان** -- انظر [إعدادات الأمان](/2.x/ar/dlyl-alidarh/admin-guide/platform-settings/security-settings.md).

## استكشاف الأخطاء وحل المشكلات

| المشكلة                         | الحل                                                                                                                         |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| صفحة فارغة في عنوان URL للتثبيت | تحقق من سجلات أخطاء PHP. غيّر إلى `APP_ENV=dev` في .env مؤقتًا لرؤية الأخطاء في المتصفح.                                     |
| فشل اتصال قاعدة البيانات        | تحقق من بيانات المصادقة، وتأكد من وجود قاعدة البيانات، وتحقق من أن خادم قاعدة البيانات يسمح بالاتصالات من مضيف الخادم الويب. |
| أخطاء رفض الصلاحية              | تأكد من أن `var/` قابل للكتابة بواسطة مستخدم الخادم الويب.                                                                   |
| عدم تحميل الموارد (لا CSS/JS)   | قم بتشغيل `yarn install && yarn build` لتجميع موارد الواجهة الأمامية.                                                        |