npm-login - Login to a registry user account

NAME  Synopsis  Description  Configuration  registry  scope  auth-type  See Also 


npm-login - Login to a registry user account


npm login

Note: This command is unaware of workspaces.


Verify a user in the specified registry, and save the credentials to the .npmrc file. If no registry is specified, the default registry will be used (see npm help config).

When using legacy for your auth-type, the username and password, are read in from prompts.

To reset your password, go to ⟨⟩

To change your email address, go to ⟨⟩

You may use this command multiple times with the same user account to authorize on a new machine. When authenticating on a new machine, the username, password and email address must all match with your existing record.



Default: ""

Type: URL

The base URL of the npm registry.


Default: the scope of the current project, if any, or ""

Type: String

Associate an operation with a scope for a scoped registry.

Useful when logging in to or out of a private registry:

# log in, linking the scope to the custom registry
npm login --scope=@mycorp --registry=

# log out, removing the link and the auth token
npm logout --scope=@mycorp

This will cause @mycorp to be mapped to the registry for future installation of packages specified according to the pattern @mycorp/package.

This will also cause npm init to create a scoped package.

# accept all defaults, and create a package named "@foo/whatever",
# instead of just named "whatever"
npm init --scope=@foo --yes


Default: "web"

Type: "legacy" or "web"

What authentication strategy to use with login. Note that if an otp config is given, this value will always be set to legacy.

See Also

npm help registry

npm help config

npm help npmrc

npm help owner

npm help whoami

npm help token

npm help profile

Updated 2024-01-29 - |