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

# squarecloud app env

> Gerencia as variáveis de ambiente da sua aplicação na Square Cloud.

Lista, define, remove ou substitui as variáveis de ambiente de uma aplicação. Para `list`, o ID da aplicação é opcional e resolvido a partir do argumento, depois do arquivo de configuração `squarecloud.app`, e por fim de um seletor interativo. Para `set`, `remove` e `replace`, passe o ID da aplicação com `--app`, já que os argumentos posicionais são usados para os nomes das variáveis.

```bash theme={null}
squarecloud app env list
# Lista as variáveis de ambiente da app do squarecloud.app ou um seletor interativo.
```

```bash theme={null}
squarecloud app env list <appID> --json
# Lista as variáveis de uma aplicação específica como JSON.
```

```bash theme={null}
squarecloud app env set KEY=VALUE ANOTHER=VALUE --app <appID>
# Define uma ou mais variáveis sem alterar as demais.
```

```bash theme={null}
squarecloud app env set --from-file .env --app <appID>
# Define variáveis lidas a partir de um arquivo no estilo .env.
```

```bash theme={null}
squarecloud app env remove KEY ANOTHER --app <appID>
# Remove uma ou mais variáveis. Aliases: "delete", "unset".
```

```bash theme={null}
squarecloud app env replace KEY=VALUE --app <appID>
# Substitui TODO o conjunto de variáveis pelas fornecidas; as existentes não listadas são removidas.
```

O subcomando `replace` é destrutivo: ele pede confirmação `y/N` antes de apagar as variáveis existentes. Passe `-y`/`--yes` para pular a confirmação.

```bash theme={null}
squarecloud app env replace --from-file .env --app <appID> -y
# Substitui todas as variáveis a partir de um arquivo sem pedir confirmação.
```

Use `squarecloud app env --help` para mais informações sobre este comando.