Report Server for .NET

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

Report Server for .NET: Installation on Docker Container

The Report Server for .NET (RS.NET) is ready for deployment on Docker Containers through ready-to-use Docker Images introduced in 2025 Q2 (11.1.25.521):

The above images would be downloaded automatically when using the docker-compose.yml files suggested in the workflow below, following the Microsoft Docker Compose concept.

The setup process described in this article consists of the following steps that should be executed in the proposed order:

  1. First, we configure the Report Server Manager application for .NET. This lets you, as an administrator, configure the Report Server by adding the required Encryption.
  2. As a second step, we redeploy the Report Server Manager for .NET with the known Encryption keys. This lets you add a Report Server Agent. Generally, you may add more than one Report Server Agent for each Report Server Manager.
  3. Finally, with the known Report Server Agent identifiers, we may also deploy the latter.

Compose the Docker Container

Below is an example of a docker-compose.yml that may be used for installing the Report Server Manager, Report Server Agent, and the MSSQL Server Storage for the complete Report Server for .NET suite. The same docker-compose.yml is used as a base in the steps below. Each step, though, requires uncommenting part of the code, updating part of it, or adding new pieces as explained in the corresponding step. Note that the tabulation must be kept as shown in the snippet:

services:

# template configuration of Report Server.
# Please update the YOUR_LICENSE_KEY_HERE environment variable with the value of your Telerik License Key.
  telerik-report-server:
    environment:
      - reportServer__storage__provider=MsSqlServer
      - reportServer__storage__parameters__0__name=ConnectionString
      - reportServer__storage__parameters__0__value=Data Source=storage;Initial Catalog=reportserver;Password=P1@ceStr0ngP@ssw0rdH3r3;User Id=sa;Encrypt=false
      - reportServer__storage__isDefault=false
      - TELERIK_LICENSE=YOUR_LICENSE_KEY_HERE
    image: progressofficial/telerik-reportserver-app:latest
    restart: always
    ports:
      - "82:80"
    depends_on: 
      - storage

# template configuration of Report Server Agent.
# Uncomment the following lines when a new server agent is configured in the Service Agents panel in the Configuration view of the Report Server web application.
# Please update the Agent__AuthenticationToken and Agent__Id environment variables with the values from the newly created agent configuration.
# Please update the YOUR_LICENSE_KEY_HERE environment variable with the value of your Telerik License Key.
  # telerik-report-server-agent:
  #   environment:
  #   - Agent__ServerAddress=http://telerik-report-server
  #   - Agent__AuthenticationToken=YOUR_AGENT_AUTHENTICATION_TOKEN_HERE
  #   - Agent__Id=YOUR_AGENT_ID_HERE
  #   - TELERIK_LICENSE=YOUR_LICENSE_KEY_HERE
  #   image: progressofficial/telerik-reportserver-agent:latest
  #   restart: always
  #   command: dockerize -wait tcp://telerik-report-server:80 -timeout 1200s

  storage:
    image: "mcr.microsoft.com/mssql/server:2022-latest"
    restart: always
    environment:
      - MSSQL_SA_PASSWORD=P1@ceStr0ngP@ssw0rdH3r3
      - ACCEPT_EULA=Y
    volumes: 
      - mssql-storage:/var/opt/mssql

volumes:
  mssql-storage:

We strongly recommend changing the password P1@ceStr0ngP@ssw0rdH3r3 for the SA database user with your strong password in the above docker-compose.yml.

Steps to install the RS.NET on the Docker Container

Installing the Report Server Manager

  • (optional, use it only if it was not used before) Initialize a swarm to make the Docker Engine hosting the RS.NET a manager in the newly created single-node swarm by running the command docker swarm init.
  • Use the following docker-compose.yml. Replace the YOUR_LICENSE_KEY_HERE environment variable with the value of your Telerik License Key:
services:

# template configuration of Report Server.
  telerik-report-server:
    environment:
      - reportServer__storage__provider=MsSqlServer
      - reportServer__storage__parameters__0__name=ConnectionString
      - reportServer__storage__parameters__0__value=Data Source=storage;Initial Catalog=reportserver;Password=P1@ceStr0ngP@ssw0rdH3r3;User Id=sa;Encrypt=false
      - reportServer__storage__isDefault=false
      - TELERIK_LICENSE=YOUR_LICENSE_KEY_HERE
    image: progressofficial/telerik-reportserver-app:latest
    restart: always
    ports:
      - "82:80"
    depends_on: 
      - storage

  storage:
    image: "mcr.microsoft.com/mssql/server:2022-latest"
    restart: always
    environment:
      - MSSQL_SA_PASSWORD=P1@ceStr0ngP@ssw0rdH3r3
      - ACCEPT_EULA=Y
    volumes: 
      - mssql-storage:/var/opt/mssql

volumes:
  mssql-storage:
  • Run the command docker stack deploy -c docker-compose.yml report-server.
  • Navigate to localhost:82 in the browser to open the Report Server Manager for .NET.

Creating a New Server Agent

The Report Server Manager for .NET has to be fully set up before following the steps from this section.

  • Use the following docker-compose.yml. Inside the environment element, there are entries for each encryption key. They should be downloaded from the Encryption step during the Configuration after successfully Installing the Report Server Manager:

    • RS_NET_MainPrivateKey - Environment variable holding the main private key for the encryption.
    • RS_NET_BackupPrivateKey - Environment variable holding the main backup key for the encryption.

    Don't forget to replace also the YOUR_LICENSE_KEY_HERE environment variable with the value of your Telerik License Key.

services:

# template configuration of Report Server.
  telerik-report-server:
    environment:
      - RS_NET_MainPrivateKey=PASTE_THE_MAIN_ENCRYPTION_KEY_HERE
      - RS_NET_BackupPrivateKey=PASTE_THE_BACKUP_ENCRYPTION_KEY_HERE
      - reportServer__storage__provider=MsSqlServer
      - reportServer__storage__parameters__0__name=ConnectionString
      - reportServer__storage__parameters__0__value=Data Source=storage;Initial Catalog=reportserver;Password=P1@ceStr0ngP@ssw0rdH3r3;User Id=sa;Encrypt=false
      - reportServer__storage__isDefault=false
      - TELERIK_LICENSE=YOUR_LICENSE_KEY_HERE
    image: progressofficial/telerik-reportserver-app:latest
    restart: always
    ports:
      - "82:80"
    depends_on: 
      - storage

  storage:
    image: "mcr.microsoft.com/mssql/server:2022-latest"
    restart: always
    environment:
      - MSSQL_SA_PASSWORD=P1@ceStr0ngP@ssw0rdH3r3
      - ACCEPT_EULA=Y
    volumes: 
      - mssql-storage:/var/opt/mssql

volumes:
  mssql-storage:
  • Run the command docker stack deploy -c docker-compose.yml report-server to re-deploy with the updated docker-compose.yml.
  • Open the Report Server Manager (by default - http://localhost:82), and then open the Configuration page.
  • Click on the SERVER AGENT tab and start the creation of a new Server Agent by pressing the CONFIGURE NEW AGENT button.

  • In the pop-up window with title Configure New Agent, enter the Report Server base URL or http://telerik-report-server. This should automatically route to the Report Server Manager application.

    Configuring a new Server Agent in the Report Server for .NET - Step 1

  • Press the GENERATE CONFIGURATION pop-up and copy the tokens from the ENVIRONMENT VARIABLES tab:

    Configuring a new Server Agent in the Report Server for .NET - Step 2

  • Use the following docker-compose.yml file:

services:

# template configuration of Report Server.
  telerik-report-server:
    environment:
      - RS_NET_MainPrivateKey=PASTE_THE_MAIN_ENCRYPTION_KEY_HERE
      - RS_NET_BackupPrivateKey=PASTE_THE_BACKUP_ENCRYPTION_KEY_HERE
      - reportServer__storage__provider=MsSqlServer
      - reportServer__storage__parameters__0__name=ConnectionString
      - reportServer__storage__parameters__0__value=Data Source=storage;Initial Catalog=reportserver;Password=P1@ceStr0ngP@ssw0rdH3r3;User Id=sa;Encrypt=false
      - reportServer__storage__isDefault=false
      - TELERIK_LICENSE=YOUR_LICENSE_KEY_HERE
    image: progressofficial/telerik-reportserver-app:latest
    restart: always
    ports:
      - "82:80"
    depends_on: 
      - storage

# template configuration of Report Server Agent.
# Uncomment the following lines when a new server agent is configured in the Service Agents panel in the Configuration view of the Report Server web application.
# Please update the Agent__AuthenticationToken and Agent__Id environment variables with the values from the newly created agent configuration.
# Please update the YOUR_LICENSE_KEY_HERE environment variable with the value of your Telerik License Key.
  telerik-report-server-agent:
    environment:
      - Agent__ServerAddress=http://telerik-report-server
      - Agent__AuthenticationToken=YOUR_AGENT_AUTHENTICATION_TOKEN_HERE
      - Agent__Id=YOUR_AGENT_ID_HERE
      - TELERIK_LICENSE=YOUR_LICENSE_KEY_HERE
    image: progressofficial/telerik-reportserver-agent:latest
    restart: always
    command: dockerize -wait tcp://telerik-report-server:80 -timeout 1200s

  storage:
    image: "mcr.microsoft.com/mssql/server:2022-latest"
    restart: always
    environment:
      - MSSQL_SA_PASSWORD=P1@ceStr0ngP@ssw0rdH3r3
      - ACCEPT_EULA=Y
    volumes: 
      - mssql-storage:/var/opt/mssql

volumes:
  mssql-storage:
  • Update the Agent__AuthenticationToken and Agent__Id environment variables with the values from the newly created agent configuration.
  • Update the YOUR_LICENSE_KEY_HERE environment variable with the value of your Telerik License Key.
  • Run the command docker stack deploy -c docker-compose.yml report-server to re-deploy with the updated docker-compose.yml.

  • Open the Configuration page with the Service Agents again, now there should be one agent visible in the Server Agents table in the middle of the page:

    Server Agents Configuration page with one agent created

See Also

In this article
Related articles
Not finding the help you need? Improve this article