> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombify.io/llms.txt
> Use this file to discover all available pages before exploring further.

# stackkit setup

> إعداد حساب المالك لتطبيق جرى تطبيقه

إعداد حساب المالك لتطبيق جرى تطبيقه.

شغّل إجراء إعداد تعلنه Plan على التطبيق المحلي الموجود. اقرأ حقول JSON الخاصة ببيانات الاعتماد الخاصة ومسار الملف من دليل الإعداد للتطبيق المحدد أو من إجراء الحالة. لا تُكتب بيانات الاعتماد أبدًا في أدلة دورة الحياة. وإعادة التشغيل بعد انقطاع تعيد رصد التطبيق قبل إكمال عملية الإعداد المعلّقة نفسها.

```bash theme={null}
stackkit setup <workload> [flags]
```

| الخيار | النوع | الافتراضي | الوصف |
| - | - | - | - |
| `--complete-onboarding` | bool | — | أكمل تهيئة مستخدم التطبيق والمسؤول بعد التحقق من تسجيل دخول المالك |
| `--credentials-file` | string | — | ملف JSON خاص ببيانات اعتماد المالك نسبةً إلى مساحة العمل (الافتراضي دليل الإعداد للتطبيق المحدد) |
| `--json` | bool | — | أخرج نتيجة الإعداد الموثَّقة الخالية من الأسرار |
| `--operation-id` | string | — | استأنف عملية إعداد معلّقة؛ والافتراضي هو الإعداد المعلّق الحالي أو معرّف جديد |
| `--owner-approve` | bool | — | وافق على إعداد التطبيق المرتبط بـ Plan هذا |

**أمثلة**

```bash theme={null}
# Create the Photos owner from the private credentials in .stackkit/setup/owner.json
stackkit setup photos --owner-approve

# Also finish the application's onboarding after the owner login is verified
stackkit setup photos --owner-approve --complete-onboarding

# Create the Files owner from a workspace-relative credentials file of your choice
stackkit setup files --owner-approve --credentials-file private/files-owner.json
```

الأوامر الفرعية: [`stackkit setup ai-connect`](#stackkit-setup-ai-connect)، [`stackkit setup ai-provider`](#stackkit-setup-ai-provider)، [`stackkit setup connector`](#stackkit-setup-connector)

## stackkit setup ai-connect

ربط Ollama في Private AI مع kombify AI لديك كنقطة نهاية لنموذج تملكه.

تشغيل موصّل kombify AI الاختياري لحالة استخدام Private AI. أنشئ نقطة نهاية نموذج في Companion Studio (Settings، AI access، Model endpoints) مع الأصل [http://ollama:11434](http://ollama:11434) وانسخ رمز الموصّل الخاص بها. يقرأ هذا الأمر الرمز من الإدخال القياسي أو من `--token-file`، ولا يقرأه من وسيطة أبدًا؛ ويتحقق من بنيته، ويبقيه في الحيازة المحلية للمالك، ويشغّل الموصّل. يبدأ generate وapply التاليان الموصّل الصادر بجانب Ollama. لا يُفتح أي اتصال وارد ويظل Ollama غير منشور.

يوقف `--disable` الموصّل ويزيل الرمز من الحيازة المحلية. ألغِ نقطة النهاية في Companion Studio لجعل الرمز عديم الفائدة في كل مكان.

```bash theme={null}
stackkit setup ai-connect [flags]
```

| الخيار | النوع | الافتراضي | الوصف |
| - | - | - | - |
| `--disable` | bool | — | إيقاف الموصّل وإزالة رمزه من الحيازة المحلية |
| `--json` | bool | — | إصدار النتيجة الخالية من الأسرار |
| `--token-file` | string | — | ملف يحتوي على رمز الموصّل؛ تقرأ "-" أو عدم تحديد الخيار من الإدخال القياسي |

**أمثلة**

```bash theme={null}
# Paste the connector token, then press Enter and Ctrl-D (or read it hidden on a terminal)
stackkit setup ai-connect --token-file -

# Read the token from a private file
stackkit setup ai-connect --token-file ~/kombify-connector-token

# Turn the connector off and remove its token
stackkit setup ai-connect --disable
```

## stackkit setup ai-provider

قدّم مزوّدًا خارجيًا متوافقًا مع OpenAI في Private AI بمفتاح من kombify Wallet الخاص بك.

دع Open WebUI في حالة استخدام Private AI يستخدم مزوّد استدلال خارجيًا متوافقًا مع OpenAI (مثل OpenAI أو Mistral أو Groq أو OpenRouter) إلى جانب Ollama الخاص بالعقدة. لا يمر مفتاح API الخاص بالمزوّد عبر هذا الأمر ولا StackSpec ولا الحزمة المُنشأة: احتفظ به كبيانات اعتماد AI في kombify Wallet، واسمح لهذه العقدة على العنصر، وسلّمه مختومًا إلى هذه العقدة عبر "stackkit wallet-item import". يربط هذا الأمر مفتاح المزوّد بذلك العنصر المسلَّم ويضبط عنوان https الأساسي للمزوّد. ثم يقرأ كل apply أحدث إصدار مسلَّم، فيسري التدوير في Wallet بعد "stackkit wallet-item import" للعنصر المدوَّر وapply التالي. يفشل apply بإغلاق آمن إذا لم يكن العنصر في عهدة هذه العقدة.

يزيل `--disable` المزوّد من Open WebUI والربط من العهدة المحلية. يبقى العنصر المسلَّم في عهدة عناصر Wallet للعقدة.

```bash theme={null}
stackkit setup ai-provider [flags]
```

| الخيار | النوع | الافتراضي | الوصف |
| - | - | - | - |
| `--base-url` | string | — | عنوان https الأساسي لواجهة API الخاصة بالمزوّد المتوافق مع OpenAI |
| `--disable` | bool | — | أزل المزوّد الخارجي وربط مفتاحه |
| `--json` | bool | — | أخرج نتيجة stackkit.command-result/v1 الخالية من الأسرار |
| `--tenant-ref` | string | — | المستأجر (tenant) الذي سُلِّم عنصر Wallet تحته |
| `--wallet-item` | string | — | مرجع عنصر Wallet لمفتاح المزوّد المسلَّم |

**أمثلة**

```bash theme={null}
# Bind the provider key delivered as Wallet item itm_... and set the provider
stackkit setup ai-provider --base-url https://api.openai.com/v1 --tenant-ref "$TENANT" --wallet-item itm_abc...

# Remove the provider
stackkit setup ai-provider --disable
```

## stackkit setup connector

أصدر موصل Home Assistant المحلي بعينه أو أبطله أو تحقق منه.

```bash theme={null}
stackkit setup connector [flags]
```

| الخيار | النوع | الافتراضي | الوصف |
| - | - | - | - |
| `--json` | bool | — | أخرج بايتات الإيصال الموقّع الدقيق والمصدّق والحقائق المحلية الحالية |
| `--operation-id` | string | — | معرّف عملية إعداد الموصل الثابت بعينه |
| `--owner-approve` | bool | — | وافق على طلب ensure أو revoke الدقيق لهذا الموصل |
| `--request-file` | string | — | JSON طلب الموصل الخاص المقتصر على البيانات الوصفية نسبةً إلى مساحة العمل؛ لا يحتوي بيانات اعتماد أبدًا |
| `--verify-only` | bool | — | اقرأ إيصالًا محتفظًا به وتحقق منه مقابل الربط المحلي الحالي دون إصدار أو إبطال |
| `--workload` | string | — | حمل العمل المحلي بعينه؛ لا يُقبل إلا smart-home |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.