# 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](https://help.sonatype.com/en/licensing-and-features.html "License and Features"). See the following KB article to learn about the [user-base license model](https://support.sonatype.com/hc/en-us/articles/213464168-Sonatype-s-User-based-License-Model-FAQ).

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](https://help.sonatype.com/en/product-license-rest-api.html "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.
