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
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.
Create a ticket with Sonatype⚓︎
Sonatype uses JIRA to manage requests.
This triggers creation of your repositories. Normally, the process takes less than 2 business days. Why the wait?
Please do not deploy until after you have received an e-mail notice indicating that the ticket is Resolved. One of the most common problems related to new projects is premature deployment, which misroutes your artifacts to a catch-all repository.
Lastly, if your component is already in Central be sure to note this in your ticket, and review how to migrate to OSSRH.
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.
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.
Note: 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⚓︎
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
Repository URL for release deployment, no download access!
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 use the legacy host https://oss.sonatype.org/.