Artifactory version: 7.x and above
Overview
This article explains why NuGet package search results may differ between a Remote repository and a Virtual repository in Artifactory, and provides the system properties needed to align search behavior with the upstream NuGet registry.
Background - Remote vs Virtual Repository Behavior
Understanding why results differ starts with understanding how each repository type works:
Remote Repository
A Remote repository acts as a direct proxy for an external source such as nuget.org. Because it proxies requests directly to the upstream registry, search results should match what you would see when querying the registry directly.
Virtual Repository
A Virtual repository aggregates multiple repositories - both local and remote - behind a single endpoint. It provides a unified access point for all included repositories and may manipulate or merge responses based on its configuration. As a result:
-
Search results may include artifacts from both local and remote repositories
-
The order of results is not guaranteed to match the order returned by a Remote repository or the upstream registry
-
This behavior is by design and is expected when local repositories are part of the Virtual repository
Important:
The order of NuGet search results in a Virtual repository (V2 or V3) is not guaranteed to be the same as in a Remote repository (V2 or V3). This is expected behavior when the Virtual repository includes local repositories in addition to remote ones.
Root Cause
Two separate behavioral gaps contribute to the difference in search results:
Gap 1: NuGet Package Handler Logic
Some NuGet packages contain a projectUrl field that Artifactory misinterprets during package processing. This causes incorrect metadata handling and affects search results returned from both Remote and Virtual repositories.
Gap 2: Search Result Relevancy Sorting
NuGet search returns up to a maximum of 1,000 results per query. Without relevancy sorting, these results are not guaranteed to be ordered by relevance - meaning the most relevant packages may not appear at the top of the results, particularly in Virtual repositories.
Resolution - Apply System Properties
To align NuGet search behavior as closely as possible with the upstream registry, add the following two properties to your Artifactory system properties file.
Step 1 - Open the System Properties File
$JFROG_HOME/artifactory/var/etc/artifactory/artifactory.system.properties
Installation Type
|
Default $JFROG_HOME Path
|
Linux (RPM/DEB/TAR)
|
/opt/jfrog/artifactory
|
Docker
|
/var/opt/jfrog/artifactory (mapped volume)
|
Windows
|
C:\JFrog\Artifactory
|
Kubernetes/Helm
|
Mounted via ConfigMap or persistent volume
|
Step 2 - Add the Following Properties
Note:
The properties below were introduced starting from Artifactory version 7.100.x
artifactory.package.handler.nuget=true
artifactory.nuget.ph.relevancy.sorting=true
Step 3 - Save and Restart Artifactory
Important:
A restart is required for the changes to take effect.
bash
# Linux (systemd):
sudo systemctl restart artifactory
# Docker:
docker restart artifactory
# Kubernetes/Helm:
kubectl rollout restart statefulset artifactory -n <namespace>
What Each Property Does:
Property
|
Value
|
Effect
|
Scope
|
artifactory.package.handler.nuget
|
true
|
Enables improved NuGet package handler logic. Fixes misinterpretation of the projectUrl field in NuGet package metadata, resulting in more accurate package processing and search results.
|
Remote & Virtual repositories
|
artifactory.nuget.ph.relevancy.sorting
|
true
|
Enables relevancy-based sorting of NuGet search results. Ensures the most relevant packages appear first within the 1,000-result search limit.
|
Virtual repositories only
|
Expected Outcome After Applying the Properties
Once both properties are set to true and Artifactory is restarted, the following improvements are expected:
-
NuGet search results from the Remote repository will more closely match results from querying the upstream registry directly
-
NuGet search results from the Virtual repository will be sorted by relevance, with the most relevant packages appearing first
-
Metadata for packages containing a projectUrl field will be processed correctly
Note:
A Virtual repository that includes local repositories will still return a slightly different result set than a pure Remote repository - this is expected and by design, since the Virtual repository aggregates results from all its members including local repositories. The properties above optimize the ordering and accuracy of those results but do not change the fundamental aggregation behavior.
Below are the outcomes:
Execute command on NuGet registry directly
nuget search newtonsoft.json -Source https://www.nuget.org/api/v2/
GET
https://www.nuget.org/api/v2/Search()?$filter=IsLatestVersion&searchTerm='newtonsoft.json'&targetFramework=''&includePrerelease=false&$skip=0&$top=20&semVerLevel=2.0.0
OK
https://www.nuget.org/api/v2/Search()?$filter=IsLatestVersion&searchTerm='newtonsoft.json'&targetFramework=''&includePrerelease=false&$skip=0&$top=20&semVerLevel=2.0.0
406ms
====================
Source: https://www.nuget.org/api/v2/
--------------------
> Newtonsoft.Json | 13.0.3 | Downloads: 2,147,483,647
Json.NET is a popular high-performance JSON framework for .NET
--------------------
> Newtonsoft.Json.Bson | 1.0.3 | Downloads: 946,851,376
Json.NET BSON adds support for reading and writing BSON
--------------------
> Newtonsoft.Json.Schema | 4.0.1 | Downloads: 65,594,946
Json.NET Schema is a complete and easy-to-use JSON Schema framework for .NET
--------------------
> Microsoft.AspNetCore.Mvc.NewtonsoftJson | 9.0.5 | Downloads: 551,081,572
ASP.NET Core MVC features that use Newtonsoft.Json. Includes input and output formatters for JSON
an...
--------------------
> Swashbuckle.AspNetCore.Newtonsoft | 8.1.1 | Downloads: 126,900,096
Swagger Generator opt-in component to support Newtonsoft.Json serializer behaviors
--------------------
> GraphQL.NewtonsoftJson | 8.5.0 | Downloads: 23,967,023
JSON.NET serializer for GraphQL.NET
--------------------
> NJsonSchema.NewtonsoftJson | 11.3.2 | Downloads: 25,760,061
JSON Schema reader, generator and validator for .NET
--------------------
> Microsoft.Azure.Core.NewtonsoftJson | 2.0.0 | Downloads: 15,745,905
This library contains converters dependent on the Newtonsoft.Json package for use with Azure.Core.
--------------------
> Refit.Newtonsoft.Json | 8.0.0 | Downloads: 23,911,511
Refit Serializers for Newtonsoft.Json
--------------------
> RestSharp.Serializers.NewtonsoftJson | 112.1.0 | Downloads: 22,220,572
Simple REST and HTTP API Client
--------------------
> MassTransit.Newtonsoft | 8.4.1 | Downloads: 12,988,368
MassTransit Newtonsoft JSON/BSON support; MassTransit provides a developer-focused, modern
platform ...
--------------------
> App.Metrics.Formatters.Json | 4.3.0 | Downloads: 40,732,273
App Metrics Formatters for metrics and environment data to JSON using Newtonsoft.Json.
--------------------
> NServiceBus.Newtonsoft.Json | 4.1.0 | Downloads: 13,363,948
Json.NET serializer for NServiceBus
--------------------
> Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson | 9.0.5 | Downloads: 26,494,079
Implements the SignalR Hub Protocol using Newtonsoft.Json.
This package was built from the source c...
--------------------
> RestSharp.Newtonsoft.Json | 1.5.1 | Downloads: 5,506,098
Restores Newtonsoft.JSON as the default serializer for RestSharp.
--------------------
> GraphQL.Client.Serializer.Newtonsoft | 6.1.0 | Downloads: 23,224,234
A serializer implementation for GraphQL.Client using Newtonsoft.Json as underlying JSON library
--------------------
> CloudNative.CloudEvents.NewtonsoftJson | 2.8.0 | Downloads: 4,477,205
JSON support for the CNCF CloudEvents SDK, based on Newtonsoft.Json.
--------------------
> JsonConverter.Newtonsoft.Json | 0.7.1 | Downloads: 4,987,575
Implementation for IJsonConverter using Newtonsoft.Json
--------------------
> StackExchange.Redis.Extensions.Newtonsoft | 11.0.0 | Downloads: 15,740,852
StackExchange.Redis.Extensions is a library that extends StackExchange.Redis allowing you a set
of f...
--------------------
> UUID.Serialization.Newtonsoft | 1.1.1 | Downloads: 7,879,930
Provides Newtonsoft.Json serialization support for the UUID library, enabling seamless JSON
serializ...
--------------------
Execute command on Remote V3:
nuget search newtonsoft.json -Source oremoteV3
====================
Source: oremoteV3
--------------------
> Newtonsoft.Json | 13.0.3 | Downloads: 6,204,298,168
Json.NET is a popular high-performance JSON framework for .NET
--------------------
> Newtonsoft.Json.Bson | 1.0.3 | Downloads: 946,851,376
Json.NET BSON adds support for reading and writing BSON
--------------------
> Newtonsoft.Json.Schema | 4.0.1 | Downloads: 65,594,946
Json.NET Schema is a complete and easy-to-use JSON Schema framework for .NET
--------------------
> Microsoft.AspNetCore.Mvc.NewtonsoftJson | 9.0.5 | Downloads: 551,081,572
ASP.NET Core MVC features that use Newtonsoft.Json. Includes input and output formatters for JSON
an...
--------------------
> Swashbuckle.AspNetCore.Newtonsoft | 8.1.1 | Downloads: 126,900,096
Swagger Generator opt-in component to support Newtonsoft.Json serializer behaviors
--------------------
> GraphQL.NewtonsoftJson | 8.5.0 | Downloads: 23,967,023
JSON.NET serializer for GraphQL.NET
--------------------
> NJsonSchema.NewtonsoftJson | 11.3.2 | Downloads: 25,760,061
JSON Schema reader, generator and validator for .NET
--------------------
> Microsoft.Azure.Core.NewtonsoftJson | 2.0.0 | Downloads: 15,745,905
This library contains converters dependent on the Newtonsoft.Json package for use with Azure.Core.
--------------------
> Refit.Newtonsoft.Json | 8.0.0 | Downloads: 23,911,511
Refit Serializers for Newtonsoft.Json
--------------------
> RestSharp.Serializers.NewtonsoftJson | 112.1.0 | Downloads: 22,220,572
Simple REST and HTTP API Client
--------------------
> MassTransit.Newtonsoft | 8.4.1 | Downloads: 12,988,368
MassTransit Newtonsoft JSON/BSON support; MassTransit provides a developer-focused, modern
platform ...
--------------------
> App.Metrics.Formatters.Json | 4.3.0 | Downloads: 40,732,273
App Metrics Formatters for metrics and environment data to JSON using Newtonsoft.Json.
--------------------
> NServiceBus.Newtonsoft.Json | 4.1.0 | Downloads: 13,363,948
Json.NET serializer for NServiceBus
--------------------
> Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson | 9.0.5 | Downloads: 26,494,079
Implements the SignalR Hub Protocol using Newtonsoft.Json.
This package was built from the source c...
--------------------
> RestSharp.Newtonsoft.Json | 1.5.1 | Downloads: 5,506,098
Restores Newtonsoft.JSON as the default serializer for RestSharp.
--------------------
> GraphQL.Client.Serializer.Newtonsoft | 6.1.0 | Downloads: 23,224,234
A serializer implementation for GraphQL.Client using Newtonsoft.Json as underlying JSON library
--------------------
> CloudNative.CloudEvents.NewtonsoftJson | 2.8.0 | Downloads: 4,477,205
JSON support for the CNCF CloudEvents SDK, based on Newtonsoft.Json.
--------------------
> JsonConverter.Newtonsoft.Json | 0.7.1 | Downloads: 4,987,575
Implementation for IJsonConverter using Newtonsoft.Json
--------------------
> StackExchange.Redis.Extensions.Newtonsoft | 11.0.0 | Downloads: 15,740,852
StackExchange.Redis.Extensions is a library that extends StackExchange.Redis allowing you a set
of f...
--------------------
> UUID.Serialization.Newtonsoft | 1.1.1 | Downloads: 7,879,930
Provides Newtonsoft.Json serialization support for the UUID library, enabling seamless JSON
serializ...
--------------------
Execute command on Remote V2:
nuget search newtonsoft.json -Source oremoteV2
GET
https://RT.jfrog.io/artifactory/api/nuget/nuget-remote/Search()?$filter=IsLatestVersion&searchTerm='newtonsoft.json'&targetFramework=''&includePrerelease=false&$skip=0&$top=20&semVerLevel=2.0.0
OK
https://RT.jfrog.io/artifactory/api/nuget/nuget-remote/Search()?$filter=IsLatestVersion&searchTerm='newtonsoft.json'&targetFramework=''&includePrerelease=false&$skip=0&$top=20&semVerLevel=2.0.0
874ms
====================
Source: oremoteV2
--------------------
> Newtonsoft.Json | 13.0.3 | Downloads: 2,147,483,647
Json.NET is a popular high-performance JSON framework for .NET
--------------------
> Newtonsoft.Json.Bson | 1.0.3 | Downloads: 946,851,376
Json.NET BSON adds support for reading and writing BSON
--------------------
> Newtonsoft.Json.Schema | 4.0.1 | Downloads: 65,594,946
Json.NET Schema is a complete and easy-to-use JSON Schema framework for .NET
--------------------
> Microsoft.AspNetCore.Mvc.NewtonsoftJson | 9.0.5 | Downloads: 551,081,572
ASP.NET Core MVC features that use Newtonsoft.Json. Includes input and output formatters for JSON
an...
--------------------
> Swashbuckle.AspNetCore.Newtonsoft | 8.1.1 | Downloads: 126,900,096
Swagger Generator opt-in component to support Newtonsoft.Json serializer behaviors
--------------------
> GraphQL.NewtonsoftJson | 8.5.0 | Downloads: 23,967,023
JSON.NET serializer for GraphQL.NET
--------------------
> NJsonSchema.NewtonsoftJson | 11.3.2 | Downloads: 25,760,061
JSON Schema reader, generator and validator for .NET
--------------------
> Microsoft.Azure.Core.NewtonsoftJson | 2.0.0 | Downloads: 15,745,905
This library contains converters dependent on the Newtonsoft.Json package for use with Azure.Core.
--------------------
> Refit.Newtonsoft.Json | 8.0.0 | Downloads: 23,911,511
Refit Serializers for Newtonsoft.Json
--------------------
> RestSharp.Serializers.NewtonsoftJson | 112.1.0 | Downloads: 22,220,572
Simple REST and HTTP API Client
--------------------
> MassTransit.Newtonsoft | 8.4.1 | Downloads: 12,988,368
MassTransit Newtonsoft JSON/BSON support; MassTransit provides a developer-focused, modern
platform ...
--------------------
> App.Metrics.Formatters.Json | 4.3.0 | Downloads: 40,732,273
App Metrics Formatters for metrics and environment data to JSON using Newtonsoft.Json.
--------------------
> NServiceBus.Newtonsoft.Json | 4.1.0 | Downloads: 13,363,948
Json.NET serializer for NServiceBus
--------------------
> Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson | 9.0.5 | Downloads: 26,494,079
Implements the SignalR Hub Protocol using Newtonsoft.Json.
This package was built from the source c...
--------------------
> RestSharp.Newtonsoft.Json | 1.5.1 | Downloads: 5,506,098
Restores Newtonsoft.JSON as the default serializer for RestSharp.
--------------------
> GraphQL.Client.Serializer.Newtonsoft | 6.1.0 | Downloads: 23,224,234
A serializer implementation for GraphQL.Client using Newtonsoft.Json as underlying JSON library
--------------------
> CloudNative.CloudEvents.NewtonsoftJson | 2.8.0 | Downloads: 4,477,205
JSON support for the CNCF CloudEvents SDK, based on Newtonsoft.Json.
--------------------
> JsonConverter.Newtonsoft.Json | 0.7.1 | Downloads: 4,987,575
Implementation for IJsonConverter using Newtonsoft.Json
--------------------
> StackExchange.Redis.Extensions.Newtonsoft | 11.0.0 | Downloads: 15,740,852
StackExchange.Redis.Extensions is a library that extends StackExchange.Redis allowing you a set
of f...
--------------------
> UUID.Serialization.Newtonsoft | 1.1.1 | Downloads: 7,879,930
Provides Newtonsoft.Json serialization support for the UUID library, enabling seamless JSON
serializ...
--------------------
Execute command on Virtual V2:
nuget search newtonsoft.json -Source omervirV2
GET
https://RT.jfrog.io/artifactory/api/nuget/nuget/Search()?$filter=IsLatestVersion&searchTerm='newtonsoft.json'&targetFramework=''&includePrerelease=false&$skip=0&$top=20&semVerLevel=2.0.0
OK
https://RT.jfrog.io/artifactory/api/nuget/nuget/Search()?$filter=IsLatestVersion&searchTerm='newtonsoft.json'&targetFramework=''&includePrerelease=false&$skip=0&$top=20&semVerLevel=2.0.0
932ms
====================
Source: omervirV2
--------------------
> Newtonsoft.Json | 13.0.3 | Downloads: 2,147,483,647
Json.NET is a popular high-performance JSON framework for .NET
--------------------
> Newtonsoft.Json.Bson | 1.0.3 | Downloads: 975,568,174
Json.NET BSON adds support for reading and writing BSON
--------------------
> Newtonsoft.Json.Schema | 4.0.1 | Downloads: 67,468,129
Json.NET Schema is a complete and easy-to-use JSON Schema framework for .NET
--------------------
> Refit.Newtonsoft.Json | 8.0.0 | Downloads: 25,071,126
Refit Serializers for Newtonsoft.Json
--------------------
> NServiceBus.Newtonsoft.Json | 4.1.0 | Downloads: 13,744,268
Json.NET serializer for NServiceBus
--------------------
> RestSharp.Newtonsoft.Json | 1.5.1 | Downloads: 5,619,012
Restores Newtonsoft.JSON as the default serializer for RestSharp.
--------------------
> JsonConverter.Newtonsoft.Json | 0.7.2 | Downloads: 5,306,990
Implementation for IJsonConverter using Newtonsoft.Json
--------------------
> Microsoft.AspNetCore.Mvc.NewtonsoftJson | 9.0.6 | Downloads: 568,854,136
ASP.NET Core MVC features that use Newtonsoft.Json. Includes input and output formatters for JSON
an...
--------------------
> Swashbuckle.AspNetCore.Newtonsoft | 9.0.1 | Downloads: 131,496,552
Swagger Generator opt-in component to support Newtonsoft.Json serializer behaviors
--------------------
> App.Metrics.Formatters.Json | 4.3.0 | Downloads: 41,659,924
App Metrics Formatters for metrics and environment data to JSON using Newtonsoft.Json.
--------------------
> NJsonSchema.NewtonsoftJson | 11.3.2 | Downloads: 29,145,696
JSON Schema reader, generator and validator for .NET
--------------------
> Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson | 9.0.6 | Downloads: 27,406,092
Implements the SignalR Hub Protocol using Newtonsoft.Json.
This package was built from the source c...
--------------------
> GraphQL.NewtonsoftJson | 8.5.0 | Downloads: 25,440,580
JSON.NET serializer for GraphQL.NET
--------------------
> GraphQL.Client.Serializer.Newtonsoft | 6.1.0 | Downloads: 24,283,863
A serializer implementation for GraphQL.Client using Newtonsoft.Json as underlying JSON library
--------------------
> RestSharp.Serializers.NewtonsoftJson | 112.1.0 | Downloads: 23,085,591
Simple REST and HTTP API Client
--------------------
> Microsoft.Azure.Core.NewtonsoftJson | 2.0.0 | Downloads: 16,903,752
This library contains converters dependent on the Newtonsoft.Json package for use with Azure.Core.
--------------------
> StackExchange.Redis.Extensions.Newtonsoft | 11.0.0 | Downloads: 16,187,181
StackExchange.Redis.Extensions is a library that extends StackExchange.Redis allowing you a set
of f...
--------------------
> MassTransit.Newtonsoft | 8.4.1 | Downloads: 13,871,623
MassTransit Newtonsoft JSON/BSON support; MassTransit provides a developer-focused, modern
platform ...
--------------------
> CloudNative.CloudEvents.NewtonsoftJson | 2.8.0 | Downloads: 4,699,480
JSON support for the CNCF CloudEvents SDK, based on Newtonsoft.Json.
--------------------
Execute command on Virtual V3:
nuget search newtonsoft.json -Source omervirV3
====================
Source: omervirV3
--------------------
> Newtonsoft.Json | 13.0.3 | Downloads: 6,377,073,834
Json.NET is a popular high-performance JSON framework for .NET
--------------------
> Newtonsoft.Json.Bson | 1.0.3 | Downloads: 975,568,174
Json.NET BSON adds support for reading and writing BSON
--------------------
> Refit.Newtonsoft.Json | 8.0.0 | Downloads: 25,071,126
Refit Serializers for Newtonsoft.Json
--------------------
> NServiceBus.Newtonsoft.Json | 4.1.0 | Downloads: 13,744,268
Json.NET serializer for NServiceBus
--------------------
> RestSharp.Newtonsoft.Json | 1.5.1 | Downloads: 5,619,012
Restores Newtonsoft.JSON as the default serializer for RestSharp.
--------------------
> JsonConverter.Newtonsoft.Json | 0.7.2 | Downloads: 5,306,990
Implementation for IJsonConverter using Newtonsoft.Json
--------------------
> Newtonsoft.Json.Schema | 4.0.1 | Downloads: 67,468,129
Json.NET Schema is a complete and easy-to-use JSON Schema framework for .NET
--------------------
> Microsoft.AspNetCore.Mvc.NewtonsoftJson | 9.0.6 | Downloads: 568,854,136
ASP.NET Core MVC features that use Newtonsoft.Json. Includes input and output formatters for JSON
an...
--------------------
> Swashbuckle.AspNetCore.Newtonsoft | 9.0.1 | Downloads: 131,496,552
Swagger Generator opt-in component to support Newtonsoft.Json serializer behaviors
--------------------
> App.Metrics.Formatters.Json | 4.3.0 | Downloads: 41,659,924
App Metrics Formatters for metrics and environment data to JSON using Newtonsoft.Json.
--------------------
> NJsonSchema.NewtonsoftJson | 11.3.2 | Downloads: 29,145,696
JSON Schema reader, generator and validator for .NET
--------------------
> Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson | 9.0.6 | Downloads: 27,406,092
Implements the SignalR Hub Protocol using Newtonsoft.Json.
This package was built from the source c...
--------------------
> GraphQL.NewtonsoftJson | 8.5.0 | Downloads: 25,440,580
JSON.NET serializer for GraphQL.NET
--------------------
> GraphQL.Client.Serializer.Newtonsoft | 6.1.0 | Downloads: 24,283,863
A serializer implementation for GraphQL.Client using Newtonsoft.Json as underlying JSON library
--------------------
> RestSharp.Serializers.NewtonsoftJson | 112.1.0 | Downloads: 23,085,591
Simple REST and HTTP API Client
--------------------
> Microsoft.Azure.Core.NewtonsoftJson | 2.0.0 | Downloads: 16,903,752
This library contains converters dependent on the Newtonsoft.Json package for use with Azure.Core.
--------------------
> StackExchange.Redis.Extensions.Newtonsoft | 11.0.0 | Downloads: 16,187,181
StackExchange.Redis.Extensions is a library that extends StackExchange.Redis allowing you a set
of f...
--------------------
> MassTransit.Newtonsoft | 8.4.1 | Downloads: 13,871,623
MassTransit Newtonsoft JSON/BSON support; MassTransit provides a developer-focused, modern
platform ...
--------------------
> UUID.Serialization.Newtonsoft | 1.1.1 | Downloads: 7,879,994
Provides Newtonsoft.Json serialization support for the UUID library, enabling seamless JSON
serializ...
--------------------
> CloudNative.CloudEvents.NewtonsoftJson | 2.8.0 | Downloads: 4,699,480
JSON support for the CNCF CloudEvents SDK, based on Newtonsoft.Json.
--------------------