Skip to Content
PortcullisDocs
Integrate (product engineers)

Offline activation

Support air-gapped sites with activation request files and license file import.

Required if your product is sold to sites without internet access. The product's admin screen offers two actions: Generate activation request and Import license file.

Flow

  1. The operator clicks Generate activation request. The product writes <host>.req.
  2. The operator sends the file to Digicom support.
  3. Digicom staff upload it in the Portcullis console. Portcullis checks the product, enforces max_machines, records the machine (method offline), and returns a signed .lic file with mode: "offline" and the request's nonce echoed. Its exp is normally the license end date.
  4. The operator clicks Import license file. The product verifies it and stores it.

Request file

The .req file is the base64 encoding of this JSON (unsigned):

{
  "v": 1,
  "type": "activation_request",
  "productCode": "omnifleet",
  "fingerprint": "<64 hex chars>",
  "nonce": "<random 16 bytes base64url, also stored locally as pending>",
  "hostname": "omf-prod-01",
  "platform": "linux-x64",
  "productVersion": "3.4.0",
  "createdAt": "2026-11-14T09:00:00Z",
  "licenseKeyHint": "3ZC8D"
}
  • Store the nonce locally as the pending request nonce so you can match the returned file.
  • licenseKeyHint is optional: the last 5 characters of the license key, which helps Digicom find the right license.
  • Times are RFC 3339 UTC strings.
import { randomBytes } from 'node:crypto';
import os from 'node:os';

export function createActivationRequest(fingerprint: string, keyHint?: string): string {
  const nonce = randomBytes(16).toString('base64url');
  savePendingNonce(nonce); // persist in the data directory
  const request = {
    v: 1,
    type: 'activation_request',
    productCode: PRODUCT_CODE,
    fingerprint,
    nonce,
    hostname: os.hostname(),
    platform: `${process.platform}-${process.arch}`,
    productVersion: PRODUCT_VERSION,
    createdAt: new Date().toISOString(),
    ...(keyHint ? { licenseKeyHint: keyHint } : {}),
  };
  return Buffer.from(JSON.stringify(request), 'utf8').toString('base64');
}

Importing a license file

Use the same verification as for online files, with the offline nonce rule:

  • accept the file if claims.nonce matches the pending request nonce, or
  • accept it if it is for the same fingerprint and its iat is newer than the stored file's iat.

The second rule allows offline renewal: Digicom can issue a new file for an existing offline machine without a new request (the fingerprint is already known). The operator just imports it.

After a successful import, store the file atomically, clear the pending nonce, and re-evaluate the state.

Deactivation

Offline machines are deactivated by Digicom staff in the console, on the customer's request.

On this page