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.
-
Some module versions are not supported or recommended for use with Redis Enterprise.
-
We recommend consulting Redis support before you upgrade a module on the cluster, especially if the cluster is used in production.
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:
-
Copy the module package to a node in the cluster.
-
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.
-
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 anerror_code
anddescription
with more details.
Cluster Manager UI method
To add a module to the cluster using the Cluster Manager UI:
-
Go to Cluster > Modules.
-
Select Upload module.
-
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.