> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Globale Flags, Exit-Codes und CI

> Globale Flags, JSON-Ausgabe, Exit-Codes und Debug-Tracing der Square Cloud CLI, dazu der Plattformstatus und der sichere Einsatz in Skripten und CI.

## `squarecloud help`

```bash Verwendung theme={"system"}
squarecloud help [command]
squarecloud [command] --help
```

Listet alle Befehle auf oder erklärt einen einzelnen. Die Hilfe folgt deiner [Systemsprache](/de/cli-reference/installation#sprache).

```bash Ausgabe theme={"system"}
A command line application to manage your Square Cloud applications

Usage:
  squarecloud COMMAND [flags]
  squarecloud [command]

Available Commands:
  app         Manage your applications with these commands
  auth        Manage your Square Cloud login with these commands
  commit      Make a commit for your application
  db          Manage the databases of your account
  help        Help about any command
  status      Check the Square Cloud platform health
  upload      Upload a new application
  workspace   Manage your team workspaces
  zip         Zip the current folder

Flags:
  -h, --help      Show help for this command
      --json      Output raw JSON
  -v, --version   Print the CLI version

Use "squarecloud [command] --help" for more information about a command.
```

## Globale Flags

| Flag | Beschreibung |
| - | - |
| `--json` | Gibt bei Befehlen, die Daten ausgeben (`list`, `info`, `status`, `logs`, `auth whoami`, `upload`, ...), rohes, maschinenlesbares JSON aus. Befehle ohne JSON-Ausgabe (`app start`, `app delete`, `commit`, `zip`, ...) lehnen das Flag mit einem Fehler ab. |
| `-h`, `--help` | Zeigt die Hilfe zu jedem Befehl. |
| `-v`, `--version` | Gibt die Version der CLI aus. Nur bei `squarecloud` selbst. |

Destruktive Befehle akzeptieren außerdem `-y`/`--yes`, um ihre `y/N`-Bestätigung zu überspringen. Die Seiten der einzelnen Befehle führen das jeweils auf.

## `squarecloud status`

```bash Verwendung theme={"system"}
squarecloud status [--json]
```

Prüft, ob die Square Cloud Plattform normal arbeitet. Der Befehl funktioniert ohne Anmeldung. Für eine einzelne Anwendung oder Datenbank verwende [`squarecloud app status`](/de/cli-reference/status-and-metrics#squarecloud-app-status) oder [`squarecloud db status`](/de/cli-reference/databases#squarecloud-db-status).

```bash Ausgabe theme={"system"}
✓ <status message>
```

Meldet die Plattform ein Problem, beginnt die Zeile stattdessen mit `X`. Siehe auch die [Statusseite](https://status.squarecloud.app/).

## Debugging

* Setze **`SQUARECLOUD_DEBUG=1`**, um jede API-Anfrage auf stderr zu protokollieren: Methode, Pfad, Status und Dauer. Header, Query-Strings und Bodys werden nie protokolliert, sodass du die Ausgabe gefahrlos teilen kannst.
* Leseanfragen werden nach einem Netzwerkfehler oder bei kurzzeitiger Überlastung der Plattform automatisch wiederholt.
* **Ctrl+C** bricht die laufende Anfrage ab; ein zweites Ctrl+C beendet einen Befehl, der auf eine Eingabe wartet.

```bash theme={"system"}
SQUARECLOUD_DEBUG=1 squarecloud app list
```

## Skripte und CI

Die CLI verhält sich vorhersehbar, wenn niemand an der Tastatur sitzt:

* **Authentifizierung:** Setze `SQUARECLOUD_API_KEY`, statt `auth login` auszuführen. Siehe [Authentifizierung](/de/cli-reference/authentication#ci-und-skripte).
* **Übergib IDs explizit.** Die Auswahllisten für Anwendungen und Datenbanken benötigen ein Terminal. Siehe [Wie die CLI deine Anwendung findet](/de/cli-reference/quickstart#wie-die-cli-deine-anwendung-findet).
* **Exit-Codes:** Jeder Fehler endet mit Code `1`, auch wenn die CLI über npm installiert wurde. Prüfe Exit-Codes, nicht den Meldungstext.
* **Bestätigungen schlagen sicher fehl.** Wer mit Nein antwortet oder einen Befehl mit Bestätigung ohne Terminal und ohne `-y` ausführt, erhält Exit-Code `1`, und nichts wird geändert. Nachfragende Befehle sind `app delete`, `app env replace`, `app env remove --all`, `app file delete`, `app file read -o` über eine vorhandene Datei, `app network purge-cache`, `app snapshot restore`, `db delete`, `db snapshot restore`, `db credentials reset`, `workspace delete`, `workspace leave`, `workspace member remove` und `auth login`, wenn es den Schlüssel eines anderen Kontos ersetzen würde.
* **stdout enthält nur Ergebnisse.** Fehler, die Meldung "not logged in", Bestätigungsabfragen, Fehlerzeilen und der Update-Hinweis gehen nach stderr. Mit `upload --json` gehen auch Fortschrittsmeldungen nach stderr.
* **Werte `--json` aus, nicht Tabellen.** Auf nicht englischen Systemen werden Tabellenköpfe und `info`-Beschriftungen übersetzt. Um Englisch zu erzwingen, führe die CLI mit `LC_ALL=en_US.UTF-8` aus.
* **Bereits im Zielzustand gilt als Erfolg.** Das Starten einer laufenden Anwendung oder Datenbank oder das Stoppen einer gestoppten wird gemeldet und endet mit Code `0`.

Für Deploys aus GitHub Actions siehe den [automatisierten Deploy-Workflow](https://help.squarecloud.app/en-us/article/workflow-github-actions-automated-deploy-ff34mk/) im Hilfe-Center.

## Siehe auch

| Befehl | API | JavaScript SDK |
| - | - | - |
| `status` | [`GET /v2/service/status`](/de/api-reference/endpoint/service/status) | [`api.service.status()`](/de/sdks/js/client) |