Skip to main content
User guide

Activation

Which capabilities need a licence, how to get a trial, online and offline activation, licence states, upgrade notes.

The generic flow (online / offline, deactivation, common errors) is under Platform → Licence activation; this page covers what is specific to QRadar AI Copilot. "Activation" sits in the tabs of Settings, administrators only.

What needs a licence

TierWhat you get
UnactivatedAsk AI, offense sync and dispositions, all masking modes, posture / audit / reports / platform checks, under a daily LLM quota (200 by default)
Trial= Standard for 14 days, one host. Apply in the console
Standard / EnterpriseThe four paid engines: offense batch triage, offense investigation, rule copilot, platform-ops copilot (the AI read on Platform health)

The four paid engines ship encrypted: the image carries only ciphertext, and the licence server issues each key per tier, bound to the activated host. A gateway without a licence cannot run them.

Overview

CardMeaning
Licence stateSee the table below
ExpiryDays left; "renew soon" within 30 days
Unlocked featuresListed per feature, or "wildcard * (Enterprise)"
UsageToday's quota when unactivated; "unlimited" once activated; last heartbeat

States

StateMeaningDo
UnactivatedNo licence; free features under quotaApply for a trial or buy
ValidNormal
ExpiringWithin 30 days of expiryRenew, paste the new key
Grace periodOnline licence cannot reach the licence server but is inside the offline graceCheck outbound access to license.reallysec.com:443
Heartbeat lostGrace nearly used upSame; expires automatically after the grace period
Expired / revoked / invalidPaid engines lockedContact sales; invalid usually means the key belongs to another host

An invalid licence does not block login, logout, password change or deactivation.

Online activation

Online and offline activation

Paste the token from the console (starts with ey…) and click Activate. The gateway binds this host with the licence server and heartbeats every 5 minutes; renewals, tier changes and keys for new engines arrive over the heartbeat. The host fingerprint never has to be sent to anyone.

Offline activation

Air-gapped: copy the host fingerprint (64 hex characters), send it to Reallysec, and upload the returned .lic file (or paste its contents). Signature and fingerprint are verified locally; no heartbeat, nothing leaves the network. An offline licence's feature set is fixed in the file; renewals and tier changes need a re-issued one.

The fingerprint is derived from state/machine-id and state/server_guid in the install directory. Never regenerate them; back up the whole state/ directory.

Replace or renew / deactivate

  • Replace or renew: paste the new key and activate; no need to deactivate first.
  • Deactivate: back to unactivated; an online licence returns its host seat to the server. Do this before moving to another host.

On this page