🚀 Welcome to MDriven Learn –  MDriven is now on Discord!  Don’t miss the latest Release Notes.
Troubleshooting IIS application startup issues
This page was created by Hans.karlsen on 2020-10-14. Last edited by Edgar on 2025-10-12.

Turnkey Not Starting[edit source]

If your Turnkey application does not start in IIS, follow these guidelines to pinpoint the problem area.

In the Turnkey web.config file, remove the section that makes the errors route into the application:

<httpErrors errorMode="Detailed" >
</httpErrors>

If you do not replace this, some errors will be rerouted into the same situation that has the problem.

Make sure you have:  

<system.web>
  <compilation debug="true" />
  • Advanced settings for AppPool* (to consider)

Specific time, same every day

Allow overlap AppPool recycle must be disabled.

Idle time-out action Suspend AppPool (not terminate).

------------

ServerSidejobs or SysAsyncTickets being re-entered and started in parallel, or VistaDB is locked by another process:

Understanding IIS Restarting and Process[edit source]

External helpful article on how IIS works internally and how to handle restarting it: https://www.leansentry.com/guide/reset-restart-recycle-iis