UiPath Install Platform

The UiPathInstallPlatform task downloads and installs a specific version of the UiPath CLI to the Azure DevOps agent's tool cache. This task applies to both standalone automation projects (processes, libraries, tests) and Solutions.

When to use this task

Use the UiPathInstallPlatform task when:

• You want to explicitly control which CLI version is used in your pipeline.
• You need to install a specific CLI flavor based on your project types (see CLI Flavors below).
• Your build agents don't have internet access to the UiPath Public Feed.
• You want to cache the CLI on the agent to speed up subsequent builds.

Execute the UiPathInstallPlatform task before any other UiPath tasks in your pipeline.

Note:

This task is optional. If not specified, Azure DevOps will automatically use the CLI version bundled with the extension. However, using this task gives you explicit control and improves build performance through caching.

CLI Flavors

UiPath CLI is distributed in three platform-specific packages:

CLI Package	OS	Supported Project Types
UiPath.CLI.Windows	Windows	Cross-platform, Windows (non-legacy), Solutions
UiPath.CLI.Linux	Linux	Cross-platform, Solutions
UiPath.CLI.Windows.Legacy	Windows	Windows - Legacy projects only

All CLI packages require .NET 8 Runtime:

• Windows agents: .NET Desktop Runtime 8
• Linux agents: .NET Runtime 8

Handling mixed project types

If your repository contains multiple project types (e.g., both Windows-Legacy and Cross-platform projects), you need to install multiple CLI flavors and process each project type with the correct CLI:

Recommended approach:

1. Install UiPath.CLI.Windows and process all Cross-platform and Windows (non-legacy) projects.
2. Install UiPath.CLI.Windows.Legacy and process all Windows-Legacy projects separately.

You can achieve this in the same Azure DevOps pipeline by:

• Using multiple UiPathInstallPlatform tasks with different CLI versions.
• Organizing your pipeline stages to process each project type with the appropriate CLI.
• Using conditional logic based on folder structure or naming conventions to identify project types.

Tip:

There is no automatic way for UiPath CLI to detect project types. You must know which projects in your repository are Windows-Legacy and organize your pipeline accordingly.

CLI version selector

Select the version of the CLI that you want to use from the Choose a CLI version (Required) dropdown.

The options in the dropdown list include:

• Available versions of UiPath CLI 25.10 and later.
• The CLI flavor (Windows, Linux, or Windows.Legacy).

Path to CLI's nupkg (Offline Scenario)

If your Azure DevOps agents cannot access the UiPath Public Feed, you can manually provide the CLI package:

1. Download the desired CLI version from the UiPath Public Feed.

2. Place the downloaded .nupkg file inside the Agent.Tools directory of your build agent.

   Example: $(Agent.ToolsDirectory)\nupkg\UiPath.CLI.Windows.25.10.1-20251105-9.nupkg

3. In the UiPathInstallPlatform task configuration, set cli version to 'CustomVersion' and provide the path to the .nupkg file in the Path to CLI's nupkg field.

Important:

Make sure custom version CLI package name matches exactly the one from Official feed like below:

• UiPath.CLI.Windows.25.10.1-20251105-9.nupkg
• UiPath.CLI.Linux.25.10.1-20251105-9.nupkg

YAML pipeline

You can configure the UiPath Install Platform task in YAML format:

- task: UiPathInstallPlatform@6  displayName: 'UiPath Install Platform'  inputs:    cliVersion: 'Windows.25.10.1-20251105-9'  # For UiPath.CLI.Windows    # or 'Linux.25.10.1-20251105-9'         # For UiPath.CLI.Linux    # or 'Windows.Legacy.25.10.9424.14050'  # For UiPath.CLI.Windows.Legacy

For repositories with mixed project types, install both CLI flavors:

# Install CLI for Cross-platform and Windows (non-legacy) projects- task: UiPathInstallPlatform@6  displayName: 'Install UiPath CLI Windows'  inputs:    cliVersion: 'Windows.25.10.1-20251105-9'# Install CLI for Windows-Legacy projects- task: UiPathInstallPlatform@6  displayName: 'Install UiPath CLI Windows Legacy'  inputs:    cliVersion: 'Windows.Legacy.25.10.9424.14050'

To install custom version of CLI:

- task: UiPathInstallPlatform@6  displayName: 'UiPath Install Platform'  inputs:    cliVersion: 'CustomVersion'    cliNupkgPath: 'C:\Tools\UiPath.CLI.Windows.25.10.1-20251105-9.nupkg'

Next steps

• Executing Azure DevOps Tasks - Learn how to configure and execute Azure DevOps pipelines.
• Azure DevOps Project Tasks - Explore tasks for standalone automation projects.
• Azure DevOps Solution Tasks - Explore tasks for Solutions.