Skip to content
  • license

License Management

License Management

Section titled “License Management”

LeanJ offers Free and Pro tiers. Manage your license through the CLI.

License Tiers

Section titled “License Tiers”

Free Tier

Section titled “Free Tier”

Features:

  • Basic profiling
  • IntelliJ integration
  • CLI commands
  • Docker support

Limitations:

  • Standard features only

Pro Tier

Section titled “Pro Tier”

Features:

  • All Free features
  • Advanced analytics
  • Priority support
  • Additional insights

Purchasing a License

Section titled “Purchasing a License”

Step 1: Open Purchase Page

Section titled “Step 1: Open Purchase Page”
Terminal window
leanj license purchase

This opens the Lemon Squeezy checkout page in your browser.

Step 2: Complete Purchase

Section titled “Step 2: Complete Purchase”
  1. Select Pro license
  2. Complete payment
  3. Receive license key via email

Step 3: Activate License

Section titled “Step 3: Activate License”
Terminal window
leanj license login <your-license-key>

Example:

Terminal window
leanj license login abc123-def456-ghi789

Checking License Status

Section titled “Checking License Status”

Human-Readable Format

Section titled “Human-Readable Format”
Terminal window
leanj license status

Output:

License: Pro
Status: Active
Expires: 2025-12-31
Features: All Pro features enabled

JSON Format

Section titled “JSON Format”
Terminal window
leanj license status --json

Output:

{
  "tier": "pro",
  "status": "active",
  "expiresAt": "2025-12-31T23:59:59Z",
  "features": ["all"]
}

Validating License

Section titled “Validating License”

Manual Validation

Section titled “Manual Validation”
Terminal window
leanj license validate

Note: License validation is cached for 24 hours to reduce API calls.

Automatic Validation

Section titled “Automatic Validation”
  • Validates on login
  • Re-validates after cache expires (24 hours)
  • Uses cached data when offline

License Information

Section titled “License Information”

Detailed Info

Section titled “Detailed Info”
Terminal window
leanj license info

Shows:

  • License tier
  • Status
  • Expiration date
  • Features enabled
  • Machine ID

Logging Out

Section titled “Logging Out”

Return to Free Tier

Section titled “Return to Free Tier”
Terminal window
leanj license logout

Note: This removes the license key from local storage. You can log in again with the same key.

License Storage

Section titled “License Storage”

Location

Section titled “Location”

File: ~/.leanj/license.json

Format:

{
  "licenseKey": "abc123-def456",
  "tier": "pro",
  "expiresAt": "2025-12-31T23:59:59Z",
  "machineId": "xyz789",
  "validatedAt": "2025-01-01T00:00:00Z"
}

Security:

  • Stored locally
  • Not transmitted unnecessarily
  • 24-hour validation cache

Configuration

Section titled “Configuration”

API URL

Section titled “API URL”

Environment Variable:

Terminal window
export LEANJ_LICENSE_API_URL=https://license-api.leanj.com/v1

Default: Cloudflare Worker endpoint

Machine ID

Section titled “Machine ID”

Auto-Generated:

  • Created automatically on first use
  • Stored in license file
  • Used for license validation

Manual Override:

Terminal window
export LEANJ_MACHINE_ID=abc123

Development Mode

Section titled “Development Mode”

For Testing:

Terminal window
export LEANJ_DEV_MODE=true

Warning: Only for testing. Do not use in production.

Troubleshooting

Section titled “Troubleshooting”

License Validation Failed

Section titled “License Validation Failed”

Error: License validation failed or Network error

Solutions:

  1. Check internet connection:

    Terminal window
    ping license-api.leanj.com

  2. Verify license key:

    Terminal window
    leanj license status

  3. Retry validation:

    Terminal window
    leanj license validate

  4. Check API URL:

    Terminal window
    echo $LEANJ_LICENSE_API_URL

Rate Limit Exceeded

Section titled “Rate Limit Exceeded”

Error: Rate limit exceeded

Solutions:

  1. Wait before retrying:

    • License validation is cached for 24 hours
    • Wait a few minutes before retrying

  2. Use cached license:

    • Offline mode uses cached data
    • Check ~/.leanj/license.json

License Expired

Section titled “License Expired”

Error: License expired

Solutions:

  1. Check expiration date:

    Terminal window
    leanj license info

  2. Renew license:

    • Purchase new license
    • Or contact support

Invalid License Key

Section titled “Invalid License Key”

Error: Invalid license key

Solutions:

  1. Verify key format:

    • Check for typos
    • Ensure complete key

  2. Re-enter key:

    Terminal window
    leanj license login <correct-key>

Best Practices

Section titled “Best Practices”

  1. Keep license key secure:

    • Don’t share license keys
    • Store securely

  2. Monitor expiration:

    • Check status regularly
    • Renew before expiration

  3. Use validation cache:

    • Avoid frequent validation calls
    • Let 24-hour cache work

  4. Backup license file:

    • Copy ~/.leanj/license.json
    • Restore if needed

Next Steps

Section titled “Next Steps”