Gotchas¶
IIS¶
Microsoft Learn: Host ASP.NET Core on Windows with IIS
We do not recommend to deploy Ocelot app to IIS environments, but if you do, keep in mind the gotchas below.
When using ASP.NET Core 2.2+ and you want to use In-Process hosting, replace
UseIISIntegration()withUseIIS(), otherwise you will get startup errors.Make sure you use Out-of-process hosting model instead of In-process one (see Out-of-process hosting with IIS and ASP.NET Core), otherwise you will get very slow responses (see 1657).
Ensure all DNS servers of all downstream hosts are online and they function perfectly, otherwise you will get slow responses (see 1630).
The community constanly reports issues related to IIS. If you have some troubles in IIS environment to host Ocelot app, first of all, read open/closed issues, and after that, search for IIS in the repository. Probably you will find a ready solution by Ocelot community members.
Finally, we have special label 
for all IIS related objects. Feel free to put this label onto issues, PRs, discussions, etc.