Passer au contenu principal

​
Qu’est-ce que Laravel Cloud CLI ?

laravel/cloud-cli est un CLI qui permet de piloter Laravel Cloud depuis le terminal. Basé sur Laravel Zero, il permet d’exécuter les mêmes opérations que le tableau de bord via la commande cloud. Grâce à ce CLI, vous gérez en un seul endroit vos applications, environnements, bases de données, caches, buckets, domaines et WebSockets.

​
Prérequis

Avant l’installation, assurez-vous d’avoir :
  • PHP 8.2+
  • Composer
  • GitHub CLI (gh) (installé et authentifié)
  • Git

​
Installation

Configurez d’abord le CLI en local.
1

Cloner le dépôt et installer les dépendances

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

Définir l'alias `cloud`

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

Configuration manuelle depuis un chemin arbitraire

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

​
Authentification

Authentifiez-vous avant d’utiliser la plupart des commandes. 
cloud auth
cloud auth ouvre le navigateur et authentifie via OAuth. Pour gérer un token (usage CI par exemple), utilisez cloud auth:token. 
cloud auth:token

​
Configuration du dépôt

Si vous ne voulez pas sélectionner application ou environment à chaque fois dans votre projet, exécutez cloud repo:config. 
cloud repo:config
Cette configuration stocke les valeurs par défaut dans le dépôt Git et vous permet d’exécuter cloud deploy et d’autres commandes de manière concise.

​
Déploiement

Il est plus efficace de distinguer le premier déploiement des déploiements suivants. 
# Première fois : création de l'application et déploiement guidés
cloud ship

# Déploiements suivants : déployer sur une application existante
cloud deploy

# Ouvrir le tableau de bord
cloud dashboard

​
Principales catégories de commandes

Voici les catégories usuelles issues de la référence de commandes du README.
CatégorieExemples de commandesRôle
Auth / Configcloud auth, cloud auth:token, cloud repo:configAuthentification et valeurs par défaut
Applicationcloud application:list, cloud application:createGestion des applications
Environmentcloud environment:list, cloud environment:get, cloud environment:logsInformations et logs d’environnement
Deploycloud ship, cloud deploy, cloud deploy:monitorGestion des déploiements
Databasecloud database-cluster:*, cloud database:*, cloud database-snapshot:*Clusters, bases et snapshots
Cachecloud cache:list, cloud cache:create, cloud cache:typesGestion du cache
Bucketcloud bucket:*, cloud bucket-key:*Gestion du stockage objet
Domaincloud domain:list, cloud domain:create, cloud domain:verifyConfiguration et vérification des domaines
WebSocketcloud websocket-cluster:*, cloud websocket-application:*Ressources liées à Reverb

​
Gestion des variables d’environnement

Les variables d’environnement se gèrent avec cloud environment:variables. Cette commande regroupe les opérations append / set / replace. 
cloud environment:variables
Pour la CI ou une utilisation en équipe, uniformisez les modifications via cette commande.

​
Vérification de l’utilisation

Vous pouvez consulter la facturation et l’utilisation des ressources avec cloud usage. 
# Utilisation du mois en cours
cloud usage

# Vue détaillée
cloud usage --detailed

# Période précédente
cloud usage --period=previous
Pour filtrer par environnement, utilisez cloud usage --environment=<id>.
Dernière modification le 13 juillet 2026

Sujets connexes

Laravel Cloud — le PaaS dédié à LaravelCloud SessionsLaravel Saillaravel/symfony-on-cloud — faire tourner une application Symfony sur Laravel CloudLaravel Cloud Hibernation (mise en veille automatique)