Documentation menuCLI
CLI
Create key pairs, issue, verify and inspect licenses from the terminal.
npx integral keygen # prints INTEGRAL_PUBLIC_KEY and INTEGRAL_PRIVATE_KEY
npx integral keygen --out ./keys # writes two files, the private one with mode 600
npx integral keygen --alg es256 # ECDSA P-256 instead of Ed25519 (for KMS/HSM keys)
npx integral migrate <license>... # re-signs int1 licenses as int2, one per line on stdout
npx integral issue --product my-app --plan pro \
--feature beta --limit projects=100 --limit seats=unlimited \
--email kunde@example.ch --name "Kunde AG" \
--updates-until 2027-10-05
| Option | Meaning |
|---|---|
--private-key, --private-key-file | Signing key. Default: INTEGRAL_PRIVATE_KEY |
--feature | Extra feature, repeatable |
--limit key=n | Limit override, unlimited for no limit, repeatable |
--seats | Number of seats |
--email, --name, --customer-id | Customer |
--expires | Hard expiry |
--updates-until | End of updates |
--machine | Bind to one device (id from machineId()) |
--trial | Mark as trial license |
--id, --kid | License id, key id |
npx integral verify <license> --public-key <key> --product my-app # exit code 0 or 1
npx integral inspect <license> # shows the content, unchecked
echo "$LICENSE" | npx integral verify - --public-key "$INTEGRAL_PUBLIC_KEY"
npx integral revoke lic_123 lic_456 --product my-app > revoked.txt # signed revocation list
npx integral verify <license> --public-key <key> --revocations revoked.txt --machine <id>
npx integral request <license> --machine <id> --label "Workshop PC" > activation.txt
npx integral activate - --product my-app < activation.txt
request packs a license and a device id for offline activation. activate checks the license with your private key's public key and prints a copy bound to the device. It exits with 1 and the reason if the license is invalid or bound to another device.