Citrix Virtual Apps and Desktops

Migrate on-premises configurations to on-premises site

August 18, 2025

Contributed by:

This article describes the steps to migrate your on-premises configurations from one site to another on-premises site using Automated Configuration Tool (ACT).

Requirements

Both on-premises sites must be domain joined to the same domain.
Use Citrix Virtual Apps and Desktops version 2305 or later.

Steps

Download the Automated Configuration Tool and review the system requirements. See Download Automated Configuration.
Open ACT and export your on-premises site using the following the command.
```
Export-CvadAcToFile

```
See Supported migration objects for the list of components supported for migration. For information on the steps to export, see Export on-premises configuration. The parent folder %HOMEPATH%\\Documents\\Citrix\\AutoConfig always contains the exported files from the most recent export.
Launch the ACT on the target site. You must see an AutoConfig folder created in %HOMEPATH%\\Documents\\Citrix.
Copy the .yml files from the Export folder in the source site to the target site’s %HOMEPATH%\\Documents\\Citrix\\AutoConfig folder.
Specify the environment that you are working in using the Set-CvadAcCustomerInfoFile command. For example:
```
Set-CvadAcCustomerInfoFile -Environment OnPrem

```
This command updates the CustomerInfo file with the environment.
Migrate the configuration files using the following command.
```
Import-CvadAcToFile

```
If you want to import from a different folder rather than the AutoConfig folder, run the following:
```
Import-CvadAcToFile -Sourcefolder PATH

```
Note:

If you are migrating host connections, then update the CvadAcSecurity.yml file with the connection information for each host type. See Update the security file for host connections.

If you encounter any errors or exceptions, see the Fixups section in the log file.
Verify that your configurations are migrated on your target site using Web Studio.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Migrate on-premises configurations to on-premises site

August 18, 2025

Contributed by:

August 18, 2025

Contributed by:

Migrate on-premises configurations to on-premises site

Requirements

Steps

In this article