Miscellaneous Install Failure Scenarios
This page documents miscellaneous installation failures returned by the IA AVATAR EXE installer, built with Inno Setup.
0 means that Setup completed successfully. Any non-zero return code means that Setup did not run to completion.
Codes covered by this page
Microsoft Store standard scenarios can be entered separately in Partner Center. The following values describe additional or miscellaneous failures produced by the installer.
| EXE return code | Failure scenario | Documentation |
|---|---|---|
1 | Installer initialization failure | Code 1 details |
3 | Fatal error while preparing the installation phase | Code 3 details |
4 | Fatal error during installation | Code 4 details |
6 | Installer terminated by the Inno Setup debugger | Code 6 details |
7 | Installation cannot proceed after preparation checks | Code 7 details |
| Other non-zero value | Unexpected or future installer failure code | Unexpected code details |
Return code 1 — Setup failed to initialize
The installer could not initialize before the installation wizard or silent installation process started.
Possible causes
- The installer file is incomplete or corrupted.
- Windows could not provide the resources required to start Setup.
- Security software prevented the installer from initializing.
- The current Windows session is unstable.
Recommended action
- Restart Windows.
- Download a fresh copy from the Microsoft Store or the official NovaSphere Technologies website.
- Close unnecessary applications and run the installer again.
- Contact support if the problem continues.
Return code 3 — Fatal preparation error
A fatal error occurred while Setup was preparing to move to the next installation phase. This unusual condition can occur when Windows has insufficient memory or system resources.
Recommended action
- Close running applications.
- Restart Windows to release system resources.
- Verify that sufficient memory and storage space are available.
- Run the installer again.
Return code 4 — Fatal installation error
A fatal error occurred during the actual installation process. IA AVATAR was not installed completely.
Possible causes
- The destination folder could not be created or written to.
- An application file was locked by another process.
- The disk became unavailable or had insufficient free space.
- Security software blocked a file operation.
- The installer package or one of its resources was damaged.
Recommended action
- Record the error message displayed by Setup.
- Close IA AVATAR and applications that may be using its files.
- Check available disk space and restart Windows.
- Download a fresh installer and try again.
Return code 6 — Setup terminated by the debugger
The Inno Setup process was forcibly terminated from the development environment. This normally applies only to a development or test build and should not occur with the official public installer.
Recommended action
- Do not use the affected development build.
- Download the certified public installer.
- Contact NovaSphere Technologies if an official release returns this value.
Return code 7 — Installation cannot proceed
During the “Preparing to Install” stage, Setup determined that installation could not continue.
Possible causes
- A required condition or system component is missing.
- A conflicting process or existing application instance is running.
- A required folder or resource is unavailable.
- A custom compatibility check failed.
Recommended action
- Read the detailed message displayed by Setup.
- Close conflicting applications.
- Verify that the computer meets the IA AVATAR system requirements.
- Correct the identified condition and try again.
Unexpected non-zero return code
Future Inno Setup versions may return additional values. IA AVATAR treats every undocumented non-zero return value as an installation failure.
Information to provide to support
- The exact EXE return code.
- The complete error message displayed by Setup.
- The IA AVATAR installer version.
- The Windows version and system architecture.
- The steps performed immediately before the failure.
Standard installer scenarios
| Return code | Standard scenario |
|---|---|
0 | Installation successful |
2 or 5 | Installation cancelled by the user |
8 | Restart required before installation can continue |
Complete documentation is available on the Installer Return Codes page.
Document version: 1.0 · Updated: 14 July 2026 · Product: IA AVATAR