Private registry access
@kanunilabs/datagrid-react-enterprise is not published on public npm. It
installs 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.
The same credentials serve both products. One license, one registry account — use it for
datagrid-react-enterpriseandpivotgrid-react-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:
npm install @kanunilabs/datagrid-react-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 and
-react 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.