Repository Management with Nexus

3.9. Installing the Nexus WAR

The Nexus Open Source WAR can run on most Java application servers. To download the Nexus Open Source WAR, go to Click on the Download Site link and then download the Nexus WAR. Once you have downloaded the Nexus Open Source WAR, you can install it in a servlet container or application server.


Testing of the WAR file install is currently only done on Tomcat and Jetty. The complexity of the task to get Nexus to run on an application server may vary depending on the server and the server version. It is strongly recommended to use the bundle install with the included Jetty application server instead of the WAR file. Support for Nexus Professional is only provided for the bundle install.

The process for installing a WAR in a servlet container or application server is going to vary for each specific application. Often, this installation process is as simple as dropping a WAR file in a special directory and restarting the container. In many cases it will be required to expand the war into a folder rather than deploying the unextracted WAR file for the plugin manager to work with all installed plugins and allow installation of additional plugins.

For example, to install the Nexus WAR in Tomcat, drop the nexus-2.10.0-02.war file in $TOMCAT_HOME/webapps and restart your Tomcat instance. Assuming that Tomcat is configured on port 8080 once Tomcat is started, Nexus will be available on http://localhost:8080/nexus-2.10.0-02.

If you would like a less verbose URL, copy nexus-2.10.0-02.war to a file named nexus.war before copying the distribution to $TOMCAT_HOME/webapps.

Manage your projects with Nexus

Use Nexus with Maven to keep your teams in sync.

Try Nexus Pro for Free

When installing Nexus as a WAR in an application server or servlet container, it automatically creates a sonatype-work directory in the home directory of the user running the application server. This directory contains all of the necessary configuration and repository storage for Nexus.