Redis Search Is Unavailable on a Redis Cloud Essentials Database

Redis Cloud Essentials databases can support advanced features like Redis Search, JSON, Time series, and Probabilistic data structures. This depends on the Redis version, database type, and compatibility limits.

Starting with Redis 8, Redis Cloud no longer uses a separate advanced capability selection step for supported database types. Because of this, the Redis Cloud console may not display a module or capability picker during database creation.

This article explains how to confirm whether Redis Search is available on an Essentials database, understand common compatibility limitations, and determine the correct remediation path when commands such as FT.CREATE or FT.SEARCH are unavailable.

Quick Fix

Prerequisites

Before troubleshooting, collect the following information:

• Database name and subscription

• Redis version

• Database type

• Advanced capabilities shown on the database details page

• Whether the database uses Flex

• Whether OSS Cluster API is enabled

You also need a successful client connection so you can run:

MODULE LIST
FT._LIST

Step 1: Confirm the Redis version

In the Redis Cloud console, open the database details page and check the Version field.

For Redis 8 and later, Redis Cloud no longer uses the older advanced capability selection workflow during database creation.

For versions earlier than Redis 8, the database details page is the source of truth for which advanced capabilities are enabled.

Step 2: Confirm the database type

Check whether the database is RAM-only or Flex.

Flex databases are not compatible with Redis Search.

If the database uses Flex, Redis Search commands such as FT.CREATE, FT.SEARCH, and FT.INFO are unavailable by design.

To use Redis Search, create a RAM-only database instead.

Step 3: Check the Advanced capabilities section

Open the database details page in the Redis Cloud console and review the Advanced capabilities section.

For Redis 8 and later:

• The console may not display a capability selector during database creation

• Capability availability must be validated from the database itself and from the database details page

If the database details page shows only JSON and Probabilistic and doesn't show Redis Search, treat the database as not having Redis Search available.

Step 4: Validate from the database

Connect using redis-cli, Redis Insight, or your application client, then run:

MODULE LIST
FT._LIST

If Redis Search is available:

• MODULE LIST shows a search-related module

• FT._LIST succeeds

• FT.CREATE, FT.SEARCH, and related commands are available

If Redis Search is unavailable:

• MODULE LIST does not show a search-related module

• FT._LIST fails

• FT.CREATE returns:

ERR unknown command 'FT.CREATE'

Step 5: Check whether OSS Cluster API is enabled

Redis Search is not supported when OSS Cluster API is enabled.

If you need Redis Search functionality:

• Disable OSS Cluster API

• Use the default proxy-based routing model instead

Step 6: Choose the correct remediation path

Use the following guidance:

• If the database uses Flex, create a RAM-only database instead because Flex does not support Redis Search

• If OSS Cluster API is enabled, disable it if Redis Search is required

• If the database is Redis 8.x RAM-only and Redis Search is still unavailable, validate behavior using a new test database in the same account and region

• If the database is running a version earlier than Redis 8 and Redis Search is not listed in Advanced capabilities, create a new compatible database

Existing databases generally are not modified in place to add missing advanced capabilities.

Step 7: Create a replacement database if needed

If the current database doesn't support Redis Search, create a new compatible database and update your application to use the new endpoint.

After the replacement database is available:

1. Update the connection string or endpoint

2. Recreate Redis Search indexes with FT.CREATE

3. Repopulate or migrate data

4. Validate functionality with:

   MODULE LIST
   FT._LIST

If the existing dataset is disposable or can be recreated automatically, reprovisioning is usually the fastest remediation path.

Troubleshooting

There is no module selector in the database creation flow

This is expected behavior for Redis 8 and later database creation flows.

Redis Cloud no longer uses the older capability-selection workflow during database provisioning.

Do not use the absence of a capability picker as proof that Redis Search is unavailable. Validate availability from the database details page and with FT.* commands instead.

Redis Search is unavailable on Flex

This is expected behavior.

Flex databases are compatible with most Redis workloads except for workloads that require Redis Search or Time Series functionality.

Use a RAM-only database if Redis Search is required.

Search commands fail only in clustered access mode

If OSS Cluster API is enabled, Redis Search commands are unavailable.

Disable OSS Cluster API and use the default routing model if Redis Search is required.

FT.CONFIG is unavailable

This is expected behavior.

FT.CONFIG SET isn't supported in Redis Cloud. Configuration changes for Redis Search in supported Redis Cloud environments must go through Redis Support.

Redis Search should be available, but commands still fail

Before contacting Redis Support, collect the following:

• Database details page showing:

  • Version

  • Type

  • Advanced capabilities

• Output from:

  MODULE LIST
  FT._LIST

• Exact FT.* command error

• Confirmation that:

  • the database is not Flex

  • OSS Cluster API is disabled