robot
2024.10
false
UiPath logo, featuring letters U and I in white

Robot admin guide

Last updated Jan 14, 2026

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:

  1. In a command line terminal, download the Docker image:
    docker pull uipathprod.azurecr.io/robot/uiautomation-runtime:latest24.10
    docker pull uipathprod.azurecr.io/robot/uiautomation-runtime:latest24.10
    
  2. Once the image is displayed in your Docker environment, accept the license agreement, and connect the robot to Orchestrator.
    1. 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.10
      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.10
      
    2. 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.10
      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.10
      
  3. To see the status of the robots on your machine, run:
    docker ps -a
    docker ps -a
    
  4. To disconnect a robot, run:
    docker stop {container_id}
    docker stop {container_id}
    
  5. To stop the robot, but keep it connected to Orchestrator, run:
    docker kill {container_id}
    docker kill {container_id}
    
  6. 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?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo
Trust and Security
© 2005-2026 UiPath. All rights reserved.