> ## 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 CLI — Operar Laravel Cloud desde la terminal

> Cómo gestionar apps, entornos, bases de datos, dominios y demás recursos de Laravel Cloud desde la terminal usando laravel/cloud-cli.

## ¿Qué es Laravel Cloud CLI?

`laravel/cloud-cli` es el CLI para operar [Laravel Cloud](https://cloud.laravel.com) desde la terminal.
Esta herramienta está construida con Laravel Zero, y puedes ejecutar mediante el comando `cloud` las operaciones que se hacen en el dashboard.

Con este CLI puedes gestionar de forma unificada aplicaciones, entornos, bases de datos, cachés, buckets, dominios y WebSocket.

## Requisitos

Antes de instalarlo, cumple los siguientes requisitos.

* `PHP 8.2+`
* `Composer`
* `GitHub CLI (gh)` (instalado y autenticado)
* `Git`

## Instalación

Primero, prepara el CLI localmente.

<Steps>
  <Step title="Obtén el repositorio e instala las dependencias">
    ```bash theme={null}
    gh repo clone laravel/cloud-cli
    cd cloud-cli
    composer install
    ```
  </Step>

  <Step title="Configura el alias `cloud`">
    zsh:

    ```bash theme={null}
    echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.zshrc
    source ~/.zshrc
    ```

    bash:

    ```bash theme={null}
    echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.bashrc
    source ~/.bashrc
    ```
  </Step>

  <Step title="Configuración manual con una ruta arbitraria">
    ```bash theme={null}
    alias cloud="php /path/to/cloud-cli/cloud"
    ```
  </Step>
</Steps>

## Autenticación

Antes de usar la mayoría de comandos, autentícate.

```bash theme={null}
cloud auth
```

`cloud auth` abre el navegador y se autentica por OAuth.
Si quieres gestionar un token para CI u otros usos, utiliza `cloud auth:token`.

```bash theme={null}
cloud auth:token
```

## Configuración del repositorio

Si no quieres elegir `application` o `environment` cada vez en tu proyecto, ejecuta `cloud repo:config`.

```bash theme={null}
cloud repo:config
```

Esta configuración guarda valores por defecto en el repositorio Git y permite ejecutar `cloud deploy` y demás con comandos más cortos.

## Despliegue

Es eficiente diferenciar entre el primer despliegue y los despliegues continuos.

```bash theme={null}
# Primera vez: creación y despliegue guiado de la app
cloud ship

# A partir de la segunda vez: desplegar en una app existente
cloud deploy

# Abrir el dashboard
cloud dashboard
```

## Principales categorías de comandos

Resumen de las categorías de uso diario, según la referencia de comandos del README.

| Categoría     | Ejemplos de comandos principales                                            | Uso                                         |
| ------------- | --------------------------------------------------------------------------- | ------------------------------------------- |
| Auth / Config | `cloud auth`, `cloud auth:token`, `cloud repo:config`                       | Autenticación y configuración por defecto   |
| Application   | `cloud application:list`, `cloud application:create`                        | Gestión de apps                             |
| Environment   | `cloud environment:list`, `cloud environment:get`, `cloud environment:logs` | Información del entorno y logs              |
| Deploy        | `cloud ship`, `cloud deploy`, `cloud deploy:monitor`                        | Gestión de despliegues                      |
| Database      | `cloud database-cluster:*`, `cloud database:*`, `cloud database-snapshot:*` | Gestión de clusters de BD, BDs y snapshots  |
| Cache         | `cloud cache:list`, `cloud cache:create`, `cloud cache:types`               | Gestión de cachés                           |
| Bucket        | `cloud bucket:*`, `cloud bucket-key:*`                                      | Gestión de almacenamiento de objetos        |
| Domain        | `cloud domain:list`, `cloud domain:create`, `cloud domain:verify`           | Configuración y verificación de dominios    |
| WebSocket     | `cloud websocket-cluster:*`, `cloud websocket-application:*`                | Gestión de recursos relacionados con Reverb |

## Gestión de variables de entorno

Las variables de entorno se gestionan con `cloud environment:variables`.
Este comando permite manejar de forma conjunta operaciones como append, set o replace.

```bash theme={null}
cloud environment:variables
```

En CI o para la gestión de equipo, usa este comando para unificar el procedimiento de cambios de configuración.

## Comprobación del uso

Puedes revisar la facturación y el uso de recursos con `cloud usage`.

```bash theme={null}
# Uso del mes actual
cloud usage

# Vista detallada
cloud usage --detailed

# Uso del periodo anterior
cloud usage --period=previous
```

Si quieres filtrar por entorno, usa `cloud usage --environment=<id>`.


## Related topics

- [Cloud Sessions](/es/packages/laravel-copilot-sdk/cloud-sessions.md)
- [Laravel Cloud — Todo sobre el PaaS específico para Laravel](/es/blog/laravel-cloud.md)
- [laravel/symfony-on-cloud — Ejecutar aplicaciones Symfony en Laravel Cloud](/es/blog/symfony-on-cloud-introduction.md)
- [Laravel Cloud - GitHub Copilot SDK for Laravel](/es/packages/laravel-copilot-sdk/laravel-cloud.md)
- [laravel/agent-skills — Colección oficial de skills para agentes de IA de Laravel](/es/blog/agent-skills-introduction.md)