# Telerik NuGet Feed Troubleshooting

This article summarizes the issues that may occur when you work with the Telerik UI for ASP.NET MVC library and the online [Telerik NuGet feed](https://www.telerik.com/aspnet-mvc/documentation/installation/installation-options/nuget-install), 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](https://www.telerik.com/aspnet-mvc/documentation/troubleshoot/troubleshooting-nuget#tips-for-handling-common-nuget-issues)
* [Removing stored credentials](https://www.telerik.com/aspnet-mvc/documentation/troubleshoot/troubleshooting-nuget#removing-saved-credentials)
* [Error `401 Unauthorized`](https://www.telerik.com/aspnet-mvc/documentation/troubleshoot/troubleshooting-nuget#error-401-unauthorized)
* [Error `Unable to find package`](https://www.telerik.com/aspnet-mvc/documentation/troubleshoot/troubleshooting-nuget#unable-to-find-package)
* [Error `503 Service Unavailable`](https://www.telerik.com/aspnet-mvc/documentation/troubleshoot/troubleshooting-nuget#error-503-service-unavailable)
* [Message about package `version not found`](https://www.telerik.com/aspnet-mvc/documentation/troubleshoot/troubleshooting-nuget#package-version-not-found)
* [Error `Unable to resolve ... . PackageSourceMapping is enabled`](https://www.telerik.com/aspnet-mvc/documentation/troubleshoot/troubleshooting-nuget#unable-to-resolve-package-due-to-packagesourcemapping)
* [Error `Failed to retrieve information about ... from remote source`](https://www.telerik.com/aspnet-mvc/documentation/troubleshoot/troubleshooting-nuget#failed-to-retrieve-information-from-remote-source)

## Telerik NuGet Feed Status

Visit [status.telerik.com](https://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](https://status.telerik.com/#system-metrics) 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, using an old license key after a renewal, or after a new Telerik license purchase.
* 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.

### Verify NuGet Credentials and Package Access

To verify if you can access the Telerik NuGet server and the expected packages, open `https://nuget.telerik.com/v3/search?q=aspnet&prerelease=true&skip=0&take=100&semVerLevel=2.0.0` directly in the web browser and enter `api-key` as username and [your generated API key](https://www.telerik.com/aspnet-mvc/documentation/installation/installation-options/nuget-install#generate-a-nuget-api-key) as password.

As a result, you will see a JSON output with the NuGet packages and versions that are available for you. Search for `Telerik.UI.for.AspNet.Mvc5` or `Telerik.UI.for.AspNet.Mvc5.Lite`.

If the above URL does not open, you have either come across a local networking issue or [the NuGet server is down](https://www.telerik.com/aspnet-mvc/documentation/troubleshoot/troubleshooting-nuget#error-503-service-unavailable).

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. Ensure your saved credentials are correct. Also, you must not have a `NuGet.Config` file in your project as it may bring in invalid credentials and project-level configuration files override the global ones.

## 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:

1. Remove the saved credentials in the <a href="https://support.microsoft.com/en-us/windows/accessing-credential-manager-1b5c916a-6a16-889f-8581-fc16e8165ac0" target="_blank">Windows Credential Manager</a>. These credentials will appear as `nuget.telerik.com` or `VSCredentials_nuget.telerik.com` entries.

2. Remove the Telerik NuGet package source from Visual Studio.

3. Check if you have any credentials stored in `%AppData%\NuGet\Nuget.Config`. If so, remove them.

4. Try to reset the Visual Studio user data by <a href="https://stackoverflow.com/questions/43550797/how-to-force-nuget-to-ask-for-authentication-when-connecting-to-a-private-feed" target="_blank">forcing NuGet to ask for authentication</a>.

5. Restart Visual Studio.

6. Enter the Telerik NuGet package source again through Visual Studio. If you are using the feed in a .NET Core application, store your credentials as plain text.

## Error 401 Unauthorized

`Error 401 Unauthorized` means that the Telerik NuGet server received invalid credentials. There may be different reasons for that:

* No provided credentials
* Incorrect password
* [Correct password with unescaped special characters](https://www.telerik.com/aspnet-mvc/documentation/troubleshoot/troubleshooting-nuget#special-characters-in-the-password)
* Using an invalidated (removed) Telerik NuGet API key, which no longer exists in [your Telerik account](https://www.telerik.com/account/downloads/api-keys).
* Using a valid <a href="https://www.telerik.com/account/downloads/api-keys" target="_blank">Telerik NuGet API key</a> with the wrong username. It must be `api-key`.

An easy way to verify your credentials is to [access the Telerik NuGet server directly in the web browser](https://www.telerik.com/aspnet-mvc/documentation/troubleshoot/troubleshooting-nuget#tips-for-handling-common-nuget-issues). Then, depending on your setup, check or update your credentials in:

* The applicable `NuGet.Config` file. There may be <a href="https://learn.microsoft.com/en-us/nuget/consume-packages/configuring-nuget-behavior" target="_blank">multiple such files on the device</a>.

* [Windows Credential Manager](https://www.telerik.com/aspnet-mvc/documentation/troubleshoot/troubleshooting-nuget#removing-saved-credentials)

* In a CI/CD workflow, which [obtains the credentials from a secret](https://www.telerik.com/aspnet-mvc/documentation/deployment/nuget-keys#storing-api-keys).

### Special Characters in the Password

[If your credentials are correct and your license includes the requested product and version](https://www.telerik.com/aspnet-mvc/documentation/troubleshoot/troubleshooting-nuget#verify-nuget-credentials-and-package-access), 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:

1. Change the password so that it does not include characters you need to escape.
2. Escape the special characters before storing the credentials. For example, `my§uper&P@§§word` encodes to `my&sect;uper&amp;P@&sect;&sect;word`.

Avoid using an online encoder utility for a password. Instead, use a Powershell command:

```batch PowerShell.skip-repl
Add-Type -AssemblyName System.Web
[System.Web.HttpUtility]::HtmlEncode('my§uper&P@§§word')
```

![Powershell Encoding](https://www.telerik.com/aspnet-mvc/documentation/assets/a5477905fe5c60701cb7ef75e5d47bc6/encode-passwords-with-powershell.png)

## Unable to Find Package

If the error occurs for the `Telerik.UI.for.AspNet.Mvc5` package, it may look like this:

`error NU1101: Unable to find package Telerik.UI.for.AspNet.Mvc5. No packages exist with this id in source(s): nuget.org`

Such an error implies that the [Telerik NuGet source](https://www.telerik.com/aspnet-mvc/documentation/installation/installation-options/nuget-install) is not added or enabled. The possible causes are:

* Missing Telerik NuGet source configuration in the `NuGet.Config` file.
* The correct `NuGet.Config` file is not used, because it is missing or misplaced.

> tip If you attempt to upgrade a trial NuGet package to a Q2 2025 version, change the name of the referenced NuGet package name. As of  Q2 2025, the package has no `Trial` identifier in its name. Uninstall the older package version and install the Q2 2025 version of the `Telerik.UI.for.AspNet.Mvc5` package.

## 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 <a href="https://status.telerik.com" target="_blank">Telerik live services status page</a>.

In urgent cases, download the NuGet packages from your <a href="https://www.telerik.com/account/downloads/" target="_blank">Telerik Account **Downloads** page</a>. Then, <a href="https://learn.microsoft.com/en-us/nuget/hosting-packages/local-feeds" target="_blank">set up a local NuGet feed</a>.

## Package Version Not Found

You may encounter an error similar to:

`ProjectName depends on Telerik.UI.for.AspNet.Mvc5 (>= 2026.4.1111) but Telerik.UI.for.AspNet.Mvc5 2026.4.1111 was not found. An approximate best match of Telerik.UI.for.AspNet.Mvc5 2024.3.1015 was resolved.`

or

`error NU1102: Unable to find package Telerik.UI.for.AspNet.Mvc5 with version (>= 2026.4.1111)`

This error means that version `2026.4.1111` is outside the subscription period of your license.

To solve the issue, use a different version or ask the license holder at your company to assign you another license that includes the desired product version.

## 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: ...`

The solution is to check the **Package Source Mapping** settings in Visual Studio, or <a href="https://learn.microsoft.com/en-us/nuget/consume-packages/configuring-nuget-behavior#config-file-locations-and-uses" target="_blank">review all applicable `NuGet.Config` files</a> on the machine. Then, adjust the package source mapping configuration.

## Failed to Retrieve Information from Remote Source

An attempt to use the [obsolete Telerik NuGet v2 feed](https://www.telerik.com/aspnet-mvc/documentation/installation/installation-options/nuget-install#setting-up-the-telerik-nuget-feed) after November 2024 will result in an error:

`Failed to retrieve information about 'Telerik.UI.for.AspNet.Mvc5' from remote source 'https://nuget.telerik.com/nuget/FindPackagesById()?id='Telerik.UI.for.AspNet.Mvc5'.`

The solution is to [use the Telerik NuGet v3 feed](https://www.telerik.com/aspnet-mvc/documentation/installation/installation-options/nuget-install).

Another possible reason for the same error is an incorrect NuGet feed URL.

## See Also

* [Setting Up the Online Private Telerik NuGet Feed](https://www.telerik.com/aspnet-mvc/documentation/installation/installation-options/nuget-install)
* [CI, CD, Build Server](https://www.telerik.com/aspnet-mvc/documentation/deployment/ci-cd-build-server)
