Typical iisnode issues and solutions (please read this before posting new issues) #146
Description
Questions/issue reports related to iisnode spanned two repos, this as well as https://github.com/tjanczuk/iisnode/issues but have been addressed properly in the past years.
Below is a summary on the most common ones so future readers might read before moving on.
| Topic | Comments | Main Issue | Duplicate Issues |
|---|---|---|---|
| Maintenance, roadmap, future, alternatives | There are two widely used alternatives, HttpPlatformHandler and ARR. The former is the easiest to implement. | #76 | #101 #144 |
| IIS 10 and installation | Deprecation of Web Platform Installer impacted the installation experience. Now you need to run the MSI installer manually. The latest installers can be found in https://github.com/Azure/iisnode/releases | #46 | #53 #94 #124 #142 tjanczuk#662 tjanczuk#672 tjanczuk#677 |
| DeprecatedWarning | The code of iisnode uses deprecated Node.js API. The pull requests are ready but not accepted. | tjanczuk#636 | #60 #62 #107 #128 tjanczuk#668 |
| Latest Node.js version and related | The code of iisnode is too old to support latest Node.js, PNPM, ES6 Modules, Next.js, etc. Switch to alternatives and things will work properly. | #81 #90 #102 #110 #113 #131 #133 #137 #141 tjanczuk#678 tjanczuk#687 tjanczuk#688 tjanczuk#702 tjanczuk#705 | |
| 50x.xxx errors | There are reports on 500 or 503 errors. Need further troubleshooting according to iisnode docs. | #47 #50 #57 #89 #132 tjanczuk#649 tjanczuk#650 tjanczuk#653 tjanczuk#657 tjanczuk#673 tjanczuk#680 tjanczuk#693 tjanczuk#697 | |
| Feature requests | Some of them are already implemented in alternatives like HttpPlatformHandler. | #19 #33 #51 #67 #120 |