Quickstart

TL;DCO (too long; didn't check out)

Using docker-compose, just run docker-compose up in a directory containing our docker-compose.yml file. Soon after you'll have a working kappa instance set up to use a local couch instance (falling back to the public registry) on 0.0.0.0:8000.

Global Installation

$ npm install -g kappa

$ kappa -c config.json

Local Installation

If you choose to install locally, running kappa is as easy as

$ npm init

$ npm install --save kappa

# add start script to package.json:

# "scripts": {

# "start": "kappa -c config.json",

# }

$ npm start

You can then put those artifacts (config.json and package.json) under source control for simple deployments later:

rewriteTarballs (optional) - When true rewrites the tarball URL in packages to download each resource via kappa. When false, tarball URLs
are left untouched, allowing the client to download package tarballs directly from the registry that fulfilled the package request. Defaults to true.

For read operations (GET, HEAD, etc) the proxy will first attempt to fetch the module from the first registry.
If the requested module is not found it continues to the next registry, and so on.

For write operations the proxy will only attempt to write to the FIRST registry. All auth occurs with the first registry as well.