Sonatype Nexus Repository Core

Sonatype Nexus Repository is the single source of truth for all your internal and third-party binaries, components, and packages. Integrate all your development tools into a centralized binary repository manager so that you can choose the best open source components, optimize your build performance, and ship code quickly while increasing visibility across your SDLC.

This is the open source codebase of Nexus Repository Core. This contains functionality for maven, raw, and APT repository formats, and uses an embedded H2 database that is appropriate for small workloads.

For a fully-featured version of Nexus Repository, download the Community Edition binary from https://www.sonatype.com/products/nexus-community-edition-download. Community Edition includes additional format support such as npm, Docker, NuGet, PyPI and many others. It also allows use of an external PostgreSQL database that allows you to deploy Nexus Repository under Kubernetes.

Issues

If you are using Nexus Repository Core or Community Edition and need to report an issue or request an enhancement, open an issue here.

For help with Nexus Repository Core or Community Edition, please join the Sonatype Community to get tips and tricks from other users.

To report a security vulnerability, please see https://www.sonatype.com/report-a-security-vulnerability

Sonatype Nexus Repository Pro customers can contact our world-class support team at https://support.sonatype.com/.

Build Requirements

Builds use Apache Maven and require Java 21. Apache Maven wrapper scripts are included in the source tree.

Building From Source

Released versions are tagged and branched using a name of the form release-{version}. For example: release-3.89.0-09

To build a tagged release, first fetch all tags:

git fetch --tags

Then checkout the remote branch you want. For example:

git checkout -b release-3.89.0-09 origin/release-3.89.0-09 --

Initialize Yarn Workspaces

Before building with Maven, initialize the Yarn workspaces (required for frontend modules):

# Enable corepack (ships with Node.js 16.10+)
corepack enable

# Install workspace dependencies
corepack yarn install

Build

Build using the included Maven wrapper script:

./mvnw clean install -Ppublic

Running

To run Nexus Repository Core after building:

1. Navigate to public/selfhosted/assemblies/nexus-repository-core/target/assembly
2. Run java -jar bin/nexus-repository-core-*.jar

The application will create a sonatype-work directory at public/selfhosted/assemblies/nexus-repository-core/target/sonatype-work, which will contain the default administrator credentials, database, and file blobstore.

License

This project is licensed under the Eclipse Public License - v 1.0, you can read the full text here