|
| 1 | +--- |
| 2 | +title: Installation on Linux |
| 3 | +page_title: Installing ReportServer.NET on Linux |
| 4 | +description: "Learn about the specifics, recommendations, and available approaches for installing the Telerik Report Server for .NET on Linux." |
| 5 | +slug: dotnet-installation-on-linux |
| 6 | +tags: installation,dotnet,linux,ubuntu,fedora,arch,debian |
| 7 | +published: True |
| 8 | +position: 201 |
| 9 | +--- |
| 10 | + |
| 11 | +# Report Server for .NET: Installation on Linux |
| 12 | + |
| 13 | +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. |
| 14 | + |
| 15 | +## Installation Process |
| 16 | + |
| 17 | +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. |
| 18 | + |
| 19 | +  |
| 20 | + |
| 21 | +1. If the `unzip` command isn't already installed on the system (use `which unzip` to check), run the following command to install it: |
| 22 | + |
| 23 | + ````bash |
| 24 | +sudo apt-get install unzip |
| 25 | +```` |
| 26 | +
|
| 27 | +
|
| 28 | +1. After installing the unzip utility, use the following command to extract the installer into a new directory: |
| 29 | +
|
| 30 | + ````bash |
| 31 | +unzip Telerik_ReportServer_Net_NonWindows_Installer_11_2_25_812.zip -d reportserver |
| 32 | +```` |
| 33 | + |
| 34 | + |
| 35 | +1. Navigate to the newly created *reportserver* directory and then use the `ls` command to ensure that the **Telerik.ReportServer.Installer** file is present: |
| 36 | + |
| 37 | + ````bash |
| 38 | +cd reportserver |
| 39 | +ls |
| 40 | +```` |
| 41 | +
|
| 42 | +
|
| 43 | +1. Make the **Telerik.ReportServer.Installer** file an executable using the `chmod` command to give it the **+x** permission: |
| 44 | +
|
| 45 | + ````bash |
| 46 | +sudo chmod +x ./Telerik.ReportServer.Installer |
| 47 | +```` |
| 48 | + |
| 49 | + |
| 50 | +1. Run the executable file to begin the installation: |
| 51 | + |
| 52 | + ````bash |
| 53 | +sudo ./Telerik.ReportServer.Installer |
| 54 | +```` |
| 55 | +
|
| 56 | +
|
| 57 | +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. |
| 58 | +
|
| 59 | +  |
| 60 | +
|
| 61 | +
|
| 62 | +## Post-Installation |
| 63 | +
|
| 64 | +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. |
| 65 | +
|
| 66 | +Any configuration settings skipped during the CLI installation can be completed post-installation from the `/Configuration` page. |
| 67 | +
|
| 68 | +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): |
| 69 | +
|
| 70 | +* https://hub.docker.com/r/progressofficial/telerik-reportserver-app |
| 71 | +* https://hub.docker.com/r/progressofficial/telerik-reportserver-agent |
| 72 | +
|
| 73 | +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. |
| 74 | +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). |
| 75 | +
|
| 76 | +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. |
| 77 | +
|
| 78 | +## See Also |
| 79 | +
|
| 80 | +* [Installation on Windows]({%slug dotnet-installation-on-windows%}) |
| 81 | +* [Azure Marketplace Deployment]({%slug azure-marketplace-integration%}) |
| 82 | +* [Installation on Docker Container]({%slug dotnet-installation-on-docker-container%}) |
0 commit comments