- About this guide
- Getting started
- Installing
- Upgrading
- Connecting and licensing
- Configuring
- Running workloads
- RPA processes and tests
- Agents, functions, and API workflows
- Limits
- Securing and governing
- Monitoring
- Troubleshooting
- Reference
Redirecting robots through a proxy server
Configure UiPath Robot to use a proxy server for both attended (user-mode) and unattended (service-mode) installations, including proxy.json setup.
Whenever your infrastructure uses a proxy for machines/users to connect to the internet, you will also need to configure the Robot to use it.
There are two possible configurations based on the Robot installation mode:
- Attended Robot - user-mode installation
- Unattended Robot - service-mode installation
Configuring the proxy for Attended robots (user-mode)
Attended robots inherit the proxy settings configured for your web browser.
If your proxy needs basic authentication, Assistant will prompt you to input your credentials when you first try to connect the Robot to Orchestrator.
You can setup the proxy by using the old way described at Configuring using the web browser or using the Windows proxy settings
Configuring the proxy for Unattended robots (service-mode)
To correctly configure the Service Mode robots to use the proxy, you need to modify both the proxy.json file and the corresponding Windows Settings of the user account(s) that will run automations.
For configuring the proxy in proxy.json follow the Configuring the proxy settings.
For configuring the proxy for the user account(s) that will run automations, follow the Configuring the proxy for Attended Robots.
To configure the proxy only once, in proxy.json, see Using the machine-level proxy for all Robot processes.
Configuring the proxy using the web browser
-
Open the Internet Properties window.
-
On the Connections tab, select LAN settings. The Local Area Network (LAN) Settings window opens. Depending on your setup, you can set a proxy configuration script or a proxy server.
- To use a proxy script, select Use automatic configuration script, and provide the address to the script.
- To manually set up the proxy server, select Use a proxy server for your LAN, then provide the address of the proxy server and the port.
-
To save your settings, select OK.
-
In your web browser, test the connection by accessing the Orchestrator URL.
Configuring the proxy using Windows settings
- Open the Proxy settings window.
- To use a proxy script, under Automatic proxy setup, switch on the Use setup script. Provide the address to the script.
- To manually set up the proxy server, under Manual proxy setup, switch on the Use a proxy server. Provide the address of the proxy server and the port.
Important:
Adding the
http://prefix to the proxy server address prevents Robot from making HTTPS calls. To ensure the proxy works as expected, remove thehttp://prefix entirely or add the proxy address with bothhttp://andhttps://prefixes. For example:- Incorrect -
http://proxyaddress, - Correct -
https://proxyaddress,http://proxyaddress; https://proxyaddress
- Incorrect -
- To save your settings, select Save.
Configuring the proxy using the proxy.json file
Starting with 2025.10, to configure the proxy for the Unattended Robot (service-mode), you need to modify the proxy.json file. If you are updating from an older version and you already have a proxy setup in place, it is automatically migrated to the new file.
-
Navigate to:
%ProgramData%\UiPath\Shared. -
Search
proxy.jsonfile and open it using a text editor with administrator privileges, such as Notepad++.The
proxy.jsonfile supports multiple configurations, but not all at the same time. If bothScriptAddressandProxyAddressare present,ScriptAddresstakes precedence.{ "ScriptAddress": "http://localhost/proxy.pac", "ProxyAddress": "http://1.1.1.1:1234/", "BypassLocalAddresses": true, "BypassList": "server\\.domain\\.local$;www.google.com;192\\.168\\.\\d{1,3}\\.\\d{1,3}", "UserName": "myUser", "Password": "<your-password>", "Domain": "myDomain" }{ "ScriptAddress": "http://localhost/proxy.pac", "ProxyAddress": "http://1.1.1.1:1234/", "BypassLocalAddresses": true, "BypassList": "server\\.domain\\.local$;www.google.com;192\\.168\\.\\d{1,3}\\.\\d{1,3}", "UserName": "myUser", "Password": "<your-password>", "Domain": "myDomain" }Note:The bypass list is a string of regular expressions, separated by semicolons (
;), that match the URIs of the servers to bypass. To escape a character in a regular expression, use\\(for example,.becomes\\.).-
To use a proxy script, provide the following json:
{ "ScriptAddress" : "http://proxy.address/proxy.pac" }{ "ScriptAddress" : "http://proxy.address/proxy.pac" } -
To provide a proxy address, provide the following json:
{ "ProxyAddress": "http://proxy.address:1234/", "BypassLocalAddresses": true, "BypassList": "server\\.domain\\.local$;www.google.com;192\\.168\\.\\d{1,3}\\.\\d{1,3}", "UserName": "myUser", "Password": "<your-password>", "Domain": "myDomain" }{ "ProxyAddress": "http://proxy.address:1234/", "BypassLocalAddresses": true, "BypassList": "server\\.domain\\.local$;www.google.com;192\\.168\\.\\d{1,3}\\.\\d{1,3}", "UserName": "myUser", "Password": "<your-password>", "Domain": "myDomain" }UserName,Password, andDomainare used for basic authentication.
-
-
Save the
proxy.jsonfile. -
Restart the Robot service or the device.
The proxy.json file must be owned by the Administrators group or by SYSTEM. Otherwise the Robot ignores it, and the Robot service renames it to proxy.json.old. This matters when you deploy the file by copying it to machines: make sure the copy is owned by Administrators or SYSTEM.
Configuring the proxy using an encrypted password
If your security policy disallows storing the proxy password in clear text, you can populate an EncryptedPassword field instead of Password. The Robot decrypts it when authenticating against the proxy.
The field has the following semantics:
- Cleartext takes precedence. If both
PasswordandEncryptedPasswordare present,Passwordwins. To rely on the encrypted value, leavePasswordempty or remove it entirely. - Windows Data Protection API (DPAPI) bound to this machine. The ciphertext is produced with the DPAPI (
LocalMachinescope) and is only valid on the machine where it was generated.
Generating the encrypted value
Save the script below as Encrypt-ProxyPassword.ps1 on the Robot machine and run it from a normal PowerShell — no elevation required.
.\Encrypt-ProxyPassword.ps1 -Password '<your-password>'
.\Encrypt-ProxyPassword.ps1 -Password '<your-password>'
The script prints the Base64-encoded ciphertext to standard output.
param(
[Parameter(Mandatory = $true)]
[string] $Password
)
Add-Type -AssemblyName System.Security
[Convert]::ToBase64String(
[Security.Cryptography.ProtectedData]::Protect(
[Text.Encoding]::UTF8.GetBytes($Password),
$null,
[Security.Cryptography.DataProtectionScope]::LocalMachine))
param(
[Parameter(Mandatory = $true)]
[string] $Password
)
Add-Type -AssemblyName System.Security
[Convert]::ToBase64String(
[Security.Cryptography.ProtectedData]::Protect(
[Text.Encoding]::UTF8.GetBytes($Password),
$null,
[Security.Cryptography.DataProtectionScope]::LocalMachine))
Applying the encrypted value
- Open
%ProgramData%\UiPath\Shared\proxy.jsonwith administrator privileges. - If present, remove the
Passwordfield. - Add
EncryptedPasswordwith the value produced by the script:{ "ProxyAddress": "http://proxy.address:1234/", "BypassLocalAddresses": true, "UserName": "myUser", "EncryptedPassword": "<your-encrypted-password>", "Domain": "myDomain" }{ "ProxyAddress": "http://proxy.address:1234/", "BypassLocalAddresses": true, "UserName": "myUser", "EncryptedPassword": "<your-encrypted-password>", "Domain": "myDomain" } - Save the file.
- Restart the Robot service.
Using the machine-level proxy for all Robot processes
By default, proxy.json is read only by the Robot Service, which runs as a Windows service. The other Robot processes, such as the job executor and UiRobot.exe, take their proxy from the Windows proxy settings of the account that runs them. To make those processes read proxy.json instead:
- Configure
proxy.jsonas described in Configuring the proxy using theproxy.jsonfile, including the proxy credentials if your proxy requires basic authentication. - Create the machine-wide environment variable
UIPATH_APPLY_SERVICE_PROXYwith the valueTrue. - Restart the Robot service or the device.
If your proxy requires basic authentication, include UserName and Password, or EncryptedPassword, in proxy.json — the per-user proxy credentials are not read when this variable is set. With integrated Windows authentication no credentials are needed, because the process authenticates as the account it runs under. If proxy.json declares neither ProxyAddress nor ScriptAddress, the process keeps the Windows proxy settings of the account running it, without the per-user credentials, and the Robot logs a warning.
Configuring the proxy settings during Robot installation
The Robot package of the UiPath Platform Installer has no proxy parameters. If the machine reaches the internet through a proxy, give the proxy to the installer itself in its updater configuration file, so it can download the Robot. For the file format, refer to Install from the command line.
After the installation, configure the Robot's proxy in proxy.json, as described in Configuring the proxy using the proxy.json file.
Checking the proxy server connection
- Connect the Robot to Orchestrator
- Deploy some packages to an environment which contains the previously configured Robot.
- Navigate to the
%userprofile%\.nuget\folder and check if the corresponding process and activities packages have been downloaded. - Run the corresponding job to check if it runs successfully.
- Configuring the proxy for Attended robots (user-mode)
- Configuring the proxy for Unattended robots (service-mode)
- Configuring the proxy using the web browser
- Configuring the proxy using Windows settings
- Configuring the proxy using the
proxy.jsonfile - Configuring the proxy using an encrypted password
- Generating the encrypted value
- Applying the encrypted value
- Using the machine-level proxy for all Robot processes
- Configuring the proxy settings during Robot installation
- Checking the proxy server connection