Skip to main content
Licenses are the core entitlement records in Avalex. Each license ties a specific customer to a specific product and controls exactly how and where that product can be used — through IP address limits, hardware device (HWID) bindings, and expiration dates. When you issue a license, Avalex automatically inherits the slot limits defined on the associated product, so you rarely need to configure them manually. You can, however, override any of those values on a per-license basis at any time.
You need the licenses:write permission to issue or modify licenses in the portal.

​
Issuing a License

1

Go to Licenses

Select Licenses from the left-hand sidebar.
2

Click Issue License

Click the Issue License button in the top-right corner.
3

Select the customer and product

Choose the Customer this license belongs to and the Product it covers from the respective dropdowns.
4

Review inherited slot limits

Avalex automatically populates Max IPs and Max HWIDs from the product’s default values. You can override these now or adjust them later on the license detail page.
5

Set an expiration date (optional)

If this license should expire, enter the desired expiration as an expiresAtEpochMillis timestamp. Leave this blank for a perpetual license.
6

Issue the license

Click Issue. The license is created immediately and the customer can begin validating against it.

​
Managing Existing Licenses

Once a license has been issued, you can make targeted edits from the license detail page without affecting the underlying product or other licenses.

​
Editing Slot Limits

Change Max IPs or Max HWIDs directly on the license to override the product default. This is useful when a specific customer needs more or fewer slots than your standard configuration.

​
Unbinding IPs

Remove a specific IP address from the license’s usedIps list to free up that slot. This is helpful when a customer moves offices and needs to validate from a new IP address.

​
Unbinding HWIDs

Remove a hardware identifier from the usedHwids list to free up that device slot. This is most commonly needed when a customer replaces a computer or reinstalls their operating system.

​
Extending Expiration

Update the expiresAtEpochMillis field to push the expiration date forward — or remove it entirely to convert a time-limited license into a perpetual one.
Removing a HWID binding frees that slot for a new device. The previously-bound device will no longer be able to validate unless a new HWID slot is available on the license.

​
Viewing Validation Attempts

Every license in Avalex maintains a full history of the validation requests made against it. To access this history, go to Licenses, click the license you want to inspect, and select the Validation Attempts tab on the license detail page.
  • Each validation attempt is displayed with a green badge for a successful validation or a red badge for a failed one.
  • Each entry in the list shows the timestamp, client IP address, HWID, and status of the attempt.
  • You can use this history to investigate unusual validation patterns or confirm that a customer’s installation is working correctly.

​
License Schema