{"id":13455167,"url":"https://github.com/motdotla/dotenv","last_synced_at":"2025-05-12T15:09:27.673Z","repository":{"id":9353800,"uuid":"11205780","full_name":"motdotla/dotenv","owner":"motdotla","description":"Loads environment variables from .env for nodejs projects.","archived":false,"fork":false,"pushed_at":"2025-04-17T00:51:15.000Z","size":1612,"stargazers_count":19691,"open_issues_count":5,"forks_count":871,"subscribers_count":107,"default_branch":"master","last_synced_at":"2025-05-05T09:56:57.543Z","etag":null,"topics":["configuration-file","dotenv","env","environment-variables","javascript","node","nodejs","secret-management","secret-manager","secrets","security-tools"],"latest_commit_sha":null,"homepage":"https://www.dotenvx.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/motdotla.png","metadata":{"files":{"readme":"README-es.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"motdotla","custom":"https://www.dotenvx.com"}},"created_at":"2013-07-05T18:25:05.000Z","updated_at":"2025-05-05T07:34:10.000Z","dependencies_parsed_at":"2023-11-11T22:02:23.840Z","dependency_job_id":"66586bc1-4161-4de8-9321-2157fd6d27c5","html_url":"https://github.com/motdotla/dotenv","commit_stats":{"total_commits":559,"total_committers":97,"mean_commits":5.762886597938144,"dds":"0.38640429338103754","last_synced_commit":"8ab33066f90a20445d3c41e4fafba6c929c5e1a5"},"previous_names":[],"tags_count":81,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/motdotla%2Fdotenv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/motdotla%2Fdotenv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/motdotla%2Fdotenv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/motdotla%2Fdotenv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/motdotla","download_url":"https://codeload.github.com/motdotla/dotenv/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252486917,"owners_count":21755835,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["configuration-file","dotenv","env","environment-variables","javascript","node","nodejs","secret-management","secret-manager","secrets","security-tools"],"created_at":"2024-07-31T08:01:01.975Z","updated_at":"2025-05-05T12:35:11.908Z","avatar_url":"https://github.com/motdotla.png","language":"JavaScript","readme":"\u003cdiv align=\"center\"\u003e\n🎉 announcing \u003ca href=\"https://github.com/dotenvx/dotenvx\"\u003edotenvx\u003c/a\u003e. \u003cem\u003erun anywhere, multi-environment, encrypted envs\u003c/em\u003e.\n\u003c/div\u003e\n\n\u0026nbsp;\n\n\u003cdiv align=\"center\"\u003e\n\n\u003cp\u003e\n  \u003csup\u003e\n    \u003ca href=\"https://github.com/sponsors/motdotla\"\u003eDotenv es apoyado por la comunidad.\u003c/a\u003e\n  \u003c/sup\u003e\n\u003c/p\u003e\n\u003csup\u003eGracias espaciales a:\u003c/sup\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\u003ca href=\"https://www.warp.dev/?utm_source=github\u0026utm_medium=referral\u0026utm_campaign=dotenv_p_20220831\"\u003e\n  \u003cdiv\u003e\n    \u003cimg src=\"https://res.cloudinary.com/dotenv-org/image/upload/v1661980709/warp_hi8oqj.png\" width=\"230\" alt=\"Warp\"\u003e\n  \u003c/div\u003e\n  \u003cb\u003eWarp is a blazingly fast, Rust-based terminal reimagined to work like a modern app.\u003c/b\u003e\n  \u003cdiv\u003e\n    \u003csup\u003eGet more done in the CLI with real text editing, block-based output, and AI command search.\u003c/sup\u003e\n  \u003c/div\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\n\u003ca href=\"https://graphite.dev/?utm_source=github\u0026utm_medium=repo\u0026utm_campaign=dotenv\"\u003e\u003cimg src=\"https://res.cloudinary.com/dotenv-org/image/upload/v1744035073/graphite_lgsrl8.gif\" width=\"240\" alt=\"Graphite\" /\u003e\u003c/a\u003e\n\n\u003ca href=\"https://graphite.dev/?utm_source=github\u0026utm_medium=repo\u0026utm_campaign=dotenv\"\u003e\n  \u003cb\u003eGraphite is the AI developer productivity platform helping teams on GitHub ship higher quality software, faster.\u003c/b\u003e\n\u003c/a\u003e\n\u003chr\u003e\n\u003c/div\u003e\n\n# dotenv [![NPM version](https://img.shields.io/npm/v/dotenv.svg?style=flat-square)](https://www.npmjs.com/package/dotenv)\n\n\u003cimg src=\"https://raw.githubusercontent.com/motdotla/dotenv/master/dotenv.svg\" alt=\"dotenv\" align=\"right\" width=\"200\" /\u003e\n\nDotenv es un módulo de dependencia cero que carga las variables de entorno desde un archivo `.env` en [`process.env`](https://nodejs.org/docs/latest/api/process.html#process_process_env). El almacenamiento de la configuración del entorno separado del código está basado en la metodología [The Twelve-Factor App](http://12factor.net/config).\n\n[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/feross/standard)\n[![LICENSE](https://img.shields.io/github/license/motdotla/dotenv.svg)](LICENSE)\n\n## Instalación\n\n```bash\n# instalación local (recomendado)\nnpm install dotenv --save\n```\n\nO installación con yarn? `yarn add dotenv`\n\n## Uso\n\nCree un archivo `.env` en la raíz de su proyecto:\n\n```dosini\nS3_BUCKET=\"YOURS3BUCKET\"\nSECRET_KEY=\"YOURSECRETKEYGOESHERE\"\n```\n\nTan prónto como sea posible en su aplicación, importe y configure dotenv:\n\n```javascript\nrequire('dotenv').config()\nconsole.log(process.env) // elimine esto después que haya confirmado que esta funcionando\n```\n\n.. o usa ES6?\n\n```javascript\nimport * as dotenv from 'dotenv' // vea en https://github.com/motdotla/dotenv#como-uso-dotenv-con-import\n// REVISAR LINK DE REFERENCIA DE IMPORTACIÓN\ndotenv.config()\nimport express from 'express'\n```\n\nEso es todo. `process.env` ahora tiene las claves y los valores que definiste en tu archivo `.env`:\n\n```javascript\nrequire('dotenv').config()\n\n...\n\ns3.getBucketCors({Bucket: process.env.S3_BUCKET}, function(err, data) {})\n```\n\n### Valores multilínea\n\nSi necesita variables de varias líneas, por ejemplo, claves privadas, ahora se admiten en la versión (`\u003e= v15.0.0`) con saltos de línea:\n\n```dosini\nPRIVATE_KEY=\"-----BEGIN RSA PRIVATE KEY-----\n...\nKh9NV...\n...\n-----END RSA PRIVATE KEY-----\"\n```\n\nAlternativamente, puede usar comillas dobles y usar el carácter `\\n`:\n\n```dosini\nPRIVATE_KEY=\"-----BEGIN RSA PRIVATE KEY-----\\nKh9NV...\\n-----END RSA PRIVATE KEY-----\\n\"\n```\n\n### Comentarios\n\nLos comentarios pueden ser agregados en tu archivo o en la misma línea:\n\n```dosini\n# This is a comment\nSECRET_KEY=YOURSECRETKEYGOESHERE # comment\nSECRET_HASH=\"something-with-a-#-hash\"\n```\n\nLos comentarios comienzan donde existe un `#`, entonces, si su valor contiene un `#`, enciérrelo entre comillas. Este es un cambio importante desde la versión `\u003e= v15.0.0` en adelante.\n\n### Análisis\n\nEl motor que analiza el contenido de su archivo que contiene variables de entorno está disponible para su uso. Este Acepta una Cadena o un Búfer y devolverá un Objeto con las claves y los valores analizados.\n\n```javascript\nconst dotenv = require('dotenv')\nconst buf = Buffer.from('BASICO=basico')\nconst config = dotenv.parse(buf) // devolverá un objeto\nconsole.log(typeof config, config) // objeto { BASICO : 'basico' }\n```\n\n### Precarga\n\nPuede usar el `--require` (`-r`) [opción de línea de comando](https://nodejs.org/api/cli.html#-r---require-module) para precargar dotenv. Al hacer esto, no necesita requerir ni cargar dotnev en el código de su aplicación.\n\n```bash\n$ node -r dotenv/config tu_script.js\n```\n\nLas opciones de configuración a continuación se admiten como argumentos de línea de comandos en el formato `dotenv_config_\u003coption\u003e=value`\n\n```bash\n$ node -r dotenv/config tu_script.js dotenv_config_path=/custom/path/to/.env dotenv_config_debug=true\n```\n\nAdemás, puede usar variables de entorno para establecer opciones de configuración. Los argumentos de línea de comandos precederán a estos.\n\n```bash\n$ DOTENV_CONFIG_\u003cOPTION\u003e=value node -r dotenv/config tu_script.js\n```\n\n```bash\n$ DOTENV_CONFIG_ENCODING=latin1 DOTENV_CONFIG_DEBUG=true node -r dotenv/config tu_script.js dotenv_config_path=/custom/path/to/.env\n```\n\n### Expansión Variable\n\nNecesitaras agregar el valor de otro variable en una de sus variables? Usa [dotenv-expand](https://github.com/motdotla/dotenv-expand).\n\n### Sincronizando\n\nNecesitas mentener sincronizados los archivos `.env` entre maquinas, entornos, o miembros del equipo? Usa \n[dotenv-vault](https://github.com/dotenv-org/dotenv-vault).\n\n## Ejemplos\n\nVea [ejemplos](https://github.com/dotenv-org/examples) sobre el uso de dotenv con varios frameworks, lenguajes y configuraciones.\n\n* [nodejs](https://github.com/dotenv-org/examples/tree/master/dotenv-nodejs)\n* [nodejs (depurar en)](https://github.com/dotenv-org/examples/tree/master/dotenv-nodejs-debug)\n* [nodejs (anular en)](https://github.com/dotenv-org/examples/tree/master/dotenv-nodejs-override)\n* [esm](https://github.com/dotenv-org/examples/tree/master/dotenv-esm)\n* [esm (precarga)](https://github.com/dotenv-org/examples/tree/master/dotenv-esm-preload)\n* [typescript](https://github.com/dotenv-org/examples/tree/master/dotenv-typescript)\n* [typescript parse](https://github.com/dotenv-org/examples/tree/master/dotenv-typescript-parse)\n* [typescript config](https://github.com/dotenv-org/examples/tree/master/dotenv-typescript-config)\n* [webpack](https://github.com/dotenv-org/examples/tree/master/dotenv-webpack)\n* [webpack (plugin)](https://github.com/dotenv-org/examples/tree/master/dotenv-webpack2)\n* [react](https://github.com/dotenv-org/examples/tree/master/dotenv-react)\n* [react (typescript)](https://github.com/dotenv-org/examples/tree/master/dotenv-react-typescript)\n* [express](https://github.com/dotenv-org/examples/tree/master/dotenv-express)\n* [nestjs](https://github.com/dotenv-org/examples/tree/master/dotenv-nestjs)\n\n## Documentación\n\nDotenv expone dos funciones:\n\n* `configuración`\n* `analizar`\n\n### Configuración\n\n`Configuración` leerá su archivo `.env`, analizará el contenido, lo asignará a [`process.env`](https://nodejs.org/docs/latest/api/process.html#process_process_env),\ny devolverá un Objeto con una clave `parsed` que contiene el contenido cargado o una clave `error` si falla.\n\n```js\nconst result = dotenv.config()\n\nif (result.error) {\n  throw result.error\n}\n\nconsole.log(result.parsed)\n```\n\nAdicionalmente, puede pasar opciones a `configuracion`.\n\n#### Opciones\n\n##### Ruta\n\nPor defecto: `path.resolve(process.cwd(), '.env')`\n\nEspecifique una ruta personalizada si el archivo que contiene las variables de entorno se encuentra localizado en otro lugar.\n\n```js\nrequire('dotenv').config({ path: '/personalizado/ruta/a/.env' })\n```\n\n##### Codificación\n\nPor defecto: `utf8`\n\nEspecifique la codificación del archivo que contiene las variables de entorno.\n\n```js\nrequire('dotenv').config({ encoding: 'latin1' })\n```\n\n##### Depurar\n\nPor defecto: `false`\n\nActive el registro de ayuda para depurar por qué ciertas claves o valores no se inician como lo esperabas.\n\n```js\nrequire('dotenv').config({ debug: process.env.DEBUG })\n```\n\n##### Anular\n\nPor defecto: `false`\n\nAnule cualquier variable de entorno que ya se haya configurada en su maquina con los valores de su archivo .env.\n\n```js\nrequire('dotenv').config({ override: true })\n```\n\n### Analizar\n\nEl motor que analiza el contenido del archivo que contiene las variables de entorno está disponible para su uso. Acepta una Cadena o un Búfer y retornará un objecto con los valores analizados.\n\n```js\nconst dotenv = require('dotenv')\nconst buf = Buffer.from('BASICO=basico')\nconst config = dotenv.parse(buf) // devolverá un objeto\nconsole.log(typeof config, config) // objeto { BASICO : 'basico' }\n```\n\n#### Opciones\n\n##### Depurar\n\nPor defecto: `false`\n\nActive el registro de ayuda para depurar por qué ciertas claves o valores no se inician como lo esperabas.\n\n```js\nconst dotenv = require('dotenv')\nconst buf = Buffer.from('hola mundo')\nconst opt = { debug: true }\nconst config = dotenv.parse(buf, opt)\n// espere por un mensaje de depuración porque el búfer no esta listo KEY=VAL\n```\n\n## FAQ\n\n### ¿Por qué el archivo `.env` no carga mis variables de entorno correctamente?\n\nLo más probable es que su archivo `.env` no esté en el lugar correcto. [Vea este stack overflow](https://stackoverflow.com/questions/42335016/dotenv-file-is-not-loading-environment-variables).\n\nActive el modo de depuración y vuelva a intentarlo...\n\n```js\nrequire('dotenv').config({ debug: true })\n```\n\nRecibirá un error apropiado en su consola.\n\n### ¿Debo confirmar mi archivo `.env`?\n\nNo. Recomendamos **enfáticamente** no enviar su archivo `.env` a la versión de control. Solo debe incluir los valores especificos del entorno, como la base de datos, contraseñas o claves API.\n\n### ¿Debería tener multiples archivos `.env`?\n\nNo. Recomendamos **enfáticamente** no tener un archivo `.env` \"principal\" y un archivo `.env` de \"entorno\" como `.env.test`. Su configuración debe variar entre implementaciones y no debe compartir valores entre entornos.\n\n\u003e En una Aplicación de Doce Factores, las variables de entorno son controles diferenciados, cada uno totalmente independiente a otras variables de entorno. Nunca se agrupan como \"entornos\", sino que se gestionan de manera independiente para cada despliegue. Este es un modelo que se escala sin problemas a medida que la aplicación se expande de forma natural en más despliegues a lo largo de su vida.\n\u003e\n\u003e – [La Apliación de los Doce Factores](https://12factor.net/es/)\n\n### ¿Qué reglas sigue el motor de análisis?\n\nEl motor de análisis actualmente admite las siguientes reglas:\n\n- `BASICO=basico` se convierte en `{BASICO: 'basico'}`\n- las líneas vacías se saltan\n- las líneas que comienzan con `#` se tratan como comentarios\n- `#` marca el comienzo de un comentario (a menos que el valor esté entre comillas)\n- valores vacíos se convierten en cadenas vacías (`VACIO=` se convierte en `{VACIO: ''}`)\n- las comillas internas se mantienen (piensa en JSON) (`JSON={\"foo\": \"bar\"}` se convierte en `{JSON:\"{\\\"foo\\\": \\\"bar\\\"}\"`)\n- los espacios en blanco se eliminan de ambos extremos de los valores no citanos (aprende más en [`trim`](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/String/Trim)) (`FOO=  algo ` se convierte en `{FOO: 'algo'}`)\n- los valores entre comillas simples y dobles se escapan (`CITA_SIMPLE='citado'` se convierte en `{CITA_SIMPLE: \"citado\"}`)\n- los valores entre comillas simples y dobles mantienen los espacios en blanco en ambos extremos  (`FOO=\"  algo  \"` se convierte en `{FOO: '  algo  '}`)\n- los valores entre comillas dobles expanden nuevas líneas (`MULTILINEA=\"nueva\\nlínea\"` se convierte en\n\n```\n{MULTILINEA: 'nueva\nlínea'}\n```\n\n- se admite la comilla simple invertida (`` SIGNO_ACENTO=`Esto tiene comillas 'simples' y \"dobles\" en su interior.` ``)\n\n### ¿Qué sucede con las variables de entorno que ya estaban configuradas?\n\nPor defecto, nunca modificaremos ninguna variable de entorno que ya haya sido establecida. En particular, si hay una variable en su archivo `.env` que colisiona con una que ya existe en su entorno, entonces esa variable se omitirá.\n\nSi por el contrario, quieres anular `process.env` utiliza la opción `override`.\n\n```javascript\nrequire('dotenv').config({ override: true })\n```\n\n### ¿Por qué mis variables de entorno no aparecen para React?\n\nSu código React se ejecuta en Webpack, donde el módulo `fs` o incluso el propio `process` global no son accesibles fuera-de-la-caja. El módulo `process.env` sólo puede ser inyectado a través de la configuración de Webpack.\n\nSi estás usando [`react-scripts`](https://www.npmjs.com/package/react-scripts), el cual se distribuye a través de [`create-react-app`](https://create-react-app.dev/), tiene dotenv incorporado pero con una singularidad. Escriba sus variables de entorno con `REACT_APP_`. Vea [este stack overflow](https://stackoverflow.com/questions/42182577/is-it-possible-to-use-dotenv-in-a-react-project) para más detalles.\n\nSi estás utilizando otros frameworks (por ejemplo, Next.js, Gatsby...), debes consultar su documentación para saber cómo injectar variables de entorno en el cliente.\n\n### ¿Puedo personalizar/escribir plugins para dotenv?\n\nSí! `dotenv.config()` devuelve un objeto que representa el archivo `.env` analizado. Esto te da todo lo que necesitas para poder establecer valores en `process.env`. Por ejemplo:\n\n```js\nconst dotenv = require('dotenv')\nconst variableExpansion = require('dotenv-expand')\nconst miEnv = dotenv.config()\nvariableExpansion(miEnv)\n```\n\n### Cómo uso dotnev con `import`?\n\nSimplemente..\n\n```javascript\n// index.mjs (ESM)\nimport * as dotenv from 'dotenv' // vea https://github.com/motdotla/dotenv#como-uso-dotenv-con-import\ndotenv.config()\nimport express from 'express'\n```\n\nUn poco de historia...\n\n\u003e Cuando se ejecuta un módulo que contiene una sentencia `import`, los módulos que importa serán cargados primero, y luego se ejecuta cada bloque del módulo en un recorrido en profundidad del gráfico de dependencias, evitando los ciclos al saltarse todo lo que ya se ha ejecutado.\n\u003e\n\u003e – [ES6 en Profundidad: Módulos](https://hacks.mozilla.org/2015/08/es6-in-depth-modules/)\n\n¿Qué significa esto en lenguaje sencillo? Significa que se podrías pensar que lo siguiente funcionaría pero no lo hará.\n\n```js\n// notificarError.mjs\nimport { Cliente } from 'mejor-servicio-para-notificar-error'\n\nexport default new Client(process.env.CLAVE_API)\n\n// index.mjs\nimport dotenv from 'dotenv'\ndotenv.config()\n\nimport notificarError from './notificarError.mjs'\nnotificarError.report(new Error('ejemplo documentado'))\n```\n\n`process.env.CLAVE_API` será vacio.\n\nEn su lugar, el código anterior debe ser escrito como...\n\n```js\n// notificarError.mjs\nimport { Cliente } from 'mejor-servicio-para-notificar-errores'\n\nexport default new Client(process.env.CLAVE_API)\n\n// index.mjs\nimport * as dotenv from 'dotenv'\ndotenv.config()\n\nimport notificarError from './notificarError.mjs'\nnotificarError.report(new Error('ejemplo documentado'))\n```\n\n¿Esto tiene algo de sentido? Esto es poco poco intuitivo, pero es como funciona la importación de módulos en ES6. Aquí hay un ejemplo [ejemplo práctico de esta trampa](https://github.com/dotenv-org/examples/tree/master/dotenv-es6-import-pitfall).\n\nExisten dos arternativas a este planteamiento:\n\n1. Precarga dotenv: `node --require dotenv/config index.js` (_Nota: no es necesario usar `import` dotenv con este método_)\n2. Cree un archivo separado que ejecutará `config` primero como se describe en [este comentario #133](https://github.com/motdotla/dotenv/issues/133#issuecomment-255298822)\n\n### ¿Qué pasa con la expansión de variable?\n\nPrueba [dotenv-expand](https://github.com/motdotla/dotenv-expand)\n\n### ¿Qué pasa con la sincronización y la seguridad de los archivos .env?\n\nVea [dotenv-vault](https://github.com/dotenv-org/dotenv-vault)\n\n## Guía de contribución\n\nVea [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## REGISTRO DE CAMBIOS\n\nVea [CHANGELOG.md](CHANGELOG.md)\n\n## ¿Quiénes utilizan dotenv?\n\n[Estos módulos npm dependen de él.](https://www.npmjs.com/browse/depended/dotenv)\n\nLos proyectos que lo amplían suelen utilizar la [palabra clave \"dotenv\" en npm](https://www.npmjs.com/search?q=keywords:dotenv).\n","funding_links":["https://github.com/sponsors/motdotla","https://www.dotenvx.com"],"categories":["JavaScript","Adding Custom Environment Variables","Packages","FAQ","[Node.js](https://github.com/nodejs/node)","Repository","GIT 仓库","包","config","目录","javascript","Miscellaneous","Uncategorized","Libraries","nodejs","Programming Languages","Node.js","Node","Number","security-tools","Utilities"],"sub_categories":["Adding Development Environment Variables In `.env`","Miscellaneous","How to Use Multiple Env Configs","Environment","环境","其他","How to use multiple env configs","Uncategorized","NodeJS","Tooling \u0026 dev","工具库","杂项"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmotdotla%2Fdotenv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmotdotla%2Fdotenv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmotdotla%2Fdotenv/lists"}