Update WebReports to the Latest Version

Trouble Viewing Images? Right-click on any image and select "Open in new tab" to view a larger version. You can also zoom in using Ctrl + Mouse Wheel for easier readability.

Article Goal

Learn how to safely update your WebReports installation to the latest version while preserving your existing configuration and ensuring compatibility with newer dependencies such as .NET 10.

Why Update WebReports?

Updating WebReports ensures you have access to the latest features, performance improvements, security patches, and compatibility with modern .NET versions.

Tips: Always back up your existing installation before updating to avoid loss of configuration and to provide a fallback in case of issues.

Before updating it is recommended to check the requirements for the latest version of WebReports.

Use Case: You’re upgrading WebReports to align with a new VDM release or to resolve compatibility issues with .NET or SQL Server.

Where Do You Get the Latest WebReports?

You can download the newest installer ZIP here: Download

Steps to Update WebReports

Step 1: Stop the WebReports Services

• Open IIS Manager

• Right-click on Application Pools and stop the WebReports application pool

• Right-click on the IIS service and select stop

Step 2: Back Up the Current WebReports Installation

• In File Explorer, navigate to your wwwroot directory

• Right-click the folder and select Copy

• Paste it somewhere safe (e.g., Desktop or backup directory)

Step 3: Clean the WebReports Directory

• Inside the wwwroot, press Ctrl + A to select all files

• Hold Ctrl and unselect wwwroot and appsettings.json

• Press Delete to remove the rest

• Go into the wwwroot folder and delete the CSS and JS folders

Step 4: Prepare the New Files

• Download the latest WebReports ZIP: Download

• Right-click the ZIP file and select Properties.

• Check Unblock.

• Click Apply.

• Extract the ZIP to a folder.

• Inside the extracted folder, delete appsettings.json to avoid overwriting your current configuration.

Tip: Leaving appsettings.json in the new folder will overwrite your saved WebReports settings. Always delete it before copying.

Step 5: Copy and Paste New Files

• Select all remaining files in the extracted folder (Ctrl + A → Ctrl + C)

• Paste them into your live wwwroot directory

• When prompted to overwrite, choose Yes to All

Step 6: Check for Version-Specific Requirements

Important: WebReports 2026.3.30 or later requires .NET 10
 

You must add the following to your SQL connection string in appsettings.json: Encrypt=Yes;TrustServerCertificate=Yes

Example Updated Connection String
Server=SQLServerName\\SQLInstanceName;Database=WebReports;User Id=YourSQLUser;Password=YourSQLPassword;Connect Timeout=60;Encrypt=Yes;TrustServerCertificate=Yes

Step 7: Start the WebReports Services

• Start the IIS service

• Start the WebReports application pool

Step 8: Verify Access

• Open your browser

• Navigate to your WebReports URL

• Confirm the application launches and all expected functionality is present

Article Summary

Updating WebReports ensures optimal performance, compatibility with .NET 10, and access to the latest features. The process involves stopping IIS, backing up the current install, cleaning up files (without removing configuration), copying over the new files, and restarting services. Always confirm your connection string is updated when upgrading to versions requiring .NET 10.