Automation Suite on OpenShift installation guide

Last updated Nov 13, 2025

Deploying Redis through OperatorHub

UiPath® products on Automation Suite require Redis to ensure caching capabilities. You have the following options for meeting the Redis caching requirements:

Install and configure Redis, either on your OpenShift cluster or on different servers external to the OpenShift cluster.
Install the Redis Enterprise Operator on your OpenShift cluster. To install Redis Enterprise Operator through OperatorHub, follow the instructions in this section. If you install multiple Automation Suite instances on the same cluster, make sure to install Redis in all the corresponding namespaces and replace the redis host accordingly in the input.json file based on each installation.
Note:
- Automation Suite does not come with a Redis Enterprise Operator license. You must obtain a license directly from Redis or use a UiPath-provided HAA Redis license.
- If you use Redis Enterprise Operator version 6.2.18-41 or earlier, you must install the security context constraint before installing the operator. For more information, see the Redis documentation.

Installing Redis Enterprise Operator

Take the following steps to install Redis Enterprise Operator through OperatorHub:

In the OpenShift interface, navigate to Operators > OperatorHub.
In the search field, search for Redis Enterprise.
Select Redis Enterprise Operator provided by Redis in the result list. The entry is marked as Certified. By default, the image is pulled from the Red Had registry.
On the Install Operator page, specify the namespace for the operator. Only one namespace per operator is supported.
Update the channel with the version you want to install. For more information about specific versions, see the operator release notes.
Choose an approval strategy. For production systems, use Manual to make sure that operator updates require your approval.
Select Install and approve the installation plan.

You can monitor the status of your Redis Enterprise Operator subscription in Operators > Installed Operators.

Creating the Redis Enterprise cluster

Take the following steps to create the Redis Enterprise cluster:

Create a redis-enterprise-cluster.yaml file with the following contents:
```
---
apiVersion: app.redislabs.com/v1
kind: RedisEnterpriseCluster
metadata:
  name: rec
spec:
  bootstrapperImageSpec:
    repository: registry.connect.redhat.com/redislabs/redis-enterprise-operator
  persistentSpec:
    enabled: true
  redisEnterpriseServicesRiggerImageSpec:
    repository: registry.connect.redhat.com/redislabs/services-manager
  redisEnterpriseImageSpec:
    imagePullPolicy: IfNotPresent
    repository: registry.connect.redhat.com/redislabs/redis-enterprise
  nodes: 1
  uiServiceType: ClusterIP---
apiVersion: app.redislabs.com/v1
kind: RedisEnterpriseCluster
metadata:
  name: rec
spec:
  bootstrapperImageSpec:
    repository: registry.connect.redhat.com/redislabs/redis-enterprise-operator
  persistentSpec:
    enabled: true
  redisEnterpriseServicesRiggerImageSpec:
    repository: registry.connect.redhat.com/redislabs/services-manager
  redisEnterpriseImageSpec:
    imagePullPolicy: IfNotPresent
    repository: registry.connect.redhat.com/redislabs/redis-enterprise
  nodes: 1
  uiServiceType: ClusterIP
```
Set the value of the nodes parameter in the YAML file to determine the number of pods running in the Redis Enterprise cluster.
Apply the configuration in the YAML file to the OpenShift cluster by running the following command:
Note: Replace the <redis-namespace> placeholder in the command with the namespace that you used in the previous step.
```
oc apply -f redis-enterprise-cluster.yaml -n "<redis-namespace>"oc apply -f redis-enterprise-cluster.yaml -n "<redis-namespace>"
```

Verify that the cluster is in a Running state by using the following command. The command requires the jq utility to be installed on your machine.

oc get RedisEnterpriseCluster -n <redis-system> -o json | jq -r '.items[0].status.state'oc get RedisEnterpriseCluster -n <redis-system> -o json | jq -r '.items[0].status.state'

To install jq, use one of the following options:

Option 1: Run the following command:

yum install -y epel-release yum install -y jqyum install -y epel-release yum install -y jq

Option 2: Run the following commands:

shell
curl https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/j/jq-1.6-2.el7.x86_64.rpm --output /tmp/jq-1.6-2.el7.x86_64.rpm
yum localinstall /tmp/jq-1.6-2.el7.x86_64.rpmshell
curl https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/j/jq-1.6-2.el7.x86_64.rpm --output /tmp/jq-1.6-2.el7.x86_64.rpm
yum localinstall /tmp/jq-1.6-2.el7.x86_64.rpm

Creating the Redis database

Take the following steps to create the Redis database:

Create a redis-database.yaml file with the following contents:

---
apiVersion: app.redislabs.com/v1alpha1
kind: RedisEnterpriseDatabase
metadata:
  name: redb
spec:
  tlsMode: disabled
  databasePort: 6380---
apiVersion: app.redislabs.com/v1alpha1
kind: RedisEnterpriseDatabase
metadata:
  name: redb
spec:
  tlsMode: disabled
  databasePort: 6380

Apply the configuration in the YAML file to the OpenShift cluster by running the following command:
Note:
Replace the <redis-namespace> placeholder in the command with the namespace that you used in the previous step.
```
oc apply -f redis-database.yaml -n "<redis-namespace>"oc apply -f redis-database.yaml -n "<redis-namespace>"
```

Verify that the database is in an active state by running the following command:

oc get redisenterprisedatabase -n "<redis_namespace>" -o json | jq -r '.items[0].status.status'oc get redisenterprisedatabase -n "<redis_namespace>" -o json | jq -r '.items[0].status.status'

Updating the cluster configuration file

Deploying Redis through OperatorHub requires you to add the following section to the input.json configuration file. Replace the <redis-namespace> and <password> placeholders with appropriate values:

"fabric": {
    "redis": {
      "hostname": "redb.<redis-namespace>.svc.cluster.local",
      "port": 6380,
      "password": "<password>",
      "tls": false
    }
  },  "fabric": {
    "redis": {
      "hostname": "redb.<redis-namespace>.svc.cluster.local",
      "port": 6380,
      "password": "<password>",
      "tls": false
    }
  },

To retrieve the password, run the following command:

oc get secret -n <redis-namespace> redb-redb -o json | jq -r '.data.password' | base64 -doc get secret -n <redis-namespace> redb-redb -o json | jq -r '.data.password' | base64 -d

On this page

Installing Redis Enterprise Operator
Creating the Redis Enterprise cluster
Creating the Redis database
Updating the cluster configuration file

Was this page helpful?

PREVIOUSInstalling the External Secrets Operator

NEXTMeeting product-specific prerequisites

Support and Services

Get The Help You Need

UiPath Academy

Learning RPA - Automation Courses

UiPath Forum

UiPath Community Forum

Trust and Security

Cookies Policy