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

# Segredos e variáveis de ambiente

> Armazene configurações de runtime fora do seu código-fonte.

Variáveis de ambiente configuram apps sem precisar reconstruí-los.

## Objetivo

Manter segredos seguros e deploys portáteis.

## Quando usar

Use variáveis de ambiente para URLs de banco, chaves de API, feature flags e credenciais de serviços.

## Exemplo

```json theme={"system"}
{
  "envVars": {
    "NODE_ENV": "production",
    "DATABASE_URL": "postgresql://user:pass@host:5432/db"
  }
}
```

## Regras

* Não commite segredos.
* Use nomes de variáveis claros.
* Rotacione chaves vazadas imediatamente.
* Mantenha valores de produção e desenvolvimento separados.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Gerenciar segredos" icon="key" href="/pt/guides/manage-secrets">
    Atualize variáveis de ambiente do app.
  </Card>

  <Card title="API de ambiente do app" icon="book-open" href="/api-reference/apps#set-environment-variables">
    Veja a referência do endpoint.
  </Card>
</CardGroup>