Can the current single-node Redis support Redis Cluster mode? #16164

Closed
opened 2026-02-21 19:24:54 -05:00 by yindo · 2 comments
Owner

Originally created by @joeylee2023 on GitHub (Aug 14, 2025).

Self Checks

  • I have read the Contributing Guide and Language Policy.
  • I have searched for existing issues search for existing issues, including closed ones.
  • I confirm that I am using English to submit this report, otherwise it will be closed.
  • Please do not modify this template :) and fill in all the required fields.

1. Is this request related to a challenge you're experiencing? Tell me about your story.

Can the current single-node Redis support Redis Cluster mode?

2. Additional context or comments

No response

3. Can you help us with this feature?

  • I am interested in contributing to this feature.
Originally created by @joeylee2023 on GitHub (Aug 14, 2025). ### Self Checks - [x] I have read the [Contributing Guide](https://github.com/langgenius/dify/blob/main/CONTRIBUTING.md) and [Language Policy](https://github.com/langgenius/dify/issues/1542). - [x] I have searched for existing issues [search for existing issues](https://github.com/langgenius/dify/issues), including closed ones. - [x] I confirm that I am using English to submit this report, otherwise it will be closed. - [x] Please do not modify this template :) and fill in all the required fields. ### 1. Is this request related to a challenge you're experiencing? Tell me about your story. Can the current single-node Redis support Redis Cluster mode? ### 2. Additional context or comments _No response_ ### 3. Can you help us with this feature? - [ ] I am interested in contributing to this feature.
yindo added the 🙋‍♂️ question label 2026-02-21 19:24:54 -05:00
yindo closed this issue 2026-02-21 19:24:54 -05:00
Author
Owner

@dosubot[bot] commented on GitHub (Aug 14, 2025):

Hi @joeylee2023! I'm Dosu and I’m helping the dify team.

Dify supports both single-node Redis and Redis Cluster mode, but these are separate deployment modes. A single-node Redis instance cannot operate as a Redis Cluster; Redis Cluster mode requires multiple nodes and specific configuration. If you want to use Redis Cluster mode with Dify, you need to set REDIS_USE_CLUSTERS=true and provide your cluster node addresses in the REDIS_CLUSTERS environment variable. The system will then initialize a RedisCluster client and connect to your cluster as expected. For details, see the configuration examples in the .env.example file and the Redis client initialization logic.

To reply, just mention @dosu.


How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other  Chat with Dosu Join Discord Share on X

@dosubot[bot] commented on GitHub (Aug 14, 2025): <!-- Greeting --> Hi @joeylee2023! I'm [Dosu](https://go.dosu.dev/dosubot) and I’m helping the dify team. <!-- Answer --> Dify supports both single-node Redis and Redis Cluster mode, but these are separate deployment modes. A single-node Redis instance cannot operate as a Redis Cluster; Redis Cluster mode requires multiple nodes and specific configuration. If you want to use Redis Cluster mode with Dify, you need to set `REDIS_USE_CLUSTERS=true` and provide your cluster node addresses in the `REDIS_CLUSTERS` environment variable. The system will then initialize a RedisCluster client and connect to your cluster as expected. For details, see the configuration examples in the [.env.example file](https://github.com/langgenius/dify/blob/8d472135294aadaced6f0b71288738f6c3a4e5da/.env.example) and the [Redis client initialization logic](https://github.com/langgenius/dify/blob/8d472135294aadaced6f0b71288738f6c3a4e5da/api/extensions/ext_redis.py). <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot).* --- <sup>How did I do? [Good](https://app.dosu.dev/response-feedback/291d0eee-744c-41f3-ba46-86fd38448dba?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/291d0eee-744c-41f3-ba46-86fd38448dba?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/291d0eee-744c-41f3-ba46-86fd38448dba?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/291d0eee-744c-41f3-ba46-86fd38448dba?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/291d0eee-744c-41f3-ba46-86fd38448dba?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/291d0eee-744c-41f3-ba46-86fd38448dba?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/291d0eee-744c-41f3-ba46-86fd38448dba?feedback_type=other)</sup>&nbsp;&nbsp;[![Chat with Dosu](https://dosu.dev/dosu-chat-badge.svg)](https://app.dosu.dev/6088a4f4-073a-43f3-b3d4-4f06fb0c05a0/ask?utm_source=github)&nbsp;[![Join Discord](https://img.shields.io/badge/join-5865F2?logo=discord&logoColor=white&label=)](https://go.dosu.dev/discord-bot)&nbsp;[![Share on X](https://img.shields.io/badge/X-share-black)](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/langgenius/dify/issues/23941)
Author
Owner

@crazywoola commented on GitHub (Aug 14, 2025):

Asking a question is okay, but please do the research before posting an issue.

Please read this https://stackoverflow.com/help/how-to-ask

@crazywoola commented on GitHub (Aug 14, 2025): Asking a question is okay, but please do the research before posting an issue. Please read this https://stackoverflow.com/help/how-to-ask
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langgenius/dify#16164