Skip to main content

Installation Methods

Installing and Running with the Distribution Archive

The distribution archives combine the application and all required resources in an archive file. If you are testing Nexus Repository Manager on a local workstation the files may be extracted and run from anywhere, for production see the platform specific sections. Extracting the files will result in an application directory and a data directory, further details about the folder structure and their contents can be found in Directories.

Note

To uninstall the repository manager from an archive installation, remove the service configuration and delete the entire directory.

Unix

The downloaded GZip’d TAR archive can be extracted with the command tar xvzf. For production it is not recommend that nexus be run from a users home directory, a common practice is to use /opt.

Running Repository Manager in the Foreground

To start the repository manager from application directory in the bin folder on a Unix-like platform like Linux use:

./nexus run

Starting the repository manager with the run command will leave it running in the current shell and display the log output. The running application can be stopped using CTRL+C at the appropriate console.

The application can be accessed once the the log shows the message "Started Sonatype Nexus."

Running Repository Manager in the Background

The nexus script can be used to manage the repository manager as a background application on OSX and Unix with the start, stop, restart, force-reload and status commands.

To start repository manager and run it in the background:

./nexus start

While running in the background, all logging will go to then application log file.

To stop repository manager running in the background:

./nexus stop

Windows

The zip archive can be unpacked using the Windows compression utility or a third party utility such as 7zip. Nexus Repository Manager should not be installed in the Program Files directory to avoid problems with Windows file registry virtualization. If you plan to run the repository manager as a specific user you can install it into the AppData\Local directory of that users home directory. Otherwise simply use e.g., C:\nexus or something similar, ensuring that the user running the application has full access. The Nexus Repository Manager executable nexus.exe can be found inside the bin directory and can be run as an application using the following command:

nexus.exe /run

Starting the repository manager with the run command will leave it running in the current shell and display the log output. You can access the application once the the log shows the message "Started Sonatype Nexus". The running application can be stopped using CTRL+C at the appropriate console.

The nexus.exe executable can be used to manage the repository manager as a service with the /start, /stop, /restart, /force-reload and / status commands.

Installing with the Helm Chart

A Helm Chart (GitHub, ArtifactHub) is available for our resiliency and high-availability deployment options. Be sure to read the deployment instructions in the associated README file before using the chart.

Sonatype provides a Helm Chart that can be used for our on-premises, AWS, and Azure resiliency and high availability deployment (HA) options only.

See Resiliency and High Availability for details about resilient and HA deployments

Installing with Docker

Docker automates the deployment of applications inside virtualized Linux containers. You can create a container that supports the installation of Nexus Repository Manager Pro and Nexus Repository Manager OSS. To install the repository manager with a Docker image, follow the steps at the Sonatype nexus3 Docker Hub image.

Installing using CloudFormation Templates on AWS

If you plan to deploy Nexus Repository Manager to AWS, we also make available CloudFormation templates.

Installing using the OpenShift Operator

An OpenShift operator is available for Sonatype Nexus Repository deployments using an external PostgreSQL database. The operator also supports deploying in high availability (active/active) mode. Full details are available in Installing Sonatype Nexus Repository Using the OpenShift Operator.