System Requirements


The IQ Server is typically deployed on dedicated hardware. More specific hardware requirements are ultimately a function of the deployment architecture, the primary usage patterns and the scale of deployment.

With these influencing factors in mind, a general recommendation is provided as a starting point.

Development, test, or evaluation deployments can be scaled smaller than the recommendations and will continue to function, while performance degradation may be observed.

Installation Requirements



Recommend a processor with at least 8 CPU cores and 8GB of RAM for initial setup. A minimum of 6GB of process space should be available to the IQ Server. Additional RAM can improve the performance due to decreased disk caching.

Example: Dual Intel Xeon E5620 with 2.4Ghz, 12M Cache, 5.86 GT/s QPI, Turbo, HT.


Storage requirements range with the number of applications projected to use the IQ Server. 500 GB to 1 TB of free disk space should provide more than adequate resources.

Monitoring disk-space usage will help you gauge the storage needs in your actual deployment and react to growing demands in time.

The IQ Server is an I/O intensive application and disk speed will affect the performance of the IQ Server considerably. We therefore recommend to use local drives or SAN usage. Usage of network mapped storage via NFS or similar is not recommended. It is important to consider the I/O load when running IQ Server in a virtual machine, especially when other virtual machines on the same host are running other I/O intensive applications e.g. the Nexus Repository Manager.

Operating System

Generally, any machine that can run a supported Sun/Oracle Java version should work. Refer to the Oracle documentation for specifics: Oracle JDK 8 and JRE 8 Certified System Configurations. The most widely used operating system for the IQ Server is Linux and therefore customers should consider it the best tested platform.

User Account

It is recommended that an unprivileged service account be created if running the IQ Server as a daemon.


The IQ Server requires the following network access.

Inbound ( configurable ):

  • 8070 TCP: Main HTTP access port used by all IQ Server clients. Default connector is HTTP, binding to all interfaces on port 8070.
  • 8071 TCP: HTTP access for monitoring tools for monitoring and operational functions. Default connector is HTTP, binding to all interfaces on port 8071.


  • 443 TCP to : Used by the IQ Server to securely access Sonatype Data Services. This hostname and port are not configurable.

    Sonatype Data Services must be reachable by IQ Server on the following URL: .


To run the IQ Server or IQ CLI, use only Java 8 for versions before release 89. Starting with release 89, Java 11 is also supported.

OpenJDK officially supported since December 2018, IQ Server release 55. Prior to IQ Server release 63, the IQ Server used to check if the used JVM is supported. This check does not work for certain OpenJDK versions/flavors. You can disable this check by adding -Dclm.disableJreCheck=true to the command used to start the IQ Server.

Browser Requirements

Our general policy is to support the most recent modern browser version for your supported OS at time of IQ release date.

  • ESR (extended support release)
  • “Stable”


Safari (on OSX)
  • 5.1.9 corresponding to OS X 10.6
  • 6.0.4 corresponding to OS X 10.7 and 10.8
  • 7.1 corresponding to OS 10.9

JavaScript must be enabled for the chosen browser.

REST API Requirements

The IQ Server REST APIs are versioned. As a best practice we recommend using the latest version of the IQ Server in addition to the latest version of the REST APIs. This ensures your system will take advantage of the latest features and improvements.

However, we also realize that users of previous versions need to maintain this compatibility even when there is an update. For this reason, we do provide support for previous versions based on the criteria below.

Supported API Versions:

  • Sonatype CLM 1.12 and earlier - Only Supports REST API v1
  • Sonatype CLM 1.13 and later - Supports both REST API v1 and v2
  • IQ Server 1.17 to 1.22 - Recommend usage of v2 REST API only.
  • IQ Server 1.23 and later - Only Supports REST API v2.

Identifying the version of the API is simple. Below we have provided an example using the REST API for retrieval of an organization ID:


As you can see, the  v2  located just after  api  indicates the version of the API. If you find that the API version you are using is not documented, and would like information on upgrading to the latest version you can contact our support team for assistance.