Skip to content

Commit a1c34d2

Browse files
authored
Update telerik-nuget-source.md
1 parent 5c38e88 commit a1c34d2

File tree

1 file changed

+15
-16
lines changed

1 file changed

+15
-16
lines changed

getting-started/Installation/telerik-nuget-source.md

Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
---
22
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.
55
slug: telerik-nuget-source
6-
tags: get,started,installation,nuget,feed
6+
tags: get, started, installation, nuget, feed
77
published: True
88
position: 8
99
---
1010

11-
# Telerik Private NuGet Source
11+
# Telerik NuGet Source
1212

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).
1414

1515
The benefit of using an online NuGet source is that you will receive notifications for newer component versions.
1616

@@ -22,11 +22,11 @@ You can set up the remote Telerik NuGet feed in the following ways:
2222

2323
>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).
2424
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.
2626
2727
For NuGet-related issues, see [Troubleshooting Telerik NuGet]({%slug troubleshooting-telerik-nuget%}).
2828

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%}).
3030

3131

3232
## Use Visual Studio
@@ -106,7 +106,7 @@ To edit a `NuGet.Config` file and add the Telerik feed, you need to:
106106

107107
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).
108108

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

111111
````XML.skip-repl
112112
<?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:
126126
</configuration>
127127
````
128128

129-
## Use NuGet API Key
129+
### Use NuGet API Key
130130

131131
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):
132132

@@ -138,9 +138,9 @@ You can [generate your Telerik NuGet API Key on telerik.com](https://www.telerik
138138
> Always use the NuGet API Key in plain text.
139139
140140

141-
## Package Source Mapping
141+
### Package Source Mapping
142142

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.
144144

145145
> 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.
146146
@@ -169,7 +169,7 @@ The Document Processing Libraries' NuGet packages and most of its dependencies r
169169
````
170170

171171

172-
## Access NuGet Packages behind Firewall
172+
### Access NuGet Packages behind Firewall
173173

174174
To access the Telerik NuGet feed behind a firewall that restricts outgoing requests, you may need to allow the following domains:
175175

@@ -178,17 +178,16 @@ To access the Telerik NuGet feed behind a firewall that restricts outgoing reque
178178

179179
The firewall must allow some of the requests to be redirected from `nuget.telerik.com` to `downloads.cdn.telerik.com`.
180180

181-
## Obsolete Telerik NuGet URL
181+
### Obsolete Telerik NuGet URL
182182

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`.
184184

185185

186-
## Troubleshooting
186+
### Troubleshooting
187187

188188
See the [NuGet Troubleshooting](slug:troubleshooting-nuget) article for tips about common pitfalls when working with the Telerik NuGet feed.
189189

190190
## See Also
191191

192192
* [Restoring NuGet Packages in Your CI Workflow]({%slug using-nuget-keys%})
193193
* [Install using NuGet Packages]({%slug installation-nuget-packages%})
194-
* [NuGet Troubleshooting](slug:troubleshooting-nuget)

0 commit comments

Comments
 (0)