تثبيت ERPNext v15 على Debian 12 / Ubuntu 22.04 LTS: الدليل الحقيقي من مهندس DevOps

# تحديث قائمة الحزم وترقية كل الحزم الموجودة
sudo apt update && sudo apt upgrade -y

# تثبيت أدوات البناء الأساسية اللي حزم Python محتاجها للتجميع
sudo apt install -y \
  git curl wget \
  python3-dev python3-pip python3-venv \
  build-essential \
  libffi-dev libssl-dev \
  libjpeg-dev zlib1g-dev \
  libmysqlclient-dev pkg-config \
  xvfb libfontconfig fontconfig \
  redis-server supervisor nginx \
  cron

# تثبيت سكربت إعداد مستودع MariaDB
curl -LsS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash -s -- --mariadb-server-version=10.11

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

# التحقق من الإصدار المثبت
mysql --version
# المتوقع: mysql  Ver 15.1 Distrib 10.11.x-MariaDB

sudo mysql_secure_installation
# الإجابات: N (لا لمصادقة المقبس), Y (نعم لكلمة مرور root), Y, Y, Y, Y

sudo nano /etc/mysql/mariadb.conf.d/50-erpnext.cnf

[mysqld]
# مجموعة الأحرف — مطلوبة للبيانات العربية والفارسية وكل Unicode
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

# إعدادات InnoDB — مطلوبة لصيغة صفوف ERPNext
innodb-file-format = barracuda
innodb-file-per-table = 1
innodb-large-prefix = 1

# الأداء: اضبط على 50-70% من إجمالي RAM
# سيرفر 4 جيجا = 2G, سيرفر 8 جيجا = 5G, سيرفر 16 جيجا = 10G
innodb_buffer_pool_size = 2G

# منع انتهاء المهلة في التقارير الطويلة
wait_timeout = 28800
interactive_timeout = 28800

[mysql]
default-character-set = utf8mb4

[client]
default-character-set = utf8mb4

# إعادة تشغيل MariaDB لتطبيق الإعدادات
sudo systemctl restart mariadb
sudo systemctl enable mariadb

# التحقق من صحة مجموعة الأحرف
mysql -u root -p -e "SHOW VARIABLES LIKE 'character_set_server';"
# يجب أن يظهر: utf8mb4

# تثبيت Node.js 18 LTS من NodeSource
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

# التحقق — يجب أن يظهر v18.x.x
node --version

# تثبيت yarn (مدير الحزم الذي يستخدمه ERPNext)
sudo npm install -g yarn
yarn --version

# تنزيل الإصدار الصحيح حسب نظامك
# لـ Ubuntu 22.04 (Jammy):
wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-3/wkhtmltox_0.12.6.1-3.jammy_amd64.deb

# لـ Debian 12 (Bookworm):
# wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-3/wkhtmltox_0.12.6.1-3.bookworm_amd64.deb

# التثبيت
sudo apt install -y ./wkhtmltox_0.12.6.1-3.jammy_amd64.deb

# التحقق
wkhtmltopdf --version
# يجب أن يظهر: wkhtmltopdf 0.12.6.1 (with patched qt)

# إنشاء مستخدم frappe بدليل رئيسي
sudo adduser --disabled-password --gecos '' frappe

# منح مستخدم frappe صلاحيات sudo (مطلوبة أثناء التثبيت فقط)
sudo usermod -aG sudo frappe

# التحول لمستخدم frappe لبقية الخطوات
sudo su - frappe

# تثبيت bench باستخدام pip (كمستخدم frappe)
pip3 install frappe-bench

# التحقق من تثبيت bench
bench --version
# يجب أن يظهر: 5.x.x أو أعلى

# إذا لم يُعثر على 'bench'، أضف pip bin لـ PATH:
export PATH=$PATH:~/.local/bin
echo 'export PATH=$PATH:~/.local/bin' >> ~/.bashrc

# تهيئة bench مع Frappe v15 — يُنزّل ~200 ميجابايت
bench init --frappe-branch version-15 frappe-bench

# الانتقال لمجلد bench (ابقَ هنا لبقية الدليل)
cd ~/frappe-bench

# تنزيل ERPNext v15
bench get-app erpnext --branch version-15

# اختياري لكن موصى به: تنزيل وحدة HR بشكل منفصل
bench get-app hrms --branch version-15

# التحقق من تنزيل التطبيقات
bench version
# يجب أن يُدرج: frappe, erpnext, (hrms)

# إنشاء موقع جديد
# استبدل 'mycompany.local' بنطاقك
# استبدل 'كلمة_مرور_DB' بكلمة مرور root لـ MariaDB التي ضبطتها في الخطوة الثانية
# استبدل 'كلمة_مرور_الأدمين' بكلمة المرور التي تريدها لمستخدم أدمين ERPNext

bench new-site mycompany.local \
  --mariadb-root-password كلمة_مرور_DB \
  --admin-password كلمة_مرور_الأدمين \
  --no-mariadb-socket

# تثبيت تطبيق ERPNext على الموقع
bench --site mycompany.local install-app erpnext

# تثبيت HRMS إذا نزّلته
bench --site mycompany.local install-app hrms

# اضبط هذا كموقع افتراضي
bench use mycompany.local

# الخروج لمستخدم root/sudo
exit

# إعداد وضع الإنتاج — يهيئ Nginx وSupervisor تلقائياً
sudo bench setup production frappe --yes

# إعادة توليد إعداد Nginx
sudo bench setup nginx
sudo nginx -t  # اختبار إعداد nginx — يجب أن يقول 'syntax is ok'
sudo systemctl reload nginx

# تثبيت certbot
sudo apt install -y certbot python3-certbot-nginx

# الحصول على شهادة SSL (استبدل بنطاقك الفعلي)
sudo certbot --nginx -d mycompany.com --non-interactive --agree-tos -m admin@mycompany.com

# التحقق من عمل التجديد التلقائي
sudo certbot renew --dry-run

# التحقق من تشغيل كل الخدمات
sudo supervisorctl status
# يجب أن تظهر كل الخدمات: RUNNING

sudo systemctl status nginx
# يجب أن يظهر: active (running)

# إضافة نسخ احتياطي تلقائي — يعمل يومياً عند 2:30 صباحاً
crontab -e -u frappe

# أضف هذا السطر:
30 2 * * * cd /home/frappe/frappe-bench && bench --site mycompany.local backup --with-files >> /home/frappe/backup.log 2>&1

# تمكين النسخ الاحتياطي التلقائي المدمج في ERPNext (كل 6 ساعات)
bench --site mycompany.local set-config --global backup_limit 3
bench --site mycompany.local enable-scheduler