blob: 35aae9d001c2e7c3c5d0bd6cda7784f55f8ea8ae (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
npm-config(1) -- Manage the npm configuration file
==================================================
## SYNOPSIS
npm config set <key> <value>
npm config get <key>
npm config delete <key>
npm config list
## DESCRIPTION
The config command is a way to interact with the `.npmrc` file. This file is a
JSON encoded list of values that npm is concerned with. The first time you run
npm, it will create a conf file filled with default values.
On exit, the current state of the config is always saved, so that any changes
will be recorded. You may safely modify the file (as long as it's still
parseable JSON), but it is safer to use the npm config commands.
## Sub-commands
Config supports the following sub-commands:
### set
npm config set key value
Sets the config key to the value.
### get
npm config get key
Echo the config value to stdout. (NOTE: All the other npm logging is done to
stderr, so pipes should work properly, and you can do `npm get key 2>/dev/null`
to print out JUST the config value.)
### list
npm config list
Show all the config settings.
**FIXME**: Prints to stderr, but should really be stdout, since the log is what
you're after.
### delete
npm config delete key
Deletes the key from the configuration file.
## Config File Settings
### auto-activate
Default: true
Automatically activate a package after installation, if there is not an active
version already. Set to "always" to always activate when installing.
### root
Default: ~/.node_libraries
The root folder where packages are installed and npm keeps its data.
### registry
Default: http://registry.npmjs.org/
The base URL of the npm package registry.
### auth
A base-64 encoded "user:pass" pair.
**FIXME**: This is not encoded in any kind of security sense. It's just base-64
encoded strictly so that it can be sent along the wire with HTTP Basic
authentication. An upcoming version of npm will encrypt this and save it back
to the registry as `auth-crypt`, which will be quite a bit more secure. Until
then, use a unique password that you don't mind being compromised.
|