Internet Explorer is no longer supported. Many things will still work, but your experience will be degraded and some things won't function. Please use a modern browser such as Edge, Chrome, or Firefox.

Web Hosting & HTTPS on Windows

view on GitHub

Inedo products have a built-in web server that is often referred to as the Integrated Web Server in software and documentation.

About the Integrated Web Server

The Integrated Web Server (IWS) is based on Kestrel, a high-performance, cross-platform web server for .NET. Microsoft officially recommends Kestrel for modern .NET applications, and the IWS includes several important features:

  • Operate in both HTTP and HTTPS modes on ports you desire
  • HSTS, which will redirect HTTP requests to HTTPS
  • Use Windows certificate store or disk-based files for HTTPS
  • Specify a concurrent request limit to help prevent server overload

The IWS also allows you to use port sharing on Windows and Integrated Windows Authentication.

How to Configure HTTPS

HTTPS is effectively a requirement for modern web applications, even if you're only using it inside the firewall. It's relatively easy to use an SSL certificate with the IWS; see Configuring HTTPS on Windows to learn more.

Using Windows IIS with Inedo Products

Like with most web-based applications that run on Windows, using IIS to host Inedo products has gone from being a requirement to being no longer supported. If you're still using IIS to host an Inedo product, you will need to switch to the Integrated Web Server to upgrade to the latest versions.

2025 Versions and Later

It's no longer possible to use IIS to host the 2025 and later versions of our products.

However, it's possible Configure IIS as a Reverse Proxy for the Integrated Web Server. This may be desired if you want to configure port sharing (i.e. binding to hostnames) in IIS or enable advanced HTTP/access logs.

2022 - 2024 Versions

Following Microsoft's guidance to no longer use IIS for modern .NET applications, we stopped recommending IIS to host modern versions (2022+) of our products.

While it's possible to host modern .NET applications in IIS, it's significantly more complex from a technical perspective, requiring server administrators to fine-tune hosting models and parameters - many of which were never designed for modern .NET applications. In addition, settings from other web sites and applications hosting in IIS often interfere with settings defined in modern .NET applications.

Note that hosting in IIS requires that a special ASP.NET Hosting Bundle be installed at the system level, which the Inedo Hub will attempt to do automatically.

Older Versions (before 2022)

Older versions of our products were built on .NET Framework. Microsoft generally recommended using IIS to host .NET Framework applications.

While the Integrated Web Server (IWS) is available in older versions, it wasn't as easy to configure and had limited configuration options (including HTTPS).

If you need to configure or maintain an older version of an Inedo product, you may find the following archived documentation helpful::