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

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

قبل أن تتمكن من تثبيت واستخدام Twenty، تأكد من تثبيت الأمور التالية على جهاز الكمبيوتر الخاص بك:
لن يعمل npm ، يجب عليك استخدام yarn بدلًا من ذلك. لم يعد Node 26 يتضمن Corepack، لذا ثبّته مرة واحدة باستخدام npm install -g corepack، ثم شغّل 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) الخلفية

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

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