Maintenance & License•5 min read•License

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.

CIEL Enterprise Edition License Status and Quotas Overview

1. Edition Quotas & Capabilities

CIEL enforces resource boundaries based on the installed edition and optional modular add-on packs.

Resource / FeatureCommunity (Free)ProTeamEnterprise
Managed Hosts1030150Unlimited (999,999)
Project Workspaces1315Unlimited (999,999)
Team Users & RBAC1 (Single-User)1 (Single-User)5 (Multi-User RBAC)Unlimited (999)
Provisioner Endpoints1312Unlimited (999,999)
Monthly Provisioner Runs102502,500Unlimited (999,999)
Inbound Webhooks1415Unlimited (999,999)
Monthly Webhook Triggers1002,00020,000Unlimited (999,999)
Two-Way SaaS Callbacks0 (Disabled)500 / month5,000 / monthUnlimited (999,999)
Saved Runs550250Unlimited (999,999)
Cron Schedules325100Unlimited (999,999)
Runner Concurrency1 Parallel Job3 Parallel Jobs8 Parallel JobsUnlimited (999)
Execution Log Retention7 Days (FIFO)30 Days (FIFO)90 Days (FIFO)Unlimited
Telemetry & HeartbeatNone (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:

text
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

  1. Open the CIEL dashboard and navigate to System (/system) from the main sidebar.
  2. Click the License & Quotas tab.
  3. Click Activate License (or Upgrade License if already running a commercial tier).
  4. Paste your token string into the License Key Token textarea.
  5. 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:

Terminal(bash)
# 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.lic

Sample activation output:

text
[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.000Z

3. 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:

Terminal(bash)
ciel license status

Sample output:

text
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_callback

4. 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

  1. Navigate to System (/system) and switch to the License & Quotas tab.
  2. In the top-right corner of the license overview card, click Revert to Free.
  3. 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:

Terminal(bash)
ciel license deactivate

Output:

text
[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:

  1. The heartbeat sync fails gracefully and flags the status as offline_tolerated.
  2. CIEL grants an offline grace period of 2 days (CIEL_LICENSE_OFFLINE_GRACE_PERIOD_DAYS, default: 2).
  3. All commercial quotas, concurrency runners, and features remain fully operational during this window.
  4. 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

  1. Obtain the Controller Hardware ID (HWID): Run the hwid command on the target machine:

    Terminal(bash)
    ciel license hwid

    Output:

    text
    CIEL Hardware Identifier:
      CIEL-HWID-2E62-1550-B27F-755B
    
    Send this HWID to [email protected] to receive your node-locked Enterprise license.
  2. 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.

  3. Install the License on the Air-Gapped Host: Transfer the .lic file or token string to the controller host and activate it:

    Terminal(bash)
    ciel license activate /var/lib/ciel/license.lic

    The 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 error 422 NODE_LOCK_MISMATCH.

  4. Verify Offline Validation: Inspect the status to verify that the air-gapped feature is active:

    Terminal(bash)
    ciel license status

    The active features list will confirm air_gapped and audit_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.