New to Telerik ReportingStart a free 30-day trial

Installation Approaches for Telerik Reporting

Telerik Reporting supports three installation approaches: the Control Panel, the MSI installer, and NuGet packages. Choose the approach based on whether you need design-time support and how you plan to manage the installation in your workflow.

After installing the product, you need to download and activate your Telerik Reporting License Key.

Use this table to choose the approach that fits your workflow:

ApproachBest ForDesign-Time Support
Control PanelEvaluating the product or managing multiple Telerik products on your machine.Yes
MSI installerFull local installation with Visual Studio integration, sample projects, and the Standalone Report Designer.Yes
NuGet packagesAdding Telerik Reporting to an existing project or automating installation in a CI/CD pipeline.No

Using the Control Panel

You can install Telerik Reporting by downloading and running the Progress Control Panel. The Control Panel manages downloads, installations, and updates across all your Telerik products from a single interface. For complete instructions, refer to the Progress Control Panel online documentation.

The Progress Control Panel automatically downloads and stores your license key in your home directory, making it available for all projects you develop on your local machine. For details, see Setting Up Telerik Reporting License Key.

Using the MSI File

You can install Telerik Reporting by using the .msi file for a full local installation. The installer adds Telerik Reporting to your computer under Program Files/Progress, creates the required virtual folders and projects, and provides all files needed for development with Telerik Reporting.

The MSI installation wizard installs the product by default in the C:\Program Files (x86)\Progress\Telerik Reporting 2026 Q2 folder.

The MSI installer is the recommended approach for a full local installation. It automatically registers the required Telerik Reporting assemblies in the machine GAC for the Visual Studio Report Designer, configures the Project and Item Templates across all Visual Studio instances, and creates and populates the AdventureWorks sample database for the sample projects.

Specifics

During the MSI installation process, note the following:

  • For Telerik Reporting versions earlier than R3 2017, the default installation paths were C:\Program Files\Telerik\ and C:\Program Files (x86)\Telerik\.
  • The latest package available for download has all updates and hotfixes applied. You do not need to update it further after installation.
  • The MSI installation does not overwrite previous Telerik Reporting installations unless the new installation is the same version. The installer keeps your existing installation and places new files in a separate folder.
  • The Downloads page lists previously downloaded products. For any missing products or product versions, contact the Sales team through the support ticketing system by submitting a General Feedback thread.

MSI Installation

To install Telerik Reporting through the MSI automatic installer file:

  1. Log into your Telerik account. Select the Downloads tab to view the available products and select Telerik Reporting.

  2. From the next page, download the MSI installation and the documentation files and download the automatic installation MSI file. The source code is available for download only for commercial license holders.

  3. When the download completes, run Telerik_Reporting_[suiteversion].msi. In the dialog that appears after you execute the MSI file, confirm that you have read and accepted the License Agreement.

    The Welcome Page of the Telerik Reporting Installation Wizard

  4. In the dialog that opens, select the features you require.

    • If Telerik Reporting does not locate a local SQL Server instance, or if the SQL Server Browser Service is stopped, the Examples dialog option installs the examples but the application configuration files do not contain valid connection strings. You can still access working demos on the Telerik Reporting demos page.
    • To set up the examples with a valid connection string, select Examples Setup. All local SQL Server 2005 and later instances are supported.
    • The examples require the MS SQL Server AdventureWorks database. If the database is not already available on your machine, the wizard deploys it locally.
    • To install AdventureWorks manually from the SQL script in the installer, navigate to [InstallDir]/Examples/Data/AdventureWorks OLTP. For the script to run correctly, uncomment the SET @data_path = 'C:\Program Files\Microsoft SQL Server\90\Tools\Samples\AdventureWorks OLTP\'; statement and specify the correct path to the CSV data files in the same folder.

    The Configuration Page of the Telerik Reporting Installation Wizard

  5. (If Examples Setup was selected) In the Setup Wizard dialog, select your Database Server and the authentication for the connection. The Wizard detects all running instances and lists them in the input field.

    To enable the wizard to detect all running SQL Server instances, start the SQL Server Browser Service.

    The Setup Page for the Samples Database of the Telerik Reporting Installation Wizard

    Installation progress bar during Telerik Reporting setup

    The completion step of the Telerik Reporting Installation Wizard

Using NuGet Packages

You can add Telerik Reporting to a project by installing NuGet packages from the Telerik NuGet server at https://nuget.telerik.com/v3/index.json. The packages contain the libraries for .NET Core projects, the Reporting Engine, and the Reporting REST WebAPI-based service. You can also use them with the standard .NET 4.6.2+ framework.

The Telerik Reporting NuGet packages do not include design-time support. If you need the Visual Studio Report Designer or the Standalone Report Designer, use the MSI installer instead.

Installing the Telerik Reporting NuGet packages involves three steps:

  1. Generating an API key required for the NuGet authentication.
  2. Adding the Telerik NuGet server to Visual Studio.
  3. Installing the Telerik Reporting NuGet packages.

Step 1: Generating an API Key

As the Telerik NuGet server requires authentication, the first step is to obtain an API key that you will use instead of a password. Using an API key instead of a password is a more secure approach, especially when working with .NET CLI or the NuGet.Config file.

  1. Go to the API Keys page in your Telerik account.

  2. Click Generate New Key +.

    Manage API Keys

  3. In the Key Note field, add a note that describes the API key.

  4. Click Generate Key.

  5. Select Copy and Close. Once you close the window, you can no longer copy the generated key. For security reasons, the API Keys page displays only a portion of the key.

  6. Store the generated NuGet API key as you will need it in the next steps. Whenever you need to authenticate your system with the Telerik NuGet server, use api-key as the username and your generated API key as the password.

API keys expire after two years. Telerik sends an email when a key is about to expire. Set your own calendar reminder with details about where you used the key—file paths, project links, AzDO and GitHub Action variable names, and so on.

Step 2: Adding the Telerik NuGet Package Source to Visual Studio

To configure the Telerik NuGet feed in Visual Studio:

  1. Open Visual Studio.
  2. Go to Tools > NuGet Package Manager > Package Manager Settings.
  3. Select Package Sources, and then click the + button.
  4. In the Source field, enter https://nuget.telerik.com/v3/index.json. If you use a locally available NuGet package downloaded from your account, add the path to the local package instead of the URL.
  5. Click Update and then OK.

The Telerik NuGet feed is now available as a package source.

For details on adding a NuGet feed, refer to the official Microsoft NuGet documentation.

Step 3: Installing Telerik Reporting

After adding the Telerik NuGet feed as a package source, authenticate your local NuGet instance and install Telerik Reporting:

  1. Create a new Reporting project or open an existing one.
  2. Go to Tools > NuGet Package Manager > Manage NuGet Packages for Solution.... Select the Telerik NuGet Package source from the drop-down list on the left.
  3. Select the Browse tab to see the available packages.
  4. In the authentication window, enter api-key in the User name field and the generated API key in the Password field.
  5. Select the desired Telerik Reporting NuGet package and click Install.

See Also