# Variáveis de ambiente

> As variáveis lidas pelo backend e pelo frontend — quais você configura localmente e quais são injetadas pela Plataforma.

> [!IMPORTANT]
> Na plataforma, identidade, credenciais e endpoints de capabilities são **injetados pela publicação**. Não configure manualmente variáveis de Deployment, Central ou capabilities no App.

## Backend — configuradas pelo App (local)

| Variável | Exemplo | Descrição |
|---|---|---|
| `SERVICE_NAME` | `minha-central` | Nome do serviço |
| `SERVICE_VERSION` | `0.1.0` | Versão do App |
| `PORT` | `4000` | Porta HTTP |
| `HOST` | `127.0.0.1` | Bind (somente loopback no local) |
| `NODE_ENV` | `development` | Obrigatório `development` no runtime local |
| `OON_RUNTIME_MODE` | `local` | Ativa o runtime local |
| `MONGO_URI` | `mongodb://localhost:27017/minha-central` | Conexão MongoDB |
| `DB_SERVER`, `DB_NAME`, `DB_USER`, `DB_PASSWORD`, `DB_REPLICA_SET`, `DB_AUTH_SOURCE` | — | Alternativa à `MONGO_URI` |
| `APP_CODE` | `minha-central` | Código do App |
| `OON_LOCAL_HTTPS` | `true` | Adiciona `Secure` aos cookies locais |
| `OON_SECRETS_KEY`, `OON_SECRETS_INSTANCE`, `OON_SECRETS_TENANT` | — | `core.secrets` no local (veja [Segredos](/docs/capabilities/segredos)) |

## Backend — comportamento do runtime

| Variável | Padrão | Descrição |
|---|---|---|
| `APP_ENVIRONMENT` | — | Ambiente lógico: `desenvolvimento`, `homologacao`, `producao` |
| `OON_SYNC_INDEXES` | cria faltantes | `drop` remove não declarados; `false` desliga |
| `OON_USAGE_FLUSH_MS` | `15000` | Intervalo de envio das métricas de uso |
| `OON_DATA_PURGE` | ligado | `false` desliga a exclusão de dados de licenças encerradas |
| `OON_DATA_PURGE_INTERVAL_MS` | 6 h | Intervalo da exclusão |
| `OON_SHUTDOWN_GRACE_MS` | `25000` | Espera antes de encerrar o contêiner |
| `OON_CENTRAL_INVITATIONS_ENABLED` | — | Chave de emergência para convites pela Central |

## Backend — injetadas pela Plataforma

`PUBLIC_APP_URL`, `CENTRAL_ATIVACAO_URL`, `CENTRAL_ATIVACAO_API_URL`, `INSTANCE_CREDENTIAL_ENCRYPTION_KEY`, `AUTH_PROVIDER_TIMEOUT_MS`, `OON_DEPLOYMENT_ID`, `OON_DEPLOYMENT_TOKEN`, `OON_RELEASE_ID`, `OON_BUILD_COMMIT`, `OON_BUILD_TIME`, `OON_CAPABILITY_PDF_RENDERING_*`, `OON_DB_PERFORMANCE_MODE`, `OON_SECRETS_KEY`. Detalhes em [Ativação de instâncias](/docs/fundamentos/ativacao-de-instancias#variaveis-injetadas-pela-publicacao).

## Frontend

| Variável | Descrição |
|---|---|
| `VITE_API_URL` | Base da API (padrão `/api`) |
| `VITE_MEUS_APPS_URL` | Endereço do Meus Apps (desde a 0.7.37 não é usado como login; para login externo, use `auth.loginUrl`) |

> [!DANGER]
> Tudo que começa com `VITE_` vai para o bundle público. A conformance reprova variáveis com `SECRET`, `PASSWORD`, `TOKEN`, `PRIVATE_KEY` ou `API_KEY` no frontend.

## Proibidas no runtime local

`DEV_TOKEN`, `VITE_DEV_TOKEN`, credencial `dev-local`, bind `0.0.0.0`, identidade de Deployment e `PUBLIC_APP_URL` externa.

Fonte: https://sdk.oonapps.com/docs/referencia/variaveis-de-ambiente