Como configurar variáveis de ambiente com um arquivo .env em produção

Como configurar variáveis de ambiente com um arquivo .env em produção

Oi! Aqui é a Sensei da GeHost 🌱. Se você chegou até este guia, provavelmente sua aplicação (um projeto Laravel, Node ou outro framework moderno) pede um arquivo .env para funcionar — é ali que ficam as informações sensíveis do seu site, como senha do banco de dados, chaves de API e outras configurações que nunca devem aparecer direto no código. Vamos configurar isso juntos, com calma, passo a passo.

O que é o arquivo .env e por que ele existe

O .env é um arquivo de texto simples que guarda "variáveis de ambiente": pares de chave e valor, como DB_PASSWORD=minhasenha. Em vez de escrever essas informações espalhadas pelo código-fonte, você centraliza tudo em um único arquivo — assim fica mais fácil de manter e, principalmente, mais seguro.

Dica da Sensei: o arquivo .env deve ficar SEMPRE fora do código público (fora de repositórios enviados a serviços externos) e nunca acessível pelo navegador. É informação sensível — trate como uma senha.

Passo 1 — Acesse o Gerenciador de Arquivos

1. Entre no seu cPanel (o acesso fica disponível no seu painel do cliente GeHost).
2. Abra o Gerenciador de Arquivos (File Manager).
3. Navegue até a pasta raiz da sua aplicação — geralmente dentro de public_html ou, em projetos com framework, na pasta principal do projeto (um nível acima da pasta pública, quando possível).

Passo 2 — Crie o arquivo .env

1. Clique em "+ Arquivo" (ou "New File") na barra de ações do Gerenciador de Arquivos.
2. Digite exatamente .env como nome (sim, começando com ponto — isso faz o arquivo ficar "oculto" por padrão em muitos sistemas).
3. Se o Gerenciador de Arquivos não estiver mostrando arquivos ocultos, ative a opção "Mostrar Arquivos Ocultos (dotfiles)" nas configurações da ferramenta para conseguir encontrá-lo depois.

Passo 3 — Preencha as variáveis

Clique com o botão direito no arquivo .env e escolha "Editar". Cada linha do arquivo segue o formato:

NOME_DA_VARIAVEL=valor

Alguns exemplos comuns que aplicações costumam pedir:

• Dados do banco de dados: nome do banco, usuário e senha — você encontra e gerencia isso na tela de Bancos de Dados MySQL do cPanel.
• Ambiente da aplicação: geralmente algo como APP_ENV=production, indicando que o site está no ar (não em desenvolvimento).
• Chaves de serviços externos: e-mail transacional, integrações, APIs de terceiros que o seu projeto utiliza.

Dica da Sensei: cada aplicação (Laravel, Node, etc.) espera um conjunto diferente de variáveis. Consulte a documentação do seu próprio projeto ou o desenvolvedor responsável por ele para saber exatamente quais chaves ele precisa — nós da GeHost cuidamos do servidor, mas as variáveis específicas do seu sistema são definidas por quem construiu a aplicação.

Passo 4 — Proteja o arquivo

1. Nunca deixe o .env dentro de uma pasta acessível diretamente pelo navegador sem proteção. O ideal é que ele fique fora da pasta pública do site (fora de public_html), quando a estrutura do seu projeto permitir.
2. Se precisar mesmo assim mantê-lo dentro de uma pasta pública, peça orientação ao suporte sobre como bloquear o acesso externo a arquivos .env nessa pasta.
3. Confira as permissões do arquivo no Gerenciador de Arquivos (clique com o botão direito → "Permissões") — de forma geral, arquivos sensíveis como esse não devem ter permissão de leitura para "todos" (Others).

Passo 5 — Salve e teste

1. Depois de preencher as variáveis, clique em "Salvar Alterações" no editor do Gerenciador de Arquivos.
2. Acesse seu site normalmente para conferir se tudo carregou certinho.
3. Se a aplicação usa algum processo que precisa ser reiniciado para ler o novo .env (comum em projetos Node, por exemplo), verifique com o desenvolvedor do projeto ou abra um chamado com o nosso suporte para te orientar sobre o seu plano específico.

Dica da Sensei: antes de editar um .env que já está em produção e funcionando, faça uma cópia do arquivo atual (duplique-o no Gerenciador de Arquivos) antes de mexer. Assim, se algo der errado, você volta pro que funcionava em segundos.

Erros comuns (e como evitar)

• Espaços em volta do "=": escreva CHAVE=valor, sem espaços antes ou depois do sinal de igual.
• Valores com espaço ou caracteres especiais: normalmente precisam ser colocados entre aspas, como NOME="Minha Empresa".
• Subir o .env para um repositório público: nunca envie esse arquivo para serviços de versionamento de código acessíveis publicamente — ele deve ficar só no servidor.
• Esquecer de atualizar depois de trocar uma senha de banco: se você alterar a senha do banco de dados no cPanel, lembre de atualizar o mesmo valor no .env, senão a aplicação para de conectar.

Se travar em qualquer passo, chama a gente — é pra isso que estamos aqui. Você tem 30 dias de suporte gratuito após a entrega do seu projeto, e fora esse período nosso time também está disponível para te ajudar. 💚