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

# Dateien einer Anwendung mit der CLI verwalten

> Liste, lies, schreibe, verschiebe und lösche Dateien einer laufenden Square Cloud Anwendung mit squarecloud app file, ganz ohne Commit.

`squarecloud app file` ist ein entfernter Dateimanager: Er ändert Dateien direkt in der Anwendung, ohne Commit. Jeder Unterbefehl nimmt die Anwendung mit `--app <appID>` entgegen, was optional ist: siehe [Wie die CLI deine Anwendung findet](/de/cli-reference/quickstart#wie-die-cli-deine-anwendung-findet).

`read` und `write` übertragen Binärdateien unverändert.

## `squarecloud app file list`

```bash Verwendung theme={"system"}
squarecloud app file list [path] [--app <appID>] [--json]
```

Listet einen Ordner der Anwendung auf (das Stammverzeichnis, wenn du `path` weglässt): Typ, Name, Größe und letzte Änderung.

```bash theme={"system"}
squarecloud app file list /logs --app <appID>
# Listet den Ordner logs einer bestimmten App auf.
```

## `squarecloud app file read`

```bash Verwendung theme={"system"}
squarecloud app file read <path> [-o <local file>] [-y] [--app <appID>]
```

| Flag | Beschreibung |
| - | - |
| `-o`, `--output <local file>` | Speichert den Inhalt in einer lokalen Datei, statt ihn auszugeben. Fragt nach, bevor eine vorhandene Datei überschrieben wird. |
| `-y`, `--yes` | Überschreibt eine vorhandene lokale Datei ohne Nachfrage. |
| `--app <appID>` | Die Anwendung, aus der gelesen wird. |

```bash theme={"system"}
squarecloud app file read config.json
# Gibt die Datei auf stdout aus.
```

```bash theme={"system"}
squarecloud app file read config.json -o ./config.backup.json
# Speichert sie lokal.
```

Eine neue lokale Datei, die `-o` anlegt, ist nur für dich lesbar (Berechtigungen 0600), da Anwendungsdateien oft Geheimnisse enthalten.

## `squarecloud app file write`

```bash Verwendung theme={"system"}
squarecloud app file write <path> [--from <local file>] [--app <appID>]
```

| Flag | Beschreibung |
| - | - |
| `--from <local file>` | Liest den Inhalt aus einer lokalen Datei. Ohne dieses Flag stammt der Inhalt aus stdin. |
| `--app <appID>` | Die Anwendung, in die geschrieben wird. |

Erstellt die Datei oder überschreibt sie, wenn sie bereits existiert.

```bash theme={"system"}
squarecloud app file write config.json --from ./config.json
```

```bash theme={"system"}
cat ./config.json | squarecloud app file write config.json --app <appID>
# Schreibt stdin als Dateiinhalt.
```

## `squarecloud app file move`

```bash Verwendung theme={"system"}
squarecloud app file move <path> <new path> [--app <appID>]
```

**Aliase:** `mv`, `rename`

```bash theme={"system"}
squarecloud app file mv old-name.txt new-name.txt
```

## `squarecloud app file delete`

```bash Verwendung theme={"system"}
squarecloud app file delete <path> [-y] [--app <appID>]
```

**Aliase:** `rm`

| Flag | Beschreibung |
| - | - |
| `-y`, `--yes` | Überspringt die Bestätigungsabfrage. |
| `--app <appID>` | Die Anwendung, die geändert wird. |

Fragt nach einer `y/N`-Bestätigung und löscht dann die Datei.

```bash theme={"system"}
squarecloud app file rm old-log.txt -y
```

## Siehe auch

| Befehl | API | JavaScript SDK |
| - | - | - |
| `list` | [`GET .../files`](/de/api-reference/endpoint/apps/filemanager/list) | [`api.apps.files.list()`](/de/sdks/js/managing_files) |
| `read` | [`GET .../files/content`](/de/api-reference/endpoint/apps/filemanager/content) | [`api.apps.files.read()`](/de/sdks/js/managing_files) |
| `write` | [`PUT .../files`](/de/api-reference/endpoint/apps/filemanager/put) | [`api.apps.files.write()`](/de/sdks/js/managing_files) |
| `move` | [`PATCH .../files`](/de/api-reference/endpoint/apps/filemanager/patch) | [`api.apps.files.move()`](/de/sdks/js/managing_files) |
| `delete` | [`DELETE .../files`](/de/api-reference/endpoint/apps/filemanager/delete) | [`api.apps.files.delete()`](/de/sdks/js/managing_files) |

Um einen ganzen Ordner in einem Schritt zu senden, verwende [`squarecloud commit`](/de/cli-reference/deploy#squarecloud-commit).
