Variáveis de ambiente
Variáveis de ambiente servem para configurar sua aplicação sem colocar dados sensíveis no código. Use para URLs, tokens, credenciais, flags e configurações por ambiente.Criar variável
- Abra o projeto no dashboard.
- Acesse a área de variáveis.
- Clique para adicionar uma nova variável.
- Informe chave e valor.
- Marque como secret quando o valor for sensível.
- Salve e faça um novo deploy para aplicar.
Limites e validações
- Você pode salvar até 100 variáveis por projeto por requisição em lote.
- Chaves aceitam apenas letras/números/underscore (regex):
^[A-Z0-9_]+$(case-insensitive).
Campos
Variáveis reservadas (evite sobrescrever)
Algumas variáveis são usadas com frequência pela plataforma e/ou por runtimes. Evite criar variáveis com o mesmo nome com valores incompatíveis:
Se você não tiver certeza se um nome é reservado no seu plano/ambiente, prefira nomes com prefixo do seu app (ex.:
MYAPP_...).
Boas práticas
- Use nomes em caixa alta, como
DATABASE_URL,APP_ENVeAPI_KEY. - Não envie secrets dentro do repositório ou ZIP.
- Faça novo deploy após alterar variáveis usadas pela aplicação.
- Use valores diferentes para teste e produção.