متطلبات بنية النظام

الخطوة 1: تثبيت الاعتمادات الأساسية

نحتاج للتأكد من وجود أدوات البناء اللازمة لملف mysqlclient وأدوات الـ bench.

sudo dnf install python3.14 pip mariadb11.8 mariadb11.8-server wkhtmltopdf redis 
 redis-server node uv python3.14-devel mariadb-devel gcc uv git make
sudo dnf install nodejs24

الخطوة 2: إعداد قاعدة البيانات و Valkey

تفعيل الخدمات لضمان استمراريتها بعد إعادة التشغيل.

sudo systemctl enable --now valkey
sudo systemctl enable --now mariadb
sudo mariadb-secure-installation

الخطوة 3: التحكم في الإصدارات (خاص بفيدورا)

هنا تختلف الإجراءات؛ إذا كنت تستخدم فيدورا 42، يجب عليك إعادة توجيه أوامر بايثون العالمية. مستخدمو فيدورا 43 يجب عليهم تخطي أوامر الروابط الرمزية (Symlinks).

# Fedora 42 Only
sudo rm /usr/bin/python
sudo ln -s /usr/bin/python3.14 /usr/bin/python
sudo rm /usr/bin/python3
sudo ln -s /usr/bin/python /usr/bin/python3

# For both if node -v is not 24
sudo rm /usr/bin/node
sudo ln -s /usr/bin/node-24 /usr/bin/node

الخطوة 4: تهيئة الـ Bench

نستخدم أداة uv لتثبيت سريع وإدارة معزولة لبيئة العمل.

uv python install 3.14 --default
uv tool install frappe-bench
mkdir ~/frappe && cd ~/frappe
bench init frappe-bench --frappe-branch version-16

الخطوة 5: تثبيت التطبيقات

أخيراً، قم بجلب تطبيقات v16 وتثبيتها على موقعك.

bench get-app hrms --branch version-16
bench install-app hrms
bench migrate