- Getting Started
- Installation and Upgrade
- Robot Types
- Robot Components
- Licensing
- Connecting Robots to Orchestrator
- Processes and Activities
- Logging
- Specific Scenarios
- Restarting Robot Components
- Windows Sessions
- Login Using Thales Luna Credential System
- Login Using NShield Key Storage Provider
- Redirecting Robots Through a Proxy Server
- Executing Tasks in a Minimized RDP Window
- Using Mapped Network Drives
- Stopping a Process
- Disable Stop Button
- Custom Package Folders and Network Paths
- CrowdStrike integration
- Robot Citrix Apps Virtualization
- Governance
- Troubleshooting
- Common Connection Errors
- Unresponsive Robot Over RDP
- Duplicate Execution Logs
- Frequently Encountered Robot Errors
- Increased Process Execution Duration
- Enforced Package Signature Verification
- Message Too Large to Process
- Errors When Running as Administrator
- NuGet Packages Not Accessible After Migration
- User Access Control Prompt and UI Automation Activities
- .NET required during installation
- Assembly Cannot Be Loaded From Network Or Azure File Share
- Activities cannot find .NET Runtime
- CrowdStrike integration troubleshooting

Robot user guide
UiPathRobot.msi installer from the command line.
See the following sections for descriptions of the available parameters and a few usage examples.
- Administrator rights are required to execute these commands.
- Using the
/passiveoption of msiexec.exe to run an unattended installation is not supported.
The following list displays all available command line parameters.
/q- Installs the specified UiPath features silently, without displaying the user interface./l*vx <LogFile>- Generates an installer log file at the specified path. You can send the file further to our support team if, for any reason, you encounter difficulties during the installation process.-
ADDLOCAL- Allows selecting the features to install. Without this parameter, the following features are installed by default: Robot in Service Mode, Default activity packages, and JavaScript Add-on.It supports the following options:
DesktopFeature— Indicates that you want to install the Robot feature.Studio(exclusively for UiPathStudio.msi) — Installs Studio. Must be used together with theDesktopFeatureparameter.ExcelAddin(exclusively for UiPathStudio.msi) — Installs the StudioX Excel Add-in. Must be used together with theStudioparameter.Robot— Installs the Robot in User Mode or Service Mode, as well as the Assistant. Must be used together with theDesktopFeatureparameter.RegisterService— Required for Service Mode installations. Do not add it for User Mode installations.StartupLauncher— Runs the Robot at Windows startup. Must be used together with theDesktopFeatureparameter.Packages(exclusively for UiPathStudio.msi) — Installs the default activity packages. Must be used together with theRobotparameter.JavaBridge— Installs the UiPath Java Bridge for better integration and automation with Java applications. Adding this may increase installation time. Must be used together with theRobotparameter.ChromeExtension— Installs the Google Chrome Extension. Must be used together with theRobotparameter.FirefoxExtension— Installs the Firefox extension. Must be used together with theRobotparameter.EdgeExtension— Installs the Microsoft Edge Chromium-based Extension. Must be used together with theRobotparameter.CitrixClient— Installs the UiPath Citrix Client Extension. Must be used together with theRobotparameter. Not available for per-user installations.JavaScriptAddOn— Installs the Browser Embedding add-on. Must be used together with theRobotparameter. Cannot be used with elevated rights.SapPlugin(exclusively for UiPathStudio.msi) — Installs the SAP Solution Manager plugin. Requires the SAP Connector for Microsoft to be installed on your machine. On clean installs, you must also provide an address for the instance using theSAP_SOL_MAN_HOSTparameter. Must be used together with theStudioparameter. Not available for per-user installations.VMwareExtension— Installs the UiPath extension for VMware Horizon. Must be used together with theRobotparameter. Not available for per-user installations.WindowsRdpExtension— Installs the UiPath extension for Windows Remote Desktop. Must be used together with theRobotparameter.
MSIINSTALLPERUSER- Enables you to install only for the current user.- To install per user, add
MSIINSTALLPERUSER=1. The following options are not available in per-user installations: RegisterService, CitrixExtension, VMwareExtension, PACKAGES_FOLDER, CODE. - To install per machine, do not include this parameter.
- To install per user, add
SAP_SOL_MAN_HOST(exclusively forUiPathStudio.msi) - The hostname or IP address of your SAP Solution Manager instance. Required for clean installations where theSapPluginparameter was added in theADDLOCALoption.APPLICATIONFOLDER- Enables you to install the Robot in a custom location.NUGET_OPTIONS- For offline environments. If set toDisableOnlineFeeds, this parameter disables the online UiPath official and Community feeds for the Robot, and uses Orchestrator and local feeds exclusively.Note: The URL feeds remain in the configuration files, but are ignored.-
PACKAGES_FOLDER- Enables you to change the download location for your workflows and their dependencies. The chosen folder can be user-specific or accessible by all users on a machine.
- Without this parameter, the default download location is
%userProfile%\.nuget\packages. -
Not available for per-user installations.
Note: Make sure that all users that need to execute processes have read access to the new folder. - Find out how to set up .
- For installations on Windows Server machines that enable concurrent execution, you must provide paths that are specific to each user. Read more about .
- Find out how to change the download folder for packages after installation.
CUSTOM_NUGET_FEEDS- Enables you to add custom NuGet activities feeds for Studio and/or Robot. This command only adds or updates the existing list of feeds. It must be populated with key-value pairs of type string:- Valid locations include online feeds, folder paths, and shared network drives.
- Make sure that the provided feeds are accessible by all users on a given machine.
-
Separate feeds with semicolons (;).
For example:
CUSTOM_NUGET_FEEDS="FeedName1,https://my.custom.nuget.feed; FeedName2,D:\Custom\Activities\Packages\"CUSTOM_NUGET_FEEDS="FeedName1,https://my.custom.nuget.feed; FeedName2,D:\Custom\Activities\Packages\"
ENFORCE_SIGNED_EXECUTION- Optional. Enables you to enforce your Robots to execute only signed packages. Without this parameter, package signing is not enabled. It has the following options:1- The Robot only handles packages signed by UiPath-verified authors or repositories. To add your own certificate as a trusted source, modify thenuget.configfile.0- No package signing rule is enforced on your Robot deployment.
CODE- Licenses your Robot instance. Not available for per-user installations.-
CLIENT_IDandCLIENT_SECRET- Automatically connects the Robot to Orchestrator using client credentials, while also installing it. For example:UiPathRobot.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_ CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32kUiPathRobot.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_ CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32k CHROME_INSTALL_TYPE- Allows you to choose the installation method for the Chrome extension. Needs admin rights. Without this parameter, the most appropriate method is selected automatically. It has the following options:POLICYOFFLINE- The Chrome Extension is automatically installed per system via the Group Policy Offline method, the equivalent of calling the/Chrome-Policy-Offlinecommand using the SetupExtensions tool.POLICYONLINE- The Edge Extension is automatically installed per system via the Group Policy Online method, the equivalent of calling the/Edge-Chromium-PolicyGlobalcommand using the SetupExtensions tool.MANUALPERMACHINE- The Chrome Extension is installed for all users, the equivalent of calling the/ChromeGlobalcommand using the SetupExtensions tool.NATIVEHOSTONLY- Only the Native Messaging Host component (ChromeNativeMessaging.exe) is installed, the equivalent of calling the/ChromeNativeHostGlobalcommand using the SetupExtensions tool.
Note: The old installation methods names (STORE,GLOBAL) are kept for backwards compatibility.EDGE_INSTALL_TYPE- Allows you to choose the installation method for the Edge extension. Needs admin rights. Without this parameter, the most appropriate method is selected automatically. It has the following options:POLICYOFFLINE- The Edge Extension is automatically installed per system via the Group Policy Offline method, the equivalent of calling the/Edge-Policy-Offlinecommand using the SetupExtensions tool.POLICYONLINE- The Edge Extension is automatically installed per system via the Group Policy Online method, the equivalent of calling the/Edge-Chromium-PolicyGlobalcommand using the SetupExtensions tool.MANUALPERMACHINE- The Edge Extension is installed for all users, the equivalent of calling the/Edge-Chromium-Globalcommand using the SetupExtensions tool.NATIVEHOSTONLY- Only the Native Messaging Host component (ChromeNativeMessaging.exe) is installed, the equivalent of calling the/Edge-Chromium-NativeHostGlobalcommand using the SetupExtensions tool.
Note: The old installation methods names (STORE,GLOBAL) are kept for backwards compatibility.DISABLE_SECURE_XAML- Allows you to disable security ofXAMLfiles for Robots installed as a Windows service. UnsecuredXAMLfiles allow users to read and modify the process files and logic. It has the following options:0- The default option. Enables security forXAMLfiles for Windows service Robots.1- Disables security forXAMLfiles for Windows service Robots.
SERVICE_URL- Allows you to define the URL of the Orchestrator instance to connect to using Interactive Sign-In. This value is saved in theuipath.configfile. Required by User Mode installations. Service Mode installations ignore this parameter.ORCHESTRATOR_URL- In clean installations, you can specify the main Orchestrator URL, used for retrieving auto-update information. For example:https://orchestrator.local/organizationName/tenantName.TELEMETRY_ENABLED- Allows you to disable the usage data collection. It has the following options:0- Disables the telemetry for Studio and Robot.1- Default option. Enables the telemetry for Studio and Robot.
-
ENABLE_PIP- Allows you to enable the Robot session (Picture in Picture) functionality of the machine. It has the following options:0- Default option. The Robot session capability is disabled.1- Enables the Robot session capability.
INSTALLER_LANGUAGE- Enables you to select the display language of the installer. Without this parameter, the installer uses the language settings in Windows. It has the following options:2052- Chinese (Simplified)12- French7- German17- Japanese1- Korean22- Portuguese (Portugal)1046- Portuguese (Brazil)25- Russian10- Spanish (Spain)2058- Spanish (Mexico)31- Turkish
ASSISTANT_OPTIONS- Enables or disables the Marketplace widget for Assistant. It has the following options:- Absent or
EnableMarketplace- The default option. Enables the widget. DisableMarketplace- Disables the widget.
- Absent or
ORCHESTRATOR_AUTO_SIGNIN- Enables automatic sign-in to your account. For User Mode installations and environments configured to use the SSO with Azure Active Directory. Must be used together with theORCHESTRATOR_URLparameter. It has the following options:0- Disables the automatic sign-in.1- Enables the automatic sign-in.
- If you need to use environment variables such as
%USERNAME%or%USERPROFILE%, the%special character needs to be escaped as follows:- When the setup is invoked from Command Prompt, use
^-UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%. - In batch scripts, use
^-UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%. - In PowerShell console or scripts - no escaping is needed.
- When using Active Directory domain accounts, it is recommended to specify the domain name in the folder structure too, such
as
C:\packages\^%UserDomain^%.^%Username^%.
- When the setup is invoked from Command Prompt, use
- If you need to use paths with spaces, they must be wrapped as follows:
- In Command Prompt, surround with double quotes (
" "). For example,UiPathRobot.msi APPLICATIONFOLDER="C:\folder name". - In PowerShell, surround with single and double quotes (
'" "'). For example,./UiPathRobot.msi APPLICATIONFOLDER='"C:\folder name"'.
- In Command Prompt, surround with double quotes (
If you want to make additional configurations after the installation is completed, you can run the installer synchronously. This enables you to add other commands to be performed after the installer finishes, For example, you can install and also set up a robot connection or configure feeds.
The following scripts perform the installation and enable you to add other commands to be performed if the installation is successful.
:: Runnning the MSI synchronously
start /wait /b UiPathRobot.msi /Q
:: Assert the exit code and continue accordingly
set "_isSuccess="
if %ERRORLEVEL% EQU 0 Set "_isSuccess=1"
if %ERRORLEVEL% EQU 1641 Set "_isSuccess=1"
if %ERRORLEVEL% EQU 3010 Set "_isSuccess=1"
:: test for success and run follow-up commands
if (%_isSuccess% EQU 1) (
echo "success"
) ELSE (
echo "fail"
):: Runnning the MSI synchronously
start /wait /b UiPathRobot.msi /Q
:: Assert the exit code and continue accordingly
set "_isSuccess="
if %ERRORLEVEL% EQU 0 Set "_isSuccess=1"
if %ERRORLEVEL% EQU 1641 Set "_isSuccess=1"
if %ERRORLEVEL% EQU 3010 Set "_isSuccess=1"
:: test for success and run follow-up commands
if (%_isSuccess% EQU 1) (
echo "success"
) ELSE (
echo "fail"
)UiPathRobot.msi installer is located. You can do this with the following command, for example: cd D:\UiPathInstaller.
- Install the Robot in user mode only for the current user -
UiPathRobot.msi MSIINSTALLPERUSER=1 ADDLOCAL=DesktopFeature,Robot - Silently install the Robot -
UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,StartupLauncher,JavaBridge /Q - Silently install the Robot and the Chrome Extension via policy -
UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=POLICYONLINE /Q -
Silently install the Robot as a Windows service and connect it to Orchestrator -
UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService CONNECTIONSTRING=https://demo.uipath.com/api/robotsservice/GetConnectionData?tenantId=1 /Q - Silently install the Robot as a Windows service, and add two custom activity feeds -
UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1,https://my.custom.nuget.feed; FeedName2,D:\RPA\Activities\Packages\" /Q - Silently install and license a Robot registered as a Windows service and the local activity feed -
UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,CODE=1234567890 /Q - Install Robot as a Windows service, and disable the official online feeds -
UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds - Uninstall the Chrome Extension -
UiPathRobot.msi REMOVE=ChromeExtension /Q -
Set up the auto-update connection during attended robot installation -
UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService SERVICE_URL="https://demo.uipath.com/myorg/mytenant" -
Set up the auto-update connection during unattended robot installation -
UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService ORCHESTRATOR_URL="https://demo.uipath.com/myorg/mytenant/orchestrator_"