• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<!DOCTYPE html><html><head>
2<meta charset="utf-8">
3<title>install</title>
4<style>
5body {
6    background-color: #ffffff;
7    color: #24292e;
8
9    margin: 0;
10
11    line-height: 1.5;
12
13    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
14}
15#rainbar {
16    height: 10px;
17    background-image: linear-gradient(139deg, #fb8817, #ff4b01, #c12127, #e02aff);
18}
19
20a {
21    text-decoration: none;
22    color: #0366d6;
23}
24a:hover {
25    text-decoration: underline;
26}
27
28pre {
29    margin: 1em 0px;
30    padding: 1em;
31    border: solid 1px #e1e4e8;
32    border-radius: 6px;
33
34    display: block;
35    overflow: auto;
36
37    white-space: pre;
38
39    background-color: #f6f8fa;
40    color: #393a34;
41}
42code {
43    font-family: SFMono-Regular, Consolas, "Liberation Mono", Menlo, Courier, monospace;
44    font-size: 85%;
45    padding: 0.2em 0.4em;
46    background-color: #f6f8fa;
47    color: #393a34;
48}
49pre > code {
50    padding: 0;
51    background-color: inherit;
52    color: inherit;
53}
54h1, h2, h3 {
55    font-weight: 600;
56}
57
58#logobar {
59    background-color: #333333;
60    margin: 0 auto;
61    padding: 1em 4em;
62}
63#logobar .logo {
64    float: left;
65}
66#logobar .title {
67    font-weight: 600;
68    color: #dddddd;
69    float: left;
70    margin: 5px 0 0 1em;
71}
72#logobar:after {
73    content: "";
74    display: block;
75    clear: both;
76}
77
78#content {
79    margin: 0 auto;
80    padding: 0 4em;
81}
82
83#table_of_contents > h2 {
84    font-size: 1.17em;
85}
86#table_of_contents ul:first-child {
87    border: solid 1px #e1e4e8;
88    border-radius: 6px;
89    padding: 1em;
90    background-color: #f6f8fa;
91    color: #393a34;
92}
93#table_of_contents ul {
94    list-style-type: none;
95    padding-left: 1.5em;
96}
97#table_of_contents li {
98    font-size: 0.9em;
99}
100#table_of_contents li a {
101    color: #000000;
102}
103
104header.title {
105    border-bottom: solid 1px #e1e4e8;
106}
107header.title > h1 {
108    margin-bottom: 0.25em;
109}
110header.title > .description {
111    display: block;
112    margin-bottom: 0.5em;
113    line-height: 1;
114}
115
116footer#edit {
117    border-top: solid 1px #e1e4e8;
118    margin: 3em 0 4em 0;
119    padding-top: 2em;
120}
121</style>
122</head>
123<body>
124<div id="banner">
125<div id="rainbar"></div>
126<div id="logobar">
127<svg class="logo" role="img" height="32" width="32" viewBox="0 0 700 700">
128<polygon fill="#cb0000" points="0,700 700,700 700,0 0,0"></polygon>
129<polygon fill="#ffffff" points="150,550 350,550 350,250 450,250 450,550 550,550 550,150 150,150"></polygon>
130</svg>
131<div class="title">
132npm command-line interface
133</div>
134</div>
135</div>
136
137<section id="content">
138<header class="title">
139<h1 id="install">install</h1>
140<span class="description">Download and install node and npm</span>
141</header>
142
143<section id="table_of_contents">
144<h2 id="table-of-contents">Table of contents</h2>
145<div id="_table_of_contents"><ul><li><a href="#description">Description</a></li><li><a href="#overview">Overview</a></li><li><a href="#checking-your-version-of-npm-and-nodejs">Checking your version of npm and Node.js</a></li><li><a href="#using-a-node-version-manager-to-install-nodejs-and-npm">Using a Node version manager to install Node.js and npm</a></li><li><a href="#using-a-node-installer-to-install-nodejs-and-npm">Using a Node installer to install Node.js and npm</a></li><ul><li><a href="#os-x-or-windows-node-installers">OS X or Windows Node installers</a></li><li><a href="#linux-or-other-operating-systems-node-installers">Linux or other operating systems Node installers</a></li><li><a href="#less-common-operating-systems">Less-common operating systems</a></li></ul></ul></div>
146</section>
147
148<div id="_content"><h3 id="description">Description</h3>
149<p>To publish and install packages to and from the public npm registry, you
150must install Node.js and the npm command line interface using either a Node
151version manager or a Node installer. <strong>We strongly recommend using a Node
152version manager to install Node.js and npm.</strong> We do not recommend using a
153Node installer, since the Node installation process installs npm in a
154directory with local permissions and can cause permissions errors when you
155run npm packages globally.</p>
156<h3 id="overview">Overview</h3>
157<ul>
158<li><a href="#checking-your-version-of-npm-and-nodejs">Checking your version of npm and
159Node.js</a></li>
160<li><a href="#using-a-node-version-manager-to-install-nodejs-and-npm">Using a Node version manager to install Node.js and
161npm</a></li>
162<li><a href="#using-a-node-installer-to-install-nodejs-and-npm">Using a Node installer to install Node.js and
163npm</a></li>
164</ul>
165<h3 id="checking-your-version-of-npm-and-nodejs">Checking your version of npm and Node.js</h3>
166<p>To see if you already have Node.js and npm installed and check the
167installed version, run the following commands:</p>
168<pre><code>node -v
169npm -v
170</code></pre>
171<h3 id="using-a-node-version-manager-to-install-nodejs-and-npm">Using a Node version manager to install Node.js and npm</h3>
172<p>Node version managers allow you to install and switch between multiple
173versions of Node.js and npm on your system so you can test your
174applications on multiple versions of npm to ensure they work for users on
175different versions.  You can
176<a href="https://github.com/search?q=node+version+manager+archived%3Afalse&amp;type=repositories&amp;ref=advsearch">search for them on GitHub</a>.</p>
177<h3 id="using-a-node-installer-to-install-nodejs-and-npm">Using a Node installer to install Node.js and npm</h3>
178<p>If you are unable to use a Node version manager, you can use a Node
179installer to install both Node.js and npm on your system.</p>
180<ul>
181<li><a href="https://nodejs.org/en/download/">Node.js installer</a></li>
182<li><a href="https://github.com/nodesource/distributions">NodeSource installer</a>. If
183you use Linux, we recommend that you use a NodeSource installer.</li>
184</ul>
185<h4 id="os-x-or-windows-node-installers">OS X or Windows Node installers</h4>
186<p>If you're using OS X or Windows, use one of the installers from the
187<a href="https://nodejs.org/en/download/">Node.js download page</a>. Be sure to
188install the version labeled <strong>LTS</strong>. Other versions have not yet been
189tested with npm.</p>
190<h4 id="linux-or-other-operating-systems-node-installers">Linux or other operating systems Node installers</h4>
191<p>If you're using Linux or another operating system, use one of the following
192installers:</p>
193<ul>
194<li><a href="https://github.com/nodesource/distributions">NodeSource installer</a>
195(recommended)</li>
196<li>One of the installers on the <a href="https://nodejs.org/en/download/">Node.js download
197page</a></li>
198</ul>
199<p>Or see <a href="https://nodejs.org/en/download/package-manager/">this page</a> to
200install npm for Linux in the way many Linux developers prefer.</p>
201<h4 id="less-common-operating-systems">Less-common operating systems</h4>
202<p>For more information on installing Node.js on a variety of operating
203systems, see <a href="https://nodejs.org/en/download/package-manager/">this page</a>.</p></div>
204
205<footer id="edit">
206<a href="https://github.com/npm/cli/edit/latest/docs/content/configuring-npm/install.md">
207<svg role="img" viewBox="0 0 16 16" width="16" height="16" fill="currentcolor" style="vertical-align: text-bottom; margin-right: 0.3em;">
208<path fill-rule="evenodd" d="M11.013 1.427a1.75 1.75 0 012.474 0l1.086 1.086a1.75 1.75 0 010 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 01-.927-.928l.929-3.25a1.75 1.75 0 01.445-.758l8.61-8.61zm1.414 1.06a.25.25 0 00-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 000-.354l-1.086-1.086zM11.189 6.25L9.75 4.81l-6.286 6.287a.25.25 0 00-.064.108l-.558 1.953 1.953-.558a.249.249 0 00.108-.064l6.286-6.286z"></path>
209</svg>
210Edit this page on GitHub
211</a>
212</footer>
213</section>
214
215
216
217</body></html>