دليل التثبيت لـ ERPNext الإصدار 15 على Ubuntu 24.04

دليل التثبيت لـ ERPNext الإصدار 15 على Ubuntu 24.04 مع تطبيق جميع التعديلات والتحسينات الموصى بها، وتقديمها كـ خطوات تنفيذ مباشرة وواضحة.

هذا الدليل يضمن تثبيتاً مستقراً ومتوافقاً مع أفضل الممارسات البرمجية.

🛠️ دليل التثبيت المحدث: ERPNext 15 على Ubuntu 24.04

هذه الخطوات يجب تنفيذها بواسطة مستخدم غير Root لديه صلاحيات sudo.

I. الإعدادات الأولية للمتطلبات الأساسية

1. تحديث النظام وإنشاء المستخدم

ابدأ بتحديث حزم نظام التشغيل وإنشاء مستخدم خاص بـ Frappe Bench للأمان.

Bash
# تحديث الحزم
sudo apt update -y 
sudo apt upgrade -y

# إنشاء مستخدم "frappe" (استبدل frappe باسم مستخدم من اختيارك إذا أردت)
sudo adduser frappe
sudo usermod -aG sudo frappe

# التبديل إلى المستخدم الجديد
su frappe
cd /home/frappe 

ملاحظة: الآن، جميع الأوامر اللاحقة (ما لم يذكر sudo) يتم تنفيذها بواسطة المستخدم frappe.

2. تثبيت الحزم الأساسية والبرمجيات المساعدة

هذه الحزم ضرورية لتشغيل Frappe:

Bash
# تثبيت Git، Python Dependencies، Redis، و wkhtmltopdf
sudo apt install -y git python3-dev python3-setuptools python3-pip python3-venv redis-server curl
# تثبيت wkhtmltopdf (لتوليد PDF)
sudo apt install -y xvfb libfontconfig wkhtmltopdf

II. تثبيت قواعد البيانات Node.js و Yarn

3. تثبيت MariaDB وتكوينه

سنقوم بتثبيت MariaDB وضبط الإعدادات لدعم اللغة العربية (utf8mb4).

Bash
# تثبيت MariaDB
sudo apt install -y mariadb-server

# تأمين قاعدة البيانات (اتبع التعليمات)
sudo mysql_secure_installation

# تعديل التكوين لدعم utf8mb4 (إنشاء ملف تكوين مخصص)
sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf

في ملف 50-server.cnf، أضف الكود التالي تحت قسم [mysqld]:

Ini, TOML
[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

Bash
# إعادة تشغيل MariaDB لتطبيق التغييرات
sudo service mariadb restart

4. تثبيت Node.js (الإصدار 18) و Yarn

نستخدم طريقة NodeSource الموثوقة لضمان تثبيت الإصدار الصحيح (18)، وهو متطلب لـ ERPNext 15.

Bash
# إعداد مستودع NodeSource (الإصدار 18)
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
NODE_MAJOR=18
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list

# تثبيت Node.js
sudo apt update
sudo apt install -y nodejs

# تثبيت Yarn عالمياً عبر NPM
sudo npm install -g yarn

III. تثبيت Frappe Bench و ERPNext 15

5. تثبيت Frappe Bench و Ansible

نستخدم الأعلام الضرورية لتجاوز قيود pip في بيئات Linux الحديثة.

Bash
# تثبيت Frappe Bench و Ansible
sudo -H pip3 install frappe-bench --break-system-packages
sudo -H pip3 install ansible --break-system-packages

# إعطاء المستخدم frappe صلاحية الوصول إلى مجلده
chmod -R o+rx /home/frappe

6. تهيئة Bench وإنشاء الموقع

سنقوم بتهيئة البيئة وجلب ERPNext 15 مباشرة.

Bash
# تهيئة Bench وجلب الفرع 15 من Frappe
bench init frappe-bench --frappe-branch version-15

# الدخول إلى مجلد Bench
cd frappe-bench

# إنشاء موقع جديد (استبدل [site-name] باسم موقعك الفعلي، مثل sdce.com.sa)
bench new-site [site-name]

7. تثبيت التطبيقات الإضافية وتطبيق ERPNext

Bash
# جلب تطبيقات ERPNext (فرع 15) و Payments و HRMS
bench get-app erpnext --branch version-15
bench get-app payments
bench get-app hrms

# تثبيت ERPNext على الموقع
bench --site [site-name] install-app erpnext

# تثبيت التطبيقات الأخرى (Payments و HRMS)
bench --site [site-name] install-app payments
bench --site [site-name] install-app hrms

IV. الانتقال إلى وضع الإنتاج (Production)

لجعل النظام يعمل باستمرار وأمان باستخدام Nginx و Gunicorn:

Bash
# 1. إعداد التكوين للإنتاج (ينشئ ملفات Nginx و Gunicorn)
sudo bench setup production frappe 

# 2. تفعيل المجدول (Scheduler) على الموقع
bench --site [site-name] enable-scheduler

# 3. إعادة تحميل مدير النظام لقراءة ملفات الخدمات الجديدة
sudo systemctl daemon-reload

# 4. بدء تشغيل الخدمات (لضمان عمل Redis و Workers)
sudo systemctl start frappe-bench-web.service
sudo systemctl start frappe-bench-workers.target

# 5. التحديث النهائي وتطبيق الترحيل (Migration)
bench migrate 

التحقق: بعد هذه الخطوات، يمكنك الوصول إلى موقعك باستخدام اسم النطاق أو IP الخادم (لن تحتاج إلى استخدام المنفذ 8000).