New to Telerik Report Server? Download free 30-day trial

Report Server for .NET: Installation on Linux

Starting with the 2025 Q3 release of the Telerik Report Server, you can download a separate installer for Linux operating systems.

The CLI installer is configured for Ubuntu and Ubuntu-based distributions.

Installation Process

  1. Navigate to the Progress® Telerik® Report Server download page, where you should find the zipped installer file.

    The Linux Installer for Report Server available for download from the Telerik downloads page

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

    sudo apt-get install unzip
    
  3. After installing the unzip utility, use the following command to extract the installer into a new directory:

    unzip Telerik_ReportServer_Net_NonWindows_Installer_11_2_25_813.zip -d reportserver
    
  4. Navigate to the newly created reportserver directory and then use the ls command to ensure that the Telerik.ReportServer.Installer file is present:

    cd reportserver
    ls
    
  5. Make the Telerik.ReportServer.Installer file an executable using the chmod command to give it the +x permission:

    sudo chmod +x ./Telerik.ReportServer.Installer
    
  6. Run the executable file to begin the installation:

    sudo ./Telerik.ReportServer.Installer
    
  7. 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

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

The above images are downloaded automatically during the installation. If Docker 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.

The installer will also automatically create a single Report Server Agent, the configuration for which can also be found in the docker-compose.yml file.

See Also

In this article