Telerik NuGet Feed Troubleshooting
This article summarizes the issues that may occur when you work with JustMock and the online Telerik NuGet feed, and their solutions.
Regardless of the cause for the issue, it is recommended that you start from the section on the commonly occurring issues.
- Tips for handling common NuGet issues
- Removing stored credentials
- Error
401 Unauthorized
- Error
503 Service Unavailable
- Error
Unable to resolve ... . PackageSourceMapping is enabled
- Error
Failed to retrieve information about ... from remote source
Telerik NuGet Feed Status
Visit status.telerik.com to check the status of the Telerik NuGet server. The top section shows manually logged incidents with possible updates or workaround suggestions. The System Metrics section provides real-time automated diagnostics.
Tips for Handling Common NuGet Issues
The most common reasons for issues with the private Telerik NuGet feed are related to:
- Authentication and credentials.
- Licensing. For example, requesting commercial packages with a trial license or vice-versa.
- Missing or wrong local configuration (
NuGet.Config
). - Network connectivity issues, including proxies and firewalls.
Errors like Unable to load the service index for source https://nuget.telerik.com/v3/index.json
don't indicate the exact cause of the problem. In such cases, check the additional error information which usually provides an error code.
To verify if you can access the Telerik NuGet server and the expected packages, open the https://nuget.telerik.com/v3/search?q=justmock&prerelease=true&skip=0&take=100&semVerLevel=2.0.0 URL directly in the web browser and enter your Telerik credentials in the prompt.
As a result, you will see a JSON output with the NuGet packages and versions that are available for you. You can search for JustMock.Commercial
or Telerik.JustMock.Console
.
If the above URL doesn't open, you have either come across a local networking issue or the NuGet server is down.
If you can access the feed in the browser, but you do not see the packages in Visual Studio, most likely the problem is caused by entering wrong credentials or using a different Telerik account. Make sure your saved credentials are correct. Also, check to see if you have a NuGet.Config
file in the project. That will add its package sources and package source credentials. If there is one, make sure it is using the correct values.
Removing Saved Credentials
If you suspect that your saved credentials are wrong, use the following steps to remove them from Windows and, then, add the correct ones:
- Remove the saved credentials in the Windows Credential Manager. These credentials will appear as
nuget.telerik.com
orVSCredentials_nuget.telerik.com
entries. - Remove the Telerik NuGet package source from Visual Studio.
- If you have added the Telerik package source by NuGet CLI, try to remove it from the CLI by running the following commands:
- Check if you have any credentials stored in
%AppData%\NuGet\Nuget.Config
. If so, remove them. - Try to reset the Visual Studio user data by forcing NuGet to ask for authentication.
- Restart Visual Studio.
- Enter the Telerik NuGet package source again through Visual Studio or CLI. If you are using the feed in a .NET Core application, store your credentials as plain text.
- Option 1 - When using CLI to add the package source, you need to use the
--store-password-in-clear-text
flag - Option 2 - When using a nuget.config file, the key should be
ClearTextPassword
:
<packageSourceCredentials> <Telerik> <add key="Username" value="YOUR_TELERIK_USERNAME" /> <add key="ClearTextPassword" value="YOUR_TELERIK_PASSWORD" /> </Telerik> </packageSourceCredentials>
- Option 1 - When using CLI to add the package source, you need to use the
Error 401 Unauthorized
If your credentials are correct and your license includes the requested product and version, then the password probably contains special characters. You need to escape these characters or the authentication can fail on the NuGet server. For example, a common character you must escape is the ampersand (&
); however, the character causing the issue may be as unique as the section character (§
).
To solve the issue:
- Change the password so that it doesn't include characters you need to escape.
- Escape the special characters before storing the credentials. For example,
my§uper&P@§§word
encodes tomy§uper&P@§§word
.
Avoid using an online encoder utility for a password. Instead, use a Powershell command:
Add-Type -AssemblyName System.Web
[System.Web.HttpUtility]::HtmlEncode('my§uper&P@§§word')
Error 503 Service Unavailable
If you get a message like Unable to load the service index for source
and error 503 (Service unavailable)
, check the Telerik NuGet server health at the Telerik live services status page.
In urgent cases, download the NuGet packages from your Telerik Account Downloads page. Then, set up a local NuGet feed.
Unable to Resolve Package due to PackageSourceMapping
Incorrect package source mapping can result in errors similar to:
NU1100 Unable to resolve 'Telerik... (>= ...)' for 'net...'. PackageSourceMapping is enabled, the following source(s) were not considered: ...
One solution is to check the Package Source Mapping settings in Visual Studio, or review all applicable NuGet.Config
files on the machine. Then, adjust the package source mapping configuration. You can refine your mapping to account for JustMock and other Telerik products like the following example.
Failed to Retrieve Information from Remote Source
An attempt to use the obsolete Telerik NuGet v2 feed after November 2024 will result in an error:
Failed to retrieve information about 'JustMock.Commercial' from remote source 'https://nuget.telerik.com/nuget/FindPackagesById()?id='JustMock.Commercial'&semVerLevel=2.0.0'.
The solution is to use the Telerik NuGet v3 feed.
Another possible reason for the same error is an incorrect NuGet feed URL.