Windows installer deployment

Technical reference for running the full MATCHA Windows .exe installer from scripts, software deployment tools, or endpoint management systems.

Installer file

These commands apply to the full Windows installer named MATCHA-Windows-<version>-x64-Setup.exe. They do not apply to the bootstrap installer named MATCHA-Windows-Setup.exe.

Silent install

Use the standard NSIS silent flag. The /S flag is case-sensitive and must be uppercase.

MATCHA-Windows-<version>-x64-Setup.exe /S

Install scope

MATCHA installs for the current user by default unless an existing installation or deployment flag selects a different scope.

MATCHA-Windows-<version>-x64-Setup.exe /S /currentuser
MATCHA-Windows-<version>-x64-Setup.exe /S /allusers

/allusers installs per-machine and requires administrator privileges. /currentuser installs under the signed-in Windows user.

Custom install directory

Add /D= to override the install directory. It should be the final argument.

MATCHA-Windows-<version>-x64-Setup.exe /S /currentuser /D=C:\Users\Public\MATCHA

PowerShell deployment example

Use Start-Process with -Wait and -PassThru so your deployment script can read the installer exit code.

$installer = ".\MATCHA-Windows-<version>-x64-Setup.exe"
$process = Start-Process -FilePath $installer -ArgumentList '/S', '/currentuser' -Wait -PassThru

if ($process.ExitCode -eq 0 -or $process.ExitCode -eq 3010) {
  Write-Host "MATCHA installed successfully."
} else {
  Write-Error "MATCHA installer failed with exit code $($process.ExitCode)."
}

exit $process.ExitCode

Command Prompt deployment example

MATCHA-Windows-<version>-x64-Setup.exe /S /currentuser
echo %ERRORLEVEL%

Return codes

Microsoft Partner Center asks for EXE return code values for standard installer-handling scenarios. Use the following values for the full offline MATCHA installer package.

Scenario	EXE return code value	MATCHA deployment note
Installation cancelled by user	`1602`	The user cancelled the install before completion.
Application already exists	`1638`	Use when deployment logic blocks the install because a same-or-newer MATCHA installation is already present. Normal MATCHA updates reinstall or upgrade instead of treating this as a failure.
Installation already in progress	`1618`	Another installer is already running and must finish first.
Disk space is full	`112`	Windows reports that the target disk does not have enough free space.
Reboot required	`3010`	Treat as a successful install that requires a Windows restart to finish.
Network failure	`1200212007120291203012031`	The full installer is standalone and does not download additional payloads. These values are only for network failures surfaced by a deployment wrapper or package delivery layer.
Package rejected during installation	`1625`	The install is forbidden by Windows system policy or a device security policy.
Installation successful	`0`	Treat as success.

Treat any other non-zero value as a miscellaneous install failure and inspect the deployment context, permissions, available disk space, and running MATCHA processes.

Silent uninstall

The installed uninstaller also accepts /S. The uninstall command is registered in Windows as the quiet uninstall string for the installed application.

"%LOCALAPPDATA%\Programs\MATCHA\Uninstall MATCHA.exe" /S

Back to Documentation Download MATCHA