Variáveis de ambiente
As variáveis lidas pelo backend e pelo frontend — quais você configura localmente e quais são injetadas pela Plataforma.
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) |
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.
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) |
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.