How-to

Activate an identity

Quick reference

For a first-time setup, follow Get Started → Activating an identity end to end. The summary below is the recipe once you know the flow.

Prerequisites

• A license purchased from hexaeight.com/pricing that covers the machine's CPU cores
• The 6-character license code from your purchase email
• The HexaEight Authenticator app on your phone, signed in to your email vault

Activate

# .NET
hexaeight-activate --newtoken

# Node.js
npx hexaeight-activate --newtoken

Answer the prompts in order:

1. Resource name — the identity name (custom hostname or generic web0-...)
2. Password — press Enter to auto-generate, or type your own
3. License code — the 6-character code from email
4. QR display — enter Y, open the printed URL in a browser, scan with the Authenticator app, approve within 2 minutes, press a key when prompted

Result

• env-file — four environment variables (HEXAEIGHT_RESOURCENAME, HEXAEIGHT_MACHINETOKEN, HEXAEIGHT_SECRET, HEXAEIGHT_LICENSECODE)
• hexaeight.mac — small machine-binding file

Renew a license

# .NET
hexaeight-activate --renewtoken

# Node.js
npx hexaeight-activate --renewtoken

Prompts only for the new license code. Updates HEXAEIGHT_MACHINETOKEN in env-file. Restart your application after renewal.

Check CPU cores before purchasing

hexaeight-activate --cpucores