الانتقال إلى المحتوى الرئيسي
Header

​
Prerequisites

  • Linux and MacOS
  • Windows (WSL)
قبل أن تتمكن من تثبيت واستخدام Twenty، تأكد من تثبيت الأمور التالية على جهاز الكمبيوتر الخاص بك:
لن يعمل npm ، يجب عليك استخدام yarn بدلًا من ذلك. Yarn is now shipped with Node.js, so you don’t need to install it separately. عليك فقط تشغيل corepack enable لتفعيل Yarn إذا لم تقم بذلك بعد.

​
الخطوة 1: استنساخ Git

في الطرفية الخاصة بك، قم بتشغيل الأمر التالي.

​
الخطوة 2: ضع نفسك في الجذر

cd twenty
يجب تشغيل جميع الأوامر في الخطوات التالية من جذر المشروع.

​
الخطوة 3: إعداد قاعدة بيانات PostgreSQL

  • Linux
  • Mac OS
  • Windows (WSL)
Option 1 (preferred): To provision your database locally: Use the following link to install Postgresql on your Linux machine: Postgresql Installation
  psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;"
Note: You might need to add sudo -u postgres to the command before psql to avoid permission errors.
**Option 2:** If you have docker installed:
```bash
  make postgres-on-docker
```
يمكنك الآن الوصول إلى قاعدة البيانات على localhost:5432، مع المستخدم postgres وكلمة المرور postgres.

​
الخطوة 4: إعداد قاعدة البيانات Redis (للتخزين المؤقت)

يتطلب Twenty مخزن بيانات Redis لتقديم أفضل أداء
  • Linux
  • Mac OS
  • Windows (WSL)
Option 1: To provision your Redis locally: Use the following link to install Redis on your Linux machine: Redis Installation
**Option 2:** If you have docker installed:
```bash
  make redis-on-docker
```
إذا كنت بحاجة إلى واجهة رسومية للعميل، نوصي بـ redis insight (يتوفر إصدار مجاني)

​
الخطوة 5: إعداد متغيرات البيئة

استخدم متغيرات البيئة أو ملفات .env لتكوين مشروعك. المزيد من المعلومات هنا نسخ ملفات .env.example الموجودة في /front و /server: 
cp ./packages/twenty-front/.env.example ./packages/twenty-front/.env
cp ./packages/twenty-server/.env.example ./packages/twenty-server/.env

​
الخطوة 6: تثبيت التبعيات

لبناء خادم Twenty وزرع بعض البيانات في قاعدة البيانات الخاصة بك، قم بتشغيل الأمر التالي: 
yarn
لاحظ أن npm أو pnpm لن تعملا

​
الخطوة 7: تشغيل المشروع

  • Linux
  • Mac OS
  • Windows (WSL)
اعتمادًا على توزيعة Linux الخاصة بك، قد يتم بدء خادم Redis تلقائيًا. إذا لم يكن كذلك، تحقق من دليل تثبيت ريديس لتوزيعتك.
قم بضبط قاعدة بياناتك بالأمر التالي: 
npx nx database:reset twenty-server
ابدأ الخادم والخادم الثانوي وخدمات الواجهة الأمامية: 
npx nx start twenty-server
npx nx worker twenty-server
npx nx start twenty-front
بدلاً من ذلك، يمكنك بدء جميع الخدمات مرة واحدة: 
npx nx start

​
الخطوة الثامنة: استخدم Twenty

الواجهة الأمامية ستكون واجهة Twenty الأمامية تعمل على http://localhost:3001. يمكنك تسجيل الدخول باستخدام حساب العرض التوضيحي الافتراضي: tim@apple.dev (كلمة المرور: tim@apple.dev) الخلفية

​
استكشاف الأخطاء وإصلاحها

إذا واجهت أي مشكلة، فارجع إلى استكشاف الأخطاء وإصلاحها للحصول على الحلول.