Robot user guide

Last updated Nov 22, 2025

UiPath Robot system variables

Further custom behavior can be configured through system environment variables.

Important:

After modifying any of the system variables, restart the Robot Service.

The following list summarizes the most common use cases:

UIPATH_SESSION_TIMEOUT - Changes the default 60-second timeout for creating an interactive session. Adjust this value to adapt the Robot behavior based on the performance and load times of the system it interacts with.

Example:
```
UIPATH_SESSION_TIMEOUT=75UIPATH_SESSION_TIMEOUT=75
```
UIPATH_PIP_SESSION_TIMEOUT - Changes the default 180-second timeout for starting a process in a Robot session.

Example:
```
UIPATH_PIP_SESSION_TIMEOUT=60UIPATH_PIP_SESSION_TIMEOUT=60
```
UIPATH_LANGUAGE - Sets the language the Robot operates in. The order of precedence is:
1. UIPATH_LANGUAGE value
2. Machine environment variable
3. Current thread UI culture
4. Default UiPath language (English)
Example:
```
UIPATH_LANGUAGE=FrenchUIPATH_LANGUAGE=French
```
UIPATH_HEADLESS_WITH_USER - Uses the credentials of a specific user, which was previously configured in Orchestrator.

Example:
```
UIPATH_HEADLESS_WITH_USER=TrueUIPATH_HEADLESS_WITH_USER=True
```
UIPATH_PRE_LOADED_EXECUTOR - By default, a preloaded executor is launched when the Robot starts. To change this behavior and launch the preloaded executor only when the first process runs, set this variable to None.

Example:
```
UIPATH_PRE_LOADED_EXECUTOR=NoneUIPATH_PRE_LOADED_EXECUTOR=None
```
UIPATH_DISABLE_PRE_LOADED_EXECUTOR - Disables the preloaded executor feature.

Example:
```
UIPATH_PRE_LOADED_EXECUTOR=NoneUIPATH_PRE_LOADED_EXECUTOR=None
```
UIPATH_ROBOTJS_ALLOWLIST - Automatically accepts the robot consent dialog, when establishing the connection between the Robot JS SDK and the Robot Executor.

The variable accepts custom application URLs, separated by semicolons. Include the port number in the URL if it differs from the standard ports (80 or 443).

Example:
```
UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;
```
UIPATH_DNS_MACHINENAME - Allows using the DNS host name for Localhost when creating RDP sessions. To execute unattended jobs in environments with Kerberos authentication for RDP, set this value to True.

Example:
```
UIPATH_DNS_MACHINENAME=TrueUIPATH_DNS_MACHINENAME=True
```
NUGET_FALLBACK_PACKAGES - Configures the paths to fallback packages folders. Use semicolons to separate multiple paths.

In the absence of this variable, the Robot searches for fallback packages folders in the Nuget.config file.
NUGET_SCRATCH - Allows multiple User Mode robots on the same machine to share a local path for storing packages.

The value must be a path different to the Nuget installation folder, and it acts as a temporary folder for NuGet.

Note: Only the NUGET_SCRATCH variable should use the configured temporary folder.

Example:
```
NUGET_SCRATCH=C:\NuGetTempFolderNUGET_SCRATCH=C:\NuGetTempFolder
```
UIPATH_PRESERVE_CREDENTIALS_CASE - Preserves the original casing of logging credentials (domain\username).

Example:
```
UIPATH_PRESERVE_CREDENTIALS_CASE = TrueUIPATH_PRESERVE_CREDENTIALS_CASE = True
```
UIPATH_SESSION_BEHAVIOR - Configures the way the session restore behaves after a job completes. The following options are available:
- TryReuseAndRestoreSession—Default option. Attempts to reuse the session and restore it to its previous state after a job completes. If there is no initial session to reuse, it logs off on restore.
- ForceNew—Creates a completely new session, regardless of the previous session state. Always logs off on restore.
- LeaveSessionActive—Prevents restoration of the initial session state.
- LeaveSessionDisconnected—Always disconnects the session on restore.
Example:
```
UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnectedUIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected
```

Was this page helpful?

PREVIOUSUiPath.Settings File Description

NEXTAccording to License

Support and Services

Get The Help You Need

UiPath Academy

Learning RPA - Automation Courses

UiPath Forum

UiPath Community Forum

Trust and Security

Cookies Policy