License Activation & Quota Management
Activate commercial licenses, inspect resource quotas, and configure air-gapped or offline controller operations.
CIEL verifies licenses and resource quotas locally using Ed25519 asymmetric cryptographic signatures. Controllers do not require a persistent cloud connection to operate: Community and Enterprise editions function completely offline, while online commercial tiers (Pro and Team) tolerate network interruptions through an offline grace period before requiring telemetry synchronization.
1. Edition Quotas & Capabilities
CIEL enforces resource boundaries based on the installed edition and optional modular add-on packs.
| Resource / Feature | Community (Free) | Pro | Team | Enterprise |
|---|---|---|---|---|
| Managed Hosts | 10 | 30 | 150 | Unlimited (999,999) |
| Project Workspaces | 1 | 3 | 15 | Unlimited (999,999) |
| Team Users & RBAC | 1 (Single-User) | 1 (Single-User) | 5 (Multi-User RBAC) | Unlimited (999) |
| Provisioner Endpoints | 1 | 3 | 12 | Unlimited (999,999) |
| Monthly Provisioner Runs | 10 | 250 | 2,500 | Unlimited (999,999) |
| Inbound Webhooks | 1 | 4 | 15 | Unlimited (999,999) |
| Monthly Webhook Triggers | 100 | 2,000 | 20,000 | Unlimited (999,999) |
| Two-Way SaaS Callbacks | 0 (Disabled) | 500 / month | 5,000 / month | Unlimited (999,999) |
| Saved Runs | 5 | 50 | 250 | Unlimited (999,999) |
| Cron Schedules | 3 | 25 | 100 | Unlimited (999,999) |
| Runner Concurrency | 1 Parallel Job | 3 Parallel Jobs | 8 Parallel Jobs | Unlimited (999) |
| Execution Log Retention | 7 Days (FIFO) | 30 Days (FIFO) | 90 Days (FIFO) | Unlimited |
| Telemetry & Heartbeat | None (100% Offline) | Hourly (2-Day Grace) | Hourly (2-Day Grace) | None (Air-Gapped) |
Modular Scale Add-on Packs
Pro and Team subscriptions support attachable add-on packs to expand quotas without upgrading tiers:
- Host Pack: +100 Managed Hosts ($12/mo)
- User Pack: +5 User Seats ($10/mo, automatically enables multi-user RBAC on Pro)
- Provisioner Pack: +5 Provisioners and +1,000 monthly bootstrap runs ($10/mo)
- SaaS Callback Pack: +1,000 monthly two-way webhook callbacks ($9/mo)
2. Activating a Commercial License
A CIEL commercial license key is a cryptographically signed token string with four dot-separated segments:
CIEL-V1.<edition>.<payload_base64>.<signature_base64>When activated, the controller verifies the Ed25519 signature against the embedded master public key. If the signature matches and the expiration date has not passed, quotas unlock immediately.
Method A: Web Dashboard
- Open the CIEL dashboard and navigate to System (
/system) from the main sidebar. - Click the License & Quotas tab.
- Click Activate License (or Upgrade License if already running a commercial tier).
- Paste your token string into the License Key Token textarea.
- Click Activate License. The controller validates the token locally and updates active quota meters.
Method B: Command Line Interface (CLI)
You can activate a license directly on the host using the ciel binary. The CLI accepts either a raw token string or a file path containing the token:
# Activate using a token string
ciel license activate "CIEL-V1.pro.eyJhZGRvbnMi...signature"
# Activate from a license file (.lic or .key)
ciel license activate /etc/ciel/license.licSample activation output:
[INFO] Read license key from file: /etc/ciel/license.lic
[OK] License activated successfully!
[INFO] Edition: PRO
[INFO] Customer: [email protected]
[INFO] Expires: 2027-10-18T00:00:00.000Z3. Inspecting License Status & Quotas
Method A: Web Dashboard
The License & Quotas tab in System Diagnostics (/system) displays live usage progress bars for each resource limit:
- Current vs Max Usage: Color-coded indicators show green under 80% capacity, amber between 80% and 99%, and red when a quota is exhausted.
- Available Headroom: Displays remaining slots and percentage of free capacity.
- Active Features: Badges confirm features enabled by your edition, such as Multi-User RBAC, Two-Way SaaS Callbacks, or Unlimited Retention.
Method B: Command Line Interface (CLI)
Run ciel license status (or ciel license info) to display the current licensing overview, quota tables, and active features:
ciel license statusSample output:
CIEL Licensing & Quota Status
─────────────────────────────
License Overview
┏━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Property ┃ Value ┃
┡━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ License Edition │ PRO │
│ Licensee / Customer │ [email protected] │
│ Status │ ACTIVE / VALID │
│ Hardware ID (HWID) │ CIEL-HWID-2E62-1550-B27F-755B │
│ Expiration Date │ 2027-10-18T00:00:00.000Z │
└─────────────────────┴──────────────────────────┘
Resource Quotas
┏━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
┃ Resource ┃ Usage / Quota ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━┩
│ Managed Hosts │ 14 / 30 │
│ Projects │ 2 / 3 │
│ Provisioners │ 1 / 3 │
│ Monthly Provisioner Runs │ 42 / 250 │
│ Webhooks │ 2 / 4 │
│ Monthly Webhook Triggers │ 184 / 2000 │
│ Registered Users │ 1 / 1 │
│ Concurrency Limit │ 3 │
└──────────────────────────┴───────────────┘
Active Modular Add-ons
┏━━━━━━━━━━━━━┳━━━━━━━━━━━┓
┃ Add-on Pack ┃ Quantity ┃
┡━━━━━━━━━━━━━╇━━━━━━━━━━━┩
│ hosts │ 0 pack(s) │
│ users │ 0 pack(s) │
└─────────────┴───────────┘
[INFO] Active Features: audit_retention_30d, saas_callback4. Deactivating & Reverting to Community Edition
If you need to move a commercial license to a different server or cancel a subscription:
Method A: Web Dashboard
- Navigate to System (
/system) and switch to the License & Quotas tab. - In the top-right corner of the license overview card, click Revert to Free.
- Confirm the action in the prompt. The instance will immediately clear the commercial key and enforce Community limits (max 10 hosts, 1 project, 1 runner concurrency, 7-day retention).
Method B: CLI
Run ciel license deactivate:
ciel license deactivateOutput:
[OK] License deactivated successfully. Reverted to Community edition limits.Existing playbooks, inventories, job execution logs, and project files remain intact. If your active host or project count exceeds Community limits, existing data is preserved, but adding new hosts or creating new projects will be blocked until usage is brought under the threshold or a commercial license is reactivated.
5. Heartbeat Telemetry & Offline Grace Period
To support transient network outages on on-premise controllers, CIEL distinguishes between connected commercial editions and air-gapped deployments.
Hourly Telemetry Synchronization (Pro & Team)
Controllers running Pro or Team licenses periodically contact the CIEL licensing hub every hour (CIEL_LICENSE_HEARTBEAT_INTERVAL_SECONDS, default: 3600 seconds) via POST /api/v1/telemetry/sync. The synchronization payload contains non-sensitive operational metrics:
- Hardware ID (HWID) and License ID
- Controller version and hostname
- Active host count and project count
- Concurrency and monthly run counters
Hardware Binding & Node Protection (Pro & Team)
When a Pro or Team license is activated, CIEL automatically binds the license to the controller's Hardware ID (HWID) in the CIEL Customer Hub database:
- Automatic Binding: On initial activation, the Hub records the controller's HWID.
- Hardware Mismatch Guard: Subsequent activation or sync requests from a different server or container with a mismatched HWID are rejected with HTTP 403
LICENSE_HARDWARE_MISMATCH. - Server Migration & HWID Reset: If you move your controller to a new server or virtual machine, sign in to your account at cielstack.com/dashboard/license and click Unbind Server / Reset HWID. Once unbound, the license locks onto your new server upon its next activation.
Offline Grace Window (2 Days)
If your controller loses outbound internet connectivity:
- The heartbeat sync fails gracefully and flags the status as
offline_tolerated. - CIEL grants an offline grace period of 2 days (
CIEL_LICENSE_OFFLINE_GRACE_PERIOD_DAYS, default: 2). - All commercial quotas, concurrency runners, and features remain fully operational during this window.
- If connectivity is restored within 2 days, the next hourly sync resets the grace timer automatically.
What Happens When the Grace Period Expires?
If the controller remains disconnected from the license hub beyond the 2-day grace window:
- The controller status switches to
grace_period_expired. - New playbook runs are blocked with HTTP 403
LICENSE_GRACE_PERIOD_EXPIRED. - Running background jobs complete their active tasks without interruption.
- Web UI, host inventories, credentials, and logs remain accessible.
- Restoring network connectivity and allowing the hourly sync to succeed immediately lifts the execution block.
6. Air-Gapped Deployments (Enterprise)
For banking, defense, and high-security isolated infrastructure where outbound internet access is prohibited:
Enterprise licenses operate in Air-Gapped Mode (air_gapped: true). Air-gapped controllers never initiate outbound HTTP connections to the licensing hub and are completely exempt from heartbeat synchronization and grace period expiration.
Step-by-Step Air-Gapped Setup
-
Obtain the Controller Hardware ID (HWID): Run the
hwidcommand on the target machine:Terminal(bash)ciel license hwidOutput:
textCIEL Hardware Identifier: CIEL-HWID-2E62-1550-B27F-755B Send this HWID to [email protected] to receive your node-locked Enterprise license. -
Generate the Node-Locked License: Email this HWID to your CIEL representative or input it into the CIEL Admin Console under Target Hardware ID (HWID). The generated Enterprise token embeds the HWID directly into the Ed25519 payload (
node_lock_id). Because this value is cryptographically signed, it cannot be altered or transferred to other hardware. -
Install the License on the Air-Gapped Host: Transfer the
.licfile or token string to the controller host and activate it:Terminal(bash)ciel license activate /var/lib/ciel/license.licThe controller verifies the Ed25519 signature and confirms that
local_hwid == token.node_lock_id. If activated on mismatched hardware, the controller rejects the license with error422 NODE_LOCK_MISMATCH. -
Verify Offline Validation: Inspect the status to verify that the air-gapped feature is active:
Terminal(bash)ciel license statusThe active features list will confirm
air_gappedandaudit_retention_unlimited. The controller will execute all automation workflows without any internet access.
7. Quota Enforcement & Compliance Audits
CIEL protects against quota violations through real-time API guards and scheduled background compliance audits.
Real-Time API Guards
- Host Creation: Attempting to add an 11th host on Community returns HTTP 403
LICENSE_HOST_QUOTA_EXCEEDED. - Project Creation: Creating a 2nd project workspace on Community returns HTTP 403
LICENSE_PROJECT_QUOTA_EXCEEDED. - Concurrency Limit: When the active job count reaches the concurrency limit (1 on Community, 3 on Pro, 8 on Team), subsequent executions queue safely in Redis until a runner slot frees up.
- Two-Way SaaS Callbacks: Webhook callbacks with custom HTTP postbacks return HTTP 403 on Community and require Pro or Team.
Background Compliance Worker
An internal background worker runs periodically on the controller to audit database records:
- Checks if out-of-band database imports or restores exceeded host or project limits.
- Evaluates license expiration dates against system time.
- Enforces FIFO log pruning based on your edition retention policy (7 days for Community, 30 days for Pro, 90 days for Team, unlimited for Enterprise).
If an audit detects a non-compliant state (e.g. host count exceeding license limit), it flags compliance_status: "quota_exceeded" and temporarily blocks new playbook launches until the surplus resources are removed or the license is upgraded.