> ## 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

> Den Owner-Account einer angewendeten Anwendung einrichten

Den Owner-Account einer angewendeten Anwendung einrichten.

Führt eine vom Plan deklarierte Setup-Aktion auf der bestehenden lokalen Anwendung aus. Lies die privaten Credential-JSON-Felder und den Dateipfad aus der Setup-Anleitung oder der Status-Aktion der ausgewählten Anwendung. Credentials werden nie in Lifecycle-Nachweise geschrieben. Ein erneuter Lauf nach einer Unterbrechung beobachtet die Anwendung neu, bevor dieselbe ausstehende Setup-Operation abgeschlossen wird.

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

| Flag | Typ | Standard | Beschreibung |
| - | - | - | - |
| `--complete-onboarding` | bool | — | Das Onboarding von App-Benutzern und Administrator abschließen, nachdem der Owner-Login verifiziert wurde |
| `--credentials-file` | string | — | Workspace-relative private Owner-Credential-JSON-Datei (Standard ist die Setup-Anleitung der ausgewählten Anwendung) |
| `--json` | bool | — | Das secretfreie, verifizierte Setup-Ergebnis ausgeben |
| `--operation-id` | string | — | Eine ausstehende Setup-Operation fortsetzen; Standard ist das aktuell ausstehende Setup oder eine neue ID |
| `--owner-approve` | bool | — | Dieses an den Plan gebundene Anwendungs-Setup freigeben |

**Examples**

```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
```

Unterbefehle: [`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

Private AI Ollama als eigenen Modell-Endpunkt mit deiner kombify AI verbinden.

Den optionalen kombify-AI-Connector des Private-AI-Anwendungsfalls aktivieren. Erstelle in Companion Studio (Settings, AI access, Model endpoints) einen Modell-Endpunkt mit dem Ursprung [http://ollama:11434](http://ollama:11434) und kopiere dessen Connector-Token. Dieser Befehl liest das Token von der Standardeingabe oder aus `--token-file`, niemals aus einem Argument, prüft sein Format, bewahrt es in lokaler Besitzerverwahrung auf und aktiviert den Connector. Das nächste generate und apply starten den ausgehenden Connector neben Ollama. Eingehend wird nichts geöffnet, und Ollama bleibt unveröffentlicht.

`--disable` schaltet den Connector aus und entfernt das Token aus der lokalen Verwahrung. Widerrufe den Endpunkt in Companion Studio, damit das Token überall unbrauchbar wird.

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

| Flag | Typ | Standard | Beschreibung |
| - | - | - | - |
| `--disable` | bool | — | Den Connector ausschalten und sein Token aus der lokalen Verwahrung entfernen |
| `--json` | bool | — | Das geheimnisfreie Ergebnis ausgeben |
| `--token-file` | string | — | Datei mit dem Connector-Token; "-" oder kein Flag liest die Standardeingabe |

**Beispiele**

```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

Einen externen OpenAI-kompatiblen Provider in Private AI mit einem Schlüssel aus deinem kombify Wallet anbieten.

Lass Open WebUI des Private-AI-Anwendungsfalls einen externen OpenAI-kompatiblen Inferenz-Provider (zum Beispiel OpenAI, Mistral, Groq oder OpenRouter) neben dem Ollama des Nodes nutzen. Der API-Schlüssel des Providers läuft nie durch diesen Befehl, die StackSpec oder das generierte Bundle: Bewahre ihn als AI-Credential in deinem kombify Wallet auf, erlaube diesem Node den Eintrag und liefere ihn versiegelt an diesen Node mit "stackkit wallet-item import". Dieser Befehl bindet den Provider-Schlüssel an den gelieferten Eintrag und setzt die https-Basis-URL des Providers. Jedes Apply liest danach die neueste gelieferte Version, sodass eine Rotation im Wallet nach "stackkit wallet-item import" des rotierten Eintrags und dem nächsten Apply wirksam wird. Apply schlägt geschlossen fehl, wenn der Eintrag nicht in der Verwahrung dieses Nodes liegt.

`--disable` entfernt den Provider aus Open WebUI und die Bindung aus der lokalen Verwahrung. Der gelieferte Eintrag bleibt in der Wallet-Eintrags-Verwahrung des Nodes.

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

| Flag | Typ | Standard | Beschreibung |
| - | - | - | - |
| `--base-url` | string | — | https-Basis-URL der OpenAI-kompatiblen Provider-API |
| `--disable` | bool | — | Den externen Provider und seine Schlüsselbindung entfernen |
| `--json` | bool | — | Das geheimnisfreie stackkit.command-result/v1-Ergebnis ausgeben |
| `--tenant-ref` | string | — | Mandant, unter dem der Wallet-Eintrag geliefert wurde |
| `--wallet-item` | string | — | Wallet-Eintrags-Referenz des gelieferten Provider-Schlüssels |

**Beispiele**

```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

Den exakten lokalen Home-Assistant-Connector ausstellen, widerrufen oder verifizieren.

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

| Flag | Typ | Standard | Beschreibung |
| - | - | - | - |
| `--json` | bool | — | Die authentifizierten, exakt signierten Receipt-Bytes und die aktuellen lokalen Fakten ausgeben |
| `--operation-id` | string | — | Exakte stabile Identität der Connector-Setup-Operation |
| `--owner-approve` | bool | — | Diese exakte Connector-Anlage oder den exakten Widerruf freigeben |
| `--request-file` | string | — | Workspace-relative private, nur Metadaten enthaltende Connector-Request-JSON; enthält nie Credentials |
| `--verify-only` | bool | — | Einen aufbewahrten Receipt gegen die aktuelle lokale Bindung lesen und verifizieren, ohne etwas auszustellen oder zu widerrufen |
| `--workload` | string | — | Exakter lokaler Workload; nur smart-home ist zugelassen |


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