motdotla/dotenv

O que é?

Recursos principais

• 01Carrega pares de chave e valor de arquivos .env para process.env com uma única chamada a config().
• 02Oferece parse() para converter uma string ou Buffer em um objeto.
• 03Oferece populate() para gravar valores em um objeto de destino personalizado.
• 04Inclui uma CLI com dotenv run para injetar variáveis antes de executar um comando.
• 05Oferece suporte a vários arquivos env carregados em ordem, com opção de override.
• 06Não tem dependências e funciona com imports ESM por meio de dotenv/config.

Casos de uso

• Manter chaves de API e URLs de banco de dados fora do código-fonte de um serviço Node.js.
• Usar arquivos .env diferentes para ambientes locais, de teste e de produção.
• Injetar variáveis de ambiente em comandos de teste ou scripts com dotenv run.
• Analisar texto formatado como env em uma ferramenta personalizada usando a função parse().

Início rápido

1. 1

   Instale dotenv com npm

   npm install dotenv --save
2. 2

   Crie um arquivo .env na raiz do projeto com suas variáveis

3. 3

   Carregue dotenv no início da aplicação

4. 4

   Execute o app com node

   node index.js

Antes de usar

• !A expansão de variáveis e a substituição de comandos exigem a ferramenta separada dotenvx.
• !Os comentários começam em #, a menos que o valor esteja entre aspas. Essa é uma mudança incompatível em relação à v15.

Em coleções

Tópicos

Perguntas frequentes

O que é dotenv?

Módulo Node.js sem dependências que carrega variáveis de ambiente de um arquivo .env para process.env. dotenv carrega pares de chave e valor de um arquivo .env para process.env em aplicações Node.js, permitindo manter configurações e segredos fora do código-fonte, seguindo a abordagem Twelve-Factor App. O projeto cria um arquivo .env na raiz, chama config() o mais cedo possível e, em seguida, acessa os valores normalmente por meio de process.env.

dotenv é gratuito? Qual é a licença?

dotenv é open source sob a licença BSD-2-Clause. Confira os termos da licença antes de usá-lo em produtos comerciais.

dotenv ainda é mantido?

Manutenção ativa. O último commit de dotenv foi em 29 de out. de 2026.

Para que posso usar dotenv?

Manter chaves de API e URLs de banco de dados fora do código-fonte de um serviço Node.js. Usar arquivos .env diferentes para ambientes locais, de teste e de produção. Injetar variáveis de ambiente em comandos de teste ou scripts com dotenv run. Analisar texto formatado como env em uma ferramenta personalizada usando a função parse().

Como instalar dotenv?

Instale dotenv com npm: npm install dotenv --save Crie um arquivo .env na raiz do projeto com suas variáveis Carregue dotenv no início da aplicação Execute o app com node: node index.js

Onde consigo dotenv?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/motdotla/dotenv