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

# Umgebung

> Plattformvariablen und Sibling-URLs, die in deine App injiziert werden.

# Umgebung

Kazzle injiziert eine kleine Menge von Plattformvariablen in App-Prozesse. Deine eigenen Anmeldedaten kommen aus dem Vault über `kazzle.config.ts`.

## Prozessvariablen

| Variable         | Beschreibung                                 | Beispiel                 |
| ---------------- | -------------------------------------------- | ------------------------ |
| `PORT`           | Der Port, auf dem dein Prozess lauschen soll | `3000`                   |
| `HOST`           | Der Host zum Binden                          | `0.0.0.0`                |
| `KAZZLE_API_URL` | Basis-URL für Kazzle-Runtime-Helfer          | `https://api.kazzle.app` |

`PORT`, `HOST` und `KAZZLE_API_URL` werden für Prozesskomponenten gesetzt. Kazzle erstellt nicht automatisch API-Schlüssel für App-Prozesse; füge explizite Anmeldedaten nur hinzu, wenn deine App sie wirklich benötigt.

Dein Prozess sollte sich an `HOST:PORT` binden. Kazzle verwaltet Preview-Routing und Produktionsdomänen darüber hinaus.

## Sibling-Komponenten-URLs

Wenn eine App mehrere Komponenten hat, kann Kazzle URLs injizieren, die es einer Komponente ermöglichen, eine andere zu erreichen:

| Variable                          | Beschreibung                                 |
| --------------------------------- | -------------------------------------------- |
| `KAZZLE_APP_COMPONENT_{NAME}_URL` | URL für eine Sibling-Komponente zur Laufzeit |

Der Name kommt aus dem `name`-Feld der Komponente: in Großbuchstaben, nicht-alphanumerische Zeichen werden zu Unterstrichen. Eine Komponente namens `API Server` wird zu `KAZZLE_APP_COMPONENT_API_SERVER_URL`.

Diese URLs verweisen auf die bereitgestellte Sibling-Komponente, falls vorhanden. Andernfalls verweisen sie auf die aktuelle Entwicklungsadresse für diese Sibling-Komponente.

## App-Anmeldedaten

App-Anmeldedaten erreichen eine Komponente über eine Secret-Collection + Umgebung. Speichere das Secret im Vault mit dem Namen, den du als Umgebungsvariablenschlüssel möchtest (z. B. `KAZZLE_API_KEY`), und verweise dann die Komponente auf diese Collection + Umgebung:

```typescript theme={"theme":"material-theme-darker"}
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
```

Verwende `KAZZLE_API_KEY` für Aufrufe an Kazzles `/ai/*`-Endpunkte aus einer generierten App. Gib private Schlüssel niemals über `VITE_*` preis; diese Werte werden in Browser-Code gebündelt.