Alteryx One App Command-Line Installation Guide
The Alteryx One installer supports command-line options that enable silent installations, enterprise deployments, and automated software distribution. This guide explains the available options, deployment considerations, and installer exit codes.
Note
All installer command-line flags are case-sensitive. Invalid flags, incorrect spelling, or incorrect capitalization are ignored and do not return an error message.
Default Installation (Per-User): If no command-line flags are provided, the installer performs a per-user installation in the default location:
%LOCALAPPDATA%\Alteryx\AlteryxOneExample:
AlteryxOne-1.0.352-US-setup.exe/ALLUSERS: Use this flag to install the Alteryx One app for all users on the machine (Per-Machine installation).Default installation location:
C:\Program Files\Alteryx\AlteryxOneExample:
AlteryxOne-1.0.352-US-setup.exe /ALLUSERS
/S: Use this flag to run the installer in silent mode. When used, the installer does not display the interactive installer and accepts all default settings unless modified by additional supported flags. Examples:AlteryxOne-1.0.352-US-setup.exe /SAlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS
/NOAUTOLAUNCH: Use this flag to prevent the Alteryx One app from automatically launching after installation. This option is supported only for silent installations (/S).Examples:
AlteryxOne-1.0.352-US-setup.exe /S /NOAUTOLAUNCHAlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH
/D=<path>: Use this flag to specify a custom installation directory.Requirements and limitations:
Supported only for silent per-machine installations.
Supports only per-machine installs; custom locations for per-user installs are not supported.
The installer automatically appends an “AlteryxOne” subfolder to the specified location.
/D=C:\temp\Alteryxis installed toC:\temp\Alteryx\AlteryxOne./D=C:\temp\AlteryxOneis installed toC:\temp\AlteryxOne\AlteryxOne.Example:
AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\path\to\installLocationInstalls to:
C:\InstallLocation\AlteryxOneExample with spaces:
AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\Program Files\CustomLocationInstalls to:
C:\Program Files\CustomLocation\AlteryxOne
Important Considerations for
/D=flag:The
/D=<path>parameter must be the final argument in the command. Any text that appears after/D=is interpreted as part of the installation path rather than as additional installer flags.For example, the following command:
AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D=C:\temp\Alteryx /S /NOAUTOLAUNCHinstalls toC:\temp\Alteryx S NOAUTOLAUNCH.To avoid unexpected installation locations, always place
/D=as the last argument:AlteryxOne-1.0.359-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH /D=C:\temp\Alteryx.Do not enclose the path specified with
/D=in quotation marks. If quotation marks are used, the installer ignores the/D=parameter and installs to the default location for the selected installation type.Example:
AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D="C:\temp\Alteryx"Result: The
/D=parameter is ignored, and the application installs to:C:\Program Files\Alteryx\AlteryxOne
Note
Unsupported or incorrectly combined flags do not return an error message. Depending on the flag, the installer may ignore the unsupported option or interpret the command differently than expected. For custom install paths, always ensure /D= is the final argument. Also, do not enclose the path specified with /D= in quotation marks.
Capturing Error Codes When Installing Alteryx One Using a Silent Install
Silent installations return exit codes that IT admins can use to determine whether the installation completed successfully or failed.
This applies to both per-user and per-machine silent installations. For interactive installations, these errors appear in dialog messages on the screen.
Option A: Using Windows Command Prompt
In Windows Command Prompt, use start /wait to keep the terminal open until the installer finishes. Then, use %ERRORLEVEL% to view the installer exit code.
Example: start /wait "" "AlteryxOne-1.0.359-US-setup.exe" /S /ALLUSERS echo Installer Exit Code: %ERRORLEVEL%
Option B: Using PowerShell
In PowerShell, use Start-Process with the -Wait and -PassThru parameters to wait for the installer to finish and capture the exit code.
Example:
$process = Start-Process -FilePath "AlteryxOne-1.0.359-US-setup.exe" ` -ArgumentList "/S", "/ALLUSERS" ` -Wait ` -PassThru
$exitCode = $process.ExitCode
Write-Host "Installer Exit Code: $exitCode"
if ($exitCode -ne 0) { throw "Installation failed with exit code $exitCode" }
Alteryx One Installer Exit Codes
Exit Code | Classification | Meaning and Cause | Action Required |
|---|---|---|---|
0 | Success | The installation or uninstallation completed successfully. | None |
1 | User Abort | The installation was manually cancelled by the user clicking Cancel in the UI. | Retrigger the installation. |
2 | Already Running | Another instance of the Alteryx One installer is already running. | Close any other setup instances before retrying. |
3 | Architecture Mismatch | The operating system is not 64-bit Windows. | Install on a supported 64-bit Windows operating system. |
4 | Installation Conflict | A conflict was detected between installation modes. For example, installing per-machine while a per-user instance exists, or installing per-user while a per-machine instance exists. | Completely uninstall the conflicting installation mode before continuing. |
5 | Locked Files / Processes Active | One of the critical application processes is currently active: | Close Alteryx One and stop the updater service, then run the installer again. |
6 | Elevation Required | The installation mode requires Administrator rights, and the current user or shell is not elevated. This commonly applies to | Run Command Prompt, PowerShell, or the deployment script as an Administrator. |
Note
For silent deployments using /S, monitor exit codes 4, 5, and 6. These are common automated deployment failure scenarios, such as pushing a per-machine install while a per-user instance still exists, or running the installer while Alteryx One is active.