Important: This installation is required specifically for applications built on the .NET Core or .NET 5+ frameworks. If your application uses the legacy .NET Framework, this bundle is not required.
Before you begin
You will need:
Administrator privileges on the Windows Server.
Remote Desktop access to the server.
The specific version of the ASP.NET Core Hosting Bundle that matches the version of the .NET runtime your application requires.
Install the ASP.NET Core Hosting Bundle
Log in to the Windows Server via Remote Desktop.
Open a web browser and navigate to the official Microsoft download page for the .NET Runtime.
Locate the version of .NET required by your application.
Find the Hosting Bundle installer for that specific version.
Download and run the installer.
Follow the installation prompts.
Once the installation is complete, the system may prompt you to restart or the IIS service may automatically restart to apply the changes.
Confirm the result
The installation completes successfully without errors in the installer.
You can verify the installation by opening the PowerShell console and running the command
dotnet --info. The output should list the installed .NET runtimes and the corresponding hosting bundle.The application can be successfully hosted and served via IIS.
Troubleshooting
Installation fails or does not appear in IIS
If the installation completes but the .NET modules do not appear in the IIS Manager, restart the Windows Server or manually restart the World Wide Web Publishing Service.
"Module not found" errors in IIS
If you receive a "Module not found" error when attempting to start the site, ensure that the version of the Hosting Bundle installed matches the version of the ..NET runtime the application is targeting.
Limitations
This procedure only installs the hosting components for the specific version of .NET selected during the download process. If you upgrade your application to a newer version of .NET, you must repeat this process to install the corresponding Hosting Bundle.
