License & Activation Guide
Revenue Engine AI uses a domain-tied license key to validate your installation. The key is issued by Zybroz when you purchase the extension and is linked to the specific domain name of your SuiteCRM instance. This guide covers where to enter the key, how validation works, and what to do if activation fails.
Getting Your License Key
Your license key is provided by Zybroz at the time of purchase. It is delivered by email to the address used during checkout and is also available in your account dashboard at zybroz.com.
Each license key is:
- Domain-specific — tied to the exact domain name of your SuiteCRM installation (e.g.,
crm.yourcompany.com) - Single-installation — one key covers one SuiteCRM domain. Staging or development instances require separate keys or a multi-instance licence
- Version-independent — your key continues to work across minor version updates (e.g., v1.7.x) without reactivation
If you have not received your key or cannot locate it, contact support@zybroz.com with your purchase reference.
Entering Your License Key
- Log in to SuiteCRM as a system administrator.
- Open Revenue Engine AI from the navigation menu.
- Click the Settings icon in the dashboard header.
- Scroll to the License & Activation accordion section and expand it.
- Paste your license key into the input field.
- Click Save & Activate.
The system will validate the key against your domain and display one of the following statuses:
| Status | Meaning |
|---|---|
| License Active (green) | Key is valid and matches this domain. All features are enabled. |
| Domain Mismatch (red) | The key was issued for a different domain. Verify you are using the correct key for this installation. |
| Invalid Key (red) | The key format is incorrect or has been tampered with. Contact Zybroz support for a replacement. |
| Expired (amber) | The license has passed its renewal date. Renew at zybroz.com to restore full access. |
| Not Activated (grey) | No key has been entered yet. The extension is running in evaluation mode. |
How License Validation Works
Revenue Engine AI uses HMAC-SHA256 domain-tied key validation. When you enter a key:
- The PHP data bridge reads the domain of the current SuiteCRM installation from
$sugar_config['site_url']. - It computes an HMAC-SHA256 signature using the domain name and a Zybroz-held secret.
- It compares the computed signature against the key you entered.
- If they match, the license is marked active and stored in SuiteCRM’s config table.
This validation is entirely server-side and offline — no outbound request is made to Zybroz servers during activation. The key itself encodes the domain it is valid for, making it impossible to reuse on a different domain without a reissued key.
Security: Only SuiteCRM system administrators can save a license key. The license save endpoint returns HTTP 403 for non-admin users, even if they can view the License section in read-only mode.
What Runs Without a License
Revenue Engine AI will install and function without an active license. In evaluation mode (no key entered or key not yet activated), the following limitations apply:
- All 13 dashboard views are available and display live CRM data
- AI Insights (BYOK) may be limited or display an “Upgrade to unlock” prompt depending on your version
- A licence notice may appear in the Settings panel or dashboard footer
- SuiteCRM Store compliance requires a valid key for production use
The extension does not disable itself or remove data access without a licence — it is designed to let you evaluate fully before committing. However, for production deployments, an active license is required per the terms of use.
Renewing Your License
License renewal is handled at zybroz.com. When your license approaches its renewal date:
- Log in to your account at zybroz.com.
- Navigate to your purchased products and select Revenue Engine AI.
- Follow the renewal checkout process.
- A new license key will be issued to your email address.
- Enter the new key in Settings → License & Activation and click Save & Activate.
Renewal keys follow the same format and domain-tie as the original key. If your SuiteCRM domain has changed since the original purchase (e.g., you migrated to a new server), contact support@zybroz.com to have the key reissued for the new domain.
Troubleshooting Activation
“Domain Mismatch” error
This almost always means you are using a key purchased for a different domain. Common causes:
- You purchased the key for
crm.company.combut are installing onstaging.company.com - Your SuiteCRM
site_urlinconfig.phpdoes not exactly match the domain the key was issued for (check for trailing slashes orhttpvshttpsdifferences) - You are testing on a local development installation — contact support for a dev key
“Invalid Key” error
The key was entered incorrectly (extra space, missing characters) or may be corrupted. Copy the key directly from the email or your zybroz.com account dashboard and paste it without modification.
License section not visible in Settings
The License & Activation section is only visible to Admin-tier users. If you are logged in as a manager or rep and cannot see it, ask your SuiteCRM system administrator to enter the key on your behalf.
Revenue Engine AI v1.7.2 · Built by Zybroz · support@zybroz.com