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

> Explica cómo ejecutar Laravel Copilot SDK en Laravel Cloud: instalación de Copilot CLI, variables de entorno y consideraciones de los modos stdio/TCP.

## Usar en Laravel Cloud

## Instalación

Añade lo siguiente en **Settings > Deployments > Build commands** y despliega:

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

Como la ruta del CLI queda en `/var/www/.local/bin/copilot`, configura lo siguiente en **Custom environment variables**:

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

En `COPILOT_GITHUB_TOKEN` puedes usar cualquier método de autenticación soportado por Copilot CLI: `GH_TOKEN`, `GITHUB_TOKEN`, etc.

Si vas a usar el modo stdio por defecto, con esta instalación es suficiente.

## Operar en modo TCP

En **App cluster > Background processes > Custom worker** configura `/var/www/.local/bin/copilot --headless --port 12345`.
Corre como proceso en segundo plano de forma continua y se reinicia automáticamente en el despliegue.

El número de puerto es libre.

En **Custom environment variables** define `COPILOT_URL`:

```dotenv theme={null}
COPILOT_URL=tcp://127.0.0.1:12345
# En modo TCP, COPILOT_CLI_PATH no es necesario. Si están ambos, tiene prioridad el modo TCP.
```

Al estar siempre en ejecución, consume mucha memoria y puede requerir un servidor con 2 GiB de RAM o más.
Si lo usas dentro de una petición HTTP, es fácil que no termine en 60 segundos y falle, por lo que se recomienda ejecución vía colas.

En Laravel Cloud, el modo TCP no resulta especialmente práctico, por lo que se recomienda usar el modo stdio.

También puedes ejecutarlo en un Worker cluster de un plan superior. Es útil si quieres evitar la falta de memoria del App cluster.

## Consideraciones

* Los servidores más económicos tienden a quedarse sin memoria.
* El timeout HTTP por defecto es de 20 segundos. Si ves muchos fallos, amplíalo hasta 60 segundos como máximo.

<Info>
  Consulta la información más reciente en el [repositorio de GitHub](https://github.com/invokable/laravel-copilot-sdk).
</Info>


## Related topics

- [GitHub Copilot SDK for Laravel](/es/packages/laravel-copilot-sdk/index.md)
- [GitHub Actions - GitHub Copilot SDK for Laravel](/es/packages/laravel-copilot-sdk/github-actions.md)
- [Tests - GitHub Copilot SDK for Laravel](/es/packages/laravel-copilot-sdk/fake.md)
- [Autenticación - GitHub Copilot SDK for Laravel](/es/packages/laravel-copilot-sdk/auth.md)
- [Primeros pasos - GitHub Copilot SDK for Laravel](/es/packages/laravel-copilot-sdk/getting-started.md)