> ## 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 – Laravel Cloud vom Terminal aus bedienen

> Wie Sie mit laravel/cloud-cli Anwendungen, Umgebungen, Datenbanken, Domains und mehr auf Laravel Cloud vom Terminal aus verwalten.

## Was ist die Laravel Cloud CLI?

`laravel/cloud-cli` ist die CLI, mit der Sie [Laravel Cloud](https://cloud.laravel.com) 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.

<Steps>
  <Step title="Repository klonen und Abhängigkeiten installieren">
    ```bash theme={null}
    gh repo clone laravel/cloud-cli
    cd cloud-cli
    composer install
    ```
  </Step>

  <Step title="Alias `cloud` einrichten">
    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="Manuelle Konfiguration mit beliebigem Pfad">
    ```bash theme={null}
    alias cloud="php /path/to/cloud-cli/cloud"
    ```
  </Step>
</Steps>

## Authentifizierung

Authentifizieren Sie sich, bevor Sie die meisten Kommandos verwenden.

```bash theme={null}
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`.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
# 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:

| Kategorie     | Beispiele                                                                   | Zweck                                                 |
| ------------- | --------------------------------------------------------------------------- | ----------------------------------------------------- |
| Auth / Config | `cloud auth`, `cloud auth:token`, `cloud repo:config`                       | Authentifizierung und Defaults                        |
| Application   | `cloud application:list`, `cloud application:create`                        | Anwendungsverwaltung                                  |
| Environment   | `cloud environment:list`, `cloud environment:get`, `cloud environment:logs` | Umgebungsinfos und Logs                               |
| Deploy        | `cloud ship`, `cloud deploy`, `cloud deploy:monitor`                        | Deployment-Verwaltung                                 |
| Database      | `cloud database-cluster:*`, `cloud database:*`, `cloud database-snapshot:*` | Verwaltung von DB-Clustern, Datenbanken und Snapshots |
| Cache         | `cloud cache:list`, `cloud cache:create`, `cloud cache:types`               | Cache-Verwaltung                                      |
| Bucket        | `cloud bucket:*`, `cloud bucket-key:*`                                      | Objekt-Storage-Verwaltung                             |
| Domain        | `cloud domain:list`, `cloud domain:create`, `cloud domain:verify`           | Domain-Konfiguration und -Verifikation                |
| WebSocket     | `cloud 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.

```bash theme={null}
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`.

```bash theme={null}
# 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>`.


## Related topics

- [Cloud Sessions](/de/packages/laravel-copilot-sdk/cloud-sessions.md)
- [Laravel Cloud – Der Gesamtüberblick zum Laravel-eigenen PaaS](/de/blog/laravel-cloud.md)
- [laravel/symfony-on-cloud – Symfony-Apps auf Laravel Cloud betreiben](/de/blog/symfony-on-cloud-introduction.md)
- [laravel/agent-skills – Offizielle KI-Agent-Skills-Sammlung von Laravel](/de/blog/agent-skills-introduction.md)
- [Laravel Cloud Hibernation (automatisches Pausieren)](/de/blog/laravel-cloud-hibernation.md)