Skip to main content

Grouping NuGet Repositories

Note

Grouped NuGet repositories must all be on the same NuGet version (2 or 3).

A repository group is the recommended way to expose all your NuGet repositories from the repository manager to your users, without needing any further client-side configuration. A repository group allows you to expose the aggregated content of multiple proxies and hosted repositories with one URL to your tools.

Nexus Repository Manager includes a nuget-group repository group by default. This default groups the nuget.org-proxy repository that proxies the NuGet Gallery and the nuget-hosted hosted repository. You can add additional hosted and proxy repositories to it, once you have set them up.

The URL of a repository group can be used in your client tool and will give you access to the packages in all repositories from the group with one URL. Any new packages added as well as any new repositories added to the group will automatically be available.

NuGet Group Version 3 API Support

The V3 API for NuGet is supported when using Nexus Repository NuGet group repositories. Read more about the API athttps://docs.microsoft.com/en-us/nuget/api/overview.

If you want to use a group repository using the V3 protocol you must observe the following rules:

  1. Group members must be only V3 repositories. This rule applies only for proxy and group repositories because hosted repositories can work as V2 and V3 at the same time. A group repository is V3 when all members are V3. This will be validated.

  2. Add group service index <nexus-host> :<nexus-port>/repository/<repository-name>/index.jsonas source, for example:

    $ nuget source add -name nuget-v3-group -source http://localhost:8081/repository/nuget-v3-group/index.json
Package source with Name: nuget-v3-group added successfully.