Zum Hauptinhalt springen

​
Was ist die Laravel Cloud CLI?

laravel/cloud-cli ist die CLI, mit der Sie Laravel Cloud vom Terminal aus steuern.
Sie ist mit Laravel Zero gebaut und lässt Sie die Aktionen des Dashboards über den Befehl cloud ausführen. Mit dieser CLI verwalten Sie Anwendungen, Umgebungen, Datenbanken, Cache, Buckets, Domains, WebSockets u. v. m. an einer Stelle.

​
Voraussetzungen

Erfüllen Sie vor der Einführung folgende Voraussetzungen:
  • PHP 8.2+
  • Composer
  • GitHub CLI (gh) (installiert und authentifiziert)
  • Git

​
Installation

Richten Sie die CLI zunächst lokal ein.
1

Repository klonen und Abhängigkeiten installieren

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

Alias `cloud` einrichten

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

Manuelle Konfiguration mit beliebigem Pfad

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

​
Authentifizierung

Authentifizieren Sie sich, bevor Sie die meisten Kommandos verwenden. 
cloud auth
cloud auth öffnet den Browser und authentifiziert per OAuth.
Wenn Sie für CI oder ähnliches ein Token verwalten möchten, nutzen Sie cloud auth:token. 
cloud auth:token

​
Repository-Konfiguration

Wenn Sie in Ihrem Projekt nicht jedes Mal application und environment auswählen möchten, führen Sie cloud repo:config aus. 
cloud repo:config
Diese Konfiguration speichert die Defaults im Git-Repository, sodass Sie cloud deploy und andere Kommandos in Kurzform ausführen können.

​
Deployment

Es ist effizient, Erst-Deployment und laufende Deployments zu trennen. 
# Erstmalig: geführte App-Erstellung und Deployment
cloud ship

# Ab dem zweiten Mal: Deployment einer bestehenden App
cloud deploy

# Dashboard öffnen
cloud dashboard

​
Wichtige Kommando-Kategorien

Aus der Kommando-Referenz der README die Kategorien für den täglichen Gebrauch:
KategorieBeispieleZweck
Auth / Configcloud auth, cloud auth:token, cloud repo:configAuthentifizierung und Defaults
Applicationcloud application:list, cloud application:createAnwendungsverwaltung
Environmentcloud environment:list, cloud environment:get, cloud environment:logsUmgebungsinfos und Logs
Deploycloud ship, cloud deploy, cloud deploy:monitorDeployment-Verwaltung
Databasecloud database-cluster:*, cloud database:*, cloud database-snapshot:*Verwaltung von DB-Clustern, Datenbanken und Snapshots
Cachecloud cache:list, cloud cache:create, cloud cache:typesCache-Verwaltung
Bucketcloud bucket:*, cloud bucket-key:*Objekt-Storage-Verwaltung
Domaincloud domain:list, cloud domain:create, cloud domain:verifyDomain-Konfiguration und -Verifikation
WebSocketcloud websocket-cluster:*, cloud websocket-application:*Verwaltung Reverb-nahen Ressourcen

​
Verwaltung von Umgebungsvariablen

Umgebungsvariablen werden mit cloud environment:variables verwaltet.
Der Befehl unterstützt Operationen wie append, set und replace in einem Aufruf. 
cloud environment:variables
Für CI und Teamworkflows sollten Sie mit diesem Kommando die Vorgehensweise für Konfigurationsänderungen vereinheitlichen.

​
Nutzung prüfen

Kosten und Ressourcennutzung prüfen Sie mit cloud usage. 
# Nutzung des aktuellen Monats
cloud usage

# Detailansicht
cloud usage --detailed

# Nutzung der Vorperiode
cloud usage --period=previous
Für eine Einschränkung pro Umgebung verwenden Sie cloud usage --environment=<id>.
Zuletzt geändert am 13. Juli 2026

Verwandte Themen

Cloud SessionsLaravel Cloud – Der Gesamtüberblick zum Laravel-eigenen PaaSlaravel/symfony-on-cloud – Symfony-Apps auf Laravel Cloud betreibenlaravel/agent-skills – Offizielle KI-Agent-Skills-Sammlung von LaravelLaravel Cloud Hibernation (automatisches Pausieren)