# Como configurar variáveis de ambiente do projeto no Deploy

> Na página do projeto, abra a aba Variáveis e clique em Nova variável. Informe nome, valor, se é secret ou public, o ambiente e o momento de uso (build ou runtime). As mudanças valem a partir da próxima publicação.

> **Atenção: este tutorial mexe na segurança da sua conta.** As mudanças descritas aqui são feitas por sua conta e risco. Confira cada passo antes de aplicar.

Variáveis de ambiente são dados que o site usa para funcionar, como senhas, chaves e configurações. Para criar uma, abra o projeto, vá à aba **Variáveis** e clique em **Nova variável**. As mudanças valem a partir da próxima publicação.

## Antes de começar
- Você precisa de um projeto no Deploy e de acesso ao painel em `dash.staycloud.com`.
- Tenha em mãos o nome e o valor de cada variável (por exemplo, `MEU_APP_KEY`).
- Variáveis do tipo **secret** ficam criptografadas, e o valor nunca volta a aparecer no painel. Guarde uma cópia num lugar seguro.

## Abrir a aba Variáveis
1. No menu da esquerda, clique em **Deploy IA**.
   Resultado: abre a página **Projetos**.

![Menu da esquerda com o item Deploy IA destacado](/imagens/0e88ce6e176b5c07d9fe72da3cce14c58ee84261f2a8ed2851fd6c53429284c2.webp)

2. Clique no projeto na lista.
   Resultado: abre a página do projeto, na **Visão geral**.

![Página Projetos com um projeto listado, com o nome e o endereço borrados](/imagens/b0176ec058af3c91dd82b52b9d90f982db6c1e6adc176aa858350ef025960c43.webp)

3. Clique na aba **Variáveis**.
   Resultado: aparece a explicação **O que são variáveis?** e a lista **Variáveis de ambiente**, com filtros **Todas**, **Produção** e **Preview**.

![Topo da página do projeto com a aba Variáveis destacada](/imagens/6bedb4efac782b7321780be90bd9c86a9fcebb374000106a68610dd367b1d63f.webp)

![Aba Variáveis com a explicação O que são variáveis, a lista Variáveis de ambiente vazia e os botões Nova variável e Adicionar primeira variável](/imagens/bebc7b77532de2615a8603231f48ff26c219be8926171dfa9f1899a39da678e9.webp)

## Criar a variável
1. Clique em **Nova variável** (ou em **Adicionar primeira variável**, se a lista estiver vazia).
   Resultado: abre a janela **Nova variável**.
2. Preencha:
   - **Nome**: em maiúsculas, com sublinhado (`UPPERCASE_SNAKE_CASE`), até 64 caracteres.
   - **Valor**: o conteúdo da variável.
   - **Visibility**: **secret** (criptografada, o valor não volta a aparecer) ou **public**.
   - **Environment**: **production** ou **preview**.
   - **Target**: quando a variável é usada: **build**, **runtime** ou **build + runtime**. Secrets não estão disponíveis durante o build.
3. Clique em **criar variável**.
   Resultado: a variável entra na lista e passa a valer na próxima publicação.

![Janela Nova variável com os campos Nome (exemplo MEU_APP_KEY), Valor, Visibility (secret ou public), Environment (production ou preview), Target (build, runtime ou build + runtime) e os botões Cancelar e criar variável](/imagens/effb70f2b5876a8124fc14fb4946bd7f812cb4828a58f428b7cb2884fbab81b4.webp)

## Colar um arquivo .env na criação do projeto
Ao criar um projeto pelo GitHub, a etapa **Configure o projeto** tem, em **Configurações avançadas › Variáveis de ambiente**, os botões **Adicionar variável** e **Colar .env**. Com **Colar .env**, você cola o conteúdo do arquivo `.env` de uma vez, no formato `NOME=valor`, uma por linha.

## Como saber se deu certo
A variável aparece na lista da aba **Variáveis**, e o contador mostra o total de variáveis. Publique uma nova versão do projeto para que ela passe a valer.

## Se algo der errado
### A variável não faz efeito no site
Causa: as alterações valem só a partir da próxima publicação, ou a variável é secret e o projeto precisa dela no build. Solução: publique uma nova versão; se a variável for usada no build, use uma variável public.

## Relacionados
- Como publicar uma nova versão do projeto no Deploy
- Como fazer deploy a partir do GitHub

---
Fonte: https://help.staycloud.com/artigos/como-configurar-variaveis-de-ambiente-do-projeto-no-deploy