| <!doctype html> |
| <html> |
| <title>npm-config</title> |
| <meta http-equiv="content-type" value="text/html;utf-8"> |
| <link rel="stylesheet" type="text/css" href="../../static/style.css"> |
| |
| <body> |
| <div id="wrapper"> |
| <h1><a href="../misc/npm-config.html">npm-config</a></h1> <p>More than you probably want to know about npm configuration</p> |
| |
| <h2 id="DESCRIPTION">DESCRIPTION</h2> |
| |
| <p>npm gets its configuration values from 6 sources, in this priority:</p> |
| |
| <h3 id="Command-Line-Flags">Command Line Flags</h3> |
| |
| <p>Putting <code>--foo bar</code> on the command line sets the <code>foo</code> configuration |
| parameter to <code>"bar"</code>. A <code>--</code> argument tells the cli parser to stop |
| reading flags. A <code>--flag</code> parameter that is at the <em>end</em> of the |
| command will be given the value of <code>true</code>.</p> |
| |
| <h3 id="Environment-Variables">Environment Variables</h3> |
| |
| <p>Any environment variables that start with <code>npm_config_</code> will be |
| interpreted as a configuration parameter. For example, putting |
| <code>npm_config_foo=bar</code> in your environment will set the <code>foo</code> |
| configuration parameter to <code>bar</code>. Any environment configurations that |
| are not given a value will be given the value of <code>true</code>. Config |
| values are case-insensitive, so <code>NPM_CONFIG_FOO=bar</code> will work the |
| same.</p> |
| |
| <h3 id="npmrc-Files">npmrc Files</h3> |
| |
| <p>The three relevant files are:</p> |
| |
| <ul><li>per-user config file (~/.npmrc)</li><li>global config file ($PREFIX/npmrc)</li><li>npm builtin config file (/path/to/npm/npmrc)</li></ul> |
| |
| <p>See <a href="../files/npmrc.html">npmrc(5)</a> for more details.</p> |
| |
| <h3 id="Default-Configs">Default Configs</h3> |
| |
| <p>A set of configuration parameters that are internal to npm, and are |
| defaults if nothing else is specified.</p> |
| |
| <h2 id="Shorthands-and-Other-CLI-Niceties">Shorthands and Other CLI Niceties</h2> |
| |
| <p>The following shorthands are parsed on the command-line:</p> |
| |
| <ul><li><code>-v</code>: <code>--version</code></li><li><code>-h</code>, <code>-?</code>, <code>--help</code>, <code>-H</code>: <code>--usage</code></li><li><code>-s</code>, <code>--silent</code>: <code>--loglevel silent</code></li><li><code>-q</code>, <code>--quiet</code>: <code>--loglevel warn</code></li><li><code>-d</code>: <code>--loglevel info</code></li><li><code>-dd</code>, <code>--verbose</code>: <code>--loglevel verbose</code></li><li><code>-ddd</code>: <code>--loglevel silly</code></li><li><code>-g</code>: <code>--global</code></li><li><code>-l</code>: <code>--long</code></li><li><code>-m</code>: <code>--message</code></li><li><code>-p</code>, <code>--porcelain</code>: <code>--parseable</code></li><li><code>-reg</code>: <code>--registry</code></li><li><code>-v</code>: <code>--version</code></li><li><code>-f</code>: <code>--force</code></li><li><code>-desc</code>: <code>--description</code></li><li><code>-S</code>: <code>--save</code></li><li><code>-D</code>: <code>--save-dev</code></li><li><code>-O</code>: <code>--save-optional</code></li><li><code>-B</code>: <code>--save-bundle</code></li><li><code>-y</code>: <code>--yes</code></li><li><code>-n</code>: <code>--yes false</code></li><li><code>ll</code> and <code>la</code> commands: <code>ls --long</code></li></ul> |
| |
| <p>If the specified configuration param resolves unambiguously to a known |
| configuration parameter, then it is expanded to that configuration |
| parameter. For example:</p> |
| |
| <pre><code>npm ls --par |
| # same as: |
| npm ls --parseable</code></pre> |
| |
| <p>If multiple single-character shorthands are strung together, and the |
| resulting combination is unambiguously not some other configuration |
| param, then it is expanded to its various component pieces. For |
| example:</p> |
| |
| <pre><code>npm ls -gpld |
| # same as: |
| npm ls --global --parseable --long --loglevel info</code></pre> |
| |
| <h2 id="Per-Package-Config-Settings">Per-Package Config Settings</h2> |
| |
| <p>When running scripts (see <code><a href="../misc/npm-scripts.html">npm-scripts(7)</a></code>) the package.json "config" |
| keys are overwritten in the environment if there is a config param of |
| <code><name>[@<version>]:<key></code>. For example, if the package.json has |
| this:</p> |
| |
| <pre><code>{ "name" : "foo" |
| , "config" : { "port" : "8080" } |
| , "scripts" : { "start" : "node server.js" } }</code></pre> |
| |
| <p>and the server.js is this:</p> |
| |
| <pre><code>http.createServer(...).listen(process.env.npm_package_config_port)</code></pre> |
| |
| <p>then the user could change the behavior by doing:</p> |
| |
| <pre><code>npm config set foo:port 80</code></pre> |
| |
| <p>See <a href="../files/package.json.html">package.json(5)</a> for more information.</p> |
| |
| <h2 id="Config-Settings">Config Settings</h2> |
| |
| <h3 id="always-auth">always-auth</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>Force npm to always require authentication when accessing the registry, |
| even for <code>GET</code> requests.</p> |
| |
| <h3 id="bin-links">bin-links</h3> |
| |
| <ul><li>Default: <code>true</code></li><li>Type: Boolean</li></ul> |
| |
| <p>Tells npm to create symlinks (or <code>.cmd</code> shims on Windows) for package |
| executables.</p> |
| |
| <p>Set to false to have it not do this. This can be used to work around |
| the fact that some file systems don't support symlinks, even on |
| ostensibly Unix systems.</p> |
| |
| <h3 id="browser">browser</h3> |
| |
| <ul><li>Default: OS X: <code>"open"</code>, Windows: <code>"start"</code>, Others: <code>"xdg-open"</code></li><li>Type: String</li></ul> |
| |
| <p>The browser that is called by the <code>npm docs</code> command to open websites.</p> |
| |
| <h3 id="ca">ca</h3> |
| |
| <ul><li>Default: The npm CA certificate</li><li>Type: String or null</li></ul> |
| |
| <p>The Certificate Authority signing certificate that is trusted for SSL |
| connections to the registry.</p> |
| |
| <p>Set to <code>null</code> to only allow "known" registrars, or to a specific CA cert |
| to trust only that specific signing authority.</p> |
| |
| <p>See also the <code>strict-ssl</code> config.</p> |
| |
| <h3 id="cache">cache</h3> |
| |
| <ul><li>Default: Windows: <code>%AppData%\npm-cache</code>, Posix: <code>~/.npm</code></li><li>Type: path</li></ul> |
| |
| <p>The location of npm's cache directory. See <code><a href="../cli/npm-cache.html">npm-cache(1)</a></code></p> |
| |
| <h3 id="cache-lock-stale">cache-lock-stale</h3> |
| |
| <ul><li>Default: 60000 (1 minute)</li><li>Type: Number</li></ul> |
| |
| <p>The number of ms before cache folder lockfiles are considered stale.</p> |
| |
| <h3 id="cache-lock-retries">cache-lock-retries</h3> |
| |
| <ul><li>Default: 10</li><li>Type: Number</li></ul> |
| |
| <p>Number of times to retry to acquire a lock on cache folder lockfiles.</p> |
| |
| <h3 id="cache-lock-wait">cache-lock-wait</h3> |
| |
| <ul><li>Default: 10000 (10 seconds)</li><li>Type: Number</li></ul> |
| |
| <p>Number of ms to wait for cache lock files to expire.</p> |
| |
| <h3 id="cache-max">cache-max</h3> |
| |
| <ul><li>Default: Infinity</li><li>Type: Number</li></ul> |
| |
| <p>The maximum time (in seconds) to keep items in the registry cache before |
| re-checking against the registry.</p> |
| |
| <p>Note that no purging is done unless the <code>npm cache clean</code> command is |
| explicitly used, and that only GET requests use the cache.</p> |
| |
| <h3 id="cache-min">cache-min</h3> |
| |
| <ul><li>Default: 10</li><li>Type: Number</li></ul> |
| |
| <p>The minimum time (in seconds) to keep items in the registry cache before |
| re-checking against the registry.</p> |
| |
| <p>Note that no purging is done unless the <code>npm cache clean</code> command is |
| explicitly used, and that only GET requests use the cache.</p> |
| |
| <h3 id="cert">cert</h3> |
| |
| <ul><li>Default: <code>null</code></li><li>Type: String</li></ul> |
| |
| <p>A client certificate to pass when accessing the registry.</p> |
| |
| <h3 id="color">color</h3> |
| |
| <ul><li>Default: true on Posix, false on Windows</li><li>Type: Boolean or <code>"always"</code></li></ul> |
| |
| <p>If false, never shows colors. If <code>"always"</code> then always shows colors. |
| If true, then only prints color codes for tty file descriptors.</p> |
| |
| <h3 id="depth">depth</h3> |
| |
| <ul><li>Default: Infinity</li><li>Type: Number</li></ul> |
| |
| <p>The depth to go when recursing directories for <code>npm ls</code> and |
| <code>npm cache ls</code>.</p> |
| |
| <h3 id="description">description</h3> |
| |
| <ul><li>Default: true</li><li>Type: Boolean</li></ul> |
| |
| <p>Show the description in <code>npm search</code></p> |
| |
| <h3 id="dev">dev</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>Install <code>dev-dependencies</code> along with packages.</p> |
| |
| <p>Note that <code>dev-dependencies</code> are also installed if the <code>npat</code> flag is |
| set.</p> |
| |
| <h3 id="editor">editor</h3> |
| |
| <ul><li>Default: <code>EDITOR</code> environment variable if set, or <code>"vi"</code> on Posix, |
| or <code>"notepad"</code> on Windows.</li><li>Type: path</li></ul> |
| |
| <p>The command to run for <code>npm edit</code> or <code>npm config edit</code>.</p> |
| |
| <h3 id="email">email</h3> |
| |
| <p>The email of the logged-in user.</p> |
| |
| <p>Set by the <code>npm adduser</code> command. Should not be set explicitly.</p> |
| |
| <h3 id="engine-strict">engine-strict</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>If set to true, then npm will stubbornly refuse to install (or even |
| consider installing) any package that claims to not be compatible with |
| the current Node.js version.</p> |
| |
| <h3 id="force">force</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>Makes various commands more forceful.</p> |
| |
| <ul><li>lifecycle script failure does not block progress.</li><li>publishing clobbers previously published versions.</li><li>skips cache when requesting from the registry.</li><li>prevents checks against clobbering non-npm files.</li></ul> |
| |
| <h3 id="fetch-retries">fetch-retries</h3> |
| |
| <ul><li>Default: 2</li><li>Type: Number</li></ul> |
| |
| <p>The "retries" config for the <code>retry</code> module to use when fetching |
| packages from the registry.</p> |
| |
| <h3 id="fetch-retry-factor">fetch-retry-factor</h3> |
| |
| <ul><li>Default: 10</li><li>Type: Number</li></ul> |
| |
| <p>The "factor" config for the <code>retry</code> module to use when fetching |
| packages.</p> |
| |
| <h3 id="fetch-retry-mintimeout">fetch-retry-mintimeout</h3> |
| |
| <ul><li>Default: 10000 (10 seconds)</li><li>Type: Number</li></ul> |
| |
| <p>The "minTimeout" config for the <code>retry</code> module to use when fetching |
| packages.</p> |
| |
| <h3 id="fetch-retry-maxtimeout">fetch-retry-maxtimeout</h3> |
| |
| <ul><li>Default: 60000 (1 minute)</li><li>Type: Number</li></ul> |
| |
| <p>The "maxTimeout" config for the <code>retry</code> module to use when fetching |
| packages.</p> |
| |
| <h3 id="git">git</h3> |
| |
| <ul><li>Default: <code>"git"</code></li><li>Type: String</li></ul> |
| |
| <p>The command to use for git commands. If git is installed on the |
| computer, but is not in the <code>PATH</code>, then set this to the full path to |
| the git binary.</p> |
| |
| <h3 id="git-tag-version">git-tag-version</h3> |
| |
| <ul><li>Default: <code>true</code></li><li>Type: Boolean</li></ul> |
| |
| <p>Tag the commit when using the <code>npm version</code> command.</p> |
| |
| <h3 id="global">global</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>Operates in "global" mode, so that packages are installed into the |
| <code>prefix</code> folder instead of the current working directory. See |
| <code><a href="../files/npm-folders.html">npm-folders(5)</a></code> for more on the differences in behavior.</p> |
| |
| <ul><li>packages are installed into the <code>{prefix}/lib/node_modules</code> folder, instead of the |
| current working directory.</li><li>bin files are linked to <code>{prefix}/bin</code></li><li>man pages are linked to <code>{prefix}/share/man</code></li></ul> |
| |
| <h3 id="globalconfig">globalconfig</h3> |
| |
| <ul><li>Default: {prefix}/etc/npmrc</li><li>Type: path</li></ul> |
| |
| <p>The config file to read for global config options.</p> |
| |
| <h3 id="group">group</h3> |
| |
| <ul><li>Default: GID of the current process</li><li>Type: String or Number</li></ul> |
| |
| <p>The group to use when running package scripts in global mode as the root |
| user.</p> |
| |
| <h3 id="heading">heading</h3> |
| |
| <ul><li>Default: <code>"npm"</code></li><li>Type: String</li></ul> |
| |
| <p>The string that starts all the debugging log output.</p> |
| |
| <h3 id="https-proxy">https-proxy</h3> |
| |
| <ul><li>Default: the <code>HTTPS_PROXY</code> or <code>https_proxy</code> or <code>HTTP_PROXY</code> or |
| <code>http_proxy</code> environment variables.</li><li>Type: url</li></ul> |
| |
| <p>A proxy to use for outgoing https requests.</p> |
| |
| <h3 id="ignore-scripts">ignore-scripts</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>If true, npm does not run scripts specified in package.json files.</p> |
| |
| <h3 id="init-module">init-module</h3> |
| |
| <ul><li>Default: ~/.npm-init.js</li><li>Type: path</li></ul> |
| |
| <p>A module that will be loaded by the <code>npm init</code> command. See the |
| documentation for the |
| <a href="https://github.com/isaacs/init-package-json">init-package-json</a> module |
| for more information, or <a href="../cli/npm-init.html">npm-init(1)</a>.</p> |
| |
| <h3 id="init-author-name">init.author.name</h3> |
| |
| <ul><li>Default: ""</li><li>Type: String</li></ul> |
| |
| <p>The value <code>npm init</code> should use by default for the package author's name.</p> |
| |
| <h3 id="init-author-email">init.author.email</h3> |
| |
| <ul><li>Default: ""</li><li>Type: String</li></ul> |
| |
| <p>The value <code>npm init</code> should use by default for the package author's email.</p> |
| |
| <h3 id="init-author-url">init.author.url</h3> |
| |
| <ul><li>Default: ""</li><li>Type: String</li></ul> |
| |
| <p>The value <code>npm init</code> should use by default for the package author's homepage.</p> |
| |
| <h3 id="init-license">init.license</h3> |
| |
| <ul><li>Default: "BSD-2-Clause"</li><li>Type: String</li></ul> |
| |
| <p>The value <code>npm init</code> should use by default for the package license.</p> |
| |
| <h3 id="json">json</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>Whether or not to output JSON data, rather than the normal output.</p> |
| |
| <p>This feature is currently experimental, and the output data structures |
| for many commands is either not implemented in JSON yet, or subject to |
| change. Only the output from <code>npm ls --json</code> is currently valid.</p> |
| |
| <h3 id="key">key</h3> |
| |
| <ul><li>Default: <code>null</code></li><li>Type: String</li></ul> |
| |
| <p>A client key to pass when accessing the registry.</p> |
| |
| <h3 id="link">link</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>If true, then local installs will link if there is a suitable globally |
| installed package.</p> |
| |
| <p>Note that this means that local installs can cause things to be |
| installed into the global space at the same time. The link is only done |
| if one of the two conditions are met:</p> |
| |
| <ul><li>The package is not already installed globally, or</li><li>the globally installed version is identical to the version that is |
| being installed locally.</li></ul> |
| |
| <h3 id="local-address">local-address</h3> |
| |
| <ul><li>Default: undefined</li><li>Type: IP Address</li></ul> |
| |
| <p>The IP address of the local interface to use when making connections |
| to the npm registry. Must be IPv4 in versions of Node prior to 0.12.</p> |
| |
| <h3 id="loglevel">loglevel</h3> |
| |
| <ul><li>Default: "http"</li><li>Type: String</li><li>Values: "silent", "win", "error", "warn", "http", "info", "verbose", "silly"</li></ul> |
| |
| <p>What level of logs to report. On failure, <em>all</em> logs are written to |
| <code>npm-debug.log</code> in the current working directory.</p> |
| |
| <p>Any logs of a higher level than the setting are shown. |
| The default is "http", which shows http, warn, and error output.</p> |
| |
| <h3 id="logstream">logstream</h3> |
| |
| <ul><li>Default: process.stderr</li><li>Type: Stream</li></ul> |
| |
| <p>This is the stream that is passed to the |
| <a href="https://github.com/isaacs/npmlog">npmlog</a> module at run time.</p> |
| |
| <p>It cannot be set from the command line, but if you are using npm |
| programmatically, you may wish to send logs to somewhere other than |
| stderr.</p> |
| |
| <p>If the <code>color</code> config is set to true, then this stream will receive |
| colored output if it is a TTY.</p> |
| |
| <h3 id="long">long</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>Show extended information in <code>npm ls</code></p> |
| |
| <h3 id="message">message</h3> |
| |
| <ul><li>Default: "%s"</li><li>Type: String</li></ul> |
| |
| <p>Commit message which is used by <code>npm version</code> when creating version commit.</p> |
| |
| <p>Any "%s" in the message will be replaced with the version number.</p> |
| |
| <h3 id="node-version">node-version</h3> |
| |
| <ul><li>Default: process.version</li><li>Type: semver or false</li></ul> |
| |
| <p>The node version to use when checking package's "engines" hash.</p> |
| |
| <h3 id="npat">npat</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>Run tests on installation.</p> |
| |
| <h3 id="onload-script">onload-script</h3> |
| |
| <ul><li>Default: false</li><li>Type: path</li></ul> |
| |
| <p>A node module to <code>require()</code> when npm loads. Useful for programmatic |
| usage.</p> |
| |
| <h3 id="optional">optional</h3> |
| |
| <ul><li>Default: true</li><li>Type: Boolean</li></ul> |
| |
| <p>Attempt to install packages in the <code>optionalDependencies</code> hash. Note |
| that if these packages fail to install, the overall installation |
| process is not aborted.</p> |
| |
| <h3 id="parseable">parseable</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>Output parseable results from commands that write to |
| standard output.</p> |
| |
| <h3 id="prefix">prefix</h3> |
| |
| <ul><li>Default: see <a href="../files/npm-folders.html">npm-folders(5)</a></li><li>Type: path</li></ul> |
| |
| <p>The location to install global items. If set on the command line, then |
| it forces non-global commands to run in the specified folder.</p> |
| |
| <h3 id="production">production</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>Set to true to run in "production" mode.</p> |
| |
| <ol><li>devDependencies are not installed at the topmost level when running |
| local <code>npm install</code> without any arguments.</li><li>Set the NODE_ENV="production" for lifecycle scripts.</li></ol> |
| |
| <h3 id="proprietary-attribs">proprietary-attribs</h3> |
| |
| <ul><li>Default: true</li><li>Type: Boolean</li></ul> |
| |
| <p>Whether or not to include proprietary extended attributes in the |
| tarballs created by npm.</p> |
| |
| <p>Unless you are expecting to unpack package tarballs with something other |
| than npm -- particularly a very outdated tar implementation -- leave |
| this as true.</p> |
| |
| <h3 id="proxy">proxy</h3> |
| |
| <ul><li>Default: <code>HTTP_PROXY</code> or <code>http_proxy</code> environment variable, or null</li><li>Type: url</li></ul> |
| |
| <p>A proxy to use for outgoing http requests.</p> |
| |
| <h3 id="rebuild-bundle">rebuild-bundle</h3> |
| |
| <ul><li>Default: true</li><li>Type: Boolean</li></ul> |
| |
| <p>Rebuild bundled dependencies after installation.</p> |
| |
| <h3 id="registry">registry</h3> |
| |
| <ul><li>Default: https://registry.npmjs.org/</li><li>Type: url</li></ul> |
| |
| <p>The base URL of the npm package registry.</p> |
| |
| <h3 id="rollback">rollback</h3> |
| |
| <ul><li>Default: true</li><li>Type: Boolean</li></ul> |
| |
| <p>Remove failed installs.</p> |
| |
| <h3 id="save">save</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>Save installed packages to a package.json file as dependencies.</p> |
| |
| <p>When used with the <code>npm rm</code> command, it removes it from the dependencies |
| hash.</p> |
| |
| <p>Only works if there is already a package.json file present.</p> |
| |
| <h3 id="save-bundle">save-bundle</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>If a package would be saved at install time by the use of <code>--save</code>, |
| <code>--save-dev</code>, or <code>--save-optional</code>, then also put it in the |
| <code>bundleDependencies</code> list.</p> |
| |
| <p>When used with the <code>npm rm</code> command, it removes it from the |
| bundledDependencies list.</p> |
| |
| <h3 id="save-dev">save-dev</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>Save installed packages to a package.json file as devDependencies.</p> |
| |
| <p>When used with the <code>npm rm</code> command, it removes it from the devDependencies |
| hash.</p> |
| |
| <p>Only works if there is already a package.json file present.</p> |
| |
| <h3 id="save-optional">save-optional</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>Save installed packages to a package.json file as optionalDependencies.</p> |
| |
| <p>When used with the <code>npm rm</code> command, it removes it from the devDependencies |
| hash.</p> |
| |
| <p>Only works if there is already a package.json file present.</p> |
| |
| <h3 id="searchopts">searchopts</h3> |
| |
| <ul><li>Default: ""</li><li>Type: String</li></ul> |
| |
| <p>Space-separated options that are always passed to search.</p> |
| |
| <h3 id="searchexclude">searchexclude</h3> |
| |
| <ul><li>Default: ""</li><li>Type: String</li></ul> |
| |
| <p>Space-separated options that limit the results from search.</p> |
| |
| <h3 id="searchsort">searchsort</h3> |
| |
| <ul><li>Default: "name"</li><li>Type: String</li><li>Values: "name", "-name", "date", "-date", "description", |
| "-description", "keywords", "-keywords"</li></ul> |
| |
| <p>Indication of which field to sort search results by. Prefix with a <code>-</code> |
| character to indicate reverse sort.</p> |
| |
| <h3 id="shell">shell</h3> |
| |
| <ul><li>Default: SHELL environment variable, or "bash" on Posix, or "cmd" on |
| Windows</li><li>Type: path</li></ul> |
| |
| <p>The shell to run for the <code>npm explore</code> command.</p> |
| |
| <h3 id="shrinkwrap">shrinkwrap</h3> |
| |
| <ul><li>Default: true</li><li>Type: Boolean</li></ul> |
| |
| <p>If set to false, then ignore <code>npm-shrinkwrap.json</code> files when |
| installing.</p> |
| |
| <h3 id="sign-git-tag">sign-git-tag</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>If set to true, then the <code>npm version</code> command will tag the version |
| using <code>-s</code> to add a signature.</p> |
| |
| <p>Note that git requires you to have set up GPG keys in your git configs |
| for this to work properly.</p> |
| |
| <h3 id="strict-ssl">strict-ssl</h3> |
| |
| <ul><li>Default: true</li><li>Type: Boolean</li></ul> |
| |
| <p>Whether or not to do SSL key validation when making requests to the |
| registry via https.</p> |
| |
| <p>See also the <code>ca</code> config.</p> |
| |
| <h3 id="tag">tag</h3> |
| |
| <ul><li>Default: latest</li><li>Type: String</li></ul> |
| |
| <p>If you ask npm to install a package and don't tell it a specific version, then |
| it will install the specified tag.</p> |
| |
| <p>Also the tag that is added to the package@version specified by the <code>npm |
| tag</code> command, if no explicit tag is given.</p> |
| |
| <h3 id="tmp">tmp</h3> |
| |
| <ul><li>Default: TMPDIR environment variable, or "/tmp"</li><li>Type: path</li></ul> |
| |
| <p>Where to store temporary files and folders. All temp files are deleted |
| on success, but left behind on failure for forensic purposes.</p> |
| |
| <h3 id="unicode">unicode</h3> |
| |
| <ul><li>Default: true</li><li>Type: Boolean</li></ul> |
| |
| <p>When set to true, npm uses unicode characters in the tree output. When |
| false, it uses ascii characters to draw trees.</p> |
| |
| <h3 id="unsafe-perm">unsafe-perm</h3> |
| |
| <ul><li>Default: false if running as root, true otherwise</li><li>Type: Boolean</li></ul> |
| |
| <p>Set to true to suppress the UID/GID switching when running package |
| scripts. If set explicitly to false, then installing as a non-root user |
| will fail.</p> |
| |
| <h3 id="usage">usage</h3> |
| |
| <ul><li>Default: false</li><li>Type: Boolean</li></ul> |
| |
| <p>Set to show short usage output (like the -H output) |
| instead of complete help when doing <code><a href="../cli/npm-help.html">npm-help(1)</a></code>.</p> |
| |
| <h3 id="user">user</h3> |
| |
| <ul><li>Default: "nobody"</li><li>Type: String or Number</li></ul> |
| |
| <p>The UID to set to when running package scripts as root.</p> |
| |
| <h3 id="username">username</h3> |
| |
| <ul><li>Default: null</li><li>Type: String</li></ul> |
| |
| <p>The username on the npm registry. Set with <code>npm adduser</code></p> |
| |
| <h3 id="userconfig">userconfig</h3> |
| |
| <ul><li>Default: ~/.npmrc</li><li>Type: path</li></ul> |
| |
| <p>The location of user-level configuration settings.</p> |
| |
| <h3 id="umask">umask</h3> |
| |
| <ul><li>Default: 022</li><li>Type: Octal numeric string</li></ul> |
| |
| <p>The "umask" value to use when setting the file creation mode on files |
| and folders.</p> |
| |
| <p>Folders and executables are given a mode which is <code>0777</code> masked against |
| this value. Other files are given a mode which is <code>0666</code> masked against |
| this value. Thus, the defaults are <code>0755</code> and <code>0644</code> respectively.</p> |
| |
| <h3 id="user-agent">user-agent</h3> |
| |
| <ul><li>Default: node/{process.version} {process.platform} {process.arch}</li><li>Type: String</li></ul> |
| |
| <p>Sets a User-Agent to the request header</p> |
| |
| <h3 id="version">version</h3> |
| |
| <ul><li>Default: false</li><li>Type: boolean</li></ul> |
| |
| <p>If true, output the npm version and exit successfully.</p> |
| |
| <p>Only relevant when specified explicitly on the command line.</p> |
| |
| <h3 id="versions">versions</h3> |
| |
| <ul><li>Default: false</li><li>Type: boolean</li></ul> |
| |
| <p>If true, output the npm version as well as node's <code>process.versions</code> |
| hash, and exit successfully.</p> |
| |
| <p>Only relevant when specified explicitly on the command line.</p> |
| |
| <h3 id="viewer">viewer</h3> |
| |
| <ul><li>Default: "man" on Posix, "browser" on Windows</li><li>Type: path</li></ul> |
| |
| <p>The program to use to view help content.</p> |
| |
| <p>Set to <code>"browser"</code> to view html help content in the default web browser.</p> |
| |
| <h2 id="SEE-ALSO">SEE ALSO</h2> |
| |
| <ul><li><a href="../cli/npm-config.html">npm-config(1)</a></li><li><a href="../misc/npm-config.html">npm-config(7)</a></li><li><a href="../files/npmrc.html">npmrc(5)</a></li><li><a href="../misc/npm-scripts.html">npm-scripts(7)</a></li><li><a href="../files/npm-folders.html">npm-folders(5)</a></li><li><a href="../cli/npm.html">npm(1)</a></li></ul> |
| </div> |
| <p id="footer">npm-config — npm@1.3.21</p> |
| <script> |
| ;(function () { |
| var wrapper = document.getElementById("wrapper") |
| var els = Array.prototype.slice.call(wrapper.getElementsByTagName("*"), 0) |
| .filter(function (el) { |
| return el.parentNode === wrapper |
| && el.tagName.match(/H[1-6]/) |
| && el.id |
| }) |
| var l = 2 |
| , toc = document.createElement("ul") |
| toc.innerHTML = els.map(function (el) { |
| var i = el.tagName.charAt(1) |
| , out = "" |
| while (i > l) { |
| out += "<ul>" |
| l ++ |
| } |
| while (i < l) { |
| out += "</ul>" |
| l -- |
| } |
| out += "<li><a href='#" + el.id + "'>" + |
| ( el.innerText || el.text || el.innerHTML) |
| + "</a>" |
| return out |
| }).join("\n") |
| toc.id = "toc" |
| document.body.appendChild(toc) |
| })() |
| </script> |