Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including node-env-run with all npm packages installed. Try it out:

node-env-run lists no main file and has no index.js, so it can't be directly required. If this is a mistake, please let us know. It may however contain internal files that you can require manually:

// require("node-env-run/[??]")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

node-env-run v3.0.2

Wrapper executable to load env variables from .env and run Node

npm npm npm Build Status All Contributors

node-env-run logo


Command-line tool to read .env files and execute scripts/commands after loading those environment variables

  • Uses dotenv under the hood
  • Easy to configure
  • Flexible command to execute
  • Let's you override existing environment variables

node-env-run example screenshot. Code below in Documentation section


Install per project:

I recommend installing this module as a devDependency for the respective project.

Install via yarn:

yarn add node-env-run --dev

Install via npm:

npm install node-env-run --save-dev

Install globally:

You can alternatively install the module globally if you want to:

npm install node-env-run --global


Add a new scripts entry to your package.json. Example:

  "scripts": {
    "dev": "nodenv .",
    "test": "nodenv -E test/.env test/test.js"

Or use it with npx:

npx node-env-run .


This module uses under the hood the dotenv module to parse the .env file. For more information about how to structure your .env file, please refer to its documentation.

Usage examples:

Start up the main file in package.json with the enviornment variables from .env:

nodenv .

More examples:

Start Node.js REPL with set environment variables from .env.repl:

nodenv -E .env.repl

Run Python file with overridden environment variables:

nodenv --exec python --force

Run server.js file using nodemon:

nodenv server.js --exec nodemon

Pass --inspect flag for debugging after --:

nodenv someScript -- --inspect


You can pass node-env-run a variety of arguments. These are the currently supported arguments:

--encodingstringLets you specify the encoding of the .env file. Defaults to utf8 encoding.
--env or
stringSpecifies the path to the .env file that should be read
--exec or
stringThis lets you specify a command other than node to execute the script with. More in the next section.
--force or -fbooleanFlag to temporarily override existing environment variables with the ones in the .env file
--helpbooleanDisplays the usage/help instructions
--verbosebooleanFlag to enable more verbose logging
--versionbooleanDisplays the current version of the package

Using node-env-run with other executables

You can use node-env-run with other executables. This is particularly useful if you try to combine it with things like babel-node or ts-node:

nodenv index.ts --exec "ts-node"

However, you can also use it with completely unrelated executables such as python:

nodenv --exec python


| [
Dominik Kundel](
[💻]( "Code") | | :---: |




RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free