Documentation

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-enterprise and pivotgrid-react-enterprise alike. There is nothing separate to set up if you already installed one of them.

Where your credentials come from

Two places:

  1. Purchase email — the "Your license is ready" email contains a ready-to-paste .npmrc block under Private npm registry.
  2. DashboardDashboard → 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, .npmrc after. Project generators can wipe the directory they scaffold into — create-vite's --overwrite flag, 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

  1. Sign in at kanunilabs.com/dashboard.
  2. Open Licenses and click your license.
  3. In the Private npm registry section, click Regenerate credentials (or Generate credentials if you never had any).
  4. Copy the new .npmrc block 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 install will start failing with 401.

Your registry username never changes when you regenerate — only the password does.

Troubleshooting

SymptomCause & fix
404 Not Found for the enterprise packagenpm asked the public registry — the @kanunilabs:registry= line is missing, or .npmrc is not in the project root.
401 Unauthorized / 403 ForbiddenWrong or rotated password. Regenerate from the dashboard and update .npmrc / CI secrets.
Works locally, fails in CICI 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 refundRegistry access ends with the subscription — by design. Reactivating restores it.

Still stuck? Open a support ticket — we're happy to help.