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

# Gestire i file delle app dalla CLI

> Elenca, leggi, scrivi, sposta ed elimina i file di un'app Square Cloud in esecuzione con squarecloud app file, senza commit. I file binari restano intatti.

`squarecloud app file` è un gestore di file remoto: modifica i file direttamente nell'applicazione, senza un commit. Ogni sottocomando accetta l'applicazione con `--app <appID>`, che è facoltativo: vedi [come la CLI trova la tua app](/it/cli-reference/quickstart#come-la-cli-trova-la-tua-app).

`read` e `write` trasferiscono i file binari senza modificarli.

## `squarecloud app file list`

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

Elenca una cartella dell'applicazione (la radice quando ometti `path`): tipo, nome, dimensione e ultima modifica.

```bash theme={"system"}
squarecloud app file list /logs --app <appID>
# Elenca la cartella logs di un'app specifica.
```

## `squarecloud app file read`

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

| Flag | Descrizione |
| - | - |
| `-o`, `--output <local file>` | Salva il contenuto in un file locale invece di stamparlo. Chiede conferma prima di sovrascrivere un file esistente. |
| `-y`, `--yes` | Sovrascrive un file locale esistente senza chiedere. |
| `--app <appID>` | L'applicazione da cui leggere. |

```bash theme={"system"}
squarecloud app file read config.json
# Stampa il file su stdout.
```

```bash theme={"system"}
squarecloud app file read config.json -o ./config.backup.json
# Lo salva in locale.
```

Un nuovo file locale creato da `-o` è leggibile solo da te (permessi 0600), perché i file delle applicazioni contengono spesso dei segreti.

## `squarecloud app file write`

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

| Flag | Descrizione |
| - | - |
| `--from <local file>` | Legge il contenuto da un file locale. Senza questo flag, il contenuto arriva da stdin. |
| `--app <appID>` | L'applicazione in cui scrivere. |

Crea il file, oppure lo sovrascrive se esiste.

```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>
# Scrive stdin come contenuto del file.
```

## `squarecloud app file move`

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

**Alias:** `mv`, `rename`

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

## `squarecloud app file delete`

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

**Alias:** `rm`

| Flag | Descrizione |
| - | - |
| `-y`, `--yes` | Salta la richiesta di conferma. |
| `--app <appID>` | L'applicazione da modificare. |

Chiede una conferma `y/N`, poi elimina il file.

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

## Correlati

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

Per inviare un'intera cartella in un solo passaggio, usa [`squarecloud commit`](/it/cli-reference/deploy#squarecloud-commit).