IQ Server Installation


Check the IQ Server 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:

README.txt
config.yml
demo.bat
demo.sh
eula.html
nexus-iq-cli-1.125.0-01.jar
nexus-iq-server-1.125.0-01.jar

If you plan to use an external database, we highly recommend configuring it before starting the IQ Server.
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@0.0.0.0:8070
... [main] org.eclipse.jetty.server.AbstractConnector - Started SocketConnector@0.0.0.0:8071


IQ Server now requires Java 8 starting with the 1.42 release. If you are running on an older version of Java you may encounter an error message on startup. Check out the System Requirements for more information. 

The IQ Server start command can be modified by adding java configurations parameters such as -Xmx4g -XX:+UseG1GC to improve performance and adapt to the server hardware.

The web application can be accessed at port 8070 of your server via any web browser.

The initial startup will prompt you to install a License.

We recommend always using SSL to ensure confidentiality of report and credential data during transit. This can be done by setting up a proxy server. You can find more information in the HTTPS Configuration section of Configuring.

Log in to IQ Server

You must log in to IQ Server before it will function. You can create a user 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. localhost:8070).
  2. Enter your username and password.

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

IQ server will time out after 30 minutes of inactivity.

Product Notifications

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

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. Navigate to the IQ Server web application (e.g. http://localhost:8070).
  2. Sign in to the IQ Server with the default administrator login credentials (user ID "admin", password "admin123").
  3. Click the Install License button and upload your .lic file.
  4. Accept the end user license agreement.

After installing the license, you will be redirected to the Getting Started page.

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.