Getting Started/Licensing & Authentication
Docs/Getting Started/Licensing & Authentication

Licensing & Authentication

Configure your Imagerry Pro license key for CLI and API servers.

Imagerry CLI utilizes your Imagerry Pro license key. You can supply your license key using an environment variable or as a command-line flag.

Method 1: Environment Variable (Recommended)

Set IMAGERRY_LICENSE_KEY in your shell configuration profile or CI/CD secret manager:

|bash
# macOS / Linux (~/.zshrc or ~/.bashrc)
export IMAGERRY_LICENSE_KEY="YOUR_PRO_LICENSE_KEY"

# Windows PowerShell
$env:IMAGERRY_LICENSE_KEY="YOUR_PRO_LICENSE_KEY"

Once exported, all subsequent imagerry commands will automatically detect and use the license key without requiring additional flags.

Method 2: Command-Line Flag

Pass the key explicitly when invoking the CLI:

|bash
imagerry -i raw.png -o out.png --preset mesh --license-key=YOUR_PRO_LICENSE_KEY
Pro Tip

No Device Limits for CLI & CI/CD

License verification for the CLI does not count toward personal desktop device seat limits. You can safely deploy the CLI across all your automated build runners, Docker containers, and GitHub Actions workers.

Security & Privacy

24-Hour Offline Cache

Once validated, license verification is cryptographically cached on your machine for 24 hours. The CLI runs with zero network latency and full offline support.

Found an issue or typo? Report on GitHub
Imagerry CLI Docs • v0.2.0-beta