> ## 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.

# Umgebungsvariablen mit der CLI verwalten

> Liste, setze, entferne oder ersetze die Umgebungsvariablen einer Square Cloud Anwendung mit squarecloud app env, auch direkt aus einer .env-Datei.

`squarecloud app env` verwaltet die Umgebungsvariablen einer Anwendung. Wie deine Anwendung sie liest, erklärt die Seite [Umgebungsvariablen](/de/platform/environment-variables).

`list` erwartet die App-ID als Argument. `set`, `remove` und `replace` verwenden ihre Argumente für Variablen und nehmen die ID daher mit `--app` entgegen. Beides ist optional: siehe [Wie die CLI deine Anwendung findet](/de/cli-reference/quickstart#wie-die-cli-deine-anwendung-findet).

## `squarecloud app env list`

```bash Verwendung theme={"system"}
squarecloud app env list [appID] [--json]
```

Gibt jede Variable als `KEY=value` aus, nach Namen sortiert.

```bash theme={"system"}
squarecloud app env list <appID> --json
# Gibt die Variablen als JSON-Objekt aus.
```

## `squarecloud app env set`

```bash Verwendung theme={"system"}
squarecloud app env set KEY=VALUE... [--from-file <path>] [--app <appID>]
```

| Flag | Beschreibung |
| - | - |
| `--from-file <path>` | Liest Variablen aus einer Datei im `.env`-Format. Argumente der Form `KEY=VALUE` überschreiben gleichnamige Schlüssel aus der Datei. |
| `--app <appID>` | Die Anwendung, die geändert wird. |

Setzt eine oder mehrere Variablen und lässt die übrigen unverändert.

```bash theme={"system"}
squarecloud app env set NODE_ENV=production PORT=80
# Setzt zwei Variablen in der App aus der Zeile ID=.
```

```bash theme={"system"}
squarecloud app env set --from-file .env --app <appID>
# Setzt alle Variablen einer .env-Datei.
```

```bash Ausgabe theme={"system"}
✓ Environment variables set: 2
```

## `squarecloud app env remove`

```bash Verwendung theme={"system"}
squarecloud app env remove KEY... [--app <appID>]
squarecloud app env remove --all [--app <appID>] [-y]
```

**Aliase:** `delete`, `unset`

| Flag | Beschreibung |
| - | - |
| `--all` | Entfernt nach einer Bestätigung alle Variablen der Anwendung. Lässt sich nicht mit Variablennamen kombinieren. |
| `-y`, `--yes` | Überspringt die Bestätigung von `--all`. |
| `--app <appID>` | Die Anwendung, die geändert wird. |

```bash theme={"system"}
squarecloud app env remove API_KEY OLD_FLAG
# Entfernt zwei Variablen.
```

## `squarecloud app env replace`

```bash Verwendung theme={"system"}
squarecloud app env replace KEY=VALUE... [--from-file <path>] [--app <appID>] [-y]
```

| Flag | Beschreibung |
| - | - |
| `--from-file <path>` | Liest Variablen aus einer Datei im `.env`-Format. |
| `-y`, `--yes` | Überspringt die Bestätigungsabfrage. |
| `--app <appID>` | Die Anwendung, die geändert wird. |

Ersetzt die **gesamte** Menge der Variablen durch die übergebenen: Variablen, die du nicht aufführst, werden entfernt. Der Befehl fragt zuerst nach einer `y/N`-Bestätigung und benötigt mindestens eine Variable. Um alle Variablen zu entfernen, verwende `remove --all`.

```bash theme={"system"}
squarecloud app env replace --from-file .env --app <appID> -y
# Setzt die Variablen der App ohne Nachfrage exakt auf die aus .env.
```

## Werte mit Leerzeichen und Sonderzeichen

Deine Anwendung lädt ihre Variablen über eine Shell. Damit sie jeden Wert genau so erhält, wie du ihn eingegeben hast, setzt die CLI Werte in Anführungszeichen, die Leerzeichen oder Zeichen wie `$`, `&`, `;` oder `#` enthalten. `env list` zeigt den gespeicherten Wert dann mit diesen Anführungszeichen.

```bash theme={"system"}
squarecloud app env set 'GREETING=hello world'
# Die Anwendung liest: hello world
```

Ein Wert, den du selbst in ein Paar Anführungszeichen setzt, wird unverändert gesendet, sodass die Shell deiner Anwendung ihn expandieren kann. So baust du einen Wert aus einer anderen Variable zusammen:

```bash theme={"system"}
squarecloud app env set 'API_URL="${HOST}:3000"'
# Die Anwendung liest den Wert von HOST, gefolgt von :3000.
```

## Das Format von `--from-file`

* Ein `KEY=VALUE` pro Zeile. Leere Zeilen, Zeilen, die mit `#` beginnen, und Zeilen ohne `=` werden übersprungen.
* Ein Präfix `export ` ist erlaubt, und ein UTF-8-BOM am Dateianfang wird ignoriert.
* Ein Wert in passenden Anführungszeichen wird so übernommen, wie er zwischen ihnen steht.
* In einem Wert ohne Anführungszeichen ist alles ab ` #` ein Kommentar: `A=foo #bar` setzt `foo`. Setze Werte, die ` #` enthalten, in Anführungszeichen.
* Escape-Sequenzen und Werte über mehrere Zeilen werden nicht unterstützt.

## Siehe auch

| Befehl | API | JavaScript SDK | VS Code |
| - | - | - | - |
| `list` | [`GET .../envs`](/de/api-reference/endpoint/apps/envs/get) | [`api.apps.envs.get()`](/de/sdks/js/environment_variables) | [Umgebungsvariablen](/de/vscode-extension/features#anwendungen) |
| `set` | [`POST .../envs`](/de/api-reference/endpoint/apps/envs/add_n_edit) | [`api.apps.envs.set()`](/de/sdks/js/environment_variables) | [Umgebungsvariablen](/de/vscode-extension/features#anwendungen) |
| `remove` | [`DELETE .../envs`](/de/api-reference/endpoint/apps/envs/remove) | [`api.apps.envs.delete()`](/de/sdks/js/environment_variables) | [Umgebungsvariablen](/de/vscode-extension/features#anwendungen) |
| `replace` | [`PUT .../envs`](/de/api-reference/endpoint/apps/envs/overwrite) | [`api.apps.envs.replace()`](/de/sdks/js/environment_variables) | |