automation-suite
2024.10
false
UiPath logo, featuring letters U and I in white

Automation Suite on Linux installation guide

Last updated Nov 13, 2025

Generating the configuration file using a wizard

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.

In some specific instances, manual creation of the configuration file might be required. For details, see Configuring cluster_config.json.

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.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo
Trust and Security
© 2005-2025 UiPath. All rights reserved.