التثبيت

ملاحظة: لعمليات النشر للإنتاج أو التطوير القائم على Docker، استخدم frappe_docker.

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

يفترض هذا الدليل أنك تستخدم كمبيوترًا شخصيًا، أو VPS، أو خادمًا حديديًا. أنت أيضًا بحاجة إلى أن تكون على نظام *nix، لذلك أي توزيعة Linux و macOS مدعومة. إذا كنت مستخدمًا لنظام Windows، فيمكنك استخدام Ubuntu في WSL. نحن ندعم رسميًا فقط التوزيعات التالية: * macOS * Debian / Ubuntu

المتطلبات المسبقة

• MariaDB 10.6.6+ (يُوصى بـ 11.3 على الإصدار develop)
• Python 3.10+
• Node 18+
• Redis 6 (للتخزين المؤقت والتحديثات الفورية)
• yarn 1.12+ (مدير اعتمادات JavaScript)
• pip 20+ (مدير اعتمادات Python)
• wkhtmltopdf (الإصدار 0.12.5 مع تصحيح qt) (لإنشاء ملفات PDF)
• cron (للمهام المجدولة في Bench: مثل تجديد الشهادات الآلي، والنسخ الاحتياطي المجدول)

macOS

1. قم بتثبيت أدوات سطر الأوامر من Xcode.

   xcode-select --install
   

2. قم بتثبيت Homebrew. إنه يسهل تثبيت الحزم على macOS.

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

   (قد يطالبك بتشغيل بعض الأوامر الإضافية في النهاية، والتي ستضمن أن brew متاح في PATH الخاص بك)

3. قم بتثبيت wkhtmltopdf.

   curl -L https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6-2/wkhtmltox-0.12.6-2.macos-cocoa.pkg -O
   installer -pkg wkhtmltox-0.12.6-2.macos-cocoa.pkg -target ~
   

4. الآن، يمكنك تثبيت الحزم المطلوبة بسهولة عن طريق تشغيل الأمر التالي:

   brew install python@3.12 git redis mariadb@10.6 node@18 postgresql pkg-config mariadb-connector-c
   

5. الآن، قم بتحرير ملف تكوين MariaDB (هذه الخطوة غير مطلوبة لإصدار Frappe v15.21.0 أو أعلى).

   nano /usr/local/etc/my.cnf
   

   بالنسبة لأجهزة Apple Silicon (غير Intel)، يكون مسار تكوين MariaDB هو:

   nano /opt/homebrew/etc/my.cnf
   

   وأضف هذا التكوين:

   [mysqld]
   character-set-client-handshake = FALSE
   character-set-server = utf8mb4
   collation-server = utf8mb4_unicode_ci
   bind-address = 127.0.0.1
   
   [mysql]
   default-character-set = utf8mb4
   

6. الآن، فقط أعد تشغيل خدمة mysql وسيكون كل شيء على ما يرام.

   brew services restart mariadb@10.6
   

7. قم بتثبيت Yarn باستخدام npm.

   npm install -g yarn
   

Debian / Ubuntu

يجب أن تعمل على Debian 12+ أو Ubuntu 22.04+، وإلا قد تواجه مشاكل مع بعض الحزم.

1. قم بتحديث فهرس الحزم الخاص بنظامك.

   sudo apt update
   

2. قم بتثبيت git، python، و redis.

   sudo apt install git python-is-python3 python3-dev python3-pip redis-server libmariadb-dev mariadb-server mariadb-client pkg-config
   

   خلال هذا التثبيت، ستُطلب منك تعيين كلمة مرور root لـ MySQL. إذا لم يُطلب منك، فسيتعين عليك تهيئة إعداد خادم MySQL بنفسك. يمكنك القيام بذلك عن طريق تشغيل الأمر:

   sudo mariadb-secure-installation
   

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

3. الآن، قم بتحرير ملف تكوين MariaDB (هذه الخطوة غير مطلوبة لإصدار Frappe v15.21.0 أو أعلى).

   sudo nano /etc/mysql/my.cnf
   

   وأضف هذا التكوين:

   [mysqld]
   character-set-client-handshake = FALSE
   character-set-server = utf8mb4
   collation-server = utf8mb4_unicode_ci
   
   [mysql]
   default-character-set = utf8mb4
   

4. الآن، فقط أعد تشغيل خدمة MariaDB وسيكون كل شيء على ما يرام.

   sudo systemctl restart mariadb
   

5. قم بتثبيت Node (نوصي بتثبيت node باستخدام nvm).

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
   

   بعد تثبيت nvm، قد تضطر إلى إغلاق الطرفية وفتح أخرى. الآن قم بتشغيل الأمر التالي لتثبيت node.

   nvm install 18 # أو 20, 22
   

   تحقق من الإصدار المثبت، عن طريق تشغيل:

   node -v
   

6. أخيرًا، قم بتثبيت yarn باستخدام npm.

   npm install -g yarn
   

7. قم بتثبيت wkhtmltopdf.

   sudo apt install xvfb libfontconfig
   

   قم بتنزيل وتثبيت حزمة wkhtmltopdf من https://wkhtmltopdf.org/downloads.html، ثم قم بتشغيل هذا الأمر لتثبيت الحزمة.

   sudo dpkg -i wkhtmltox_file.deb
   

تثبيت Bench CLI

1. قم بتثبيت bench عبر pip.

   pip install frappe-bench
   

   ملاحظة: اعتمادًا على نظام التشغيل وإصدار Python، قد تحتاج إلى استخدام pip3 بدلاً من pip.

   Pip لا يشجع عمليات التثبيت على مستوى النظام، وبالتالي قد تضطر إلى القيام بشيء مكافئ لـ source rcfile. سيختلف هذا اعتمادًا على نظام التشغيل. على سبيل المثال، لـ Ubuntu:

   source ~/.profile
   

   قد تحتاج إلى إضافة الدليل الذي تم التثبيت فيه يدويًا إلى PATH الخاص بك. يجب أن يشير إخراج pip install إلى ذلك إذا لزم الأمر. يمكنك تشغيل شيء مثل هذا مع المسار الصحيح لتحقيق ذلك.

   echo "export PATH=/path/to/bin:$PATH" >> ~/.profile
   source ~/.profile
   

   اعتمادًا على إصدار نظام التشغيل وإصدار Python/pip، قد تحصل على خطأ هنا بخصوص externally-managed-environment. يمكنك التعامل مع هذا الآن عن طريق تشغيل أو استخدام virtualenv.

   pip install frappe-bench --break-system-packages
   

   طريقة بديلة للقيام بذلك هي باستخدام uv واسم مستعار للطرفية.

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   أضف alias bench='uvx --from frappe-bench bench' إلى ملف shell rc الخاص بك (.zshrc, .bashrc أو ما شابه)

2. تأكيد تثبيت bench عن طريق التحقق من الإصدار.

   bench --version
   

3. قم بإنشاء أول bench لك.

   cd ~
   bench init <directory name>
   

   مبروك، لقد قمت بتثبيت bench على نظامك.