Skip to content
ElastiCache for Redis/Valkey
Sub-page 1 of 9
Core one-way-door · Free

Enabling Cluster Mode Is a One-Way Door — Decide Before You Need It

Decision drivers
  • Realistic ceiling on dataset size and write throughput over the cluster's lifetime
  • Whether the client library is cluster-protocol-capable already
  • Whether the application uses multiple Redis/Valkey database indices (blocks cluster mode — single-database only)
  • Tolerance for a supervised migration project if this needs revisiting later

Production premise

Cluster mode is a node-based-only concept — ElastiCache Serverless shards automatically and has no cluster-mode toggle at all; this page applies once you've committed to (or are evaluating) node-based deployment. Within node-based, cluster mode disabled runs Valkey as a single logical dataset (one primary, up to 5 replicas); cluster mode enabled shards data across multiple nodes (default up to 90 shards, extendable on request) for horizontal write scaling. AWS's own migration path is explicit and one-directional.

Failure mode & inflection point

You can change cluster mode disabled → enabled, but AWS's documentation states plainly: "Reverting this configuration is not possible." Migrating requires the cluster to be Valkey 7.2+ (or Redis OSS 7.0+), all keys in database 0, a cluster-protocol-aware client, and auto-failover with at least one replica already configured — teams that discover they need cluster mode after already depending on multi-database-index usage or a non-cluster-aware client face real application changes, not just a config flip.

Production guardrail

Decide cluster mode based on your actual scaling ceiling, not your current size — if there's a real chance the dataset or write throughput will outgrow a single shard's capacity, start in cluster mode (or at minimum, use a cluster-protocol-aware client from day one, even while running cluster-mode-disabled) rather than betting on a clean later migration. If you're genuinely unsure, "compatible" mode exists as a bridge state — clients can connect via either protocol during a supervised transition — but that bridge only runs one direction.