Skip to content

npm

mise-server proxies the npm registry, caching packuments (metadata) and tarballs.

Endpoints

GET /npm/{package}              # packument (metadata)
GET /npm/@{scope}/{package}     # scoped packument
GET /npm/{package}/-/{file}     # tarball download

Client Configuration

bash
npm config set registry http://your-server:3000/npm/

Or per-project in .npmrc:

ini
registry=http://your-server:3000/npm/

For scoped packages:

ini
@myorg:registry=http://your-server:3000/npm/

Upstream Override

toml
[settings.piers.npm]
upstream = "https://registry.npmmirror.com"
bash
export MISE_SERVER_NPM_UPSTREAM=https://registry.npmmirror.com

Hosted / Private Packages

mise-server supports npm publish for hosting private packages. Published packages take precedence over upstream cached versions.

bash
npm publish --registry http://your-server:3000/npm/

See Hosted Packages for details.

Licensed under FSL-1.1-ALv2. Maintained by @jdx.