.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "NPMRC" "5" "August 2014" "" ""
.
.SH "NAME"
\fBnpmrc\fR \- The npm config files
.
.SH "DESCRIPTION"
npm gets its config settings from the command line, environment variables, and \fBnpmrc\fR files\.
.
.P
The \fBnpm config\fR command can be used to update and edit the contents of the user and global npmrc files\.
.
.P
npm help  For a list of available configuration options, see npm\-config\.
.
.SH "FILES"
The four relevant files are:
.
.IP "\(bu" 4
per\-project config file (/path/to/my/project/\.npmrc)
.
.IP "\(bu" 4
per\-user config file (~/\.npmrc)
.
.IP "\(bu" 4
global config file ($PREFIX/npmrc)
.
.IP "\(bu" 4
npm builtin config file (/path/to/npm/npmrc)
.
.IP "" 0
.
.P
All npm config files are an ini\-formatted list of \fBkey = value\fR parameters\. Environment variables can be replaced using \fB${VARIABLE_NAME}\fR\. For example:
.
.IP "" 4
.
.nf

prefix = ${HOME}/\.npm\-packages
.
.fi
.
.IP "" 0
.
.P
Each of these files is loaded, and config options are resolved in priority order\. For example, a setting in the userconfig file would override the setting in the globalconfig file\.
.
.SS "Per\-project config file"
When working locally in a project, a \fB\.npmrc\fR file in the root of the project (ie, a sibling of \fBnode_modules\fR and \fBpackage\.json\fR) will set config values specific to this project\.
.
.P
Note that this only applies to the root of the project that you\'re running npm in\. It has no effect when your module is published\. For example, you can\'t publish a module that forces itself to install globally, or in a different location\.
.
.SS "Per\-user config file"
\fB$HOME/\.npmrc\fR (or the \fBuserconfig\fR param, if set in the environment or on the command line)
.
.SS "Global config file"
\fB$PREFIX/etc/npmrc\fR (or the \fBglobalconfig\fR param, if set above): This file is an ini\-file formatted list of \fBkey = value\fR parameters\. Environment variables can be replaced as above\.
.
.SS "Built\-in config file"
\fBpath/to/npm/itself/npmrc\fR
.
.P
This is an unchangeable "builtin" configuration file that npm keeps consistent across updates\. Set fields in here using the \fB\./configure\fR script that comes with npm\. This is primarily for distribution maintainers to override default configs in a standard and consistent manner\.
.
.SH "SEE ALSO"
.
.IP "\(bu" 4
npm help  folders
.
.IP "\(bu" 4
npm help config
.
.IP "\(bu" 4
npm help  config
.
.IP "\(bu" 4
npm help  package\.json
.
.IP "\(bu" 4
npm help npm
.
.IP "" 0