الإعداد المحلي

Prerequisites

Linux و MacOS
ويندوز (WSL)

قبل أن تتمكن من تثبيت واستخدام Twenty، تأكد من تثبيت الأمور التالية على جهاز الكمبيوتر الخاص بك:

لن يعمل npm ، يجب عليك استخدام yarn بدلًا من ذلك. Yarn is now shipped with Node.js, so you don’t need to install it separately. عليك فقط تشغيل corepack enable لتفعيل Yarn إذا لم تقم بذلك بعد.

ثبّت WSL افتح PowerShell كمسؤول ثم نفّذ:

wsl --install

يجب أن ترى الآن مطالبة لإعادة تشغيل جهاز الكمبيوتر الخاص بك. إذا لم يكن كذلك، فأعد تشغيله يدويًا.Upon restart, a powershell window will open and install Ubuntu. قد يستغرق هذا وقتًا طويلاً. سترى مطالبة لإنشاء اسم المستخدم وكلمة المرور لتثبيت Ubuntu الخاص بك.

تثبيت وإعداد git

sudo apt-get install git

git config --global user.name "Your Name"

git config --global user.email "[email protected]"

تثبيت nvm و node.js و yarn

استخدم nvm لتثبيت نسخة node الصحيحة. الملف .nvmrc يضمن استخدام جميع المشاركين لنفس النسخة.

sudo apt-get install curl

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

أغلق وأعد فتح برنامجك الطرفي لاستخدام nvm. ثم قم بتشغيل الأوامر التالية.

nvm install # يثبت إصدار node الموصى به

nvm use # استخدم إصدار node الموصى به

corepack enable

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

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

SSH (موصى به)
HTTPS

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

git clone [email protected]:twentyhq/twenty.git

git clone https://github.com/twentyhq/twenty.git

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

cd twenty

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

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

Linux
نظام Mac OS
ويندوز (WSL)

الخيار 1 (المفضل): لتوفير قاعدة بياناتك محليًا: استخدم الرابط التالي لتثبيت Postgresql على جهاز Linux الخاص بك: تثبيت Postgresql

  psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;"

ملاحظة: قد تحتاج إلى إضافة sudo -u postgres إلى الأمر قبل psql لتجنب أخطاء الإذن.الخيار 2: إذا كنت قد قمت بتثبيت docker:

make postgres-on-docker

الخيار 1 (المفضل): لتوفير قاعدة بياناتك محليًا مع brew:

brew install postgresql@16
export PATH="/opt/homebrew/opt/postgresql@16/bin:$PATH"
brew services start postgresql@16
psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;"

يمكنك التحقق مما إذا كان خادم PostgreSQL يعمل بتنفيذ:

brew services list

المثبت قد لا ينشئ المستخدم postgres افتراضيًا عند التثبيت عبر Homebrew على MacOS. بدلاً من ذلك، فإنه ينشئ دور PostgreSQL يطابق اسم المستخدم الخاص بك في MacOS (مثل “john”). للتحقق وإنشاء المستخدم postgres إذا لزم الأمر، اتبع هذه الخطوات:

# قم بالاتصال بPostgreSQL
psql postgres
أو
psql -U $(whoami) -d postgres

بمجرد أن تكون عند مطالبة psql (postgres=#)، قم بتشغيل:

# قائمة الأدوار الموجودة في PostgreSQL
\du

سترى مخرجات مشابهة ل:

اسم الأدوار | الخصائص | عضو في
-----------+-------------+-----------
john | مشرف نظام | {}

إذا لم ترَ دور postgres مدرجًا، انتقل إلى الخطوة التالية. قم بإنشاء دور postgres يدويًا:

CREATE ROLE postgres WITH SUPERUSER LOGIN;

يقوم هذا بإنشاء دور مشرف نظام باسم postgres مع إمكانية تسجيل الدخول.الخيار 2: إذا كنت قد قمت بتثبيت docker:

make postgres-on-docker

يجب أن تُنفذ جميع الخطوات التالية في تيرمينال WSL (داخل جهازك الافتراضي)الخيار 1: لتوفير قاعدة بيانات Postgresql الخاصة بك محليًا: استخدم الرابط التالي لتثبيت Postgresql على جهاز Linux الافتراضي الخاص بك: تثبيت Postgresql

  psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;"

ملاحظة: قد تحتاج إلى إضافة sudo -u postgres إلى الأمر قبل psql لتجنب أخطاء الإذن.الخيار 2: إذا كنت قد قمت بتثبيت docker: تشغيل Docker على WSL يضيف طبقة إضافية من التعقيد. استخدم هذا الخيار فقط إذا كنت مرتاحًا مع الخطوات الإضافية المتضمنة، بما في ذلك تشغيل Docker Desktop WSL2.

make postgres-on-docker

يمكنك الآن الوصول إلى قاعدة البيانات على localhost:5432، مع المستخدم postgres وكلمة المرور postgres.

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

يتطلب Twenty مخزن بيانات Redis لتقديم أفضل أداء

Linux
Mac OS
ويندوز (WSL)

الخيار 1: لتوفير Redis الخاص بك محليًا: استخدم الرابط التالي لتثبيت Redis على جهاز Linux: تثبيت Redisالخيار 2: إذا كنت قد قمت بتثبيت docker:

make redis-on-docker

الخيار 1 (المفضل): لتوفير Redis الخاص بك محليًا مع brew:

brew install redis

ابدأ خادم redis الخاص بك: brew services start redisالخيار 2: إذا كنت قد قمت بتثبيت docker:

make redis-on-docker

الخيار 1: لتوفير Redis الخاص بك محليًا: استخدم الرابط التالي لتثبيت Redis على جهاز Linux الافتراضي الخاص بك: تثبيت Redisالخيار 2: إذا كنت قد قمت بتثبيت docker:

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

Multi-Workspace Mode: By default, Twenty runs in single-workspace mode where only one workspace can be created. To enable multi-workspace support (useful for testing subdomain-based features), set IS_MULTIWORKSPACE_ENABLED=true in your server .env file. See Multi-Workspace Mode for details.

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

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

yarn

لاحظ أن npm أو pnpm لن تعملا

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

Linux
نظام Mac OS
ويندوز (WSL)

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

من المفترض أن يكون Redis قد تم تشغيله بالفعل. إذا لم يكن كذلك، قم بتشغيل:

brew services start 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. يمكنك تسجيل الدخول باستخدام حساب العرض التوضيحي الافتراضي: [email protected] (كلمة المرور: [email protected]) الخلفية

سيكون خادم Twenty متصلاً ويعمل على http://localhost:3000
يمكن الوصول إلى واجهة برمجة التطبيقات GraphQL في http://localhost:3000/graphql
يمكن الوصول إلى واجهة برمجة التطبيقات REST في http://localhost:3000/rest

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

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

المطورون

Extend

Self-Host

Contribute

Prerequisites

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

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

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

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

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

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

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

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

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

المطورون

Extend

Self-Host

Contribute

​Prerequisites

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

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

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

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

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

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

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

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

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

Prerequisites

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

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

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

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

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

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

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

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

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