automation-suite
2024.10
false
UiPath logo, featuring letters U and I in white

Automation Suite on EKS/AKS installation guide

Last updated Mar 9, 2026

Running uipathctl

uipathctl is a UiPath® command-line tool that allows you to perform various operations in Automation Suite on EKS/AKS, Automation Suite on OpenShift, and Automation Suite on Linux.

You can use uipathctl to check prerequisites in your environment, install Automation Suite, as well as configure and manage it from a single unified CLI.

You can install uipathctl on the Linux, macOS, and Windows platforms.

Currently, uipathctl is only compatible with the x86 architecture. You cannot run uipathctl on machines based on the ARM architecture, such as Macs with Apple Silicon (M series) CPUs.

For more information, including a complete list of uipathctl operations, see the uipathctl Reference Guide.

Running uipathctl on Linux

To run uipathctl on Linux, take the following steps:

  1. Download the version of the uipathctl binary that you are interested in. For instructions, see Downloading the installation packages.

  2. Uncompress uipathctl and add it to your PATH:

    tar xzvf uipathctl-linux-amd64.tar.gz
    chmod +x uipathctl
    export PATH=$PATH:$(pwd)
    tar xzvf uipathctl-linux-amd64.tar.gz
    chmod +x uipathctl
    export PATH=$PATH:$(pwd)
    
  3. Verify if uipathctl works:

    uipathctl version
    uipathctl version
    

    The command prints some version information, as shown in the following example:

    Version:       2024.10.0
    ...
    Version:       2024.10.0
    ...
    

Running uipathctl on Windows

To run uipathctl on Windows, take the following steps:

  1. Download the version of the uipathctl binary that you are interested in. For instructions, see Downloading the installation packages.

  2. Uncompress uipathctl and add it to your PATH:

    tar xzvf uipathctl-windows-amd64.tar.gz
    tar xzvf uipathctl-windows-amd64.tar.gz
    

    Append or prepend the uipathctl binary folder to your PATH environment variable.

  3. Verify if uipathctl works:

    uipathctl version
    uipathctl version
    

    The command prints some version information, as shown in the following example:

    Version:       2024.10.0
    ...
    Version:       2024.10.0
    ...
    

Running uipathctl on MacOS

To run uipathctl on MacOS, take the following steps:

  1. Download the version of the uipathctl binary that you are interested in. For instructions, see Downloading the installation packages.

  2. Uncompress uipathctl and add it to your PATH:

    tar xzvf uipathctl-darwin-amd64.tar.gz
    chmod +x uipathctl
    export PATH=$PATH:$(pwd)
    tar xzvf uipathctl-darwin-amd64.tar.gz
    chmod +x uipathctl
    export PATH=$PATH:$(pwd)
    
  3. Verify if uipathctl works:

    uipathctl version
    uipathctl version
    

    The command prints some version information, as shown in the following example:

    Version:       2024.10.0
    ...
    Version:       2024.10.0
    ...
    

Telemetry

By default, telemetry is sent from uipathctl to UiPath® at each command execution. This helps us improve our products and user experience.

To opt out of telemetry, set the UIPATHCTL_TELEMETRY_OPTOUT environment variable to 1:

export UIPATHCTL_TELEMETRY_OPTOUT=1
export UIPATHCTL_TELEMETRY_OPTOUT=1

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated