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

Automation Suite on Linux installation guide

Last updated Feb 18, 2026

Step 13: Generating cluster_config.json

Generating cluster_config.json on the first machine

The cluster_config.json file defines the parameters, settings, and preferences applied to the UiPath® products deployed via Automation Suite.
You can generate the cluster_config.json configuration file either manually or using the Automation Suite Installer Wizard. While the wizard offers a more user-friendly approach, it currently does not accommodate all possible configuration scenarios.
Note: In some specific instances, manual creation of the configuration file might be required. For details, see Configuring cluster_config.json.

You can always edit the generated file to update the configuration.

Generating the configuration file using a wizard

To generate cluster_config.json using the Automation Suite Installer Wizard, take the following steps:

  1. Launch the wizard on port 80 on the local host by running the following command:

    • On Linux/macOS:

      ./uipathctl config generate./uipathctl config generate
    • On Windows:
      uipathctl.exe config generate
uipathctl.exe config generate
    To launch the wizard on a different port and host, run the following command:

    • On Linux/macOS:

      ./uipathctl config generate --port <your port> --host <your IP address>./uipathctl config generate --port <your port> --host <your IP address>
    • On Windows:
      uipathctl.exe config generate --port <your port> --host <your IP address>
uipathctl.exe config generate --port <your port> --host <your IP address>
  2. In a browser of your choice, launch the wizard by accessing the following URL: http://localhost:80.
    If you chose a different host and port, make sure to replace localhost and 80 with the IP address and port where you want to launch the wizard.
  3. Accept the license agreement.
  4. Indicate the platform where you want to host Automation Suite. You can choose from the following options:

    • Automation Suite on AKS

    • Automation Suite on EKS

    • Automation Suite on OpenShift
    • Automation Suite on Linux
      Note: The instructions in this guide are applicable if you choose this option.
  5. Specify your deployment mode. You can choose from the following options:

    • Online - Choose this option to install Automation Suite in an online environment. This deployment mode requires internet access during installation and runtime.

    • Offline - Choose this option to install Automation in an offline environment. This deployment mode requires an OCI-compliant container registry.

    For details, refer to Online deployment or Offline deployment.

  6. Indicate your deployment type. You can choose from the following options:

    • Highly Available - Choose this option if you want to install Automation Suite in multi-node HA-ready mode.

    • Lite mode - Choose this option if you want to install Automation Suite in lite mode.

    For details, refer to Deployment modes and use cases.

  7. Provide additional details on your initial configuration. Depending on your previous selection, you may have to provide details such as the Automation Suite FQDN, admin username and password, storage class, namespace, ArgoCD project, and ArgoCD application namespace.
  8. Indicate the Automation Suite products you want to enable.

    For details, refer to Automation Suite products.

  9. Provide the details on your SQL database configuration, such as the following:

    • Whether you want to bring your own database or you want the Automation Suite installer to create it for you

    • Whether you want to use Kerberos authentication

    • The Redis cache details

    For details, refer to Configuring SQL databases.

  10. Specify the storage configuration details, such as storage type or bucket details.

    For details, refer to Hardware requirements.

  11. If you opted for an offline installation, provide the details of your OCI-compliant registry.
  12. Provide your certificates details.

    For details, refer to Certificates.

  13. Specify the products for which you want to perform advanced configuration such as overwrite platform-level configurations with service-level configurations such as connections strings, objectstore setup, etc.
  14. Download the cluster_config.json configuration file.

Any feature that is not available during the cluster_config.json configuration using the Automation Suite Installer Wizard, can be manually included after downloading the configuration file.

Copying cluster_config.json to all the other machines

To install Automation Suite, the cluster_config.json file must be available on all the machines. After generating the configuration file on the first machine, you must copy it to the other machines instead of regenerating it. Regenerating the configuration file may result in discrepancies that could cause the installation to fail.
To copy the configuration file from the first machine to the other machines, run the following command. Make sure to replace username and node_dns with the values relevant to the target machine. 
scp /opt/UiPathAutomationSuite/cluster_config.json <username>@<node_dns>:/opt/UiPathAutomationSuitescp /opt/UiPathAutomationSuite/cluster_config.json <username>@<node_dns>:/opt/UiPathAutomationSuite
If you do not have direct access to copy the files to the /opt/UiPathAutomationSuite folder, you can transfer them to your home directory, and then move them to the desired location.
  • Generating cluster_config.json on the first machine
  • Generating the configuration file using a wizard
  • Copying cluster_config.json to all the other machines

Was this page helpful?

Support and Services
Get The Help You Need
UiPath Academy
Learning RPA - Automation Courses
UiPath Forum
UiPath Community Forum
Uipath Logo
Trust and Security
Terms of Use
Privacy Policy
Cookies Policy
© 2005-2026 UiPath. All rights reserved.