CI/CD integrations user guide

Last updated Nov 12, 2025

UiPath Solution Download Config

The UiPath Solution Download Config task downloads a solution configuration from UiPath Orchestrator. This allows you to retrieve environment-specific configuration files for solutions stored in Orchestrator.

Note:

Solutions are currently supported only in Automation Cloud. Support for Automation Suite is planned for a future release. On-premises (MSI) Orchestrator does not support Solutions.

Note:

This task is compatible only with **UiPath.CLI.WindowsorUiPath.CLI.Linux` at least version 25.10 or higher.

Configuration

Use the following table to configure the UiPath Solution Download Config inputs.

Parameter	Description
Orchestrator connection (Required)	A service connection to the Orchestrator instance.
Package Name (Required)	The solution package name from Orchestrator.
Package Version	Optional. The solution package version from Orchestrator. If not specified, the latest version will be used.
Destination Path (Required)	The local path where the downloaded configuration file will be saved.
Filename	Optional. The local filename including extension where the downloaded configuration will be saved. Final path will concatenate Destination Path and Filename.
File Format	The format of the configuration file to download. Default: `json`. Options: `json`, `yaml`
Trace Level	The trace logging level. Default: `Error`. Options: `None`, `Critical`, `Error`, `Warning`, `Information`, `Verbose`

Notes

Configuration management: This task retrieves solution configuration files stored in Orchestrator for use in deployments
Environment-specific configs: Useful for downloading different configuration files for various environments (dev, test, prod)
Format flexibility: Supports both JSON and YAML configuration formats
Version control: Can download configurations for specific package versions or latest version
Local storage: Downloads configurations to local file system for use in subsequent pipeline tasks
Orchestrator connection: Requires a valid service connection to the target Orchestrator instance
CLI compatibility: This task uses the UiPath CLI internally and requires proper CLI installation on the build agent
Minimum CLI version: Requires UiPath CLI version 25.10 or higher for full compatibility
Integration ready: Downloaded configurations can be used with deploy tasks for environment-specific deployments

Pipeline examples

Basic configuration download

- task: UiPathSolutionDownloadConfig@6  displayName: 'Download Solution Configuration'  inputs:    orchestratorConnection: 'UiPath-Orchestrator-Connection'    packageName: 'MySolution'    destinationPath: '$(Build.ArtifactStagingDirectory)/configs'    traceLevel: 'Information'- task: UiPathSolutionDownloadConfig@6  displayName: 'Download Solution Configuration'  inputs:    orchestratorConnection: 'UiPath-Orchestrator-Connection'    packageName: 'MySolution'    destinationPath: '$(Build.ArtifactStagingDirectory)/configs'    traceLevel: 'Information'

With Orchestrator connection and specific version

- task: UiPathSolutionDownloadConfig@6  displayName: 'Download Production Configuration'  inputs:    orchestratorConnection: 'Production-Orchestrator'    packageName: 'MyBusinessSolution'    packageVersion: '2.1.$(Build.BuildNumber)'    destinationPath: '$(Build.SourcesDirectory)/configs'    filename: 'production-config.json'    format: 'json'    traceLevel: 'Verbose'- task: UiPathSolutionDownloadConfig@6  displayName: 'Download Production Configuration'  inputs:    orchestratorConnection: 'Production-Orchestrator'    packageName: 'MyBusinessSolution'    packageVersion: '2.1.$(Build.BuildNumber)'    destinationPath: '$(Build.SourcesDirectory)/configs'    filename: 'production-config.json'    format: 'json'    traceLevel: 'Verbose'

Complete pipeline: download config and deploy

variables:  solutionName: 'MyBusinessSolution'  solutionVersion: '1.$(Date:yyyy).$(DayOfYear)$(Rev:.r)'  environmentName: 'Production'steps:- task: UiPathSolutionDownloadConfig@6  displayName: 'Download $(environmentName) Configuration'  inputs:    orchestratorConnection: 'Production-Orchestrator'    packageName: '$(solutionName)'    packageVersion: '$(solutionVersion)'    destinationPath: '$(Build.ArtifactStagingDirectory)/configs'    filename: '$(environmentName)-config.yaml'    format: 'yaml'    traceLevel: 'Information'- task: UiPathSolutionDeploy@6  displayName: 'Deploy Solution with Downloaded Config'  inputs:    orchestratorConnection: 'Production-Orchestrator'    packageName: '$(solutionName)'    packageVersion: '$(solutionVersion)'    deploymentName: '$(solutionName)-$(environmentName)-$(Build.BuildNumber)'    deploymentParentFolder: '$(environmentName)'    deploymentFolderName: 'BusinessProcesses'    configPath: '$(Build.ArtifactStagingDirectory)/configs/$(environmentName)-config.yaml'    traceLevel: 'Information'- script: echo "Downloaded and used configuration for $(solutionName) v$(solutionVersion)"  displayName: 'Configuration Summary'variables:  solutionName: 'MyBusinessSolution'  solutionVersion: '1.$(Date:yyyy).$(DayOfYear)$(Rev:.r)'  environmentName: 'Production'steps:- task: UiPathSolutionDownloadConfig@6  displayName: 'Download $(environmentName) Configuration'  inputs:    orchestratorConnection: 'Production-Orchestrator'    packageName: '$(solutionName)'    packageVersion: '$(solutionVersion)'    destinationPath: '$(Build.ArtifactStagingDirectory)/configs'    filename: '$(environmentName)-config.yaml'    format: 'yaml'    traceLevel: 'Information'- task: UiPathSolutionDeploy@6  displayName: 'Deploy Solution with Downloaded Config'  inputs:    orchestratorConnection: 'Production-Orchestrator'    packageName: '$(solutionName)'    packageVersion: '$(solutionVersion)'    deploymentName: '$(solutionName)-$(environmentName)-$(Build.BuildNumber)'    deploymentParentFolder: '$(environmentName)'    deploymentFolderName: 'BusinessProcesses'    configPath: '$(Build.ArtifactStagingDirectory)/configs/$(environmentName)-config.yaml'    traceLevel: 'Information'- script: echo "Downloaded and used configuration for $(solutionName) v$(solutionVersion)"  displayName: 'Configuration Summary'