Digite para filtrar os verbetes do Glossário.

    Ferramentas de desenvolvimento · Developer Workspace

    O que é dotenv?

    Um arquivo dotenv define variáveis em pares de nome e valor. O programa precisa carregá-lo e interpretar os textos recebidos conforme a configuração esperada.

    Também chamado de: arquivo .env, arquivo dotenv

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    Um arquivo com nomes e valores

    Um arquivo dotenv define variáveis de ambiente como pares de nome e valor escritos em texto. O nome habitual é .env. Um mecanismo de carregamento lê o arquivo para disponibilizar suas definições à aplicação, por isso criar o arquivo no diretório não configura automaticamente um processo já em execução.

    O Node.js tem suporte próprio ao formato, que também é usado por bibliotecas e frameworks. Cada implementação determina a sintaxe aceita e a forma de carregar o arquivo.

    Números e booleanos chegam como texto

    Este exemplo didático contém duas configurações que poderiam aparecer num arquivo .env:

    LIMITE=10
    ATIVO=false

    O interpretador do Node.js lê os valores como as strings '10' e 'false'. A aplicação precisa converter o limite para um número e validar o intervalo aceito. Para a opção de ativação, ela pode comparar o texto recebido com 'true', conforme os valores previstos na configuração.

    Usar Boolean('false') em JavaScript produz true, porque a string contém caracteres. Essa conversão pode ativar uma função que você pretendia desativar. A aplicação também precisa tratar uma variável ausente ou com texto inesperado, em vez de aceitar qualquer conteúdo como configuração válida.

    Sintaxe e credenciais

    Não existe uma especificação universal para dotenv. Você precisa conferir o tratamento de aspas e a expansão de referências no carregador usado pelo projeto. Uma variável de teste sem credencial permite verificar o valor recebido sem exibir um segredo no terminal.

    O formato guarda o conteúdo em texto e não oferece criptografia. Um arquivo .env.example pode documentar os nomes esperados, mas precisa conter valores demonstrativos próprios para compartilhamento. A extensão do arquivo não remove uma credencial escrita nele.

    Dúvidas frequentes

    Perguntas frequentes sobre dotenv

    Criar um arquivo .env já configura o processo?
    Não. O processo precisa de um mecanismo de carregamento, oferecido pelo runtime, pelo framework ou por uma biblioteca. Confira como a aplicação localiza e lê esse arquivo.
    O valor false vira um booleano no Node.js?
    Não. O interpretador do Node.js lê esse valor como o texto false. A aplicação precisa convertê-lo explicitamente quando espera um booleano.
    Posso usar a mesma sintaxe em qualquer leitor de dotenv?
    Não há uma especificação universal para o formato. Aspas e referências a outras variáveis podem receber tratamento diferente conforme a implementação utilizada.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Developer Workspace

    A configuração local precisa identificar como o projeto lê as variáveis definidas em arquivos de ambiente.

    Conhecer a formação
    Capa da Formação Developer Workspace

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano