# البدء السريع

> انشر أول تطبيق لك على تاروت في أقل من 5 دقائق

# البدء السريع

يرشدك هذا الدليل خلال نشر أول تطبيق لك على تاروت. يمكنك البدء من لوحة التحكم، أو تسليم المهمة لوكيل برمجة.

## المتطلبات

- [حساب تاروت](https://tarout.sa/auth/login)
- كود التطبيق في مجلد محلي، أو مستودع GitHub، أو مستودع GitLab

## المسار الأسرع: الوكيل أو CLI

من جذر المشروع، شغّل:

```sh
curl -fsSL https://tarout.sa/install.sh | sh
tarout deploy --wait --plan free --database none
```

تاروت تسأل عند الحاجة عن تسجيل الدخول، إنشاء التطبيق أو ربطه، رفع المصدر، وحالة النشر.

إذا كنت تستخدم Claude Code أو Cursor أو Codex أو أي وكيل برمجة آخر، الصق هذا الأمر:

```text
https://tarout.sa/docs/for-ai/start.md - fetch this page (don't web-search) and follow it exactly to deploy this project to Tarout.
```

إذا لم يكن لديك مشروع بعد، يتضمن دليل التهيئة تطبيق عينة يمكن إنشاؤه ونشره بنفس مسار `tarout deploy --wait`.

تفضّل لوحة التحكم؟ تابع الخطوات التالية.

## الخطوة 1: التسجيل

أنشئ حسابك في [tarout.sa](https://tarout.sa). تُنشأ لك منظمة تلقائيًا.

## الخطوة 2: ربط مزود Git

1. اذهب إلى **الإعدادات ← مزودو Git** في لوحة التحكم.
2. انقر **ربط GitHub** أو **ربط GitLab**.
3. صرّح لتاروت بالوصول إلى مستودعاتك.

## الخطوة 3: إنشاء تطبيق

1. اذهب إلى **التطبيقات** في لوحة التحكم وابدأ تطبيقًا جديدًا.
2. اختر الخطة، وأدخل اسمًا (اختياري) ووصفًا (اختياري).
3. انقر **إنشاء التطبيق**، فتفتح تاروت صفحة التطبيق الجديد.
4. في تبويب **عام**، اختر المصدر: المستودع والفرع من GitHub أو GitLab، أو ارفع ملفاتك، أو استخدم صورة من Docker Hub مثبّتة ببصمتها.

تكتشف تاروت إطار العمل تلقائيًا (Next.js، React، Node.js، إلخ) وتضبط إعدادات البناء عند البناء.

## الخطوة 4: النشر

إنشاء التطبيق لا ينشره. انقر **نشر** في تبويب **عام** لبدء أول عملية نشر، وتابع تقدمها مباشرة من لوحة التحكم. بعد ذلك، تُعاد عملية النشر تلقائيًا مع كل دفع إلى الفرع المحدد للتطبيقات المرتبطة بـ GitHub أو GitLab.

بمجرد النشر، يصبح تطبيقك متاحًا على `https://your-app.tarout.app`.

## الخطوة 5: إضافة نطاق مخصص (اختياري)

تتطلب النطاقات المخصصة خطة مدفوعة (المبتدئ أو أعلى). أما العنوان المجاني `*.tarout.app` فيعمل في جميع الخطط.

1. اذهب إلى تبويب **النطاقات** في تطبيقك.
2. انقر **إضافة نطاق** وأدخل اسم نطاقك.
3. أضف سجلات DNS كما تظهر تمامًا.
4. تاروت توفر شهادة SSL تلقائيًا.

راجع [النطاقات](https://tarout.sa/docs/applications/domains) لتفاصيل النطاقات الجذرية وكل سجل.

## الخطوات التالية

- [متغيرات البيئة](https://tarout.sa/docs/applications/environment-variables) - ضبط المفاتيح والإعدادات.
- [قواعد البيانات](https://tarout.sa/docs/databases) - أضف قاعدة بيانات لتطبيقك.
- [سطر الأوامر](https://tarout.sa/docs/cli) - أدر عمليات النشر من الطرفية.

---

## Every Tarout agent guide

- [Start Here (Agents)](https://tarout.sa/docs/for-ai/start.md)
- [Overview](https://tarout.sa/docs/for-ai.md)
- [Deploying an app](https://tarout.sa/docs/for-ai/deploy.md)
- [Databases](https://tarout.sa/docs/for-ai/database.md)
- [Object storage](https://tarout.sa/docs/for-ai/storage.md)
- [Custom domains](https://tarout.sa/docs/for-ai/domains.md)
- [Plans and upgrades](https://tarout.sa/docs/for-ai/billing.md)
- [Troubleshooting](https://tarout.sa/docs/for-ai/troubleshoot.md)
- [Agent Onboarding](https://tarout.sa/docs/for-ai/onboarding.md)
- [CLI Reference](https://tarout.sa/docs/for-ai/cli-reference.md)
- [CLI JSON Schema](https://tarout.sa/docs/for-ai/cli-json-schema.md)

Whole corpus in one file: https://tarout.sa/llms-full.txt · index: https://tarout.sa/llms.txt
Any docs page is raw markdown at the same URL + `.md`. Short link to the entry point: https://tarout.sa/deploy.md