npm is one of the most important and powerful features of Node.js. It allows you to share features and code as modules with other developers in the Node community. However, often teams want to pull Node modules from a local or private npm registry instead of from the global npmjs.org registry. There are several reasons for using a local private npm registry:
- Make it easy to share and use private modules within your team, without registering or distributing to the global npmjs.org.
- Provide governance around public npm module versions to insure stability.
- Insure security by limiting access to modules that have not been audited for security compliance.
- Organizations or companies that want to install their own npm-local server behind a firewall.
node-reggie is an experimental lightweight alternative to a full-blown npm registry. A team can stand it up in a few minutes, without having to install and manage a CouchDB datastore. Last weeks Miroslav Bajtoš update to Mike Brevoort‘s node-reggie adds extended support for the npm protocol. node-reggie currently supports:
- Registering/uploading packages generated by n
- Installing packages through a tarball npm dependency convention
- Supports basic semver wildcards (1.1.x) and ranges
- A few basic routes to see what’s registered
- Flat file storage that’s simple to back-up and restore
- [NEW] subset of npm registry protocol (allowing npm to talk to node-reggie)
Use reggie to stand up a private local npm registry
Install reggie to your local global npm cache
$npm install -g reggie and start the reggie server
$reggie-server -d ~/.reggie
Publishing packages to your private npm registry
$reggie -u http://127.0.0.1:8080 publish
Using packages from your private npm registry
From an npm install:
npm install http://127.0.0.1:8080/package/myPackageModule/1.0.0
or from within your json file:
you can also use wild-card ‘x’ or ‘latest’ versioning tags:
Using a private or on-premise npm is an important feature for teams who want to insure quality, security, and rapid delivery when building Node apps. Some additional features to check out
- Start-up Options for configuring repository directories, ports and ‘npm’ url
- Routing configurations
- support URL version conventions
Make sure to keep up to date with the latest strongloop distro for updates on support npm packages that improve your Node.js development, delivery and deployment.