Desktop Installer Reference
About the installer
The ET Ducky Desktop application ships as a single signed EXE built with Inno Setup (for example ETDucky-Desktop-Setup-2.1.1.exe). It installs the desktop diagnostics app to %ProgramFiles%\ETDucky\Desktop, requires administrator rights, and supports both interactive and fully unattended installation.
This page documents the command-line switches for unattended deployment, every exit code the installer can return, the runtime prerequisites, and how to handle a failed install. It is the reference linked from packaging systems such as the Microsoft Store and from RMM and MDM deployment tools.
Silent and unattended installation
The installer shows a setup wizard by default. For managed or scripted deployment, pass switches so it runs without any UI:
| Switch | Effect |
|---|---|
/VERYSILENT | No wizard and no progress window. Recommended for managed deployment. |
/SILENT | No wizard, but a progress window is still shown. |
/SUPPRESSMSGBOXES | Suppresses message boxes. Use together with /SILENT or /VERYSILENT. |
/NORESTART | Never restarts the machine, even if a component requests it. |
/NOCANCEL | Disables the Cancel button so an unattended install cannot be interrupted. |
/DIR="x:\path" | Overrides the install directory. |
/LOG="x:\path\setup.log" | Writes a verbose install log. Strongly recommended for diagnosing failures. |
A typical unattended command line:
ETDucky-Desktop-Setup-2.1.1.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /LOG="%TEMP%\etducky-install.log"
The installer is not silent without these switches. Any packaging system that asks whether the installer runs silently "without switches" should be told that it does require switches.
Exit codes
The installer returns a standard Inno Setup exit code. Read it from %ERRORLEVEL% in a batch script or $LASTEXITCODE in PowerShell.
| Code | Meaning | What it means for ET Ducky |
|---|---|---|
0 | Success | The application installed successfully. |
1 | Setup failed to initialize | A prerequisite check failed: an unsupported Windows version, or a missing .NET Desktop Runtime or WebView2 Runtime. Under a silent install the prerequisite prompts are suppressed and Setup stops here. |
2 | Cancelled before installation | The user closed or cancelled the wizard before the install began. |
3 | Fatal error preparing to install | An error occurred between the wizard and the install phase. Rare; check the install log. |
4 | Fatal error during installation | The install failed while copying files or writing the registry. Common causes: insufficient permissions, antivirus locking files, or no disk space. |
5 | Cancelled during installation | The user cancelled mid-install, or chose Abort at an error prompt. |
6 | Terminated by a debugger | Not produced during normal use. |
7, 8 | Pre-install stage blocked | Reserved by Inno Setup. The ET Ducky installer does not use the stage that produces these, so they are not expected. |
Codes 0, 2, and 5 are normal outcomes (success, and two forms of user cancellation). Codes 1, 3, and 4 indicate a failure that needs attention.
Prerequisites
ET Ducky Desktop requires:
- Windows 10 version 1809 (build 17763) or later, 64-bit.
- The .NET Desktop Runtime matching the current ET Ducky Desktop build.
- The Microsoft Edge WebView2 Runtime, which is already present on most up-to-date Windows installations.
During an interactive install, Setup detects a missing runtime and offers to download it, then asks you to re-run the installer. During a silent install those prompts are suppressed and Setup exits with code 1 instead. For managed deployment, install the prerequisites first, or use a build of the installer that bundles them.
Handling a failed install
- Code 1: Confirm the machine meets the Windows version requirement and has the .NET Desktop Runtime and WebView2 Runtime installed, then re-run Setup.
- Code 2 or 5: The install was cancelled by a person. No action is needed beyond re-running it.
- Code 3 or 4: Re-run with
/LOGand review the log. Confirm Setup is running with administrator rights, that antivirus is not quarantining the files, and that the target drive has free space.
If a failure persists, send the /LOG file to [email protected], or open a report from the status page.
Uninstalling
The installer registers an uninstaller in the install directory. To uninstall silently:
"%ProgramFiles%\ETDucky\Desktop\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART
ET Ducky Desktop can also be removed through Settings > Apps > Installed apps in Windows.