# Compatibility Matrix

> This page outlines the compatibility requirements for using UiPath CLI 25.10, including supported Studio, Robot, and Orchestrator versions, project types, .NET runtimes, and CI/CD plugins.

## Compatibility overview

This page outlines the compatibility requirements for using UiPath CLI 25.10, including supported Studio, Robot, and Orchestrator versions, project types, .NET runtimes, and CI/CD plugins.

## UiPath CLI compatibility rules

UiPath CLI must always be used with UiPath Studio, Robot, and Orchestrator versions that are equal to or newer than the CLI version.
If you are using UiPath CLI 25.10, it is supported with:
- UiPath Studio 25.10+
- UiPath Robot 25.10+
- UiPath Orchestrator 25.10+

:::note
The version of UiPath Studio you use to create your projects needs to match the version of UiPath CLI you use to package them.
Using mismatched versions (for example, packaging a 25.10 project with an older CLI) can result in build or deployment errors.
:::

Backward compatibility is not guaranteed. Using a CLI version newer than the target Robot or Orchestrator may lead to unexpected behavior.

## .NET Runtime requirements

All UiPath CLI packages in 25.10 require .NET 8:

- Windows flavors (`UiPath.CLI.Windows`, `UiPath.CLI.Windows.Legacy`) require the .NET Desktop Runtime 8.
- Linux flavor (`UiPath.CLI.Linux`) requires the .NET Runtime 8.
- macOS flavor (`UiPath.CLI.macOS`) requires the .NET Runtime 8 for ARM64.

:::note
macOS support is currently available for ARM64 (Apple Silicon) processors only. Intel-based Macs are not supported.
:::

Your local environment or CI/CD agent must have the correct runtime installed for the CLI to execute properly.

## Supported project types by CLI flavor

| CLI Package                  | OS       | Supported Project Types                     |
|------------------------------|----------|---------------------------------------------|
| `UiPath.CLI.Windows`         | Windows  | RPA (Cross‑platform/Windows), Solutions            |
| `UiPath.CLI.Linux`           | Linux    | RPA (Cross‑platform), Solutions            |
| `UiPath.CLI.macOS`           | macOS    | RPA (Cross‑platform), Solutions            |
| `UiPath.CLI.Windows.Legacy`  | Windows  | RPA (Windows – Legacy)          |

:::note
Windows – Legacy projects cannot be included in Solutions. Use `UiPath.CLI.Windows.Legacy` only for standalone RPA Windows Legacy projects.
:::

## Solutions compatibility

UiPath CLI features full lifecycle support for Solutions (pack, deploy, activate). However, Solutions are currently supported only in Automation Cloud™.

You can use `uipcli solution pack`, `deploy`, and `activate` only when targeting an Automation Cloud Orchestrator.
Standalone Orchestrator (on‑premises MSI or Automation Suite) does not support Solution deployment via CLI.

## Plugin compatibility (Azure DevOps / Jenkins)

The **Azure DevOps** and **Jenkins** plugins install only the following CLI packages:
- `UiPath.CLI.Windows`
- `UiPath.CLI.Linux`
- `UiPath.CLI.macOS`
- `UiPath.CLI.Windows.Legacy`

Older CLI versions (23.x / 24.x) are no longer distributed by the updated plugins.

:::note
This is a **breaking change**. Pipelines must be updated to explicitly reference one of the new CLI flavors and its version.
:::