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

# Laravel Cloud - GitHub Copilot SDK für Laravel

> Beschreibt, wie Sie das Laravel Copilot SDK in Laravel Cloud betreiben, inklusive Copilot-CLI-Installation, Umgebungsvariablen und Betriebshinweisen zu stdio-/TCP-Modus.

## Verwendung in Laravel Cloud

## Installation

Fügen Sie in **Settings > Deployments > Build commands** Folgendes hinzu und deployen Sie.

```shell theme={null}
export PATH="$PATH:/var/www/.local/bin"
curl -fsSL https://gh.io/copilot-install | bash
/var/www/.local/bin/copilot --version
```

Der Pfad zur CLI lautet `/var/www/.local/bin/copilot`. Setzen Sie daher unter **Custom environment variables** Folgendes.

```dotenv theme={null}
COPILOT_CLI_PATH=/var/www/.local/bin/copilot
COPILOT_GITHUB_TOKEN=
```

Für `COPILOT_GITHUB_TOKEN` können Sie jede von der Copilot CLI unterstützte Authentifizierungsvariante wie `GH_TOKEN` oder `GITHUB_TOKEN` verwenden.

Für den standardmäßigen stdio-Modus ist diese Installation ausreichend.

## Betrieb im TCP-Modus

Konfigurieren Sie unter **App cluster > Background processes > Custom worker** den Befehl `/var/www/.local/bin/copilot --headless --port 12345`.
Er läuft als Hintergrundprozess dauerhaft und wird beim Deployment automatisch neu gestartet.

Die Portnummer ist beliebig wählbar.

Setzen Sie in **Custom environment variables** `COPILOT_URL`.

```dotenv theme={null}
COPILOT_URL=tcp://127.0.0.1:12345
# COPILOT_CLI_PATH wird im TCP-Modus nicht benötigt. Sind beide gesetzt, hat der TCP-Modus Vorrang.
```

Wegen des Dauerbetriebs ist der Speicherverbrauch hoch; ein Server mit mindestens 2 GiB RAM kann erforderlich sein.
Bei Nutzung innerhalb einer HTTP-Anfrage ist die Verarbeitung oft nicht innerhalb von 60 Sekunden abgeschlossen und schlägt daher häufig fehl. Der Betrieb über Queues wird empfohlen.

Da der TCP-Modus in Laravel Cloud nur eingeschränkt praktikabel ist, wird der stdio-Modus empfohlen.

Er ist auch in höheren Plänen mit Worker Cluster nutzbar. Das ist sinnvoll, um Speicherengpässe im App Cluster zu vermeiden.

## Hinweise

* Preisgünstige Server geraten leicht in Speicherknappheit.
* Der Standard-HTTP-Timeout beträgt 20 Sekunden. Wenn Fehler häufig sind, erhöhen Sie ihn auf bis zu 60 Sekunden.

<Info>
  Aktuelle Informationen finden Sie im [GitHub-Repository](https://github.com/invokable/laravel-copilot-sdk).
</Info>


## Related topics

- [GitHub Copilot SDK für Laravel](/de/packages/laravel-copilot-sdk/index.md)
- [GitHub Actions - GitHub Copilot SDK für Laravel](/de/packages/laravel-copilot-sdk/github-actions.md)
- [Authentifizierung - GitHub Copilot SDK für Laravel](/de/packages/laravel-copilot-sdk/auth.md)
- [Testing - GitHub Copilot SDK für Laravel](/de/packages/laravel-copilot-sdk/fake.md)
- [Erste Schritte - GitHub Copilot SDK für Laravel](/de/packages/laravel-copilot-sdk/getting-started.md)