These instructions are applicable if you are running Nexus Repository 3.0.0, 3.0.1, or 3.0.2.

If you are upgrading from version 3.1.0 or later, [please use these instructions instead](https://support.sonatype.com/hc/en-us/articles/115000350007).

## Before Upgrading

At runtime, Nexus Repository 3 picks up the default properties automatically. So if you update from OSS to PRO, PRO settings will persist (if a license is in place). Basically, any settings in `nexus.properties` will take precedence over `nexus-default.properties`. Our intent is that you DO NOT EDIT `nexus-default.properties`, only `nexus.properties`.

## Before Upgrading

Before you upgrade from 3.0.2 to 3.1.0, you’ll need to get familiar with the new [disk layout for 3.1.0](https://support.sonatype.com/hc/en-us/articles/231749327). It consists of a `sonatype-work` folder with a nested nexus3 directory containing all your content and configurations. Don’t modify your `nexus-defaults.properties` file. Instead, modify the `nexus.properties` file created in `sonatype-work` once you start version 3.1.0.

## Upgrading 3.0.2 to 3.1.0

Perform your upgrade as follows:

01. Locate your [3.0.2 data directory](https://support.sonatype.com/hc/en-us/articles/218707647).
02. Locate your 3.0.2 [application directory](https://support.sonatype.com/hc/en-us/articles/231742807#application-directory).
03. Download and [extract the distribution archive](https://support.sonatype.com/hc/en-us/articles/231740007) for 3.1.0 for your operating system.
04. Stop running version 3.0.2 of your Nexus Repository.
05. Manually back up the contents of the `$3.0.2-02/data` to another location.
06. Copy or move the contents of `$3.0.2-02/data` so they overwrite the contents of `/sonatype-work/nexus3/` in 3.1.0.
07. Create a `nexus.properties` file in `/sonatype-work/nexus3/etc` in 3.1.0.
08. Copy the contents of `$3.0.2-02/etc/org.sonatype.nexus.cfg` to `$3.1.0-04/../sonatype-work/nexus3/etc/nexus.properties`.
09. Remove any mention of `nexus-edition` or `nexus-features` in the 3.1.0 data directory, i.e. `$3.1.0-04/../sonatype-work/nexus3/etc/nexus.properties`.
10. In `$3.1.0-04/../sonatype-work/nexus3/etc/nexus.properties` replace each `${karaf.etc}` with `${jetty.etc}` in the `nexus-args` property. E.g. `nexus-args=${jetty.etc}/jetty.xml,${jetty.etc}/jetty-http.xml,${jetty.etc}/jetty-requestlog.xml`.
11. If you have made customizations in `$3.0.2-02/etc/`, you will need to manually re-apply these changes to 3.1.0-04.
12. Start Nexus Repository using the scripts in `nexus-3.1.0-04/bin/`, or your service.