Private registry access
The Enterprise packages are not published on public npm. They install from our
private registry at registry.kanunilabs.com, and every license comes with its
own registry credentials: a username like cust_ab12cd34 and a password.
| Package | For |
|---|---|
@kanunilabs/datagrid-react-enterprise | React |
@kanunilabs/datagrid-enterprise | plain JavaScript, no framework |
The same credentials serve every package. One license, one registry account — use it for
datagrid-react-enterprise,datagrid-enterprise,pivotgrid-react-enterpriseandpivotgrid-enterprisealike. There is nothing separate to set up if you already installed one of them.
Where your credentials come from
Two places:
- Purchase email — the "Your license is ready" email contains a
ready-to-paste
.npmrcblock under Private npm registry. - Dashboard — Dashboard → Licenses, open your license, and use the Private npm registry section.
We store only a hash of the password, so it can never be shown again after the first time. Losing it costs nothing: regenerating takes one click (see below).
Set up your project
Put the three lines from your email (or the dashboard) into a .npmrc file
next to your package.json:
@kanunilabs:registry=https://registry.kanunilabs.com/
//registry.kanunilabs.com/:_auth=<value from your email or dashboard>
//registry.kanunilabs.com/:always-auth=true
Then install as usual:
# React
npm install @kanunilabs/datagrid-react-enterprise
# or plain JavaScript, no framework
npm install @kanunilabs/datagrid-enterprise
Peer dependencies are resolved automatically by npm 7+ — one command is enough.
The first line routes only the @kanunilabs scope to our registry, which
also transparently serves the public @kanunilabs/datagrid-core,
@kanunilabs/datagrid-react and @kanunilabs/datagrid packages. Everything
else about your setup is unchanged.
⚠️ Scaffold first,
.npmrcafter. Project generators can wipe the directory they scaffold into —create-vite's--overwriteflag, for example, deletes an existing.npmrc. Create the project first, then add the file.
Keeping the token out of git (teams & CI)
.npmrc holds a secret, so either add it to .gitignore, or commit a variable
version and inject the value from the environment — npm expands ${VAR} inside
.npmrc:
@kanunilabs:registry=https://registry.kanunilabs.com/
//registry.kanunilabs.com/:_auth=${KANUNILABS_REGISTRY_AUTH}
//registry.kanunilabs.com/:always-auth=true
Set KANUNILABS_REGISTRY_AUTH (the _auth value from your email or dashboard)
as a CI secret or in your local shell.
Lost or leaked password? Regenerate it
- Sign in at kanunilabs.com/dashboard.
- Open Licenses and click your license.
- In the Private npm registry section, click Regenerate credentials (or Generate credentials if you never had any).
- Copy the new
.npmrcblock right away — it is shown only once.
⚠️ Regenerating invalidates the previous password immediately. Update every place that uses it (developer machines, CI secrets) at the same time, or their
npm installwill start failing with401.
Your registry username never changes when you regenerate — only the password does.
Troubleshooting
| Symptom | Cause & fix |
|---|---|
404 Not Found for the enterprise package | npm asked the public registry — the @kanunilabs:registry= line is missing, or .npmrc is not in the project root. |
401 Unauthorized / 403 Forbidden | Wrong or rotated password. Regenerate from the dashboard and update .npmrc / CI secrets. |
| Works locally, fails in CI | CI cannot see your .npmrc or its env var. Use the ${VAR} form above and set the secret in your CI provider. |
| Installed fine, but the grid shows "Unlicensed" | The package is installed; the license key is a separate step. See Enterprise & licensing. |
| Access stopped after cancellation or refund | Registry access ends with the subscription — by design. Reactivating restores it. |
Still stuck? Open a support ticket — we're happy to help.