Utility that sets the npmrc credentials based on environment variables

Downloads in past


321.1.07 years ago7 years agoMinified + gzip package size for npm-auth in KB


Build Status Codacy Badge
This utility is used to set the credentials in .npmrc locally to authenticate against any public/private NPM Repository.


  • This utility depends on various environment variables being set, specifically:
  • NPM_REGISTRY_API_KEY => the value of _auth.
  • NPM_REGISTRY_EMAIL => the email used to authenticate with. The default value will be used if this environment variable is not set.
  • NPM_REGISTRY => the registry that the utility will authenticate against.


npm install npm-auth


# This is the first task that needs to run prior to "npm install"

If you are not setting the properties as environment variables, you are welcome to passing them via the CLI
#   registry        (required): the registry repository, eg:
#   email           (required): your email address associated to this repositroy, format:
#   secure-token    (required): your api key  which is used to authenticate
#   file-path       (optional): specify the location to output the configuration file
#   print           prints the local configuration file

  # Example usage
  npm-auth --registry=http://www.your-private-registry/npm  --secure-token=aasd-123-zasdf-123-sfd
  # Note you may pass in just one of the three required parameters if the other parameters are set as Environment variables

  # Also note that anythning passed via the CLI will OVERRIDE the Environment variables, which allows you to flexibibly configure within your CI environment.

Make sure to ignore the local .npmrc from the project solution

# Other ignore files above


Start with:
  npm install

Running tests:
npm run test
# Run test with coverage.  The coverage report by default is configured for lcov and can be located in the `./coverage` directory.
npm run test:cover

npm run push

Building the application: The resulting source code is built to a ./dist directory which is where the transpiled source resides. By default the test files are not built to this directory, only the underlying source.
npm run build


Looking to contribute to NPM-Auth? I love seeing PR's and suggestions, please visit the CONTRIBUTING section for more information.