CLI Commands

Complete reference for the licenz command-line interface.

Global Options

Option	Description
--help, -h	Show help information
--version, -V	Show version number
--quiet, -q	Suppress non-error output
--json	Output in JSON format
--config <path>	Path to config file

License Commands

licenz license create

Create a new license.

licenz license create \
  --product <PRODUCT_ID> \
  --email <CUSTOMER_EMAIL> \
  --type <subscription|perpetual|trial> \
  [--expires <DATE>] \
  [--features <FEATURES>] \
  [--metadata <KEY=VALUE>]

licenz license list

List licenses for a product.

licenz license list \
  [--product <PRODUCT_ID>] \
  [--status <active|expired|revoked>] \
  [--limit <N>]

licenz license verify

Verify a license key.

licenz license verify <LICENSE_KEY> \
  [--hardware] \
  [--offline]

licenz license revoke

Revoke a license.

licenz license revoke <LICENSE_ID> \
  [--reason <REASON>]

licenz license status

Check the status of the currently installed license.

licenz license status

Product Commands

licenz product create

Create a new product.

licenz product create <NAME> \
  [--description <DESC>] \
  [--features <FEATURES>]

licenz product list

List all products.

licenz product list [--limit <N>]

licenz product keys

Show or rotate product signing keys.

# Show public key
licenz product keys <PRODUCT_ID>

# Rotate keys
licenz product keys <PRODUCT_ID> --rotate

Sneakernet Commands

licenz sneakernet request

Generate an offline activation request file.

licenz sneakernet request \
  --product <PRODUCT_ID> \
  [--output <FILE>]

licenz sneakernet install

Install a license from a response file.

licenz sneakernet install <RESPONSE_FILE>

licenz sneakernet status

Check sneakernet activation status.

licenz sneakernet status

Support Commands

licenz support-bundle

Generate a diagnostic support bundle.

licenz support-bundle \
  [--output <FILE>] \
  [--encrypt]

Configuration Commands

licenz config init

Initialize CLI configuration interactively.

licenz config init

licenz config show

Display current configuration.

licenz config show

licenz config set

Set a configuration value.

licenz config set <KEY> <VALUE>

Environment Variables

Variable	Description
LICENZ_API_KEY	API key for authentication
LICENZ_ORG_ID	Organization ID
LICENZ_API_URL	API endpoint (for self-hosted)
LICENZ_CONFIG_PATH	Path to config file

Exit Codes

Code	Meaning
0	Success
1	General error
2	Invalid arguments
10	License invalid
11	License expired
12	Hardware mismatch
20	Network error
21	Authentication error

Examples

Complete Workflow

# Initialize configuration
licenz config init

# Create a product
licenz product create "My Application"

# Create a license
licenz license create \
  --product prod_abc123 \
  --email customer@example.com \
  --type subscription \
  --expires 2025-12-31

# Verify the license
licenz license verify LIC-XXXXX-XXXXX-XXXXX

Offline Activation

# On the air-gapped machine
licenz sneakernet request --product prod_abc123

# Transfer the .req file, get the .resp file, then:
licenz sneakernet install license_response.resp

# Verify
licenz license status