Getting started

Introduction

Sonatype OSSRH (OSS Repository Hosting) uses Sonatype Nexus Repository Manager to provide repository hosting service for open source project binaries - be sure to review the full terms of service. OSSRH uses the Maven repository format and allows you to:

• deploy development version binaries (snapshots)
• stage release binaries
• promote release binaries and sync them to the Central Repository

Once released/published, you will not be able to remove/update/modify that artifact

We provide the option to publish artifacts using the -SNAPSHOT suffix in case that you need to do any test on your publishing process, but once it is released there is no possibility to change it. Please check the Can I change (modify, delete, update) a component on Central? FAQ for more details.

The initial setup for your OSSRH repository requires some manual steps and human review (see why), after which your deployment process is typically modified to get components into OSSRH. These are all one time steps.

After the initial setup, publishing from OSSRH to Central is a trivial action which can be done via a browser or programmatically.

Initial Setup

Review Requirements

There are basic metadata and content requirements for components available in Central. We recommend getting familiar with them while your repositories are being created. For the details, see Central Component Requirements.

Deployment

Most developers find it easiest to implement a deployment procedure in order to automatically meet the component requirements. Depending on your choice of tools and approach there are many different do this.

Below is information for popular tools and approaches. Feel free to send notes about alternative approaches or corrections.

• Apache Maven
• Apache Ant
• Gradle
• sbt
• Manual Staging Bundle Creation and Deployment

Attention

There is a limit of roughly 1024MB on any single file uploaded to OSSRH. Your uploads will fail with a broken pipe exception when you hit this limit. Contact us directly if you need to upload larger components.

Releasing to Central

At this point, your project is deployed to private repository only accessible to your project members.

To release your components, you can either release them directly from the command line, if you are using the Nexus Staging Maven Plugin or Ant Tasks or open your favorite browser and go to https://s01.oss.sonatype.org/ or follow our detailed instructions.

Note: As of February 2021, all new projects began being provisioned on https://s01.oss.sonatype.org/. If your project is not provisioned on https://s01.oss.sonatype.org/, you will want to login to the legacy host https://oss.sonatype.org/.

Upon release, your component will be published to Central: this typically occurs within 30 minutes, though updates to search can take up to four hours.

OSSRH Usage Notes

Accessing Repositories

The following repositories allow you to access your components in OSSRH directly. Users will simply get your components directly via the Central Repository, but for committers and other collaborators on your project this list might be useful.

Repository URL for snapshot deployment and download access:

• https://s01.oss.sonatype.org/content/repositories/snapshots/

Repository URL for release deployment, no download access! :

• https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/

Important

As of February 2021, all new projects began being provisioned on https://s01.oss.sonatype.org/. If your project is not provisioned on https://s01.oss.sonatype.org/, you will want to use the legacy host https://oss.sonatype.org/.