Skip to main content
Variáveis de ambiente são pares de nome e valor que o seu projeto lê quando inicia, como o TOKEN do bot ou a URL de um banco. Elas valem em todos os planos, inclusive no Free.

​
Pelo painel

Abra o projeto e vá em Configurações › Variáveis.
  • Adicionar: escreva o nome e o valor e salve.
  • Importar .env: cole o conteúdo de um arquivo .env. Linhas com # são comentários e ficam de fora. Escolha entre Mesclar com as que já existem ou Substituir todas.
  • Trocar um valor: digite o novo valor na variável e salve. O valor antigo nunca aparece.
Depois de salvar, o painel avisa que o projeto recebe as variáveis no próximo início e oferece Reiniciar agora.

​
Pela API

Use Listar variáveis e Definir variáveis com uma chave de leitura e escrita.

​
Regras

Precisa de um valor com várias linhas, como uma chave privada? Guarde em base64 e decodifique no código.

​
O que já vem definido

​
Segurança

Cifradas

Os valores ficam guardados cifrados. Depois de salvos, nunca voltam: nem no painel, nem na API, nem para Cube AI.

Fora da instalação

As variáveis chegam só ao seu app, quando ele inicia. A instalação das dependências e o build não enxergam os valores, então um pacote malicioso não lê o seu token.
Por não chegarem ao build, variáveis que o framework embute durante o build (como as NEXT_PUBLIC_… do Next.js) ficam vazias. Veja a dica em Sites e APIs.
A lista de Atividade registra quem mudou as variáveis e quando, só com os nomes, nunca com os valores.