|
|
- <!doctype html>
- <html>
- <title>README</title>
- <meta charset="utf-8">
- <link rel="stylesheet" type="text/css" href="../static/style.css">
- <link rel="canonical" href="https://www.npmjs.org/doc/README.html">
- <script async=true src="../../static/toc.js"></script>
-
- <body>
- <div id="wrapper">
-
- <h1><a href="cli/npm.html">npm</a></h1> <p>a JavaScript package manager</p>
- <p><a href="https://travis-ci.org/npm/cli"><img src="https://img.shields.io/travis/npm/cli/latest.svg" alt="Build Status"></a></p>
- <h2 id="synopsis">SYNOPSIS</h2>
- <p>This is just enough info to get you up and running.</p>
- <p>Much more info will be available via <code>npm help</code> once it's installed.</p>
- <h2 id="important">IMPORTANT</h2>
- <p><strong>You need node v6 or higher to run this program.</strong></p>
- <p>To install an old <strong>and unsupported</strong> version of npm that works on node v5
- and prior, clone the git repo and dig through the old tags and branches.</p>
- <p><strong>npm is configured to use npm, Inc.'s public registry at
- <a href="https://registry.npmjs.org">https://registry.npmjs.org</a> by default.</strong> Use of the npm public registry
- is subject to terms of use available at <a href="https://www.npmjs.com/policies/terms">https://www.npmjs.com/policies/terms</a>.</p>
- <p>You can configure npm to use any compatible registry you
- like, and even run your own registry. Check out the <a href="https://docs.npmjs.com/misc/registry">doc on
- registries</a>.</p>
- <h2 id="super-easy-install">Super Easy Install</h2>
- <p>npm is bundled with <a href="https://nodejs.org/en/download/">node</a>.</p>
- <h3 id="windows-computers">Windows Computers</h3>
- <p><a href="https://nodejs.org/en/download/">Get the MSI</a>. npm is in it.</p>
- <h3 id="apple-macintosh-computers">Apple Macintosh Computers</h3>
- <p><a href="https://nodejs.org/en/download/">Get the pkg</a>. npm is in it.</p>
- <h3 id="other-sorts-of-unices">Other Sorts of Unices</h3>
- <p>Run <code>make install</code>. npm will be installed with node.</p>
- <p>If you want a more fancy pants install (a different version, customized
- paths, etc.) then read on.</p>
- <h2 id="fancy-install-unix-">Fancy Install (Unix)</h2>
- <p>There's a pretty robust install script at
- <a href="https://www.npmjs.com/install.sh">https://www.npmjs.com/install.sh</a>. You can download that and run it.</p>
- <p>Here's an example using curl:</p>
- <pre><code class="language-sh">curl -L https://www.npmjs.com/install.sh | sh</code></pre>
- <h3 id="slightly-fancier">Slightly Fancier</h3>
- <p>You can set any npm configuration params with that script:</p>
- <pre><code class="language-sh">npm_config_prefix=/some/path sh install.sh</code></pre>
- <p>Or, you can run it in uber-debuggery mode:</p>
- <pre><code class="language-sh">npm_debug=1 sh install.sh</code></pre>
- <h3 id="even-fancier">Even Fancier</h3>
- <p>Get the code with git. Use <code>make</code> to build the docs and do other stuff.
- If you plan on hacking on npm, <code>make link</code> is your friend.</p>
- <p>If you've got the npm source code, you can also semi-permanently set
- arbitrary config keys using the <code>./configure --key=val ...</code>, and then
- run npm commands by doing <code>node bin/npm-cli.js <command> <args></code>. (This is helpful
- for testing, or running stuff without actually installing npm itself.)</p>
- <h2 id="windows-install-or-upgrade">Windows Install or Upgrade</h2>
- <p>Many improvements for Windows users have been made in npm 3 - you will have a better
- experience if you run a recent version of npm. To upgrade, either use <a href="https://github.com/felixrieseberg/npm-windows-upgrade">Microsoft's
- upgrade tool</a>,
- <a href="https://nodejs.org/en/download/">download a new version of Node</a>,
- or follow the Windows upgrade instructions in the
- <a href="https://npm.community/t/installing-upgrading-npm/251/2">Installing/upgrading npm</a> post.</p>
- <p>If that's not fancy enough for you, then you can fetch the code with
- git, and mess with it directly.</p>
- <h2 id="installing-on-cygwin">Installing on Cygwin</h2>
- <p>No.</p>
- <h2 id="uninstalling">Uninstalling</h2>
- <p>So sad to see you go.</p>
- <pre><code class="language-sh">sudo npm uninstall npm -g</code></pre>
- <p>Or, if that fails,</p>
- <pre><code class="language-sh">sudo make uninstall</code></pre>
- <h2 id="more-severe-uninstalling">More Severe Uninstalling</h2>
- <p>Usually, the above instructions are sufficient. That will remove
- npm, but leave behind anything you've installed.</p>
- <p>If you would like to remove all the packages that you have installed,
- then you can use the <code>npm ls</code> command to find them, and then <code>npm rm</code> to
- remove them.</p>
- <p>To remove cruft left behind by npm 0.x, you can use the included
- <code>clean-old.sh</code> script file. You can run it conveniently like this:</p>
- <pre><code class="language-sh">npm explore npm -g -- sh scripts/clean-old.sh</code></pre>
- <p>npm uses two configuration files, one for per-user configs, and another
- for global (every-user) configs. You can view them by doing:</p>
- <pre><code class="language-sh">npm config get userconfig # defaults to ~/.npmrc
- npm config get globalconfig # defaults to /usr/local/etc/npmrc</code></pre>
- <p>Uninstalling npm does not remove configuration files by default. You
- must remove them yourself manually if you want them gone. Note that
- this means that future npm installs will not remember the settings that
- you have chosen.</p>
- <h2 id="more-docs">More Docs</h2>
- <p>Check out the <a href="https://docs.npmjs.com/">docs</a>.</p>
- <p>You can use the <code>npm help</code> command to read any of them.</p>
- <p>If you're a developer, and you want to use npm to publish your program,
- you should <a href="https://docs.npmjs.com/misc/developers">read this</a>.</p>
- <h2 id="bugs">BUGS</h2>
- <p>When you find issues, please report them:</p>
- <ul>
- <li>web:
- <a href="https://npm.community/c/bugs">https://npm.community/c/bugs</a></li>
- </ul>
- <p>Be sure to include <em>all</em> of the output from the npm command that didn't work
- as expected. The <code>npm-debug.log</code> file is also helpful to provide.</p>
- <p>You can also find npm people in <code>#npm</code> on <a href="https://package.community/">https://package.community/</a> or
- <a href="https://twitter.com/npm_support">on Twitter</a>. Whoever responds will no
- doubt tell you to put the output in a gist or email.</p>
- <h2 id="see-also">SEE ALSO</h2>
- <ul>
- <li><a href="cli/npm.html">npm(1)</a></li>
- <li><a href="cli/npm-help.html">npm-help(1)</a></li>
- <li><a href="misc/npm-index.html">npm-index(7)</a></li>
- </ul>
-
- </div>
-
- <table border=0 cellspacing=0 cellpadding=0 id=npmlogo>
- <tr><td style="width:180px;height:10px;background:rgb(237,127,127)" colspan=18> </td></tr>
- <tr><td rowspan=4 style="width:10px;height:10px;background:rgb(237,127,127)"> </td><td style="width:40px;height:10px;background:#fff" colspan=4> </td><td style="width:10px;height:10px;background:rgb(237,127,127)" rowspan=4> </td><td style="width:40px;height:10px;background:#fff" colspan=4> </td><td rowspan=4 style="width:10px;height:10px;background:rgb(237,127,127)"> </td><td colspan=6 style="width:60px;height:10px;background:#fff"> </td><td style="width:10px;height:10px;background:rgb(237,127,127)" rowspan=4> </td></tr>
- <tr><td colspan=2 style="width:20px;height:30px;background:#fff" rowspan=3> </td><td style="width:10px;height:10px;background:rgb(237,127,127)" rowspan=3> </td><td style="width:10px;height:10px;background:#fff" rowspan=3> </td><td style="width:20px;height:10px;background:#fff" rowspan=4 colspan=2> </td><td style="width:10px;height:20px;background:rgb(237,127,127)" rowspan=2> </td><td style="width:10px;height:10px;background:#fff" rowspan=3> </td><td style="width:20px;height:10px;background:#fff" rowspan=3 colspan=2> </td><td style="width:10px;height:10px;background:rgb(237,127,127)" rowspan=3> </td><td style="width:10px;height:10px;background:#fff" rowspan=3> </td><td style="width:10px;height:10px;background:rgb(237,127,127)" rowspan=3> </td></tr>
- <tr><td style="width:10px;height:10px;background:#fff" rowspan=2> </td></tr>
- <tr><td style="width:10px;height:10px;background:#fff"> </td></tr>
- <tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6> </td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)"> </td></tr>
- <tr><td colspan=5 style="width:50px;height:10px;background:#fff"> </td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4> </td><td style="width:90px;height:10px;background:#fff" colspan=9> </td></tr>
- </table>
- <p id="footer"><a href="../doc/README.html">README</a> — npm@6.4.1</p>
-
|