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
wwwrootdirectoryRight-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 filesHold Ctrl and unselect
wwwrootandappsettings.jsonPress Delete to remove the rest
Go into the
wwwrootfolder and delete theCSSandJSfolders
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.jsonto 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
wwwrootdirectoryWhen 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 StringServer=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.
Comments
0 comments
Please sign in to leave a comment.