Automation Suite on Linux installation guide

Last updated Mar 26, 2026

Adding a dedicated agent node with GPU support

Note:

Automation Suite currently supports only Nvidia GPU drivers. See the list of GPU-supported operating systems. For more on the cloud-specific instance types, see the following:

AWS
Azure
GCP Before adding dedicated agent node(s) with GPU support, make sure to check Hardware requirements.

Installing a GPU driver on the machine

Note:

The following instructions apply to both online and offline Automation Suite installations. In the case of offline installations, you must ensure temporary internet access to retrieve the required GPU driver dependencies. If you encounter issues while installing the GPU driver, contact Nvidia support.
The GPU driver is stored under the /opt/nvidia and /usr folders. It is highly recommended that these folders should be at-least 5 GB and 15 GB, respectively, on the GPU agent machine.

To install the GPU driver on the agent node, refer to the Nvidia installation instructions. Ensure that you follow all instructions provided, including those in any linked resources.

To install the Nvidia Container Toolkit, refer to the Nvidia container toolkit installation guide.

To verify proper driver installation, run the sudo nvidia-smi command on the node, as shown in the following example:

docs image

Adding a GPU node to the cluster

Step 1: Configuring the machine

To ensure the disk is partitioned correctly and all networking requirements are met, see Step 6: Configuring the disks.

Step 2: Copying the interactive installer to the target machine

SSH to any of the server machine.
Run the following command to copy the contents of the UiPathAutomationSuite folder to the GPU node (username and DNS are specific to the GPU node):
```
sudo su -
scp -r /opt/UiPathAutomationSuite <username>@<node dns>:/opt/
scp -r ~/* <username>@<node dns>:/opt/UiPathAutomationSuite/
sudo su -
scp -r /opt/UiPathAutomationSuite <username>@<node dns>:/opt/
scp -r ~/* <username>@<node dns>:/opt/UiPathAutomationSuite/
```

Step 3: Running the interactive installer to configure the dedicated node

SSH to the GPU Node.

Run the following commands:

sudo su -
cd /opt/UiPathAutomationSuite
chmod -R 755 /opt/UiPathAutomationSuite
yum install unzip jq -y
CONFIG_PATH=/opt/UiPathAutomationSuite/cluster_config.json 

./bin/uipathctl rke2 install -i /opt/UiPathAutomationSuite/cluster_config.json -o output.json -k -j gpu --accept-license-agreement
sudo su -
cd /opt/UiPathAutomationSuite
chmod -R 755 /opt/UiPathAutomationSuite
yum install unzip jq -y
CONFIG_PATH=/opt/UiPathAutomationSuite/cluster_config.json 

./bin/uipathctl rke2 install -i /opt/UiPathAutomationSuite/cluster_config.json -o output.json -k -j gpu --accept-license-agreement

Enabling the GPU on the cluster

Log in to any server node.
Navigate to the installer folder (UiPathAutomationSuite).
```
cd /opt/UiPathAutomationSuite
cd /opt/UiPathAutomationSuite
```
Enable the GPU on the cluster by running the following command on any server node:
```
sudo ./bin/uipathctl rke2 gpu --enable
sudo ./bin/uipathctl rke2 gpu --enable
```

On this page

Installing a GPU driver on the machine
Adding a GPU node to the cluster
Step 1: Configuring the machine
Step 2: Copying the interactive installer to the target machine
Step 3: Running the interactive installer to configure the dedicated node
Enabling the GPU on the cluster

Was this page helpful?

PREVIOUSOptional: Increasing fault tolerance

NEXTAdding a Dedicated Agent Node for Automation Suite Robots

Automation Suite on Linux installation guide

Installing a GPU driver on the machine​

Adding a GPU node to the cluster​

Step 1: Configuring the machine​

Step 2: Copying the interactive installer to the target machine​

Step 3: Running the interactive installer to configure the dedicated node​

Enabling the GPU on the cluster​