How to use Repository Health Check 2.0

July 21, 2023 By Sonatype

3 minute read time

This is a quick tutorial on how to get started with Repository Health Check (RHC) 2.0, available in Sonatype Nexus Repository Manager 3.3.

NOTE: If you’re running an older version of Sonatype Nexus Repository Manager, you’ll see some of the new features, but you’ll need to upgrade for the full experience, including download trends.

Sign into the Sonatype Nexus Repository Manager UI and go to the Repositories feature in the admin section. The Health Check column is where we'll start.

RHC blog_1.jpg

First, click the Analyze button to enable RHC on a repository. A dialog box appears, giving you an opportunity to enable RHC on all supported repositories or just the repository you selected.

RHC blog_2.jpg

Choose “Yes, only this repository” if you want to try out RHC on just the repository you selected. Once you do this, the Analyze button is replaced with an Analyzing… status. The initial scan might take several minutes.

RHC blog_3.jpg

(Tip: hit the Refresh button periodically to see when the scan is complete.)

Once the scan completes, an empty bar chart will appear. Over time, this chart will be populated with the following data:

  • The total number of asset downloads over the last 30 days
  • The total number of bad asset downloads over the last 30 days (i.e. assets belonging to components with vulnerabilities)
  • Bar chart showing a rolling 30 day trend for both of the above

RHC blog_4.jpg

Hover your mouse over the chart to see the RHC summary for this repository. Initially, the summary will look something like this:

RHC blog_5.jpg

As assets are downloaded, the summary will gradually fill out with data. After a year, the summary will look something like this:

RHC 2_0.jpg


If you’re running Pro, click the View Detailed Report button to access the same detailed RHC report that existed in the previous version of RHC.

image (1)-4

And that’s it! As always, we’d love to hear what you think. Drop us a line at nexus-feedback@sonatype.com.

Tags: repository health check, Product

Written by Sonatype