Setup Exit Codes

Beginning with Inno Setup 3.0.3, the Setup program may return one of the following exit codes:


Setup was successfully run to completion or the /HELP or /? command line parameter was used.


Setup failed to initialize.


The user clicked Cancel in the wizard before the actual installation started, or chose "No" on the opening "This will install..." message box.


A fatal error occurred while preparing to move to the next installation phase (for example, from displaying the pre-installation wizard pages to the actual installation process). This should never happen except under the most unusual of circumstances, such as running out of memory or Windows resources.


A fatal error occurred during the actual installation process.

Note: Errors that cause an Abort-Retry-Ignore box to be displayed are not fatal errors. If the user chooses Abort at such a message box, exit code 5 will be returned.


The user clicked Cancel during the actual installation process, or chose Abort at an Abort-Retry-Ignore box.


The Setup process was forcefully terminated by the debugger (Run | Terminate was used in the IDE).


The Preparing to Install stage determined that Setup cannot proceed with installation. (First introduced in Inno Setup 5.4.1.)


The Preparing to Install stage determined that Setup cannot proceed with installation, and that the system needs to be restarted in order to correct the problem. (First introduced in Inno Setup 5.4.1.)

Before returning an exit code of 1, 3, 4, 7, or 8, an error message explaining the problem will normally be displayed.

Future versions of Inno Setup may return additional exit codes, so applications checking the exit code should be programmed to handle unexpected exit codes gracefully. Any non-zero exit code indicates that Setup was not run to completion.