Saltar al contenido principal

​
¿Qué es Laravel Cloud CLI?

laravel/cloud-cli es el CLI para operar Laravel Cloud 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.
1

Obtén el repositorio e instala las dependencias

gh repo clone laravel/cloud-cli
cd cloud-cli
composer install
2

Configura el alias `cloud`

zsh:
echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.zshrc
source ~/.zshrc
bash:
echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.bashrc
source ~/.bashrc
3

Configuración manual con una ruta arbitraria

alias cloud="php /path/to/cloud-cli/cloud"

​
Autenticación

Antes de usar la mayoría de comandos, autentícate. 
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. 
cloud auth:token

​
Configuración del repositorio

Si no quieres elegir application o environment cada vez en tu proyecto, ejecuta cloud repo:config. 
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. 
# 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íaEjemplos de comandos principalesUso
Auth / Configcloud auth, cloud auth:token, cloud repo:configAutenticación y configuración por defecto
Applicationcloud application:list, cloud application:createGestión de apps
Environmentcloud environment:list, cloud environment:get, cloud environment:logsInformación del entorno y logs
Deploycloud ship, cloud deploy, cloud deploy:monitorGestión de despliegues
Databasecloud database-cluster:*, cloud database:*, cloud database-snapshot:*Gestión de clusters de BD, BDs y snapshots
Cachecloud cache:list, cloud cache:create, cloud cache:typesGestión de cachés
Bucketcloud bucket:*, cloud bucket-key:*Gestión de almacenamiento de objetos
Domaincloud domain:list, cloud domain:create, cloud domain:verifyConfiguración y verificación de dominios
WebSocketcloud 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. 
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. 
# 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>.
Última modificación el 13 de julio de 2026

Temas relacionados

Cloud SessionsLaravel Cloud — Todo sobre el PaaS específico para Laravellaravel/symfony-on-cloud — Ejecutar aplicaciones Symfony en Laravel CloudLaravel Cloud - GitHub Copilot SDK for Laravellaravel/agent-skills — Colección oficial de skills para agentes de IA de Laravel