Install a module on a cluster

Redis Enterprise comes packaged with several modules. As of version 7.4.2, Redis Enterprise includes two feature sets, compatible with different Redis database versions. You can view the installed modules, their versions, and their minimum compatible Redis database versions from Cluster > Modules in the Redis Enterprise Cluster Manager UI.

To use other modules or upgrade an existing module to a more recent version, you need to install the new module package on your cluster.

Get packaged modules

To install or upgrade a module on a Redis Enterprise cluster, you need a module package.

• For the latest Redis Enterprise modules, download packages from the Redis download center.

• For earlier versions of Redis Enterprise modules that are no longer available from the Redis download center, contact support.

• For custom-packaged modules, download a custom-packaged module from the developer.

Add a module to a cluster

Use one of the following methods to add a module to a Redis Enterprise cluster:

• REST API POST request to the /v2/modules endpoint

• Redis Enterprise Cluster Manager UI

• For RedisGears, follow these installation instructions

REST API method

To add a module to the cluster using the REST API:

1. Copy the module package to a node in the cluster.

2. Add the module to the cluster with a POST request to the /v2/modules endpoint:

   POST https://[host][:port]/v2/modules
   "module=@/tmp/redisearch.Linux-ubuntu16.04-x86_64.2.2.6.zip"
   

   Here, the module parameter specifies the full path of the module package and must be submitted as form-data. In addition, the package must be available and accessible to the server processing the request.

3. If the module installation succeeds, the POST request returns a JSON object that represents the new module. If it fails, it may return a JSON object with an error_code and description with more details.

Cluster Manager UI method

To add a module to the cluster using the Cluster Manager UI:

1. Go to Cluster > Modules.

2. Select Upload module.

3. Use the file browser to add the packaged module.

Next steps

• Create a database and enable the new module.
• Upgrade a module to the new version.