Skip to main content

Installing Nexus Repository 2

Nexus Repository 2

The following instructions are for installing Nexus Repository Manager OSS or Nexus Repository Manager Pro as a stand-alone server. Nexus Repository Manager Pro and Nexus Repository Manager OSS are bundled with a Jetty instance that listens to all configured IP addresses on a host (0.0.0.0) and runs on port 8081 by default.

Installing the repository is straightforward. Unpack the web application archive in a directory. If you are installing the repository manager on a local workstation to give it a test run, you can install it in your home directory or wherever you like. Nexus Repository Manager Pro and Nexus Repository Manager OSS do not have any hard coded directories. It will run from any directory. If you downloaded the ZIP use:

$ unzip nexus-2.14.5-02-bundle.zip

And, if you download the GZip’d TAR archive, run:

$ tar xvzf nexus-2.14.5-02-bundle.tar.gz

For Nexus Repository Manager Pro the equivalent commands would be:

$ unzip nexus-professional-2.14.5-02-bundle.zip
$ tar xvzf nexus-professional-2.14.5-02-bundle.tar.gz

Warning

There are some known incompatibilities with the version of the tar command provided by Solaris and the GZip TAR format. If you are installing Nexus Repository Manager on Solaris, you must use the GNU tar application, or you will end up with corrupted files.

Note

If you are installing the repository manager on a server, you might want to use a directory other than your home directory. On a Unix machine, this book assumes that it is installed in /usr/local/nexus-2.14.4-03 with a symbolic link /usr/local/nexus to the nexus directory. Using a generic symbolic link nexus to a specific version is a common practice which makes it easier to upgrade when a newer version is made available.

$ sudo cp nexus-2.14.4-03-bundle.tar.gz /usr/local
$ cd /usr/local
$ sudo tar xvzf nexus-2.14.4-03-bundle.tar.gz
$ sudo ln -s nexus-2.14.4-03 nexus

Although it isn’t required to run, you may want to set an environment variable NEXUS_HOME in your environment that points to the installation directory. This documentation may refer to this location as $NEXUS_HOME.

Note

On Windows you should install the repository manager outside Program Files to avoid problems with Windows file registry virtualization. If you plan to run the repository manager as a specific user you could install into the AppData\Local directory of that users home directory. Otherwise simply go with e.g., C:\nexus or something similar.

The installation directory nexus-2.14.4-03 or nexus-professional-2.14.4-03 has a sibling directory named sonatype-work. This directory contains all of the repository and configuration data and is stored outside of the installation directory to make it easier to upgrade to a newer version.

By default, this directory is always a sibling to the installation directory. If you installed the repository manager in the /usr/local directory it would also contain a sonatype-work subdirectory with a nested nexus directory containing all of the content and configuration. The location of the sonatype-work directory can be customized by altering the nexus-work property in $NEXUS_HOME/conf/nexus.properties.