Skip to main content

Product License

This section covers how to install the product license in the IQ Server.

  • The Sonatype account team provides the license as a .lic file in an email sent to the primary stakeholders.

  • The IQ Server saves the license details to the database table product_license once a license file is uploaded.

For details on features and functionality provided by the Sonatype license, see License and Features. See the following KB article to learn about the user-base license model.

Sonatype licenses covering multiple license models (based on the number of applications, users, or SBOMs) require IQ version 178+. Previous versions of IQ Server need to be upgraded before installing the new license.

Automatic license installation

During the initial setup, the server may be configured to install a license file automatically. This property is not used for existing installations. An error will occur if the license file cannot be accessed.

Add the following property to the config.yml and update the path to your license file. A relative or absolute path may be used.

licenseFile: ./license.lic

Install using the REST API

While the server is running, a license may be installed or removed using the API.

See Product License REST API for details.

Log in for the first time

The first time you log into the server, you must install a valid product license.

The default server credentials are the user admin with the password admin123

  1. Navigate to the server URL (e.g. http://localhost:8070)

  2. Enter using the default admin credentials

  3. Upload your .lic file and select Install License

  4. Accept the user license agreement

  5. Update your admin password

Updating the license

When you renew a Lifecycle or Firewall license with Sonatype, you'll be sent a new .lic file. To update the license, follow the steps below.

  1. Log in as an Administrator

  2. Select the gear from the toolbar

  3. Select Product License

  4. Select Update License

  5. Navigate to and upload the license file

The browser UI should immediately update to show the details of the new license file.