Skip to main content

Repository Management

Repositories are containers that hold the components (i.e., artifacts, packages, etc.) that your development team accesses each day. Managing repositories is an essential part of your Sonatype Nexus Repository configuration as this is how you manage repository access and usage. Sonatype Nexus Repository supports hosted, proxy and group repository types across a number of formats.

A user's ability to add, edit, or delete repositories in Sonatype Nexus Repository is determined through the privileges given to that user's assigned role. It's typical to give any role that you would like to manage repositories either the global repository admin privilege (nx-repository-admin-*-*-*) or format-level repository admin privileges (e.g., nx-repository-admin-nuget-nuget-hosted-* for NuGet repositories).

The Repository Management screen displays a list of configured repositories in your Nexus Repository deployment. To access the Repository Management screen, navigate to Administration (cog icon) → Repository → Repositories.

The Repository Management screen lists the following information about each repository:

  • Name - the repository or repository group's unique name

  • Type - the repository's type (i.e., proxy, hosted, or group)

  • Format - the format that the repository uses to store and expose components in them to client tools (e.g., Docker, Maven, npm, etc.)

  • Blob Store - the blob store in which this repository stores its binary parts

  • Status - the repository's availability status; possible values include the following:

    • Online - indicates that the Online checkbox is checked in the group or hosted repository's settings

    • Online - Uninitialized - indicates a newly created proxy repository that is not yet initialized; this status will change to Online - Ready to Connect when initialization completes

    • Online - Ready to Connect - indicates a proxy repository that is ready to connect to remote, but there have not yet been any requests to that repository

    • Online - Remote Available - indicates a proxy repository that is ready to connect to remote and to which successful requests have already been made

    • Online - Remote Manually Blocked - indicates that this proxy repository has auto blocking enabled; Nexus Repository will automatically block this proxy repository if the remote repository becomes unavailable

    • Online - Remote Auto Blocked and Unavailable - indicates that this proxy repository has auto blocking enabled, and the remote repository is unreachable/unresponsive

    • Online - Remote Unavailable - indicates that this proxy repository does not have auto blocking enabled, but the remote repository is unreachable/unresponsive

    • Offline - Repository Offline - indicates that the Online checkbox in the proxy repository's settings is not checked

    • Offline - indicates that the Online checkbox in the group/hosted repository's settings is not checked

  • URL - contains a copy button that, if selected, opens a modal containing the direct URL path to that repository; you can copy and use this URL to connect other tools to this repository

  • Health Check - displays the repository health statistics from a previously run Repository Health Check or a button to start the analysis; this item only displays if you have not integrated Nexus Repository with IQ Server and Sonatype Repository Firewall

  • Firewall Report - If you have integrated Nexus Repository with IQ Server and Sonatype Repository Firewall, this column shows a count of components by their highest policy violation level, count of quarantined components, and a link to the results on the Firewall server