Skip to main content

IQ Server Installation


The default password for the admin account is "admin123". This needs to be modified immediately after starting IQ to protect your new server. The notice "Change Administrator Password" will remain in place at the top of the UX until this has been done.


Review the System Requirements before installation.

IQ Server Installation

To Install the IQ Server:

  1. Download the latest version of IQ Server

  2. Create a directory where you want to install the IQ Server

  3. Move the IQ Server archive into the folder

    For example:

    cd /opt
    mkdir nexus-iq-server
    mv ~/Downloads/nexus-iq-server.* nexus-iq-server/
    cd nexus-iq-server
  4. Enter the directory

  5. Extract the archive with one of the following commands:

    unzip nexus-iq-server*.zip
    tar xfvz nexus-iq-server*.tar.gz

This unpacks the following files into your directory:



We recommend configuring the external database before starting the IQ Server for the first time.

See External Database Configuration for more information.

Start the IQ Server

Start the IQ Server with the following commands:

cd /opt/nexus-iq-server
java -jar nexus-iq-server-*.jar server config.yml 2> stderr.log


Linux requires a User to start IQ Server. See Running IQ Server as a Service for details and examples.

This starts the IQ Server using the configuration from the config.yml file. Output will be logged to the console and errors will be recorded in the stderr.log file. A successful start will result in a console message similar to the following:

... [main] org.eclipse.jetty.server.AbstractConnector - Started InstrumentedBlockingChannelConnector@
... [main] org.eclipse.jetty.server.AbstractConnector - Started SocketConnector@


IQ Server has required Java 8 since release 42. Older versions of Java will cause an error message on startup.

The IQ Server start command can be modified by adding Java configuration parameters to improve performance and adapt to the server hardware.

Log in to IQ Server

You can create users in the IQ Server realm, or by configuring LDAP.


Your first time logging in you will need to use the default Admin account. This default Admin account has all Administrative roles and permissions. Be sure to change the default admin password after logging in.

To log into the IQ Server:

  1. Navigate to your IQ Server installation (e.g. http://localhost:8070).

  2. Enter your username and password.

Select the Log Out link in the upper right corner to log out.


IQ server will time out after 30 minutes of inactivity.

Install the License

IQ Server requires a valid license. Your IQ Server license will be provided by the Sonatype support team as .lic file.

To install the product license:

  1. Log in to IQ Server

  2. Select Install License and upload your .lic file

  3. Accept the end user license agreement

You will be redirected to the Getting Started page.

Product Notifications

In-product notifications provide information about IQ Server releases. Click the notifications icon in the toolbar to view notifications. Unread notifications are indicated by a blue counter over the notification icon.


IQ Server Directories

IQ Server creates a directory to store its data and configuration during the initial startup. The default directory is ./sonatype-work/clm-server and can be configured in config.yml. This path is relative to the location of the invoking java command.

Running the default startup command from the installation directory causes /sonatype-work/clm-server to be created within it.

Set sonatypeWork to a different location to separate the installation and data directories.

A log directory is also created in the installation directory. Set the currentLogFilename parameter in config.yml to change the location.