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 de ambiente.- Adicionar: escreva o nome e o valor e salve.
- Importar .env: escolha o arquivo
.env(Escolher arquivo) ou cole o conteúdo dele. Ele é lido no navegador, e só as variáveis entram na lista. Linhas com#são comentários e ficam de fora. Escolha entre Mesclar com as que já existem ou Substituir todas.
.env) antes de enviar: elas vão cifradas junto com o envio e chegam ao projeto antes de ele iniciar. Se o seu .zip traz um .env.example e não traz o .env, o painel já põe os nomes dele na lista, com os valores vazios para você preencher (veja O modelo de variáveis não é lido).
- Trocar um valor: digite o novo valor na variável e salve. O valor antigo nunca aparece.
O modelo de variáveis não é lido
O.env.example (e o .env.sample, o .env.template e o example.env) é só um modelo: mostra quais variáveis o código pede. A Cube não lê esse arquivo, e o seu projeto também não: quem lê o .env é o seu código, e só o .env. Quem edita o .env.example e envia o .zip assim sobe o projeto sem nenhuma variável: o código procura o TOKEN, não acha, sai com erro e cai a cada subida, até ficar em Em loop de erro.
Veja um modelo comum:
.env.example
NOME=valor vira uma variável no painel, com o valor de verdade:
1
Envie o .zip no Novo projeto
Ao achar um
.env.example e nenhum .env na raiz do .zip, o painel lista os nomes dele em Variáveis de ambiente, vazios, com a frase “Seu projeto pede estas variáveis. Preencha aqui: o arquivo .env.example é só um modelo e não é lido.” Os valores de exemplo do arquivo nunca são copiados: só os nomes.2
Preencha os valores
Escreva o valor de cada variável. Nomes que a Cube não aceita (veja as regras) ficam de fora, e a variável que você deixar vazia não é enviada.
3
Envie e inicie
O projeto sobe já com as variáveis. Num projeto que já existe, ao enviar um
.zip novo com o .env.example, a confirmação Confira antes de enviar lista as variáveis que ainda faltam e salva o que você preencher antes de enviar..env.example na pasta, o aviso no topo da aba Projeto diz isso e leva direto para Configurações › Variáveis de ambiente (nos planos pagos, que mostram os arquivos do projeto). Veja também O bot caiu 5 vezes seguidas.
Pela API
Use Listar variáveis e Definir variáveis com uma chave com as permissõesvariables:read e variables:write.
Regras
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.

