test-suite
2023.4
false
UiPath logo, featuring letters U and I in white
Test Suite User Guide
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated Aug 13, 2024

UiPath CLI

UiPath® offers a command-line interface (CLI) that allows you to execute certain pre-defined tasks for RPA package management and testing. The purpose of the UiPath CLI is to easily integrate those capabilities with third-party tools like GitLab, Jenkins, and many others, without a plugin.

Note:

UiPath CLI can be used with Orchestrator deployed via Automation Cloud™ , Automation Suite, or standalone.

Common use cases for the UiPath CLI involve:

  • Packing Studio projects into NuGet packages.
  • Deploying NuGet packages to Orchestrator.
  • Running jobs in Orchestrator.
  • Running Test Sets in Orchestrator.

UiPath CLI consists of two types:

  1. UiPath.CLI.Windows

    • Runs on Windows devices only.
    • Builds Windows - Legacy,Windows, and Cross-platform projects.
  2. UiPath.CLI

    • Runs on Linux devices only.
    • Builds only Cross-platform projects.
Note:
  • UiPath CLI does not support SSO connection.

  • UiPath CLI cannot be used to build projects that use Local Triggers.

  • UiPath CLI lacks the functionality to sign a package, a feature that is available when you publish the package from Studio. In this case, the only option is to sign the package after it is built using UiPath CLI. For details, see the sign command. This signing option works also for Azure DevOps and Jenkins.

Prerequisites

  • For UiPath.CLI, install .NET 6.0.7, that comes with the 6.0.302 SDK, or higher.
  • For UiPath.CLI.Windows, install .NET 6.0.7or higher. You must also install .NET Desktop Runtime, that comes with the .NET SDK as well.

Downloading the CLI

You can download any version of the UiPath CLI from the UiPath Official Public Feed, to find the right version for your project, review the compatibility matrix below.

  1. Go to the UiPath Official Public Feed.
  2. In the Filter by keywords search bar, type uipath.cli.
  3. Select either one of the options below:
    • UiPath.CLI
    • UiPath.CLI.Windows
  4. Go to the Versions tab, and select a version of the CLI that you want to download.
  5. Select Download.
  6. Open the folder where the NUPKG file is downloaded, right-click it, and extract the file into a folder.
Results: A folder with the same name as the NUPKG file is created. This folder holds the contents of the UiPath CLI. The entrypoint for all operations is uipcli.exe (for UiPath.CLI.Windows), or uipcli.dll (for UiPath.CLI), located in the tools folder.

UiPath.CLI.Windows Compatibility Matrix

The version of the UiPath Studio you are using to create your projects needs to match the version of the UiPath.CLI.Windows.

Legend: available - compatible; not available - not compatible.

Orchestrator

Project Type

UiPath.CLI.Windows 23.10

UiPath.CLI.Windows 23.6

UiPath.CLI.Windows 22.10

2023.10.x PaaS

Windows - Legacy

available

available

available

2023.10.x PaaS

Windows

available

available

available

2023.10.x PaaS

Cross-platform

available

available

available

2021.10.x On-premises

Windows - Legacy

available

available

available

2021.10.x On-premises

Windows

available

available

available

2021.10.x On-premises

Cross-platform

available

available

available

2021.10.x PaaS

Windows - Legacy

available

available

available

2021.10.x PaaS

Windows

available

available

available

2021.10.x PaaS

Cross-platform

available

available

available

2022.4.x

Windows - Legacy

available

available

available

2022.4.x

Windows

available

available

available

2022.4.x

Cross-platform

available

available

available

2022.10.x

Windows - Legacy

available

available

available

2022.10.x

Windows

available

available

available

2022.10.x

Cross-platform

available

available

available

2023.4.xWindows-Legacy

available

available

available

2023.4.xWindows

available

available

available

2023.4.xCross-platform

available

available

available

Cloud

Windows - Legacy

available

available

available

Cloud

Windows

available

available

available

Cloud

Cross-platform

available

available

available

UiPath.CLI Compatibility Matrix

The version of the UiPath Studio you are using to create your projects needs to match the version of the UiPath.CLI. For example, if you create projects using UiPath Studio 2021.10, you need to use the 21.10 version of the UiPath.CLI.

Legend: available - compatible; not available - not compatible.

OrchestratorProject TypeUiPath.CLI 23.10UiPath.CLI 23.6UiPath.CLI 22.10UiPath.CLI 22.4UiPath.CLI 21.10

2023.10.x PaaS

Windows - Legacy

not available

not available

not available

not available

not available

2023.10.x PaaS

Windows

not available

not available

not available

not available

not available

2023.10.x PaaS

Cross-platform

available

available

available

available

available

2021.10.x On-premises

Windows - Legacy

not available

not available

not available

available

available

2021.10.x On-premises

Windows

not available

not available

not available

not available

not available

2021.10.x On-premises

Cross-platform

available

available

available

available

available

2021.10.x PaaS

Windows - Legacy

not available

not available

not available

available

available

2021.10.x PaaS

Windows

not available

not available

not available

not available

not available

2021.10.x PaaS

Cross-platform

available

available

available

available

available

2022.4.x

Windows - Legacy

not available

not available

not available

available

available

2022.4.x

Windows

not available

not available

not available

not available

not available

2022.4.x

Cross-platform

available

available

available

available

available

2022.10.x

Windows - Legacy

not available

not available

not available

available

available

2022.10.x

Windows

not available

not available

not available

not available

not available

2022.10.x

Cross-platform

available

available

available

available

available

2023.4.xWindows-Legacy

not available

not available

not available

available

available

2023.4.xWindows

not available

not available

not available

not available

not available

2023.4.xCross-platform

available

available

available

available

available

Cloud

Windows - Legacy

not available

not available

not available

available

available

Cloud

Windows

not available

not available

not available

not available

not available

Cloud

Cross-platform

available

available

available

available

available

Was this page helpful?

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