Repolode
Enviar
motdotla

motdotla/dotenv

Módulo de Node.js sin dependencias que carga variables de entorno de un archivo .env en process.env.

Ver en GitHubSitio web
Estrellas
20,561
Forks
983
Issues abiertos
1
Último commit
hace 9 días

¿Qué es?

dotenv carga pares clave-valor de un archivo .env en process.env en aplicaciones Node.js, para que la configuración y los secretos se mantengan fuera del código fuente, siguiendo el enfoque Twelve-Factor App. El proyecto crea un archivo .env en la raíz, llama a config() lo antes posible y luego lee los valores mediante process.env como de costumbre.

Además del cargador principal, el paquete ofrece parse() para convertir una cadena o un Buffer en un objeto, y populate() para escribir los valores analizados en cualquier objeto de destino. También incluye una CLI de dotenv con el subcomando run, que inyecta variables antes de iniciar un comando y admite varios archivos, las opciones override y quiet, y una opción de parser más rápida.

El paquete no tiene dependencias y funciona con npm, yarn, pnpm, bun y deno. La expansión de variables, la sustitución de comandos y el cifrado no forman parte de este paquete; el README remite a la herramienta complementaria dotenvx para esas funciones.

Funciones clave

  • 01Carga pares clave-valor de .env en process.env con una sola llamada a config().
  • 02Ofrece parse() para convertir una cadena o un Buffer en un objeto.
  • 03Ofrece populate() para escribir valores en un objeto de destino personalizado.
  • 04Incluye una CLI con dotenv run para inyectar variables antes de ejecutar un comando.
  • 05Admite varios archivos env cargados en orden, con la opción de sobrescribir valores.
  • 06No tiene dependencias y funciona con importaciones ESM mediante dotenv/config.

Casos de uso

  • Mantener las claves de API y las URL de bases de datos fuera del código fuente de un servicio Node.js.
  • Usar distintos archivos .env para los entornos local, de pruebas y de producción.
  • Inyectar variables de entorno en comandos de prueba o scripts con dotenv run.
  • Analizar texto con formato env en una herramienta personalizada mediante la función parse().

Inicio rápido

  1. 1

    Instala dotenv con npm

    npm install dotenv --save
  2. 2

    Crea un archivo .env en la raíz del proyecto con tus variables

  3. 3

    Carga dotenv al inicio de la aplicación

  4. 4

    Ejecuta la aplicación con node

    node index.js

Antes de usarlo

  • La expansión de variables y la sustitución de comandos requieren la herramienta independiente dotenvx.
  • Los comentarios empiezan con #, salvo que el valor esté entre comillas. Este cambio rompe la compatibilidad con la versión 15.

En colecciones

Herramientas de CLI y terminal

Temas

#nodejs#environment-variables#configuration#secrets#twelve-factor#javascript#cli#configuration-file#dotenv#env

Preguntas frecuentes

¿Qué es dotenv?
Módulo de Node.js sin dependencias que carga variables de entorno de un archivo .env en process.env. dotenv carga pares clave-valor de un archivo .env en process.env en aplicaciones Node.js, para que la configuración y los secretos se mantengan fuera del código fuente, siguiendo el enfoque Twelve-Factor App. El proyecto crea un archivo .env en la raíz, llama a config() lo antes posible y luego lee los valores mediante process.env como de costumbre.
¿dotenv es gratuito? ¿Qué licencia tiene?
dotenv es open source bajo la licencia BSD-2-Clause. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿dotenv sigue mantenido?
Mantenimiento activo. El último commit de dotenv fue el 29 oct 2026.
¿Para qué puedo usar dotenv?
Mantener las claves de API y las URL de bases de datos fuera del código fuente de un servicio Node.js. Usar distintos archivos .env para los entornos local, de pruebas y de producción. Inyectar variables de entorno en comandos de prueba o scripts con dotenv run. Analizar texto con formato env en una herramienta personalizada mediante la función parse().
¿Cómo se instala dotenv?
Instala dotenv con npm: npm install dotenv --save Crea un archivo .env en la raíz del proyecto con tus variables Carga dotenv al inicio de la aplicación Ejecuta la aplicación con node: node index.js
¿Dónde consigo dotenv?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/motdotla/dotenv

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados