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
| Symptom | Likely Cause | Recommended Action |
|---|---|---|
| FT.SEARCH or FT.CREATE is unavailable on an Essentials database running Redis 8.x | Redis Search availability depends on database type and compatibility limitations. | Confirm the database version, type, Advanced capabilities, Flex status, and OSS Cluster API setting, then test with MODULE LIST and FT._LIST. |
| Advanced capabilities show only JSON and Probabilistic on an Essentials database | The database may be running a version earlier than Redis 8, or the database type may not support Redis Search. | Check the database version and database type first. |
| You created an Essentials database and never saw a module selector | This is expected behavior for Redis 8 and later database creation flows. | Verify Redis Search availability after provisioning instead of looking for a capability picker. |
| You are using a Flex database and Redis Search is unavailable | Flex databases are not compatible with Redis Search. | Create a RAM-only database instead. |
| Search commands fail only when OSS Cluster API is enabled | Redis Search is not supported with OSS Cluster API. | Disable OSS Cluster API if Redis Search is required. |
| You need Redis Search but the current database does not support it | The database was created on an incompatible type or without Redis Search support. | Create a new compatible database and migrate or repopulate data as needed. |
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._LISTStep 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._LISTIf 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:
Update the connection string or endpoint
Recreate Redis Search indexes with FT.CREATE
Repopulate or migrate data
-
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
0 comments
Please sign in to leave a comment.