robot
2026.10
false
Robot admin guide
- 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
Setting up Linux robots
Prerequisites and steps for connecting a UiPath Robot Docker image on Linux to Orchestrator using the client credentials of a machine template.
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:
For the tag, refer to The Docker image tag.
docker pull uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>docker pull uipathprod.azurecr.io/robot/uiautomation-runtime:<tag> - Once the image is displayed in your Docker environment, accept the license agreement, and connect the robot to Orchestrator.
Use 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/tenant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid uipathprod.azurecr.io/robot/uiautomation-runtime:<tag>docker run -e LICENSE_AGREEMENT=accept -e ORCHESTRATOR_URL="https://cloud.uipath.com/organization/tenant/orchestrator_" -e CLIENT_ID="$Client_ID" -e CLIENT_SECRET="$Client_secret" -tid uipathprod.azurecr.io/robot/uiautomation-runtime:<tag> - 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>