Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
82 changes: 82 additions & 0 deletions dotnet-docs/linux-installation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
---
title: Installation on Linux
page_title: Installing ReportServer.NET on Linux
description: "Learn about the specifics, recommendations, and available approaches for installing the Telerik Report Server for .NET on Linux."
slug: dotnet-installation-on-linux
tags: installation,dotnet,linux,ubuntu,fedora,arch,debian
published: True
position: 201
---

# Report Server for .NET: Installation on Linux

Starting with the [2025 Q3 release](https://www.telerik.com/support/whats-new/report-server/release-history/progress-telerik-report-server-2025-q3-11-2-25-812) of the Telerik Report Server, you can download a separate installer for Linux operating systems.

## Installation Process

1. Navigate to the [Progress® Telerik® Report Server download page](https://www.telerik.com/account/downloads/product-download?product=REPSERVER), where you should find the zipped installer file.

![The Linux Installer for Report Server available for download from the Telerik downloads page](../images/rs-net-images/rs-net-download-linux-cli-installer.png)

1. If the `unzip` command isn't already installed on the system (use `which unzip` to check), run the following command to install it:

````bash
sudo apt-get install unzip
````


1. After installing the unzip utility, use the following command to extract the installer into a new directory:

````bash
unzip Telerik_ReportServer_Net_NonWindows_Installer_11_2_25_812.zip -d reportserver
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
unzip Telerik_ReportServer_Net_NonWindows_Installer_11_2_25_812.zip -d reportserver
unzip Telerik_ReportServer_Net_NonWindows_Installer_11_2_25_813.zip -d reportserver

````


1. Navigate to the newly created *reportserver* directory and then use the `ls` command to ensure that the **Telerik.ReportServer.Installer** file is present:

````bash
cd reportserver
ls
````


1. Make the **Telerik.ReportServer.Installer** file an executable using the `chmod` command to give it the **+x** permission:

````bash
sudo chmod +x ./Telerik.ReportServer.Installer
````


1. Run the executable file to begin the installation:

````bash
sudo ./Telerik.ReportServer.Installer
````


1. If the previous steps were executed successfully, the installer will begin, and during the rest of the installation process, you will be asked to configure the Telerik Report Server for .NET via the CLI. This includes providing the operating system account that should be used by the installer, credentials for the admin user in the Report Server, and so on.

![A Preview of a Successful Start of the Report Server Linux CLI Installer](../images/rs-net-images/rs-net-linux-installer-preview.png)


## Post-Installation

Once the installation is complete, navigate to the `/Account/Login` page of the Report Server for .NET in your browser to verify that the application is up and running.

Any configuration settings skipped during the CLI installation can be completed post-installation from the `/Configuration` page.

Internally, the installer uses the ready-to-use Docker Images introduced in [2025 Q2 (11.1.25.521)](https://www.telerik.com/support/whats-new/report-server/release-history/progress-telerik-report-server-2025-q2-11-1-25-521):

* https://hub.docker.com/r/progressofficial/telerik-reportserver-app
* https://hub.docker.com/r/progressofficial/telerik-reportserver-agent

The above images are downloaded automatically during the installation. If [Docker](https://www.docker.com/) is not present on the system, it will be automatically installed, as the installer uses **Docker** to host the application.
In the installation directory, you will find the `docker-compose.yml` file, which contains valuable information such as the **main and backup** [encryption keys]({%slug security%}#encryption).

The installer will also automatically create a single [Report Server Agent]({%slug dotnet-server-agents%}), the configuration for which can also be found in the `docker-compose.yml` file.

## See Also

* [Installation on Windows]({%slug dotnet-installation-on-windows%})
* [Azure Marketplace Deployment]({%slug azure-marketplace-integration%})
* [Installation on Docker Container]({%slug dotnet-installation-on-docker-container%})
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.