Installing Telerik UI for ASP.NET MVC with NuGet
This article describes how to configure your system for the Telerik NuGet source and then use it to install Telerik UI for ASP.NET MVC in your project.
NuGet is a popular .NET package manager. Telerik maintains a NuGet feed with official Telerik UI for ASP.NET MVC releases and service packs. These packages are available only for registered users with an active trial or commercial license. In the Telerik NuGet feed, you will see only the packages that are licensed to your account.
Looking for a complete tutorial? Check out the Getting Started guide that uses NuGet to add Telerik UI to the project.
Setting Up the Telerik NuGet Feed
The Telerik NuGet feed allows you instant access to various Telerik and Kendo packages that you can install in your project. Before you can use the Telerik NuGet Feed as a Package source, you must configure your machine by utilizing any of the following methods:
The legacy https://nuget.telerik.com/nuget server is now deprecated. Make sure to switch to the new https://nuget.telerik.com/v3/index.json server, which is faster, lighter, and reduces the number of requests from your NuGet client.
Setup with the NuGet Package Manager
The following video demonstrates how to add the Telerik NuGet feed through the NuGet Package Manager tool in Visual Studio. Scroll below the video to find the required steps.
To configure the Telerik NuGet feed in Visual Studio:
Open Visual Studio.
Go to Tools > NuGet Package Manager > Package Manager Settings, select Package Manager Sources, and then click the + button.
Enter a Name for the Telerik NuGet feed, for example,
In the Source field, enter
https://nuget.telerik.com/v3/index.jsonand click OK.
You have successfully added the Telerik NuGet feed as a Package source.
The next steps describe how to authenticate your local NuGet instance and display the available packages:
Create a new project or open an existing project.
Right-click the solution in the Solution Explorer window.
Select Manage NuGet Packages for Solution...
Select the Telerik NuGet Package source from the drop-down list.
Click on the Browse tab to see the available packages.
Enter your Telerik credentials in the Windows Authentication dialog.
In the Visual Studio Package Manager, you will see all packages that are licensed to your user account.
Setup with the Trial Installer
The UI for ASP.NET MVC free trial installer package comes with an option that will automatically configure the Telerik NuGet feed for you. Refer to the Getting Started article for more details.
Setup with the Progress Control Panel Application
If you have already purchased a commercial Telerik UI license, you can use the Progress Control Panel application to configure the Telerik NuGet. The Control Panel has an option that you can select, and it will configure the Visual Studio Package Manager to use the Telerik NuGet feed.
Refer to the Getting Started article for step-by-step instructions.
Setup with NuGet CLI
The following video demonstrates how to add the Telerik NuGet feed by using the NuGet CLI or directly editing the
nuget.config file. Scroll below the video to find the required steps.
To add the Telerik NuGet feed by using the NuGet CLI:
- Download the latest NuGet executable.
- Open a command prompt and change the path to where the
Execute the command:
NuGet Sources Add -Name "telerik.com" -Source "https://nuget.telerik.com/v3/index.json" -UserName "your login email" -Password "your password"
The above command stores a token in the
%AppData%\NuGet\NuGet.configfile. Your original credentials cannot be obtained from this token.
If you are unable to connect to the feed by using encrypted credentials, try the alternative approach of storing credentials in clear text:
NuGet Sources Add -Name "telerik.com" -Source "https://nuget.telerik.com/v3/index.json" -UserName "your login email" -Password "your password" -StorePasswordInClearText
If you have already stored a token instead of storing the credentials as clear text, you can update the definition in the
%AppData%\NuGet\NuGet.config file by using the following command:
NuGet Sources Update -Name "telerik.com" -Source "https://nuget.telerik.com/v3/index.json" -UserName "your login email" -Password "your password" -StorePasswordInClearText
Setup with nuget.config
An alternative way to add the Telerik NuGet feed is to directly edit the
nuget.config file. For more details about this config file, see Microsoft's dedicated article.
To learn more about how this configuration works, see the Common NuGet Configurations article.
To use a
nuget.config file for the Telerik feed, you need to:
Ensure you have the relevant config file:
%AppData%\NuGet\NuGet.Config. You can create a new one by via the dotnet new command by calling
dotnet new nugetconfig.
Add the Telerik feed to the
nuget.configfile, and make sure to use plain-text credentials because the .NET Core NuGet tooling does not fully support encrypted credentials. Here is an example of how your config file can look like:
<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <!--To inherit the global NuGet package sources remove the <clear/> line below --> <clear /> <add key="nuget" value="https://api.nuget.org/v3/index.json" /> <add key="telerik" value="https://nuget.telerik.com/v3/index.json" /> </packageSources> <packageSourceCredentials> <telerik> <add key="Username" value="your telerik account email" /> <add key="ClearTextPassword" value="your plain text password" /> </telerik> </packageSourceCredentials> </configuration>
Refer to the Telerik NuGet feed instructional video for more details.
Installing the NuGet Packages
After setting up the Telerik NuGet package source, install the packages either through the Package Manager Dialog or the Package Manager Console.
The NuGet packages allow you to use the Telerik UI HtmlHelpers in your application. For the UI components to render correctly, you must also provide the required client-side resources.
To check the status of the Progress Live Services, like Telerik NuGet, Kendo UI CDN, Kendo UI Dojo playground and others, visit the Progress® Telerik® Live Services Status Page.
List of Provided Packages
The NuGet feed provides the following packages related to UI for ASP.NET Core and UI for ASP.NET MVC:
Telerik.UI.for.AspNet.Core—Telerik UI for ASP.NET Core Commercial.
Telerik.UI.for.AspNet.Core.Trial—Telerik UI for ASP.NET Core Trial.
Telerik.UI.for.AspNet.Mvc5—Telerik UI for ASP.NET MVC 5 Commercial.
Telerik.UI.for.AspNet.Mvc5.Trial—Telerik UI for ASP.NET MVC 5 Trial.
As of the R3 2022 release, NuGet packages for MVC 3 and MVC 4 are no longer provided for Telerik UI for ASP.NET MVC.
For more information on the list of the provided Kendo UI packages, refer to the article on installing Kendo UI for jQuery with NuGet.
Troubleshooting Issues with NuGet
If you experience any issues while configuring or using the Telerik NuGet server, check the dedicated Telerik NuGet Troubleshooting article.
To learn more about securing your NuGet feed setup and supply chain, check the following Microsoft articles with general best practices:
Lock down your dependencies using configurable trust policies - Blog Post
How to Scan NuGet Packages for Security Vulnerabilities - Blog Post
Best practices for a secure software supply chain - MSDN docs