Robot admin guide

Last updated Aug 25, 2025

Setting up Linux robots

To set up robots in a Linux environment, you need an existing unattended setup in Orchestrator.

The following procedure downloads the docker image on Linux and connects the Robot to Orchestrator:

In a command line terminal, download the Docker image:
```
docker pull uipathprod.azurecr.io/robot/uiautomation-runtime:latest24.10docker pull uipathprod.azurecr.io/robot/uiautomation-runtime:latest24.10
```

Once the image is displayed in your Docker environment, accept the license agreement, and connect the robot to Orchestrator.

Using the client ID and the client secret of the machine template:

docker run -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_"-e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid uipathprod.azurecr.io/robot/uiautomation-runtime:latest24.10docker run -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_"-e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid uipathprod.azurecr.io/robot/uiautomation-runtime:latest24.10

Using the machine key:

docker run -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -e MACHINE_KEY="$KEY" -tid uipathprod.azurecr.io/robot/uiautomation-runtime:latest24.10docker run -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tentant/orchestrator_" -e MACHINE_KEY="$KEY" -tid uipathprod.azurecr.io/robot/uiautomation-runtime:latest24.10

To see the status of the robots on your machine, run:
```
docker ps -adocker ps -a
```

To disconnect a robot, run:

docker stop {container_id}docker stop {container_id}

To stop the robot, but keep it connected to Orchestrator, run:
```
docker kill {container_id}docker kill {container_id}
```

To retrieve the logs from the container, run:

docker cp <ContainerId>:/home/robotuser/.local/share/UiPath/Logs <TargetPath>docker cp <ContainerId>:/home/robotuser/.local/share/UiPath/Logs <TargetPath>

Was this page helpful?

PREVIOUSDeploying the Robot to multiple machines

NEXTLicensing robots for unattended automations

Support and Services

Get The Help You Need

UiPath Academy

Learning RPA - Automation Courses

UiPath Forum

UiPath Community Forum

Trust and Security

Cookies Policy