You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: getting-started/Installation/telerik-nuget-source.md
+15-16Lines changed: 15 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,16 +1,16 @@
1
1
---
2
2
title: Telerik NuGet Source
3
-
page_title: Telerik Private NuGet Feed
4
-
description: Explore the different ways to add the Telerik private NuGet feed to your system, and start using NuGet packages to install the Telerik Document Processing libraries.
3
+
page_title: Telerik NuGet Feed
4
+
description: Explore the different ways to add the Telerik NuGet feed to your system, and start using NuGet packages to install the Telerik Document Processing libraries.
5
5
slug: telerik-nuget-source
6
-
tags: get,started,installation,nuget,feed
6
+
tags: get,started,installation,nuget,feed
7
7
published: True
8
8
position: 8
9
9
---
10
10
11
-
# Telerik Private NuGet Source
11
+
# Telerik NuGet Source
12
12
13
-
This article explains how to add the private Telerik NuGet package feed to your environment. You can use it to obtain the Telerik Document Processing libraries instead of [setting up a local NuGet feed]({%slug installation-nuget-packages%}#manually-download-nuget-packages).
13
+
This article explains how to add the Telerik NuGet package feed to your environment. You can use it to obtain the Telerik Document Processing libraries instead of [setting up a local NuGet feed]({%slug installation-nuget-packages%}#manually-download-nuget-packages).
14
14
15
15
The benefit of using an online NuGet source is that you will receive notifications for newer component versions.
16
16
@@ -22,11 +22,11 @@ You can set up the remote Telerik NuGet feed in the following ways:
22
22
23
23
>tip When working with the .NET CLI or editing the `NuGet.Config` manually, you can use your Telerik account credentials or a [NuGet API Key](#use-nuget-api-key). If you are logging in to telerik.com through single sign-on (SSO), use a [NuGet API Key](#use-nuget-api-key).
24
24
25
-
>warning Never hard-code Telerik account credentials or NuGet API keys in a `NuGet.Config` file in a GitHub repository, Docker image, or any location that may be accessed by unauthorized parties. A NuGet key is valuable and bad actors can use it to access the NuGet packages that are licensed under your account. A credentials abuse can lead to a review of the affected Telerik account.
25
+
>warning Never hard-code Telerik account credentials or NuGet API keys in a `NuGet.Config` file in a GitHub repository, Docker image, or any location that may be accessed by unauthorized parties. A NuGet key is valuable, and bad actors can use it to access the NuGet packages that are licensed under your account. A credentials abuse can lead to a review of the affected Telerik account.
26
26
27
27
For NuGet-related issues, see [Troubleshooting Telerik NuGet]({%slug troubleshooting-telerik-nuget%}).
28
28
29
-
For information on automated builds, CI and CD, see [Restoring NuGet Packages in Your CI Workflow]({%slug using-nuget-keys%}).
29
+
For information on automated builds, CI, and CD, see [Restoring NuGet Packages in Your CI Workflow]({%slug using-nuget-keys%}).
30
30
31
31
32
32
## Use Visual Studio
@@ -106,7 +106,7 @@ To edit a `NuGet.Config` file and add the Telerik feed, you need to:
106
106
107
107
1. Ensure you are editing the [correct and desired config file](https://learn.microsoft.com/en-us/nuget/consume-packages/configuring-nuget-behavior#config-file-locations-and-uses). You can also create a new one with the [`dotnet new nugetconfig` command](https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-new).
108
108
109
-
2. Add the Telerik package source to the config file. Use plain text credentials, because the .NET Core NuGet tooling does not fully support encrypted credentials. Here is an example of how your `NuGet.Config` file can look like:
109
+
2. Add the Telerik package source to the config file. Use plain text credentials because the .NET Core NuGet tooling does not fully support encrypted credentials. Here is an example of how your `NuGet.Config` file can look like:
110
110
111
111
````XML.skip-repl
112
112
<?xml version="1.0" encoding="utf-8"?>
@@ -126,7 +126,7 @@ To edit a `NuGet.Config` file and add the Telerik feed, you need to:
126
126
</configuration>
127
127
````
128
128
129
-
## Use NuGet API Key
129
+
###Use NuGet API Key
130
130
131
131
There are two ways to authenticate with the Telerik NuGet server when you add the Telerik NuGet source [with the .NET CLI](#use-the-net-cli) or [edit the `NuGet.Config` file manually](#edit-the-nuget-config-file):
132
132
@@ -138,9 +138,9 @@ You can [generate your Telerik NuGet API Key on telerik.com](https://www.telerik
138
138
> Always use the NuGet API Key in plain text.
139
139
140
140
141
-
## Package Source Mapping
141
+
###Package Source Mapping
142
142
143
-
The Document Processing Libraries' NuGet packages and most of its dependencies reside on `nuget.telerik.com`. On the other hand, the [`Telerik.Licensing` package]({%slug setting-up-license-key%}) reside on `nuget.org`. The correct [package source mapping](https://learn.microsoft.com/en-us/nuget/consume-packages/package-source-mapping) configuration should be similar to the one below.
143
+
The Document Processing Libraries' NuGet packages and most of its dependencies reside on `nuget.telerik.com`. On the other hand, the [`Telerik.Licensing` package]({%slug setting-up-license-key%}) resides on `nuget.org`. The correct [package source mapping](https://learn.microsoft.com/en-us/nuget/consume-packages/package-source-mapping) configuration should be similar to the one below.
144
144
145
145
> Make sure that the `key` values in the `packageSourceMapping` section match the `key` values in the `packageSources` section, otherwise you will get a "Package not found" error.
146
146
@@ -169,7 +169,7 @@ The Document Processing Libraries' NuGet packages and most of its dependencies r
169
169
````
170
170
171
171
172
-
## Access NuGet Packages behind Firewall
172
+
###Access NuGet Packages behind Firewall
173
173
174
174
To access the Telerik NuGet feed behind a firewall that restricts outgoing requests, you may need to allow the following domains:
175
175
@@ -178,17 +178,16 @@ To access the Telerik NuGet feed behind a firewall that restricts outgoing reque
178
178
179
179
The firewall must allow some of the requests to be redirected from `nuget.telerik.com` to `downloads.cdn.telerik.com`.
180
180
181
-
## Obsolete Telerik NuGet URL
181
+
###Obsolete Telerik NuGet URL
182
182
183
-
The NuGet v2 server at `https://nuget.telerik.com/nuget` was sunset in November 2024 and is no longer available. The v3 protocol offers faster package searches and restores, improved security, and more reliable infrastructure. To redirect your feed to the NuGet v3 protocol, all you have to do is to change your NuGet package source URL to `https://nuget.telerik.com/v3/index.json`.
183
+
The NuGet v2 server at `https://nuget.telerik.com/nuget` was sunset in November 2024 and is no longer available. The v3 protocol offers faster package searches and restores, improved security, and more reliable infrastructure. To redirect your feed to the NuGet v3 protocol, all you have to do is change your NuGet package source URL to `https://nuget.telerik.com/v3/index.json`.
184
184
185
185
186
-
## Troubleshooting
186
+
###Troubleshooting
187
187
188
188
See the [NuGet Troubleshooting](slug:troubleshooting-nuget) article for tips about common pitfalls when working with the Telerik NuGet feed.
189
189
190
190
## See Also
191
191
192
192
*[Restoring NuGet Packages in Your CI Workflow]({%slug using-nuget-keys%})
193
193
*[Install using NuGet Packages]({%slug installation-nuget-packages%})
0 commit comments