Skip to main content

المتطلبات الأساسية

قبل أن تتمكن من تثبيت واستخدام Twenty، تأكد من تثبيت الأمور التالية على جهاز الكمبيوتر الخاص بك:
لن يعمل npm ، يجب عليك استخدام yarn بدلًا من ذلك. يأتي Yarn الآن مع Node.js، لذا لست بحاجة إلى تثبيته بشكل منفصل. عليك فقط تشغيل corepack enable لتفعيل Yarn إذا لم تقم بذلك بعد.

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

في الطرفية الخاصة بك، قم بتشغيل الأمر التالي.
إذا لم تكن قد أعددت مفاتيح SSH بالفعل، يمكنك معرفة كيفية القيام بذلك هنا.

الخطوة 2: انتقل إلى جذر المشروع

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

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

الخيار 1 (المفضل): لتوفير قاعدة بياناتك محليًا: استخدم الرابط التالي لتثبيت PostgreSQL على جهاز Linux الخاص بك: تثبيت PostgreSQL
ملاحظة: قد تحتاج إلى إضافة sudo -u postgres إلى الأمر قبل psql لتجنب أخطاء الإذن.الخيار 2: إذا كنت قد قمت بتثبيت docker:
يمكنك الآن الوصول إلى قاعدة البيانات على localhost:5432. إذا استخدمت خيار Docker أعلاه، فإن بيانات الاعتماد الافتراضية هي اسم المستخدم postgres وكلمة المرور postgres. بالنسبة لتثبيتات PostgreSQL الأصلية، استخدم بيانات الاعتماد والأدوار المُكوَّنة على جهازك.

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

يتطلب Twenty مخزن بيانات Redis لتقديم أفضل أداء.
الخيار 1: لتوفير Redis الخاص بك محليًا: استخدم الرابط التالي لتثبيت Redis على جهاز Linux: تثبيت Redisالخيار 2: إذا كنت قد قمت بتثبيت docker:
إذا كنت بحاجة إلى واجهة رسومية للعميل، نوصي بـ Redis Insight (يتوفر إصدار مجاني).

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

استخدم متغيرات البيئة أو ملفات .env لتكوين مشروعك. المزيد من المعلومات هنا. انسخ ملفات .env.example الموجودة في /front و/server:
وضع تعدد مساحات العمل: بشكل افتراضي، يعمل Twenty في وضع مساحة عمل واحدة حيث يمكن إنشاء مساحة عمل واحدة فقط. لتمكين دعم تعدد مساحات العمل (مفيد لاختبار الميزات المعتمدة على النطاقات الفرعية)، عيّن IS_MULTIWORKSPACE_ENABLED=true في ملف الخادم .env. راجع وضع تعدد مساحات العمل للحصول على التفاصيل.

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

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

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

اعتمادًا على توزيعة Linux الخاصة بك، قد يتم بدء خادم Redis تلقائيًا. إذا لم يكن كذلك، تحقق من دليل تثبيت Redis لتوزيعتك.
قم بضبط قاعدة بياناتك بالأمر التالي:
ابدأ الخادم والخادم الثانوي وخدمات الواجهة الأمامية:
بدلاً من ذلك، يمكنك بدء جميع الخدمات مرة واحدة:

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

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

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

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