UiPath Documentation
automation-suite
2.2510
true
UiPath logo, featuring letters U and I in white

Automation Suite on Linux installation guide

Last updated Mar 26, 2026

Converting an existing installation to multi-site setup

You can convert an existing installation into multi-site by taking the following steps:

  1. Convert the standalone Automation Suite cluster into the primary cluster. For details, see Converting a standalone cluster into a primary cluster.
  2. Install secondary Automation Suite cluster. For details, see Disaster Recovery - Installing the secondary cluster.
Note:

Ensure that the certificates are the same on the primary and secondary clusters. This check is not performed or enforced automatically.

Converting a standalone cluster into a primary cluster

To convert an existing Automation Suite cluster into a primary cluster of the multi-site deployment, take the following steps:

  1. Update cluster_config.json. Add or update fqdn, cluster_fqdn, and enable multisite.

    "fqdn" : "<global traffic manager fqdn>"
    "cluster_fqdn": "<fqdn of the primary cluster>",
    
    "multisite": {
        "enabled": true,
        "primary": true
     }
    "fqdn" : "<global traffic manager fqdn>"
    "cluster_fqdn": "<fqdn of the primary cluster>",
    
    "multisite": {
        "enabled": true,
        "primary": true
     }
    

    For details, see the following documentation: Advanced installation experience. Update the TLS certificate section to configure the new certificate, ensuring it meets the requirements outlined in the Active/Passive Certificate Requirements section.

    Note:

    It is recommended to keep the FQDN of your existing Automation Suite setup to avoid reconfiguring all your robots.

  2. Configure the infrastructure on the first server node.

    1. Navigate to the installer folder:

      
      cd /opt/UiPathAutomationSuite/{version}/installer
      
      cd /opt/UiPathAutomationSuite/{version}/installer
      
    2. Run the following command on the first server node:

      ./bin/uipathctl rke2 update-fqdn -i /path/to/cluster_config.json --versions versions.json
      ./bin/uipathctl rke2 update-fqdn -i /path/to/cluster_config.json --versions versions.json
      

      This will update all the other nodes in the cluster, including the remaining server nodes, agent nodes, and specialized agent nodes.

  3. Configure the fabric and services on the first server node, by running the following command:

    ./bin/uipathctl manifest apply cluster_config.json --versions versions.json
    ./bin/uipathctl manifest apply cluster_config.json --versions versions.json
    
  • Converting a standalone cluster into a primary cluster

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated