ملخص تثبيت ERPNext على Ubuntu Server 24.04

1. إعداد النظام الأساسي

تحديث النظام

sudo apt update && sudo apt upgrade -y
sudo apt install software-properties-common -y

تثبيت Python والمتطلبات

sudo apt install python3-pip python3-dev python3-setuptools python3-venv -y
sudo apt install python3-testresources python3-full -y

تثبيت Git والأدوات الأساسية

sudo apt install git python3-dev python3-setuptools python3-pip build-essential -y

تثبيت MariaDB

sudo apt install mariadb-server mariadb-client -y
sudo mysql_secure_installation

تكوين MariaDB

sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf
# إضافة تحت [mysqld]:
# character-set-client-handshake = FALSE
# character-set-server = utf8mb4
# collation-server = utf8mb4_unicode_ci

sudo systemctl restart mariadb

تثبيت Redis

sudo apt install redis-server -y

تثبيت Node.js و npm

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs -y
sudo npm install -g yarn

تثبيت المتطلبات الإضافية

sudo apt install xvfb libfontconfig wkhtmltopdf -y
sudo apt install nginx supervisor cron -y

2. إنشاء مستخدم ERPNext

sudo adduser erpnext
sudo usermod -aG sudo erpnext
su - erpnext

3. تثبيت Frappe Bench

تثبيت باستخدام pipx (الطريقة الموصى بها)

sudo apt install pipx -y
pipx ensurepath
source ~/.bashrc
pipx install frappe-bench

4. إنشاء Frappe Bench

bench init frappe-bench --frappe-branch version-15
cd frappe-bench

5. إنشاء موقع جديد

bench new-site mysite.local
# أدخل كلمة مرور MySQL root
# أدخل كلمة مرور Administrator للموقع

6. تثبيت التطبيقات

تثبيت ERPNext

bench get-app erpnext --branch version-15
bench --site mysite.local install-app erpnext

تثبيت HRMS (نظام الموارد البشرية)

bench get-app hrms --branch version-15
bench --site mysite.local install-app hrms

تثبيت POS Awesome (نقطة البيع)

bench get-app https://github.com/defendicon/POS-Awesome-V15 --branch Version-15
bench --site mysite.local install-app posawesome
bench build --app posawesome

7. إعداد الإنتاج

إعداد Supervisor

bench setup supervisor
sudo ln -s /home/erpnext/frappe-bench/config/supervisor.conf /etc/supervisor/conf.d/frappe-bench.conf

إعداد Nginx

bench setup nginx
sudo ln -s /home/erpnext/frappe-bench/config/nginx.conf /etc/nginx/sites-enabled/frappe-bench.conf
sudo rm -f /etc/nginx/sites-enabled/default

إصلاح مشكلة log format في Nginx

sudo nano /etc/nginx/sites-enabled/frappe-bench.conf
# تغيير: access_log /var/log/nginx/access.log main;
# إلى: access_log /var/log/nginx/access.log;

تطبيق الإعدادات

sudo supervisorctl reread
sudo supervisorctl update
sudo nginx -t
sudo systemctl restart nginx

8. الصلاحيات المهمة

# إعطاء صلاحيات القراءة والتنفيذ للآخرين
chmod -R o+rx /home/erpnext

# التأكد من ملكية المجلدات
sudo chown -R erpnext:erpnext /home/erpnext/frappe-bench

9. إعداد الجدار الناري

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw --force enable

10. الأوامر المفيدة

تشغيل ERPNext (وضع التطوير)

cd /home/erpnext/frappe-bench
bench start

إعادة تشغيل الخدمات (وضع الإنتاج)

sudo supervisorctl restart all

عرض السجلات

bench --site mysite.local show-logs

النسخ الاحتياطي

bench --site mysite.local backup

تحديث النظام

bench update

11. الوصول إلى النظام

1. عنوان الموقع: http://your-server-ip
2. اسم المستخدم: Administrator
3. كلمة المرور: التي قمت بإدخالها عند إنشاء الموقع

التطبيقات المثبتة

1. Frappe Framework - الإطار الأساسي
2. ERPNext - نظام تخطيط موارد المؤسسات
3. HRMS - نظام إدارة الموارد البشرية
4. POS Awesome - نظام نقطة البيع المتقدم

ملاحظات مهمة

1. تم التثبيت على Ubuntu Server 24.04
2. تم استخدام MariaDB 10.11 (مع تحذير التوافق - يعمل بشكل طبيعي)
3. تم استخدام pipx لتثبيت frappe-bench لتجنب مشاكل Python
4. تم إصلاح جميع مشاكل الصلاحيات والإعدادات