wsa-installer/docs/cli-reference.md

CLI Reference

WSA Installer supports various command-line arguments for automation and advanced usage.

Basic Usage

WSA Installer.exe [OPTIONS]

Command Line Arguments

Argument	Description
--install-service	Install WSABackgroundService
--uninstall-service	Remove WSABackgroundService
--bg-service	Run as background service (SYSTEM context)
--bg-service-gui	Background service with visible console
--uninstall	Launch uninstall dialog
--update <url> <ver>	Self-update dialog
--repair-wsa	4-step WSA repair
--file-sharing	File sharing (WebDAV mount) dialog
--file-sharing root	File sharing with root access
--ad <url> <secs>	Spawn ad overlay
--sdk	Start Play Store patcher SDK

NSIS Installer Arguments

Argument	Description
/S	Silent installation
/S /repair	Silent repair from Windows Settings

Examples

Silent Installation

WSA_Installer_Setup.exe /S

Installs WSA Installer to C:\Program Files\WSA Installer without showing any UI.

Install Background Service

WSA Installer.exe --install-service

Creates and starts the WSABackgroundService Windows service.

Uninstall Background Service

WSA Installer.exe --uninstall-service

Stops and removes the WSABackgroundService.

Launch Uninstaller

WSA Installer.exe --uninstall

Opens the uninstall wizard with 7-step visual progress.

Repair WSA

WSA Installer.exe --repair-wsa

Opens the 4-step repair wizard (detect → stop → backup → reinstall).

File Sharing (User Mode)

WSA Installer.exe --file-sharing

Opens the file sharing setup dialog for user storage access.

File Sharing (Root Mode)

WSA Installer.exe --file-sharing root

Opens the file sharing setup dialog with root filesystem access.

Self-Update

WSA Installer.exe --update https://example.com/new.exe 1.3.0

Downloads and installs the specified update version.

Background Service Mode

WSA Installer.exe --bg-service

Runs as a Windows Service in SYSTEM context (no GUI).

Background Service with GUI

WSA Installer.exe --bg-service-gui

Runs as background service with a visible console window for debugging.

Windows Service Management

Using sc Commands

# Install service
sc create WSABackgroundService binPath= "C:\Program Files\WSA Installer\WSA Installer.exe --bg-service" start= auto

# Configure failure recovery
sc failure WSABackgroundService reset=86400 actions=restart/10000/restart/15000/restart/30000

# Start service
sc start WSABackgroundService

# Stop service
sc stop WSABackgroundService

# Delete service
sc delete WSABackgroundService

Service Properties

Property	Value
Name	WSABackgroundService
Display Name	WSA Background Service
Start Type	Automatic
Recovery	Restart after 10s, 15s, 30s
Reset Period	86400 seconds (24 hours)

Environment Variables

Variable	Description
FLET_VIEW_PATH	Custom path to Flet client executable

Exit Codes

Code	Description
0	Success
1	Error or cancellation