> For the complete documentation index, see [llms.txt](https://gamelauncher.cloud/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gamelauncher.cloud/help/launchers/installer-exit-codes.md).

# Installer Exit Codes

The Windows installer built for your launcher reports a specific exit code for every outcome. Use these when you deploy the launcher through a management tool, a script, or the Microsoft Store.

This is the page to enter in Partner Center under **Packages > Installer handling > Provide URL for documentation for all miscellaneous EXE return code values**.

## Codes

| Code   | Meaning                              | What happened                                                                                                                   |
| ------ | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| `0`    | Installation successful              | The launcher was installed, or an existing installation was upgraded in place.                                                  |
| `112`  | Disk space is full                   | The target drive does not have enough free space. The installer checks before writing anything, so nothing was installed.       |
| `1602` | Installation cancelled by user       | The user clicked Cancel or closed the wizard. Never returned during a silent install.                                           |
| `1603` | Package rejected during installation | A file could not be written, or a device security policy blocked the install.                                                   |
| `1618` | Installation already in progress     | Another copy of the same installer is already running in this Windows session. Wait for it to finish and try again.             |
| `1638` | Application already exists           | The launcher is already installed and the user declined the upgrade prompt. A silent install upgrades in place and returns `0`. |

The values follow the standard Windows Installer convention, so tools that already understand MSI return codes read them correctly without extra configuration.

## Silent install

The installer supports unattended installation:

```powershell
# Install without any user interaction
.\YourLauncher_Installer_Windows_x64.exe /S

# Install to a specific folder (/D must be last, and unquoted)
.\YourLauncher_Installer_Windows_x64.exe /S /D=C:\Games\YourLauncher
```

The switch is `/S`, uppercase. Switches from other installer toolkits (`/silent`, `/verysilent`, `/quiet`, `/qn`) are not recognised and will open the wizard instead.

## Silent uninstall

```powershell
& "$env:LOCALAPPDATA\YourLauncher\uninst.exe" /S
```

The same command is stored in the registry as `QuietUninstallString`, so deployment tools can discover it automatically:

```powershell
Get-ItemProperty "HKCU:\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourLauncher" |
  Select-Object DisplayName, Publisher, DisplayVersion, QuietUninstallString
```

Launchers configured to install for all users write to `HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\` instead.

## Reading the exit code

{% tabs %}
{% tab title="PowerShell" %}

```powershell
$p = Start-Process -FilePath .\YourLauncher_Installer_Windows_x64.exe -ArgumentList "/S" -Wait -PassThru
if ($p.ExitCode -ne 0) { Write-Error "Install failed with code $($p.ExitCode)" }
```

{% endtab %}

{% tab title="Command Prompt" %}

```batch
YourLauncher_Installer_Windows_x64.exe /S
echo Exit code: %ERRORLEVEL%
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Do not run the installer with `Start-Process` without `-Wait`. PowerShell returns immediately and `$p.ExitCode` will be empty.
{% endhint %}

## What the installer does not do

* It never requires a restart, so `3010` is never returned.
* It never downloads anything during installation. Everything it installs is inside the installer itself, so there are no network failure codes.
* It adds exactly one entry to Add or remove programs and installs no third party software.

## Related

* [Publish to the Microsoft Store](https://gamelauncher.cloud/help/launchers/microsoft-store)
* [Launcher Builds](https://gamelauncher.cloud/help/launchers/launcher-builds)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gamelauncher.cloud/help/launchers/installer-exit-codes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.