Activating the agent

Get a license key

Your platform admin issues a license key from Platform Admin > Agent Licenses > Issue License.

The license key is a signed JWT that contains:

• Organization ID
• Maximum sensors allowed
• Allowed sensor types
• Expiry date

Activate

cybrium-agent activate --license "eyJhbGciOiJIUzI1NiJ9..."

On first activation, the agent:

1. Generates a hardware fingerprint (MAC + CPU + hostname hash)
2. Sends the license key + hardware ID to the platform
3. Receives an agent token for ongoing authentication
4. Saves configuration to ~/.cybrium-agent/config.json

Output:

Cybrium Agent — Activation

  License:     Valid
  Organization: Memorial Hospital
  Max sensors: 8
  Expires:     2027-04-23
  Hardware ID: a1b2c3d4...

  Agent activated successfully.

Hardware binding

The license binds to the specific machine on first activation. If you move the agent to a different machine, you need a new license.

This prevents license sharing and ensures each deployment is tracked.

Re-activation

If the agent token expires or is revoked, the agent automatically re-activates using the stored license key (if the license hasn't expired).