Upgrade Compatibility - Repository Manager 2 to 3

Requirement: Always Use Latest Versions

Sonatype always recommends having the latest version 2 upgrading to the latest version 3 (as well as IQ Server for applicable users).  Latest versions have the latest bug fixes, especially important for the upgrade process and compatibility with new features of Nexus Repository Manager 3.

Upgrading to an older NXRM3 then subsequently updating to the latest NXRM3 is not equivalent, as it will hit old upgrade bugs.

Requirement: Always Use Same License

When upgrading from repository manager 2 to 3, both versions must have the same licensing setup

The same license file can be used in NXRM2 and NXRM3 or a license can always be applied at a later time.

Licensing: Valid Upgrade PathLicensing: Unsupported Upgrade Path

Nexus Repository Manager OSS 2 → Nexus Repository Manager OSS 3

Nexus Repository Manager Pro 2 → Nexus Repository Manager Pro 3

Nexus Repository Manager OSS 2 → Nexus Repository Manager Pro 3

Nexus Repository Manager Pro 2 → Nexus Repository Manager OSS 3

Supported Nexus Repository Manager Upgrade Paths

Find the repository manager version you have in the left column. Follow the upgrade procedure in the right column.

Source Nexus Repository ManagerRequired Upgrade Procedure
3.1.0 and newer
  1. Upgrade to latest available 3.x version
3.0.0 to 3.0.2
  1. Learn about important directory layout changes introduced in 3.1.0
  2. Upgrade to latest available 3.x version
3 milestone 7
  1. Upgrade to 3.0.0
  2. Learn about important directory layout changes introduced in 3.1.0
  3. Upgrade to latest available 3.x version
3 milestone 1 to milestone 6Upgrading these versions is not supported.
Latest 2.x version
  1. Upgrade to latest available 3.x version
2.0 or any later 2.x version
  1. Upgrade to latest available 2.x version
  2. Upgrade to latest available 3.x version
1.x
  1. Upgrade to any 2.x version up to 2.7.2 1
  2. Upgrade to latest available 2.x version
  3. Upgrade to latest available 3.x version

1  Versions after 2.7.2 do not include support for upgrading 1.x versions

The latest Nexus Repository Manager version 2 can be downloaded here.

The latest Nexus Repository Manager version 3 can be downloaded here.

Minimally Compatible Server Versions for Lifecycle Features

Below is a matrix of Sonatype server product versions minimally verified for lifecycle features . This does not mean all features are supported by these versions.

The table is suggesting that major issues should not be encountered running these minimal versions congruently.

If you encounter problems with any of the versions listed, we advise upgrading to the most recent version first to attempt resolution of the issue.

Version 2Version 3Minimum Lifecycle Firewall compatible IQ Server
2.14.83.12.11.46.0
2.14.63.8.01.42.0
2.14.53.7.11.33.0
2.14.43.4.0Not Supported
2.14.33.2.1Not Supported
2.14.23.2Not Supported
2.14.13.1Not Supported